Inbound

POST Create a Purchase Order

User the POST method to send a new purchase order.

If the PO is successfully created, you'll receive a 201 Created response.

Request

POST /v2/inbound/{order_number}

Requirements Example #1
  • Each request contains only one purchase order.
  • The order_number in the URL must match the order_number field in the body of the request.
  • The request body is the purchase order resource.
Required fields
Field name Data type Description
order_number string The order number associated with this purchase order; must match the order_number in the URL
business_unit string Your company code in our system.
expected_date date The expected arrival date at our warehouse.

The date should be in the format of YYYY-MM-DD
line_items array The items in which to ship.

The following fields must be included in each item entry:

  • line_number
  • item
  • qty

Response JSON 

    HTTP/1.1 202 Created
    {
        "purchase_order": {
            "order_number": "PO1234",
            "business_unit": "C1234",
            "status": "New",
            "expected_date": "2024-07-21",
            "line_items": [{
                "line_number": "9876543210",
                "item": "ITM123",
                "qty": 100
            }]
        }
    }

GET Retrieve a Purchase Order

Request

GET /v2/inbound?order_number={order_number}

Parameters
order_number string
The order number used when creating the purchase order.
Response

Response JSON 

HTTP/1.1 200 OK
{
    "purchase_order": {
        "order_number": "PO1234",
        "business_unit": "C1234",
        "status": "Receiving",
        "expected_date": "2024-07-21",
        "line_items": [{
            "line_number": "9876543210",
            "item": "ITM123",
            "qty": 100,
            "received_qty": 100
        }]
    }
}
©2024 Verde Fulfillment USA