Webservice Integration Technical Documentation & Examples

  • Updated

Unimarket utilizes two primary messaging standards for integration: uXML (Unimarket XML) for proprietary platform functions and cXML (Commerce XML) for industry-standard procurement transactions.

 

uXML Integration Points

uXML is used for specialized platform functions that fall outside the standard cXML scope. These are typically used to synchronize master data or handle real-time validation between Unimarket and your ERP.

Key uXML Message Types:

  • Account Code Validation: Real-time synchronous check for budget and GL validity at checkout.

  • Approval Configuration: Inbound sync of approval chains, levels, and groups.

  • User Details: Synchronization of user roles and organization units from a master identity source.

  • General Ledger (GL) Transactions: Sending accounting strings for commitments (orders) and accruals (receipts).

 

cXML Integration Points

Unimarket adheres to the global cXML standard (v1.2.021+) for high-volume transactional data. This ensures compatibility with thousands of suppliers and major ERP systems like Workday, Oracle, and SAP.

Common cXML Integrations:

  • Punchout (Roundtrip): Allows users to "punch out" from their ERP into Unimarket or from Unimarket into a supplier's website.

  • OrderRequest: The standard message used to transmit Purchase Order details to suppliers or external finance systems.

  • InvoiceDetailRequest: Inbound electronic invoices (eInvoicing) sent from suppliers to Unimarket for matching and payment.

  • ShipNoticeRequest: Outbound notification from suppliers regarding shipment status.

 

Integration Documentation Resources

For technical teams and developers, the following resources are essential for mapping and testing:

Resource Type Description
Webservice Documentation Comprehensive guides for configuring endpoints and security. The complete documentation and examples: Download Zip File
XML Schema (XSD) Formal definitions for validating uXML messages.

 

Which Standard Should You Use?

  • Use cXML if you are setting up standard Order or Invoice automation with a major supplier or ERP.

  • Use uXML for Platform Administration, such as synchronizing your budget data, approval hierarchies, or user role assignments.