Table of Contents
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&responseid=9&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.