Accept supplier delivery

Order API v1
POST*base*/supplier-deliveries/*supplierDeliveryId*
POST*base*/supplier-deliveries/*supplierDeliveryId*/sku
Authentication:API key

Will accept the delivery with the proper quantities in the physical delivery. This will be inserted into the preferred warehouse.

Note

This can only be done once per supplier delivery.

It is possible to over deliver or under deliver when accepting the delivery. This will be visible inside Centra when delivery was accepted.

In case of under delivery a new delivery containing the undelivered products will be created.

Parameters

products

object
required

Key is from the Get supplier delivery and value is the quantity.

key in object

string
required

Use ean from the Get supplier delivery referring to a specific product item in the supplier order delivery.

If the endpoint used is /sku, the combination of sku, variantSku and sizeSku should be used instead.

Example: {"products":{"1441":2}} will create a shipment of 2 products from item 1441.

value in object

int
required
Quantity of the item that should be accepted.

insertStock

boolean
optional

Default true. Flag that defines whether to insert items to warehouse stock.

  • "insertStock": true insert items to warehouse stock
  • "insertStock": false do not insert items to warehouse stock

xml

boolean
optional
Response in xml format instead of json.

Request example

Both id and deliveryId from List supplier deliveries can be used to accept a supplier delivery.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
POST <base>/supplier-delivery/364 HTTP/1.1
Content-type: application/json

{
  "products": {
    "73213213123": 32,
    "73213213124": 12,
  },
  "insertStock": false
}

Accept using SKU instead of EAN

Append /sku to the URL and switch from EAN to SKU for the product keys.

1
2
3
4
5
6
7
8
9
POST <base>/supplier-delivery/364/sku HTTP/1.1
Content-type: application/json

{
  "products": {
    "PRODSKUVARIANTSKUSIZESKU": 32,
    "PRODSKUVARIANTSKUSIZESKU2": 12,
  }
}

Response

200 Content-type: application/json

status

string
required
ok if success, else no.

additionalDelivery

object
optional

If not all products from the supplier order delivery was accepted, this is the new created delivery for the remaining products of the supplier order delivery.

id

string
Internal ID for the created supplier order delivery.

deliveryId

string
ID of the supplier order delivery. This is the ID communicated externally.

orderId

string
ID of the supplier order.

supplierCountry

string
ISO-Alpha-2 (SE, US, GB etc).

created

datetime
The date this supplier order delivery was created.

ETA

datetime
Estimated time of arrival to the warehouse. This will be used to calculate what orders that should be automatically connected to this specific delivery.

ETD

datetime
Estimated time of delivery for the customer.

productsQty

int
The total quantity of products remaining in the accepted supplier order delivery.

Response example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
{
  "status":"ok",
  "additionalDelivery": {
    "id": "365",
    "orderId": "957",
    "deliveryId": "957-2",
    "supplierName": "Falca",
    "supplierCountry": "ES",
    "created": "2019-01-28 01:15",
    "ETD": "2019-03-31 15:15",
    "ETA": "2019-04-05 20:15",
    "message": "Text entered by centra admin",
    "productsQty": 19891
  }
}