Receivings

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

Filter receivings

post

Authorizations

Header parameters

x-api-keystringRequired

This is the eshop key you receive during onboarding.

authorizationstringRequired

Token you get from calling /users/login

Body

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

401

Unauthorized response

application/json

post

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: 200

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

{
  "statusCode": 200,
  "message": "text",
  "data": {
    "data": [
      {
        "eshopReceivingId": "text",
        "description": "text",
        "trackingNumber": "text",
        "supplier": "text",
        "estimatedDelivery": "2025-09-15",
        "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": "2025-09-15T08:03:20.770Z",
        "slaSuspended": "text",
        "photoDocumentationTaken": "text",
        "deliveredPalletsCount": 1,
        "deliveredCartonsCount": 1,
        "returnedEurPalletsCount": 1,
        "deliveredStandardPalletsCount": 1,
        "returnedStandardPalletsCount": 1,
        "unloadedAt": "2025-09-15T08:03:20.770Z",
        "confirmedAt": "2025-09-15T08:03:20.770Z",
        "status": "awaiting"
      }
    ],
    "request": {
      "page": 1,
      "items": 30,
      "columns": [
        "estimatedDelivery",
        "duty",
        "eshopReceivingId"
      ],
      "sorts": [
        {
          "column": "estimatedDelivery",
          "direction": "DESC"
        }
      ],
      "filters": [
        [
          {
            "column": "duty",
            "operator": "eq",
            "value": true
          }
        ]
      ]
    },
    "totalCount": 430
  }
}

Get receiving

get

Authorizations

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

401

Unauthorized response

application/json

404

Not found response

application/json

get

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": "2025-09-15",
    "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": "2025-09-15T08:03:20.770Z",
    "realDelivery": "2025-09-15T08:03:20.770Z",
    "slaSuspended": "text",
    "photoDocumentationTaken": "text",
    "deliveredPalletsCount": 1,
    "deliveredCartonsCount": 1,
    "returnedEurPalletsCount": 1,
    "deliveredStandardPalletsCount": 1,
    "returnedStandardPalletsCount": 1,
    "unloadedAt": "2025-09-15T08:03:20.770Z",
    "confirmedAt": "2025-09-15T08:03:20.770Z",
    "asn": "text",
    "status": "awaiting",
    "products": [
      {
        "sku": "text",
        "quantity": 1,
        "received": 1,
        "lot": "text",
        "expirationDate": "2025-09-15",
        "productPrice": 1,
        "serialNumber": "123456789",
        "lineState": "E"
      }
    ],
    "packagings": [
      {
        "packagingType": "non_returnable_pallet",
        "pallet": "pallet_100x120_ippc",
        "quantity": 1
      }
    ]
  }
}

Create receiving

post

Authorizations

Header parameters

x-api-keystringRequired

This is the eshop key you receive during onboarding.

authorizationstringRequired

Token you get from calling /users/login

Body

all ofOptional

Responses

200

Success response

application/json

401

Unauthorized response

application/json

409

Conflict response

application/json

post

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": "2025-09-15",
  "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": "2025-09-15",
      "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": "2025-09-15",
    "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": "2025-09-15T08:03:20.770Z",
    "realDelivery": "2025-09-15T08:03:20.770Z",
    "slaSuspended": "text",
    "photoDocumentationTaken": "text",
    "deliveredPalletsCount": 1,
    "deliveredCartonsCount": 1,
    "returnedEurPalletsCount": 1,
    "deliveredStandardPalletsCount": 1,
    "returnedStandardPalletsCount": 1,
    "unloadedAt": "2025-09-15T08:03:20.770Z",
    "confirmedAt": "2025-09-15T08:03:20.770Z",
    "asn": "text",
    "status": "awaiting",
    "products": [
      {
        "sku": "text",
        "quantity": 1,
        "received": 1,
        "lot": "text",
        "expirationDate": "2025-09-15",
        "productPrice": 1,
        "serialNumber": "123456789",
        "lineState": "E"
      }
    ],
    "packagings": [
      {
        "packagingType": "non_returnable_pallet",
        "pallet": "pallet_100x120_ippc",
        "quantity": 1
      }
    ]
  }
}

Update receiving

put

Authorizations

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

all ofOptional

Responses

200

Success response

application/json

401

Unauthorized response

application/json

404

Not found response

application/json

put

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": "2025-09-15",
  "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": "2025-09-15",
      "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": "2025-09-15",
    "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": "2025-09-15T08:03:20.770Z",
    "realDelivery": "2025-09-15T08:03:20.770Z",
    "slaSuspended": "text",
    "photoDocumentationTaken": "text",
    "deliveredPalletsCount": 1,
    "deliveredCartonsCount": 1,
    "returnedEurPalletsCount": 1,
    "deliveredStandardPalletsCount": 1,
    "returnedStandardPalletsCount": 1,
    "unloadedAt": "2025-09-15T08:03:20.770Z",
    "confirmedAt": "2025-09-15T08:03:20.770Z",
    "asn": "text",
    "status": "awaiting",
    "products": [
      {
        "sku": "text",
        "quantity": 1,
        "received": 1,
        "lot": "text",
        "expirationDate": "2025-09-15",
        "productPrice": 1,
        "serialNumber": "123456789",
        "lineState": "E"
      }
    ],
    "packagings": [
      {
        "packagingType": "non_returnable_pallet",
        "pallet": "pallet_100x120_ippc",
        "quantity": 1
      }
    ]
  }
}

PreviousProducts sets NextReturns

Last updated 1 month ago