Purchase Order for external marketplace

Automate the transmission of approved purchase orders from ERPx to external Marketplace (e.g. Amazon), enabling seamless procurement of products with direct order confirmations and real-time updates between platforms, while optimising procurement workflows for efficiency and compliance.

Key APIs used

• GET /v1/objects/purchase-orders - Retrieve approved and printed purchase orders.
• GET /v1/purchase-orders/{id} - Fetch individual purchase order details.
• PATCH /v1/purchase-orders/{id} - Update PO processing status after submission.
• GET /v1/companies/{id} - Retrieve company electronic number and qualifier.
• GET /v3/objects/purchase-orders - Retrieve PO line items and details.

Integration workflow

sequenceDiagram
    participant API as ERPx API
    participant EIT as Extension/Integration toolkit
    participant Amazon as Amazon Business

    EIT->>API: 1. GET /v1/objects/purchase-orders
    API-->>EIT: Approved & printed POs

    EIT->>API: 2. GET /v1/companies/{id}
    API-->>EIT: Electronic number & qualifier

    EIT->>API: 3. POST /v1/purchase-orders/{id}
    Note over EIT: Generate PayloadID (unique identifier)
    EIT->>Amazon: Send PO in CXML format
    Amazon-->>EIT: PO received confirmation
    EIT-->>API: Submission successful

    Amazon->>EIT: 4. Order confirmation (CXML webhook)
    EIT->>API: Update PO status to "Confirmed"

    Note over API,Amazon: If submission fails: Daily retry after working hours

Quick links

For detailed API specifications, request/response formats, and authentication details, refer to:

• Purchase orders and Companies - Complete API reference with request schemas.
• Events - Documentation on events that initiate processes during record creation in the ERPx.
• Authentication & Security - Setup and security configuration.
• Limits and quotas - All available settings and options.
• Error Handling - Troubleshooting common issues and error codes.