Orders

Filter orders

post
Authorizations
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
pageinteger · min: 1Optional

Page number, can be used for pagination

Default: 1Example: 1
itemsinteger · min: 1 · max: 1000Optional

items per page

Default: 10Example: 30
columnsarray · enumOptional

List of columns you want to retrieve. If empty, all possible columns will be retrieved

Example: ["id","status","timestamp"]Possible values:
Responses
200

Success response

application/json
post
/orders/filter

Get order detail

get
Authorizations
authorizationstringRequired
x-api-keystringRequired
Path parameters
eshopOrderIdstringRequired
Query parameters
withPackingListsbooleanOptional

If turned on it returns information what SKUs are in which packing together with SSCC codes, serial numbers etc.

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
get
/orders/{eshopOrderId}

Create new order

post
Authorizations
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
eshopOrderIdstringRequired

Unique order ID from the e-shop. Used to check whether the order has not already been created in MySkladon. The ideal value is the unique order identifier from the e-shop.

Example: 12345
invoiceNumberstringOptionalExample: 4790712402150
orderTypestring · enumRequiredExample: b2cPossible values:
statusstring · enumOptional

Optional initial status. Allowed values are preReceived (default) or preOrder. preReceived is the normal default status, preOrder is for pre-orders that should not be picked yet.

Example: preReceivedPossible values:
invoiceDatestringOptionalExample: 2022-05-23 20:39:38
requiredExpeditionDatestringOptional

Required expedition date for B2B orders

Example: 2022-05-23 20:39:38
partnerOrderIdstringOptional
recipientNamestringOptionalExample: Jan Novák
recipientAttentionNamestringOptionalExample: Jan Novák
recipientEmailstringOptionalExample: [email protected]
recipientPhonestringOptionalExample: 735001002
recipientCompanyNamestringOptional
recipientCompanyIdstringOptional

Must be filled for transfer order type. Value can be found in MYS at Settings -> Provider transfer companies

recipientTaxIdstringOptional
recipientStreetstringOptionalExample: Komenského 172
recipientAddressAdditionalInfostringOptional
recipientCitystringOptionalExample: Praha
recipientStatestringOptionalExample: CZ
recipientProvinceCodestringOptional
recipientPostCodestringOptionalExample: 70316
recipientGlnstringOptionalExample: 01234563987
billingNamestringOptionalExample: Jan Novák
billingAttentionNamestringOptionalExample: Jan Novák
billingEmailstringOptionalExample: [email protected]
billingPhonestringOptionalExample: 735001002
billingCompanyNamestringOptional
billingCompanyIdstringOptional
billingTaxIdstringOptional
billingStreetstringOptionalExample: Komenského 172
billingAddressAdditionalInfostringOptional
billingCitystringOptionalExample: Praha
billingStatestringOptionalExample: CZ
billingProvinceCodestringOptional
billingPostCodestringOptionalExample: 70316
billingGlnstringOptionalExample: 9874563210
shipperstringOptional

Use the 'shipper' field obtained from GET /v2/shipper-service-codes endpoint

addressIdstringOptional

ID of carrier's pickup point

Example: CZ12345
messagestringOptional
paidbooleanOptional

True if order is paid, false otherwise.

Example: true
paymentMethodstring · enumOptional

0 - cash on delivery, 1 - card online, 2 - bank transfer

Possible values:
pricenumberOptionalExample: 2990
currencystringOptionalExample: CZK
shippingPricenumberOptional
codPricenumberOptionalExample: 2990
codCurrencystringOptionalExample: CZK
codRefNumberstring · min: 1OptionalExample: 10898
notestringOptional
eshopNotestringOptional

Note from e-shop that is not shown to the customer

shipperServiceCodestringOptional

Use the 'value' field obtained from GET /v2/shipper-service-codes endpoint

allowExpeditionbooleanOptionalDefault: true
printReturnLabelbooleanOptional
printFilesbooleanOptional

If true order file with "invoice" type will be printed

holdByQualitybooleanOptional

If true order will be picked from quality

trackingNumbersstring[]Optional

Tracking numbers

underSanctionbooleanOptional

If set to true, order is marked as under sanction. Only for B2B orders.

prioritynumber · enumOptional

Order priority. 0 - normal, 1 - high

Default: 0Possible values:
disableShippingReorderbooleanOptional

If set to true, standard shipping wont be ordered. It is necessary to pass shippingAddonLabel to order files and set value for marketplace.

marketplacestring · enumOptional

Order marketplace origin. Required if disableShippingReorder is set to true.

Example: alzaPossible values:
Responses
200

Success response

application/json
post
/orders

Updates order

put
Authorizations
authorizationstringRequired
x-api-keystringRequired
Path parameters
eshopOrderIdstringRequired
Header parameters
x-api-keystringRequired

This is the eshop key you receive during onboarding.

authorizationstringRequired

Token you get from calling /users/login

Body
eshopOrderIdstringRequired

Unique order ID from the e-shop. Used to check whether the order has not already been created in MySkladon. The ideal value is the unique order identifier from the e-shop.

Example: 12345
invoiceNumberstringOptionalExample: 4790712402150
orderTypestring · enumRequiredExample: b2cPossible values:
invoiceDatestringOptionalExample: 2022-05-23 20:39:38
requiredExpeditionDatestringOptional

Required expedition date for B2B orders.

Example: 2022-05-23 20:39:38
partnerOrderIdstringOptional
recipientNamestringOptionalExample: Jan Novák
recipientAttentionNamestringOptionalExample: Jan Novák
recipientEmailstringOptionalExample: [email protected]
recipientPhonestringOptionalExample: 735001002
recipientCompanyNamestringOptional
recipientCompanyIdstringOptional

Must be filled for transfer order type. Value can be found in MYS at Settings -> Provider transfer companies

recipientTaxIdstringOptional
recipientStreetstringOptionalExample: Komenského 172
recipientAddressAdditionalInfostringOptional
recipientCitystringOptionalExample: Praha
recipientStatestringOptionalExample: CZ
recipientProvinceCodestringOptional
recipientPostCodestringOptionalExample: 70316
recipientGlnstringOptionalExample: 01234563987
billingNamestringOptionalExample: Jan Novák
billingAttentionNamestringOptionalExample: Jan Novák
billingEmailstringOptionalExample: [email protected]
billingPhonestringOptionalExample: 735001002
billingCompanyNamestringOptional
billingCompanyIdstringOptional
billingTaxIdstringOptional
billingStreetstringOptionalExample: Komenského 172
billingAddressAdditionalInfostringOptional
billingCitystringOptionalExample: Praha
billingStatestringOptionalExample: CZ
billingProvinceCodestringOptional
billingPostCodestringOptionalExample: 70316
billingGlnstringOptionalExample: 9874563210
shipperstringOptional

Use the 'shipper' field obtained from GET /v2/shipper-service-codes endpoint

addressIdstringOptional

ID of carrier's pickup point

Example: CZ12345
messagestringOptional
paidbooleanOptional

True if order is paid, false otherwise.

Example: true
paymentMethodstring · enumOptional

0 - cash on delivery, 1 - card online, 2 - bank transfer

Possible values:
pricenumberOptionalExample: 2990
currencystringOptionalExample: CZK
shippingPricenumberOptional
codPricenumberOptionalExample: 2990
codCurrencystringOptionalExample: CZK
codRefNumberstring · min: 1OptionalExample: 10898
notestringOptional
eshopNotestringOptional

Note from e-shop that is not shown to the customer

shipperServiceCodestringOptional

Use the 'value' field obtained from GET /v2/shipper-service-codes endpoint

allowExpeditionbooleanOptionalDefault: true
printReturnLabelbooleanOptional
printFilesbooleanOptional

If true order file with "invoice" type will be printed

holdByQualitybooleanOptional

If true order will be picked from quality

trackingNumbersstring[]Optional
underSanctionbooleanOptional

If set to true, order is marked as under sanction. Only for B2B orders.

prioritynumber · enumOptional

Order priority. 0 - normal, 1 - high

Default: 0Possible values:
statusstring · enumOptionalPossible values:
Responses
200

Success response

application/json
put
/orders/{eshopOrderId}

Last updated