List Deliveries

GET/api/v2/public/orders/deliveries

Announced inbound deliveries and their current status. Use it to track whether a delivery has been received and submitted.

Query ParametersExpand Collapse

delivery_date: optional string

Filter by delivery date.

group_code: optional string

Filter by group code.

is_submitted: optional boolean

Filter by submission status.

last_modified_date: optional string

Filter by last modified date.

order_number: optional string

Filter by order number.

page_size: optional string

page_start: optional string

secondary_order_number: optional string

Filter by secondary order number.

status: optional string

Filter by order status.

store_number: optional string

Filter by store number.

supplier_code: optional string

Filter by supplier code.

supplier_name: optional string

Filter by supplier name.

ReturnsExpand Collapse

page_size: number

Maximum number of items returned per page.

formatint32

page_start: number

Current page number (1-based).

formatint32

total_count: number

Total number of records matching the query across all pages.

formatint64

list: optional array of object { datetime_created, datetime_expected, import_id, 17 more }

Collection of items for the current page.

datetime_created: string

When the order was created.

formatdate-time

datetime_expected: string

When the goods are expected to arrive.

formatdate-time

import_id: number

Identifier of the import the order arrived in.

formatint64

is_downloaded: boolean

true when the store has pulled the order down.

type: number

Type code for the order.

formatint32

updated_on: string

When the order was last changed.

formatdate-time

external_reference_number: optional string

Reference from the system the order came from.

no_of_containers: optional number

How many containers the goods arrive in.

formatint32

order_lines: optional array of object { line_number, quantity, received_quantity, 17 more }

The lines on this order.

line_number: number

Position of the line within the order.

formatint32

quantity: number

Quantity ordered.

formatdouble

received_quantity: number

Quantity actually received so far.

formatdouble

target_stock_pool: number

Stock pool the goods should be booked into.

formatint32

barcode: optional string

Barcode for the product.

base_unit: optional string

Unit the quantity is expressed in.

category_code: optional string

Category the product belongs to.

container_barcode: optional string

Barcode of the container the line arrives in.

customer_order_number: optional string

Customer order this line is reserved for.

customer_order_shipment_number: optional string

Shipment this line belongs to.

customer_order_shipment_number_line_number: optional number

Position of the line within that shipment.

formatint32

description: optional string

Product name on the line.

group_code: optional string

Group the product is ordered in.

product_number: optional string

Product on the line.

purchase_unit_barcode: optional string

Barcode of the purchase unit.

purchase_unit_product_number: optional string

Product number of the purchase unit.

purchase_unit_quantity: optional number

How many base units are in one purchase unit.

formatdouble

reference: optional string

Your own reference for the order.

rounded_quantity: optional number

Quantity after rounding to a whole purchase unit.

formatdouble

secondary_order_number: optional string

Alternate order number, when the source system uses one.

order_number: optional string

Order number in the source system.

order_type: optional string

Type of order, such as a delivery or a transfer.

recommended_location: optional object { location_code, location_tags_json, stock_pool }

location_code: optional string

location_tags_json: optional string

stock_pool: optional number

formatint32

reference: optional string

Your own reference for the order.

status: optional string

Current status of the order.

store_gln: optional string

Global Location Number of the destination store.

store_number: optional string

Store the order is for.

store_origin: optional string

Store the goods come from, for a transfer.

supplier_code: optional string

Supplier the order is placed with. Matches supplier_code on the suppliers endpoint.

supplier_name: optional string

Supplier name.

tracing_url: optional string

Link to track the shipment.

list_body: optional map[unknown]

Additional body-level metadata for the list.

list_filters: optional map[array of string]

Active filter criteria applied to the result set, keyed by field name.

next_page: optional number

Next page number, or null when on the last page.

formatint32

previous_page: optional number

Previous page number, or null when on the first page.

formatint64

project_last_modified_date: optional string

Last modified date/time of the project.

scroll_id: optional string

Opaque scroll identifier for deep-pagination scenarios.

server_time: optional string

Server UTC date/time when the response was generated.

sort_column: optional string

Column name the results are sorted by.

sort_order: optional string

Sort direction (asc or desc).

task_last_modified_date: optional string

Last modified date/time of the task.

List Deliveries

curl https://api.colleqtive.net/api/v2/public/orders/deliveries \
    -H "Authorization: $COLLEQTIVE_BEARER_TOKEN"

{
  "page_size": 0,
  "page_start": 0,
  "total_count": 0,
  "list": [
    {
      "datetime_created": "2019-12-27T18:11:19.117Z",
      "datetime_expected": "2019-12-27T18:11:19.117Z",
      "import_id": 0,
      "is_downloaded": true,
      "type": 0,
      "updated_on": "2019-12-27T18:11:19.117Z",
      "external_reference_number": "external_reference_number",
      "no_of_containers": 0,
      "order_lines": [
        {
          "line_number": 0,
          "quantity": 0,
          "received_quantity": 0,
          "target_stock_pool": 0,
          "barcode": "barcode",
          "base_unit": "base_unit",
          "category_code": "category_code",
          "container_barcode": "container_barcode",
          "customer_order_number": "customer_order_number",
          "customer_order_shipment_number": "customer_order_shipment_number",
          "customer_order_shipment_number_line_number": 0,
          "description": "description",
          "group_code": "group_code",
          "product_number": "product_number",
          "purchase_unit_barcode": "purchase_unit_barcode",
          "purchase_unit_product_number": "purchase_unit_product_number",
          "purchase_unit_quantity": 0,
          "reference": "reference",
          "rounded_quantity": 0,
          "secondary_order_number": "secondary_order_number"
        }
      ],
      "order_number": "order_number",
      "order_type": "order_type",
      "recommended_location": {
        "location_code": "location_code",
        "location_tags_json": "location_tags_json",
        "stock_pool": 0
      },
      "reference": "reference",
      "status": "status",
      "store_gln": "store_gln",
      "store_number": "store_number",
      "store_origin": "store_origin",
      "supplier_code": "supplier_code",
      "supplier_name": "supplier_name",
      "tracing_url": "tracing_url"
    }
  ],
  "list_body": {
    "foo": "bar"
  },
  "list_filters": {
    "foo": [
      "string"
    ]
  },
  "next_page": 0,
  "previous_page": 0,
  "project_last_modified_date": "project_last_modified_date",
  "scroll_id": "scroll_id",
  "server_time": "server_time",
  "sort_column": "sort_column",
  "sort_order": "sort_order",
  "task_last_modified_date": "task_last_modified_date"
}

{
  "code": 401,
  "status": "error",
  "message": "Authentication failed.",
  "error": "unauthorized",
  "error_description": "Authentication failed."
}

{
  "code": 500,
  "status": "fail",
  "message": "The request could not be processed.",
  "error": "internal_error",
  "error_description": "The request could not be processed."
}

Returns Examples

{
  "page_size": 0,
  "page_start": 0,
  "total_count": 0,
  "list": [
    {
      "datetime_created": "2019-12-27T18:11:19.117Z",
      "datetime_expected": "2019-12-27T18:11:19.117Z",
      "import_id": 0,
      "is_downloaded": true,
      "type": 0,
      "updated_on": "2019-12-27T18:11:19.117Z",
      "external_reference_number": "external_reference_number",
      "no_of_containers": 0,
      "order_lines": [
        {
          "line_number": 0,
          "quantity": 0,
          "received_quantity": 0,
          "target_stock_pool": 0,
          "barcode": "barcode",
          "base_unit": "base_unit",
          "category_code": "category_code",
          "container_barcode": "container_barcode",
          "customer_order_number": "customer_order_number",
          "customer_order_shipment_number": "customer_order_shipment_number",
          "customer_order_shipment_number_line_number": 0,
          "description": "description",
          "group_code": "group_code",
          "product_number": "product_number",
          "purchase_unit_barcode": "purchase_unit_barcode",
          "purchase_unit_product_number": "purchase_unit_product_number",
          "purchase_unit_quantity": 0,
          "reference": "reference",
          "rounded_quantity": 0,
          "secondary_order_number": "secondary_order_number"
        }
      ],
      "order_number": "order_number",
      "order_type": "order_type",
      "recommended_location": {
        "location_code": "location_code",
        "location_tags_json": "location_tags_json",
        "stock_pool": 0
      },
      "reference": "reference",
      "status": "status",
      "store_gln": "store_gln",
      "store_number": "store_number",
      "store_origin": "store_origin",
      "supplier_code": "supplier_code",
      "supplier_name": "supplier_name",
      "tracing_url": "tracing_url"
    }
  ],
  "list_body": {
    "foo": "bar"
  },
  "list_filters": {
    "foo": [
      "string"
    ]
  },
  "next_page": 0,
  "previous_page": 0,
  "project_last_modified_date": "project_last_modified_date",
  "scroll_id": "scroll_id",
  "server_time": "server_time",
  "sort_column": "sort_column",
  "sort_order": "sort_order",
  "task_last_modified_date": "task_last_modified_date"
}

{
  "code": 401,
  "status": "error",
  "message": "Authentication failed.",
  "error": "unauthorized",
  "error_description": "Authentication failed."
}

{
  "code": 500,
  "status": "fail",
  "message": "The request could not be processed.",
  "error": "internal_error",
  "error_description": "The request could not be processed."
}