POST api/v1/po_notifications

Submit a purchase order notification.

Request Information

URI Parameters

None.

Body Parameters

po_notification
NameDescriptionTypeAdditional information
account_number

Value assigned to you by DCL.

 string

Required

Max length: 10
location

Warehouse location where the delivery is expected.

 string

Required

Max length: 3
reference_transaction_number

Only letters, digits, '#' or '-' sign are allowed. This must be unique for each transaction.

 string

Required

Max length: 25
reference_order_number

Only letters, digits, '#' or '-' sign are allowed.

 string

Required

Max length: 25
order_date

Date in ISO-8601 format. Only date part (no time) is required ('YYYY-MM-DD').

 date

Required
expected_delivery_date

Date in ISO-8601 format. Only date part (no time) is required ('YYYY-MM-DD').

 date

Required
lines

List of lines included in the purchase order.

 Collection of line

Required

Request Formats

application/json, text/json

Sample: 
{
  "account_number": "10501",
  "location": "FR",
  "reference_transaction_number": "TRAZ4MSA72",
  "reference_order_number": "ABC123",
  "order_date": "2015-11-25",
  "expected_delivery_date": "2015-11-25",
  "lines": [
    {
      "line_number": 1,
      "item_number": "1001-001-DEMO",
      "quantity": 10000
    },
    {
      "line_number": 2,
      "item_number": "1002-002-DEMO2",
      "quantity": 4000,
      "expected_delivery_date": "2015-11-23"
    }
  ]
}

Response Information

Resource Description

response_post_po_notifications
NameDescriptionTypeAdditional information
error_code

Zero if no errors. When different from zero, the order is rejected. See 'error_message' for a detailed description of the error.

 integer

None.
error_message

Returns a detailed description of the error.

 string

None.
dcl_po_number

DCL PO number

 integer

None.

Response Formats

application/json, text/json

Sample: 
{
  "error_code": 0,
  "error_message": "",
  "dcl_po_number": 182759
}