Receivings

You may find descriptions of endpoints for work with receivings bellow.

Filter receivings

post

Authorizations

authorization & XApiKey

authorizationstringRequired

x-api-keystringRequired

Header parameters

x-api-keystringRequired

This is the eshop key you receive during onboarding.

authorizationstringRequired

Token you get from calling /users/login

Body

application/json

pageinteger · min: 1Optional

Page number, can be used for pagination

Default: 1Example: 1

itemsinteger · min: 1 · max: 1000Optional

items per page

Default: 10Example: 30

Responses

200

Success response

application/json

statusCodenumberRequiredDefault: 200

messagestringRequired

401

Unauthorized response

application/json

post

/receivings/filter

HTTPcURLJavaScriptPython

POST /v2/receivings/filter HTTP/1.1
Host: gw.new.skladon.net
authorization: text
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 199

{
  "page": 1,
  "items": 30,
  "columns": [
    "estimatedDelivery",
    "duty",
    "eshopReceivingId"
  ],
  "sorts": [
    {
      "column": "eshopReceivingId",
      "direction": "DESC"
    }
  ],
  "filters": [
    [
      {
        "column": "duty",
        "operator": "eq",
        "value": true
      }
    ]
  ]
}

{
  "statusCode": 200,
  "message": "text",
  "data": {
    "data": [
      {
        "eshopReceivingId": "text",
        "description": "text",
        "trackingNumber": "text",
        "supplier": "text",
        "estimatedDelivery": "2026-02-20",
        "deliveryNoteNumber": "text",
        "deliveryType": "courier",
        "urgent": "ok",
        "duty": true,
        "unitsAmount": 1,
        "driverCompany": "text",
        "driverTrailerLicensePlate": "text",
        "driverName": "text",
        "driverPhone": "text",
        "driverDispatcherContact": "text",
        "eshopNote": "text",
        "priority": 0,
        "containerNumber": "text",
        "announcedPalletsCount": 1,
        "receivingType": "piece_mix",
        "incoterms": "FOB",
        "realDelivery": "2026-02-20T05:45:48.592Z",
        "slaSuspended": "text",
        "photoDocumentationTaken": "text",
        "deliveredPalletsCount": 1,
        "deliveredCartonsCount": 1,
        "returnedEurPalletsCount": 1,
        "deliveredStandardPalletsCount": 1,
        "returnedStandardPalletsCount": 1,
        "deliveredOtherPalletsCount": 1,
        "deliveredBrokenPalletsCount": 1,
        "skladonNote": "text",
        "unloadedAt": "2026-02-20T05:45:48.592Z",
        "confirmedAt": "2026-02-20T05:45:48.592Z",
        "canceledAt": "2026-02-20T05:45:48.592Z",
        "status": "awaiting"
      }
    ],
    "request": {
      "page": 1,
      "items": 30,
      "columns": [
        "estimatedDelivery",
        "duty",
        "eshopReceivingId"
      ],
      "sorts": [
        {
          "column": "eshopReceivingId",
          "direction": "DESC"
        }
      ],
      "filters": [
        [
          {
            "column": "duty",
            "operator": "eq",
            "value": true
          }
        ]
      ]
    },
    "totalCount": 430
  }
}

Get receiving

get

Authorizations

authorization & XApiKey

authorizationstringRequired

x-api-keystringRequired

Path parameters

eshopReceivingIdstringRequired

Header parameters

x-api-keystringRequired

This is the eshop key you receive during onboarding.

authorizationstringRequired

Token you get from calling /users/login

Responses

200

Success response

application/json

statusCodenumberRequiredDefault: 200

messagestringRequired

401

Unauthorized response

application/json

404

Not found response

application/json

get

/receivings/{eshopReceivingId}

HTTPcURLJavaScriptPython

GET /v2/receivings/{eshopReceivingId} HTTP/1.1
Host: gw.new.skladon.net
authorization: text
x-api-key: text
Accept: */*

{
  "statusCode": 200,
  "message": "text",
  "data": {
    "eshopReceivingId": "text",
    "description": "text",
    "trackingNumber": "text",
    "supplier": "text",
    "estimatedDelivery": "2026-02-20",
    "deliveryNoteNumber": "text",
    "deliveryType": "courier",
    "duty": true,
    "unitsAmount": 1,
    "driverCompany": "text",
    "asnLabelEmail": "text",
    "driverTrailerLicensePlate": "text",
    "driverName": "text",
    "driverPhone": "text",
    "driverDispatcherContact": "text",
    "eshopNote": "text",
    "priority": 0,
    "containerNumber": "text",
    "announcedPalletsCount": 1,
    "receivingType": "piece_mix",
    "incoterms": "FOB",
    "urgent": "ok",
    "slaDate": "2026-02-20T05:45:48.592Z",
    "realDelivery": "2026-02-20T05:45:48.592Z",
    "slaSuspended": "text",
    "photoDocumentationTaken": "text",
    "deliveredPalletsCount": 1,
    "deliveredCartonsCount": 1,
    "returnedEurPalletsCount": 1,
    "deliveredStandardPalletsCount": 1,
    "returnedStandardPalletsCount": 1,
    "deliveredOtherPalletsCount": 1,
    "deliveredBrokenPalletsCount": 1,
    "skladonNote": "text",
    "unloadedAt": "2026-02-20T05:45:48.592Z",
    "confirmedAt": "2026-02-20T05:45:48.592Z",
    "asn": "text",
    "status": "awaiting",
    "products": [
      {
        "sku": "text",
        "quantity": 1,
        "received": 1,
        "lot": "text",
        "expirationDate": "2026-02-20",
        "productPrice": 1,
        "serialNumber": "123456789",
        "lineState": "E"
      }
    ],
    "packagings": [
      {
        "packagingType": "non_returnable_pallet",
        "pallet": "pallet_100x120_ippc",
        "quantity": 1
      }
    ]
  }
}

Create receiving

post

Authorizations

authorization & XApiKey

authorizationstringRequired

x-api-keystringRequired

Header parameters

x-api-keystringRequired

This is the eshop key you receive during onboarding.

authorizationstringRequired

Token you get from calling /users/login

Body

application/json

Responses

200

Success response

application/json

statusCodenumberRequiredDefault: 200

messagestringRequired

401

Unauthorized response

application/json

409

Conflict response

application/json

post

/receivings

HTTPcURLJavaScriptPython

POST /v2/receivings HTTP/1.1
Host: gw.new.skladon.net
authorization: text
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 706

{
  "eshopReceivingId": "text",
  "description": "text",
  "trackingNumber": "text",
  "supplier": "text",
  "estimatedDelivery": "2026-02-20",
  "deliveryNoteNumber": "text",
  "deliveryType": "courier",
  "duty": true,
  "unitsAmount": 1,
  "driverCompany": "text",
  "asnLabelEmail": "text",
  "driverTrailerLicensePlate": "text",
  "driverName": "text",
  "driverPhone": "text",
  "driverDispatcherContact": "text",
  "eshopNote": "text",
  "priority": 0,
  "containerNumber": "text",
  "announcedPalletsCount": 1,
  "receivingType": "piece_mix",
  "incoterms": "FOB",
  "products": [
    {
      "sku": "text",
      "quantity": 1,
      "lot": "text",
      "expirationDate": "2026-02-20",
      "productPrice": 1,
      "lineState": "E"
    }
  ],
  "packagings": [
    {
      "packagingType": "non_returnable_pallet",
      "pallet": "pallet_100x120_ippc",
      "quantity": 1
    }
  ]
}

{
  "statusCode": 200,
  "message": "text",
  "data": {
    "eshopReceivingId": "text",
    "description": "text",
    "trackingNumber": "text",
    "supplier": "text",
    "estimatedDelivery": "2026-02-20",
    "deliveryNoteNumber": "text",
    "deliveryType": "courier",
    "duty": true,
    "unitsAmount": 1,
    "driverCompany": "text",
    "asnLabelEmail": "text",
    "driverTrailerLicensePlate": "text",
    "driverName": "text",
    "driverPhone": "text",
    "driverDispatcherContact": "text",
    "eshopNote": "text",
    "priority": 0,
    "containerNumber": "text",
    "announcedPalletsCount": 1,
    "receivingType": "piece_mix",
    "incoterms": "FOB",
    "urgent": "ok",
    "slaDate": "2026-02-20T05:45:48.592Z",
    "realDelivery": "2026-02-20T05:45:48.592Z",
    "slaSuspended": "text",
    "photoDocumentationTaken": "text",
    "deliveredPalletsCount": 1,
    "deliveredCartonsCount": 1,
    "returnedEurPalletsCount": 1,
    "deliveredStandardPalletsCount": 1,
    "returnedStandardPalletsCount": 1,
    "deliveredOtherPalletsCount": 1,
    "deliveredBrokenPalletsCount": 1,
    "skladonNote": "text",
    "unloadedAt": "2026-02-20T05:45:48.592Z",
    "confirmedAt": "2026-02-20T05:45:48.592Z",
    "asn": "text",
    "status": "awaiting",
    "products": [
      {
        "sku": "text",
        "quantity": 1,
        "received": 1,
        "lot": "text",
        "expirationDate": "2026-02-20",
        "productPrice": 1,
        "serialNumber": "123456789",
        "lineState": "E"
      }
    ],
    "packagings": [
      {
        "packagingType": "non_returnable_pallet",
        "pallet": "pallet_100x120_ippc",
        "quantity": 1
      }
    ]
  }
}

Update receiving

put

Authorizations

authorization & XApiKey

authorizationstringRequired

x-api-keystringRequired

Path parameters

eshopReceivingIdstringRequired

Header parameters

x-api-keystringRequired

This is the eshop key you receive during onboarding.

authorizationstringRequired

Token you get from calling /users/login

Body

application/json

Responses

200

Success response

application/json

statusCodenumberRequiredDefault: 200

messagestringRequired

401

Unauthorized response

application/json

404

Not found response

application/json

put

/receivings/{eshopReceivingId}

HTTPcURLJavaScriptPython

PUT /v2/receivings/{eshopReceivingId} HTTP/1.1
Host: gw.new.skladon.net
authorization: text
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 726

{
  "eshopReceivingId": "text",
  "description": "text",
  "trackingNumber": "text",
  "supplier": "text",
  "estimatedDelivery": "2026-02-20",
  "deliveryNoteNumber": "text",
  "deliveryType": "courier",
  "duty": true,
  "unitsAmount": 1,
  "driverCompany": "text",
  "asnLabelEmail": "text",
  "driverTrailerLicensePlate": "text",
  "driverName": "text",
  "driverPhone": "text",
  "driverDispatcherContact": "text",
  "eshopNote": "text",
  "priority": 0,
  "containerNumber": "text",
  "announcedPalletsCount": 1,
  "receivingType": "piece_mix",
  "incoterms": "FOB",
  "products": [
    {
      "sku": "text",
      "quantity": 1,
      "lot": "text",
      "expirationDate": "2026-02-20",
      "productPrice": 1,
      "lineState": "E"
    }
  ],
  "packagings": [
    {
      "packagingType": "non_returnable_pallet",
      "pallet": "pallet_100x120_ippc",
      "quantity": 1
    }
  ],
  "status": "canceled"
}

{
  "statusCode": 200,
  "message": "text",
  "data": {
    "eshopReceivingId": "text",
    "description": "text",
    "trackingNumber": "text",
    "supplier": "text",
    "estimatedDelivery": "2026-02-20",
    "deliveryNoteNumber": "text",
    "deliveryType": "courier",
    "duty": true,
    "unitsAmount": 1,
    "driverCompany": "text",
    "asnLabelEmail": "text",
    "driverTrailerLicensePlate": "text",
    "driverName": "text",
    "driverPhone": "text",
    "driverDispatcherContact": "text",
    "eshopNote": "text",
    "priority": 0,
    "containerNumber": "text",
    "announcedPalletsCount": 1,
    "receivingType": "piece_mix",
    "incoterms": "FOB",
    "urgent": "ok",
    "slaDate": "2026-02-20T05:45:48.592Z",
    "realDelivery": "2026-02-20T05:45:48.592Z",
    "slaSuspended": "text",
    "photoDocumentationTaken": "text",
    "deliveredPalletsCount": 1,
    "deliveredCartonsCount": 1,
    "returnedEurPalletsCount": 1,
    "deliveredStandardPalletsCount": 1,
    "returnedStandardPalletsCount": 1,
    "deliveredOtherPalletsCount": 1,
    "deliveredBrokenPalletsCount": 1,
    "skladonNote": "text",
    "unloadedAt": "2026-02-20T05:45:48.592Z",
    "confirmedAt": "2026-02-20T05:45:48.592Z",
    "asn": "text",
    "status": "awaiting",
    "products": [
      {
        "sku": "text",
        "quantity": 1,
        "received": 1,
        "lot": "text",
        "expirationDate": "2026-02-20",
        "productPrice": 1,
        "serialNumber": "123456789",
        "lineState": "E"
      }
    ],
    "packagings": [
      {
        "packagingType": "non_returnable_pallet",
        "pallet": "pallet_100x120_ippc",
        "quantity": 1
      }
    ]
  }
}

Partially update receiving

patch

Authorizations

authorization & XApiKey

authorizationstringRequired

x-api-keystringRequired

Path parameters

eshopReceivingIdstringRequired

Header parameters

x-api-keystringRequired

This is the eshop key you receive during onboarding.

authorizationstringRequired

Token you get from calling /users/login

Body

application/json

Responses

200

Success response

application/json

statusCodenumberRequiredDefault: 200

messagestringRequired

401

Unauthorized response

application/json

404

Not found response

application/json

patch

/receivings/{eshopReceivingId}

HTTPcURLJavaScriptPython

PATCH /v2/receivings/{eshopReceivingId} HTTP/1.1
Host: gw.new.skladon.net
authorization: text
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 726

{
  "eshopReceivingId": "text",
  "description": "text",
  "trackingNumber": "text",
  "supplier": "text",
  "estimatedDelivery": "2026-02-20",
  "deliveryNoteNumber": "text",
  "deliveryType": "courier",
  "duty": true,
  "unitsAmount": 1,
  "driverCompany": "text",
  "asnLabelEmail": "text",
  "driverTrailerLicensePlate": "text",
  "driverName": "text",
  "driverPhone": "text",
  "driverDispatcherContact": "text",
  "eshopNote": "text",
  "priority": 0,
  "containerNumber": "text",
  "announcedPalletsCount": 1,
  "receivingType": "piece_mix",
  "incoterms": "FOB",
  "products": [
    {
      "sku": "text",
      "quantity": 1,
      "lot": "text",
      "expirationDate": "2026-02-20",
      "productPrice": 1,
      "lineState": "E"
    }
  ],
  "packagings": [
    {
      "packagingType": "non_returnable_pallet",
      "pallet": "pallet_100x120_ippc",
      "quantity": 1
    }
  ],
  "status": "canceled"
}

{
  "statusCode": 200,
  "message": "text",
  "data": {
    "eshopReceivingId": "text",
    "description": "text",
    "trackingNumber": "text",
    "supplier": "text",
    "estimatedDelivery": "2026-02-20",
    "deliveryNoteNumber": "text",
    "deliveryType": "courier",
    "duty": true,
    "unitsAmount": 1,
    "driverCompany": "text",
    "asnLabelEmail": "text",
    "driverTrailerLicensePlate": "text",
    "driverName": "text",
    "driverPhone": "text",
    "driverDispatcherContact": "text",
    "eshopNote": "text",
    "priority": 0,
    "containerNumber": "text",
    "announcedPalletsCount": 1,
    "receivingType": "piece_mix",
    "incoterms": "FOB",
    "urgent": "ok",
    "slaDate": "2026-02-20T05:45:48.592Z",
    "realDelivery": "2026-02-20T05:45:48.592Z",
    "slaSuspended": "text",
    "photoDocumentationTaken": "text",
    "deliveredPalletsCount": 1,
    "deliveredCartonsCount": 1,
    "returnedEurPalletsCount": 1,
    "deliveredStandardPalletsCount": 1,
    "returnedStandardPalletsCount": 1,
    "deliveredOtherPalletsCount": 1,
    "deliveredBrokenPalletsCount": 1,
    "skladonNote": "text",
    "unloadedAt": "2026-02-20T05:45:48.592Z",
    "confirmedAt": "2026-02-20T05:45:48.592Z",
    "asn": "text",
    "status": "awaiting",
    "products": [
      {
        "sku": "text",
        "quantity": 1,
        "received": 1,
        "lot": "text",
        "expirationDate": "2026-02-20",
        "productPrice": 1,
        "serialNumber": "123456789",
        "lineState": "E"
      }
    ],
    "packagings": [
      {
        "packagingType": "non_returnable_pallet",
        "pallet": "pallet_100x120_ippc",
        "quantity": 1
      }
    ]
  }
}