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.

Response Formats

application/json, text/json

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