Learn More About Our Salesforce Commerce Cloud Integration

Unlocking Efficiency with cXML Examples

In this blog post, we delve into cXML, its advantages, and offer real-life examples illustrating its application.

TradeCentric

by

When it comes to B2B eCommerce, efficiency is key. Streamlining procurement processes not only saves time but also boosts productivity and ultimately contributes to business growth. One powerful tool that facilitates this efficiency is cXML (Commerce eXtensible Markup Language). In this guide, we’ll explore the significance of cXML and provide practical cXML examples to illustrate its effectiveness in optimizing B2B transactions.

Understanding cXML

cXML is a standardized protocol used for communication between eCommerce applications, particularly in the procurement process. It allows for the exchange of business documents such as purchase orders, invoices, and acknowledgments in a structured and standardized format. This standardized format ensures seamless integration between different systems, eliminating manual data entry and reducing errors.

Benefits of cXML

The adoption of cXML offers numerous benefits for businesses engaged in B2B transactions:

  • Automation: By leveraging cXML, businesses can automate the exchange of procurement documents, saving time and reducing manual effort.
  • Accuracy: The standardized format of cXML ensures consistency and accuracy in data exchange, minimizing errors and discrepancies.
  • Efficiency: With cXML, transactions can be processed faster, leading to quicker order fulfillment and improved operational efficiency.
  • Interoperability: cXML promotes interoperability between different eCommerce systems, allowing for seamless communication and collaboration between trading partners.

Practical Examples of cXML

Let’s dive into some practical examples to illustrate how cXML can be used in real-world scenarios:

1. PunchOut Request to Supplier

<!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/cXML/1.2.032/cXML.dtd">
<cXML payloadID="ABCD1234efg567" timestamp="yyyy-mm-ddThh:mm:ssZ" xml:lang="en-US">
   <Header>
      <!-- Header information goes here if available -->
   </Header>
   <Request deploymentMode="production">
      <PunchOutSetupRequest operation="create">
         <BuyerCookie>zyx987WVU654tsr</BuyerCookie>
         <Extrinsic name="returnURL">https://connect.tradecentric.com/gateway/link/api/id/ABCD1234efg567</Extrinsic>
         <Extrinsic name="postForm">https://s1-2.ariba.com/Buyer/punchout?client=HTML.1234567890ABCDEFGHIJ0987654321kl.Node12produs-c7-buyer-s2-z1-3us2gcpint&amp;responseid=9&amp;locale=en_US</Extrinsic>
         <Contact>
            <Name>Jane Doe</Name>
            <Email>[email protected]</Email>
         </Contact>
         <Shipping>
            <Address name="Main Office" addressID="Main">
               <Name xml:lang="en">Jane Doe</Name>
               <PostalAddress>
                  <DeliverTo>Jane Doe</DeliverTo>
                  <Street>3445 Seminole Trail #218</Street>
                  <City>Charlottesville</City>
                  <State>VA</State>
                  <PostalCode>22911</PostalCode>
                  <Country isoCountryCode="US">United States</Country>
               </PostalAddress>
            </Address>
         </Shipping>
         <Items>
            <Item quantity="3">
               <ItemID>
                  <SupplierPartID>45L017</SupplierPartID>
                  <SupplierPartAuxiliaryID>CART12-ITEM123</SupplierPartAuxiliaryID>
               </ItemID>
               <ItemType>out</ItemType>
            </Item>
         </Items>
      </PunchOutSetupRequest>
   </Request>
   <Custom>
      <OrganisationID>123</OrganisationID>
      <OrganisationName>Buyer Corp.</OrganisationName>
   </Custom>
</cXML>

2. Advanced Shipping Notice

<cXML>
  <Header>
    <From>
      <Credential>
        <Identity>ABCD1234efgh5678.IJKL9012mnopq</Identity>
      </Credential>
    </From>
  </Header>
  <Request>
    <ShipNoticeRequest>
      <ShipNoticeHeader>
        <ShipNoticeHeaderExt>
          <ExtRefID>ASN-456</ExtRefID>
          <NoticeDate>2022-11-18</NoticeDate>
          <POPayloadID>93369535150910.10.57.136</POPayloadID>
          <PONumber>PO-123</PONumber>
          <PODate>2022-11-01</PODate>
          <ShipDate>2022-11-18T08:30:00-04:00</ShipDate>
          <DeliveryDate>2022-11-22T15:30:00-04:00</DeliveryDate>
          <ShipmentType>actual</ShipmentType>
          <RequestedDeliveryDate>2022-12-25</RequestedDeliveryDate>
          <Carrier>
            <CarrierID domain="SCAC">UPSC</CarrierID>
            <CarrierName>United Parcel Service Ground</CarrierName>
          </Carrier>
          <ShipmentID>1Z56F78A0450293517</ShipmentID>
          <ShipTo>
            <Address addressID="TN.04">
              <Name>Test Corp. - Nashville Branch</Name>
              <DeliverTo>John Doe</DeliverTo>
              <Street>123 Test St.</Street>
              <City>Nashville</City>
              <State>TN</State>
              <PostalCode>37011</PostalCode>
              <Country>United States</Country>
              <CountryCode>US</CountryCode>
              <Email>[email protected]</Email>
              <Phone>888-555-9876</Phone>
            </Address>
          </ShipTo>
          <BillTo>
            <Address addressID="TN.04">
              <Name>Test Corp. - Nashville Branch</Name>
              <DeliverTo>John Doe</DeliverTo>
              <Street>123 Test St.</Street>
              <City>Nashville</City>
              <State>TN</State>
              <PostalCode>37011</PostalCode>
              <Country>United States</Country>
              <CountryCode>US</CountryCode>
              <Email>[email protected]</Email>
              <Phone>888-555-9876</Phone>
            </Address>
          </BillTo>
          <Contact>
            <Email>[email protected]</Email>
            <Name>John Doe</Name>
          </Contact>
        </ShipNoticeHeaderExt>
        <ShipNoticeItem>
          <ItemIn>
            <ItemID>
              <SupplierPartID>45L017</SupplierPartID>
            </ItemID>
            <Quantity>2</Quantity>
            <UnitOfMeasure>EA</UnitOfMeasure>
            <Description>Low Arc Kitchen Faucet: Dominion Faucets, Silver, Chrome Finish, 1.75 gpm Flow Rate, CEC Compliant</Description>
            <UnitPrice>41.15</UnitPrice>
            <Classification domain="UNSPSC">56101720</Classification>
            <Comments>This product is subject to a per-item packing fee for quantities less than 50.</Comments>
            <Discount>
              <MoneyAmount>0</MoneyAmount>
              <DiscountPercent>5</DiscountPercent>
              <Description>Volume discount; 5% discount on quantities of ten or more.</Description>
            </Discount>
            <Shipping>
              <MoneyAmount>0</MoneyAmount>
              <Description>FedEx 2Day</Description>
            </Shipping>
            <Tax>
              <MoneyAmount>0</MoneyAmount>
              <RatePercent>7</RatePercent>
              <Description>Sales tax - 7% Tennessee</Description>
            </Tax>
            <Total>86.8</Total>
            <Confirmation>
              <ConfirmationStatus>
                <Quantity>1</Quantity>
                <Type>accept</Type>
                <Date>2022-01-01</Date>
                <UnitOfMeasure>EA</UnitOfMeasure>
              </ConfirmationStatus>
            </Confirmation>
          </ItemIn>
        </ShipNoticeItem>
        <ShipNoticeSummary>
          <TotalAmount>103.97</TotalAmount>
          <SubtotalAmount>85.33</SubtotalAmount>
          <Currency>USD</Currency>
          <Shipping>
            <MoneyAmount>10.09</MoneyAmount>
            <Description>FedEx 2Day</Description>
          </Shipping>
          <Tax>
            <MoneyAmount>8.64</MoneyAmount>
            <Description>Sales tax - 7% Tennessee</Description>
          </Tax>
        </ShipNoticeSummary>
      </ShipNoticeHeader>
    </ShipNoticeRequest>
  </Request>
</cXML>

3. eQuote from Supplier

<cXML>
  <Header>
    <QuoteRequest>
      <QuoteRequestHeader>
        <QuoteID>Q1234</QuoteID>
        <QuoteName>Custom Sourced Products</QuoteName>
        <QuoteDate>2023-02-08</QuoteDate>
        <QuoteExpiration>2023-03-08 23:59:59</QuoteExpiration>
        <QuoteType>standing</QuoteType>
        <MatchReference>123456798</MatchReference>
        <BuyerContact>
          <Name>Joe Bloggs</Name>
          <Email>[email protected]</Email>
        </BuyerContact>
        <SalesContact>
          <Name>Bill Smith</Name>
          <Email>[email protected]</Email>
        </SalesContact>
      </QuoteRequestHeader>
    </QuoteRequest>
  </Header>
  <Request>
    <QuoteOrder>
      <QuoteOrderItem>
        <LineNumber>1</LineNumber>
        <ItemID>
          <SupplierPartID>45L017</SupplierPartID>
          <AuxiliaryPartID>12345/1</AuxiliaryPartID>
          <Classification domain="UNSPSC">56101720</Classification>
          <Description>Low Arc Kitchen Faucet: Dominion Faucets, Silver, Chrome Finish, 1.75 gpm Flow Rate, CEC Compliant</Description>
        </ItemID>
        <Quantity>3</Quantity>
        <UnitOfMeasure>EA</UnitOfMeasure>
        <UnitPrice>41.15</UnitPrice>
      </QuoteOrderItem>
    </QuoteOrder>
  </Request>
  <Details>
    <TotalAmount currency="USD">1234.56</TotalAmount>
    <Comment>Items quoted as requested by Sue</Comment>
    <TotalDetails>
      <Total label="Discount">1.99</Total>
    </TotalDetails>
  </Details>
</cXML>

4. PO Acknowledgement

<!DOCTYPE cXML SYSTEM “http://xml.cxml.org/schemas/cXML/1.2.032/cXML.dtd”>
<cXML payloadID=“ABCD1234efgh5678.IJKL9012mnopq” timestamp=“yyyy-mm-ddThh:mm:ssZ” xml:lang=“en-US”>
   <Header>
      <!-- Header information goes here if available -->
   </Header>
   <Request>
      <OrderRequest>
         <OrderRequestHeader orderRequestID=“12345678”>
            <Extrinsic name=“ext_notice_id”>POACK-789</Extrinsic>
            <Extrinsic name=“notice_date”>2022-11-18</Extrinsic>
            <Extrinsic name=“po_payload_id”>93369535150910.10.57.136</Extrinsic>
            <Extrinsic name=“po_order_id”>PO-123</Extrinsic>
            <Extrinsic name=“po_order_date”>2022-11-01</Extrinsic>
            <Extrinsic name=“confirmation_status”>accept</Extrinsic>
            <ShipTo>
               <Address addressID=“TN.04" addressName=“Test Corp. - Nashville Branch”>
                  <Name xml:lang=“en”>John Doe</Name>
                  <PostalAddress>
                     <DeliverTo>John Doe</DeliverTo>
                     <Street>123 Test St.</Street>
                     <City>Nashville</City>
                     <State>TN</State>
                     <PostalCode>37011</PostalCode>
                     <Country isoCountryCode=“US”>United States</Country>
                  </PostalAddress>
                  <Email>[email protected]</Email>
                  <Phone>888-555-9876</Phone>
               </Address>
            </ShipTo>
            <BillTo>
               <Address addressID=“TN.04" addressName=“Test Corp. - Nashville Branch”>
                  <Name xml:lang=“en”>John Doe</Name>
                  <PostalAddress>
                     <DeliverTo>John Doe</DeliverTo>
                     <Street>123 Test St.</Street>
                     <City>Nashville</City>
                     <State>TN</State>
                     <PostalCode>37011</PostalCode>
                     <Country isoCountryCode=“US”>United States</Country>
                  </PostalAddress>
                  <Email>[email protected]</Email>
                  <Phone>888-555-9876</Phone>
               </Address>
            </BillTo>
            <Contact>
               <Name>John Doe</Name>
               <Email>[email protected]</Email>
            </Contact>
         </OrderRequestHeader>
         <ItemOut quantity=“2" lineNumber=“101”>
            <ItemID>
               <SupplierPartID>45L017</SupplierPartID>
            </ItemID>
            <Description xml:lang=“en”>Low Arc Kitchen Faucet: Dominion Faucets, Silver, Chrome Finish, 1.75 gpm Flow Rate, CEC Compliant</Description>
            <UnitPrice>41.15</UnitPrice>
            <UnitOfMeasure>EA</UnitOfMeasure>
            <Classification domain=“UNSPSC”>56101720</Classification>
            <Comments>This product is subject to a per-item packing fee for quantities less than 50.</Comments>
            <Shipping title=“FedEx 2Day”>0</Shipping>
            <Discount title=“Volume discount; 5% discount on quantities of ten or more.“>0</Discount>
            <Tax title=“Sales tax - 7% Tennessee”>0</Tax>
            <Total>86.8</Total>
            <ConfirmationStatus quantity=“1" type=“accept” shipmentDate=“2022-01-01" uom=“EA”/>
         </ItemOut>
      </OrderRequest>
   </Request>
</cXML>

5. Invoice Request

<cXML>
  <Header>
    <Sender>
      <Credential domain="ABCD1234efgh5678.IJKL9012mnopq"/>
    </Sender>
  </Header>
  <Request deploymentMode="production">
    <OrderRequest>
      <OrderRequestHeader orderID="12345678">
        <InvoiceRequest purpose="standard">
          <InvoiceHeader>
            <InvoiceDetailRequest>
              <Comments>
                <Comment>NET30</Comment>
              </Comments>
              <Extrinsic name="ext_invoice_id">INV-789</Extrinsic>
              <Extrinsic name="invoice_date">2022-11-18</Extrinsic>
              <Extrinsic name="po_order_id">PO-123</Extrinsic>
              <Extrinsic name="po_payload_id">93369535150910.10.57.136</Extrinsic>
            </InvoiceDetailRequest>
            <ShipTo>
              <Address addressID="TN.04" addressName="Test Corp. - Nashville Branch">
                <DeliverTo>John Doe</DeliverTo>
                <Street>123 Test St.</Street>
                <City>Nashville</City>
                <State>TN</State>
                <PostalCode>37011</PostalCode>
                <Country isoCountryCode="US">United States</Country>
                <Email>[email protected]</Email>
                <Phone>888-555-9876</Phone>
              </Address>
            </ShipTo>
            <BillTo>
              <Address addressID="TN.04" addressName="Test Corp. - Nashville Branch">
                <DeliverTo>John Doe</DeliverTo>
                <Street>123 Test St.</Street>
                <City>Nashville</City>
                <State>TN</State>
                <PostalCode>37011</PostalCode>
                <Country isoCountryCode="US">United States</Country>
                <Email>[email protected]</Email>
                <Phone>888-555-9876</Phone>
              </Address>
            </BillTo>
          </InvoiceHeader>
          <InvoiceDetailItem lineNumber="101">
            <Extrinsic name="description">Low Arc Kitchen Faucet: Dominion Faucets, Silver, Chrome Finish, 1.75 gpm Flow Rate, CEC Compliant</Extrinsic>
            <Quantity>2</Quantity>
            <UnitPrice>41.15</UnitPrice>
            <UnitOfMeasure>EA</UnitOfMeasure>
            <LineTotal>86.8</LineTotal>
            <Comments>
              <Comment>This product is subject to a per-item packing fee for quantities less than 50.</Comment>
            </Comments>
            <Shipping>
              <Amount>0</Amount>
              <Title>FedEx 2Day</Title>
            </Shipping>
          </InvoiceDetailItem>
          <InvoiceDetailSummary>
            <Subtotal>86.8</Subtotal>
            <Shipping>
              <Amount>10.09</Amount>
              <Title>FedEx 2Day</Title>
            </Shipping>
            <Tax>
              <Amount>8.64</Amount>
              <Title>Sales tax - 7% Tennessee</Title>
            </Tax>
            <Handling>
              <Amount>9.99</Amount>
              <Title>Per-pallet fee</Title>
            </Handling>
            <Discount>
              <Amount>11.55</Amount>
              <Title>B2B discount; 10% discount for Test Corp.</Title>
            </Discount>
            <Total>103.97</Total>
            <Currency>USD</Currency>
          </InvoiceDetailSummary>
        </InvoiceRequest>
      </OrderRequestHeader>
    </OrderRequest>
  </Request>
</cXML>

6. Advanced Shipping Notice

<cXML>
  <Header>
    <Sender>
      <Credential domain="ABCD1234efgh5678.IJKL9012mnopq"/>
    </Sender>
  </Header>
  <Request deploymentMode="production">
    <ShipNoticeRequest>
      <ShipNoticeHeader noticeID="ASN-456">
        <Extrinsic name="notice_date">2022-11-18</Extrinsic>
        <Extrinsic name="po_payload_id">93369535150910.10.57.136</Extrinsic>
        <Extrinsic name="po_order_id">PO-123</Extrinsic>
        <Extrinsic name="po_order_date">2022-11-01</Extrinsic>
        <Extrinsic name="shipment_date">2022-11-18T08:30:00-04:00</Extrinsic>
        <Extrinsic name="delivery_date">2022-11-22T15:30:00-04:00</Extrinsic>
        <Extrinsic name="shipment_type">actual</Extrinsic>
        <Extrinsic name="requested_delivery_date">2022-12-25</Extrinsic>
        <Extrinsic name="carrier_code">UPSC</Extrinsic>
        <Extrinsic name="carrier_code_domain">SCAC</Extrinsic>
        <Extrinsic name="carrier_name">United Parcel Service Ground</Extrinsic>
        <Extrinsic name="shipment_identifier">1Z56F78A0450293517</Extrinsic>
        <ShipTo>
          <Address addressID="TN.04" addressName="Test Corp. - Nashville Branch">
            <DeliverTo>John Doe</DeliverTo>
            <Street>123 Test St.</Street>
            <City>Nashville</City>
            <State>TN</State>
            <PostalCode>37011</PostalCode>
            <Country isoCountryCode="US">United States</Country>
            <Email>[email protected]</Email>
            <Phone>888-555-9876</Phone>
          </Address>
        </ShipTo>
        <BillTo>
          <Address addressID="TN.04" addressName="Test Corp. - Nashville Branch">
            <DeliverTo>John Doe</DeliverTo>
            <Street>123 Test St.</Street>
            <City>Nashville</City>
            <State>TN</State>
            <PostalCode>37011</PostalCode>
            <Country isoCountryCode="US">United States</Country>
            <Email>[email protected]</Email>
            <Phone>888-555-9876</Phone>
          </Address>
        </BillTo>
        <Contact>
          <Email>[email protected]</Email>
          <Name>John Doe</Name>
        </Contact>
      </ShipNoticeHeader>
      <ShipNoticeItem lineNumber="101">
        <Extrinsic name="description">Low Arc Kitchen Faucet: Dominion Faucets, Silver, Chrome Finish, 1.75 gpm Flow Rate, CEC Compliant</Extrinsic>
        <Quantity>2</Quantity>
        <UnitPrice>41.15</UnitPrice>
        <UnitOfMeasure>EA</UnitOfMeasure>
        <Comments>
          <Comment>This product is subject to a per-item packing fee for quantities less than 50.</Comment>
        </Comments>
        <Shipping>
          <Amount>0</Amount>
          <Title>FedEx 2Day</Title>
        </Shipping>
      </ShipNoticeItem>
      <ShipNoticeSummary>
        <Total>103.97</Total>
        <Subtotal>85.33</Subtotal>
        <Currency>USD</Currency>
        <Shipping>
          <Amount>10.09</Amount>
          <Title>FedEx 2Day</Title>
        </Shipping>
        <Tax>
          <Amount>8.64</Amount>
          <Title>Sales tax - 7% Tennessee</Title>
        </Tax>
      </ShipNoticeSummary>
    </ShipNoticeRequest>
  </Request>
</cXML>

Next steps

In conclusion, cXML serves as a powerful tool for optimizing B2B transactions by enabling automated, standardized, and efficient communication between eCommerce applications. By incorporating cXML into their workflows, businesses can streamline procurement processes, enhance accuracy, and improve overall operational efficiency. With practical examples and a standardized format, cXML facilitates seamless integration and collaboration between trading partners, paving the way for smoother and more productive B2B transactions.

Whether you need a complete overhaul of your procurement system, a better way to integrate PunchOut catalogs, or a more efficient way to create purchase orders, TradeCentric can answer all of the questions you may have about the doctype cXML system and how to properly integrate with a PunchOut catalog to achieve the best results for your business continuity.

Featured content

The latest news, reports and resources for B2B connected commerce.

understanding headless commerce punchout

Nigel Taylor

•

•

Blog

Understanding Headless Commerce & PunchOut

Explore how businesses are leveraging headless commerce and PunchOut to enhance their B2B shopping experience.
Read more: Understanding Headless Commerce & PunchOut

TradeCentric

•

•

Reports

PunchOut: The Future of B2B Transactions

This white paper explores the power of PunchOut, including how it's set up, the challenges it solves, and the benefits for both suppliers and their customers.
Read more: PunchOut: The Future of B2B Transactions

TradeCentric

•

•

Blog

PunchOut Catalog: What It Is and How It Works

PunchOut is a connection between a buyer's eProcurement solution and a supplier's eCommerce shopping cart. PunchOut helps suppliers provide real-time catalog pricing and availability to their buyers.
Read more: PunchOut Catalog: What It Is and How It Works
View all posts

Stay up-to-date on the latest B2B trends

Get B2B connected commerce news and insights delivered monthly to your inbox.

© 2024 TradeCentric®. All Rights Reserved

ISO 27001-2013-Certified | Privacy Policy