Invoice Integration - cXML Header (Credentials)

  • Updated

This article outlines the structure and required credential values for the cXML Header section, which is used to validate who is sending the document and who it's being sent to.

 

Prerequisites

  • Audience: Supplier (Technical/Integration)

  • Intent: Understand and correctly format the cXML Header for message validation.

  • Data: Valid credential values (DUNS, unimarket-id, unimarket-code, unimarket-user) for the Supplier, Customer, and Integration User.

 

Key Ideas

The <Header> section contains three required elements—<From>, <To>, and <Sender>—each with a <Credential> element that uses a domain attribute and an <Identity> value. Unimarket matches these identity credentials to the stored values for the Supplier and Customer.

ElementIdentityValid domain AttributesNotes
<From>Identifies the Supplier Store.DUNS, unimarket-id, unimarket-code.If using DUNS, the number must match exactly what is loaded for the Supplier.
<To>Identifies the Community (Customer).DUNS, unimarket-id, unimarket-code.If using DUNS, the number must match exactly what is loaded for the Customer.
<Sender>Identifies the Supplier Integration User.DUNS, unimarket-user.Includes a <SharedSecret> (password) for authentication and a <UserAgent> to identify the sending system.

Example: Using DUNS Credentials

This example uses DUNS numbers for all three identities:

 
<Header>
    <From>
        <Credential domain="DUNS">
            <Identity>1234567890</Identity>
        </Credential>
    </From>
    <To>
        <Credential domain="DUNS">
            <Identity>0987654321</Identity>
        </Credential>
    </To>
    <Sender>
        <Credential domain="DUNS">
            <Identity>1234567890</Identity>
            <SharedSecret>Super Secret Password</SharedSecret>
        </Credential>
        <UserAgent>Suppliers Software System</UserAgent>
    </Sender>
</Header>

 

Example: Using Unimarket Credentials

This example uses credentials supplied by Unimarket, specifically unimarket-id for the Supplier, unimarket-code for the Community, and unimarket-user for the Sender:

 
<Header>
    <From>
        <Credential domain="unimarket-id">
            <Identity>82d1aa66-095a-45a8-b8f1-20778aac4ed8</Identity>
        </Credential>
    </From>
    <To>
        <Credential domain="unimarket-code">
            <Identity>miketest</Identity>
        </Credential>
    </To>
    <Sender>
        <Credential domain="unimarket-user">
            <Identity>fd36b3b9-ad5a-4fa6-aedd-a826b7b3d87b</Identity>
            <SharedSecret>Super Secret Password</SharedSecret>
        </Credential>
        <UserAgent>Suppliers Software System</UserAgent>
    </Sender>
</Header>