Order Received Request Integration (Receipts)

  • Updated

The order-received-request is an outbound integration point used to communicate receiving data from Unimarket to an external system, such as a customer's ERP or Finance solution. When a user records the receipt of goods or services against a Purchase Order line, in Unimarket. This message automatically triggers an update, to ensure the external system has an accurate record of the received quantity.

 

Role in the Procurement Lifecycle

This integration is one of the three "core" transactional touchpoints between Unimarket and an ERP system. Forming the basis for Three-Way Matching:

  1. Purchase Order (OrderRequest): Sent when the order is created.

  2. Receipt (order-received-request): Sent when goods/services are delivered.

  3. Invoice (invoice-detail-request): Sent when the supplier bills for the items.

 

How it Works

When a receiving action occurs in Unimarket, the system generates a message. Containing the specific line-level details of what was received.

  • Trigger: A user clicks "Receive" on an order in Unimarket and enters the quantity or dollar amount.

  • Data Transmitted:

    • Order Reference: The original Purchase Order number.

    • Line Details: Which specific items were received.

    • Quantity: The number of units or value received in that specific transaction.

    • User Info: Who performed the receiving action.

  • ERP Action: The ERP uses this data to update its internal records. Often moving the status of the PO to "Partially Received" or "Fully Received" and creating a "Goods Receipt" entry.

 

Technical Specifications

  • Standard: The message typically follows the cXML standard for status updates.

  • Direction: Outbound (Unimarket to ERP).

  • Frequency: Real-time; a message is sent immediately upon the user saving the receiving record in Unimarket.

 

Business Benefits

  • Accrual Accuracy: Ensures the Finance system has a real-time view of liabilities for items received but not yet invoiced.

  • Eliminates Double Entry: Users only need to perform the receiving action in Unimarket, and the data flows automatically to the ERP.

  • Matching Integrity: Facilitates automated three-way matching, allowing invoices to be paid faster if they match the order and the receipt.