Downloading the list of orders

Field name

Description

Type

Requirement status

Additional remarks

page_index

Page index

string

O

page_size

Page size

string

O

order_id

Order ID

string

O

Field name

Description

Type

Requirement status

Additional remarks

page_size

Page size

integer

O

"page_size":1

total_items

Total number of items

integer

O

"total_items":159

page_index

Page index

integer

O

"page_index":1

orders

An object which returns the list of orders

object

O

orders.order_details

Order details

object

Y

orders.order_details.order_comments

Comments to an order

string

O

"comments ": "Zamówienie przetwarzane"

orders.order_details.order_id

An order ID assigned by the Merchant

string

Y

"order_id":"3433d1b7-fd9b-484b-aa68-80fccc575407"

orders.order_details.customer_order_id

Order ID presented to customer and used for payment. In case of lack of customer_order_id order_id will be used.

string

O

"customer_order_id":"3433d1b7”

orders.order_details.pos_id

POS id

string

Y

"pos_id":"000000000"

orders.order_details.order_creation_date

The date of creating an order

string($date-time)

Y

"order_creation_date":"2023-09-07T14:18:41.949Z"

orders.order_details.order_update_date

The date of an order's last update

string($date-time)

O

"order_update_date":"2023-09-07T14:23:54.190Z"

orders.order_details.payment

An object which returns any information regarding the payment

object

O

orders.order_details.payment.payment_type

Selected payment type. Enum:

[ CARD, CARD_TOKEN, GOOGLE_PAY, APPLE_PAY, BLIK_CODE, BLIK_TOKEN, PAY_BY_LINK, SHOPPING_LIMIT, DEFERRED_PAYMENT, CASH_ON_DELIVERY ]

string

Y

"payment_type":"BLIK_CODE"

orders.order_details.payment.payment_status

Payment status

Enum:[ UNPAID, STARTED, PENDING, AUTHORIZED, DECLINED, CANCELLED, ERROR, COD ]

string

Y

"payment_status":"AUTHORIZED"

orders.order_details.payment.available_payment_types

Payment types available for a given order.

List with available values: [CARD, CARD_TOKEN, GOOGLE_PAY, APPLE_PAY, BLIK_CODE, BLIK_TOKEN, PAY_BY_LINK, SHOPPING_LIMIT, DEFERRED_PAYMENT, CASH_ON_DELIVERY]

array

O

"available_payment_types":["BLIK_CODE","BLIK_TOKEN","PAY_BY_LINK"]

orders.order_details.payment.payment_details

Payment details

object

O

orders.order_details.payment.payment_details.payment_reference

Reference number

string

Y

"payment_reference":"52428_9b642ee3-ff3d-4fae-8ff8-30e29c0dafac"

orders.order_details.payment.payment_details.payment_id

Payment Id

string

O

"payment_id":"3cb4967d-4b63-4c5c-84bc-54e699a2dca0"

orders.order_details.payment.payment_details.payment_sec_token

Security token used

string

O

"payment_sec_token":"eyJraWQiOiIyMDRjY2U0OC1iYTFkLTQ0ODYtOTNlNy1kY..."

orders.order_details.payment.payment_details.payment.payment_type

Payment type

string

Y

"payment_type":"BLIK_TOKEN"

orders.order_details.payment.payment_details.payment_token

Card token

string

O

"payment_token":"gr...ki@it...om"

orders.order_details.payment.payment_details.payment_card

Card Information

object

O

orders.order_details.payment.payment_details.payment_card.last_four_digits

Card's last 4 digits

string

O

"last_four_digits":"0021"

orders.order_details.payment.payment_details.payment_card.scheme

Scheme in which the card operates

string

O

"scheme":"https://static.payu.com/images/mobile/logos/pbl_c.png"

orders.order_details.payment.payment_details.payment_card.card_type

Typ kart [ DEBIT, CREDIT, PREPAID, CHARGE, DEFERRED_DEBIT ]

string

O

"card_type":" DEBIT"

orders.order_details.payment.payment_details.payment_status

Payment status

string

O

"payment_status":"AUTHORIZED"

orders.order_details.payment.payment_details.payment_code

Payment code

string

O

"payment_code":"00"

orders.order_details.payment.payment_details.payment_description

Additional payment information

string

O

"payment_description":"APPROVED"

orders.order_details.payment.payment_details.payment_error_code

Error code 

string

O

"payment_error_code":"test"

orders.order_details.payment.payment_details.payment_message_code

Payment message (code)

string

O

"payment_message_code":"userCancelled"

orders.order_details.payment.payment_details.payment_date

Transaction date

string($date-time)

O

"payment_date":"2023-08-02T09:48:12.302Z"

orders.order_details.order_status

Technical status - used to specify the authorizations that the customer may exercise for the order in the InPost Pay app.

We can distinguish 3 technical statuses:

ORDER_COMPLETED- the status assigned by the merchant, informing the InPost Pay app that the order was completed by the customer on the merchant store's website.

ORDER_REJECTED - the status means the order has been rejected.

ORDER_PROCESSING - order in progress

string

Y

"order_status":"ORDER_COMPLETED"

orders.order_details.order_merchant_status_description

A descriptive status presented to the customer in the InPost Pay app - each Merchant may provide the status so that the statuses presented in InPost Mobile are compliant with the status presented to the clients in the Merchant's store.

string

Y

"order_merchant_status_description": "W trakcie realizacji"

orders.order_details.order_base_price

Order price without the delivery costs

object

Y

orders.order_details.order_base_price.net

Net

number ($decimal)

Y

"order_base_price":{"net":202.51,"gross":263.0,"vat":60.49},

orders.order_details.order_base_price.gross

Gross

number ($decimal)

Y

orders.order_details.order_base_price.vat

VAT

number ($decimal)

Y

orders.order_details.order_final_price

Order price with the delivery costs

object

Y

orders.order_details.order_final_price.net

Net

number ($decimal)

Y

"order_final_price":{"net":208.2,"gross":270.0,"vat":61.8}

orders.order_details.order_final_price.gross

Gross

number ($decimal)

Y

orders.order_details.order_final_price.vat

VAT

number ($decimal)

Y

orders.order_details.order_discount

Value used discount coupons on order

number($decimal) 

Y 

"order_discount": 20.2

orders.order_details.currency

Order's currency (currently, PLN only)

string

Y

"currency":"PLN"

orders.order_details.delivery_references_list

List of the numbers assigned to an order's shipments

array

O

"delivery_references_list":[12345678]

orders.account_info

Information about the account used

object

Y

orders.account_info.name

First name

string

Y

"account_info":{"name":"Jan","surname":"Kowalski","phone_number":{"country_prefix":"+48","phone":"600000000"}

orders.account_info.surname

Last name

string

Y

orders.account_info.phone_number

Telephone number

object

Y

orders.account_info.phone_number.country_prefix

Prefix

string

Y

orders.account_info.phone_number.phone

User's phone number

string

Y

orders.account_info.mail

Mail

string

Y

"mail":"test@g....m"

orders.account_info.client_address

User's address

object

Y

orders.account_info.client_address.country_code

Country code

string

Y

"client_address":{"country_code":"PL","city":"Test","address":"Testowa 3/9 Testowa 3 ","postal_code":"00-000"}

orders.account_info.client_address.address

Address

string

Y

orders.account_info.client_address.city

City

string

Y

orders.account_info.client_address.postal_code

Postal code

string

Y

orders.invoice_details

Invoice data

object

O

orders.invoice_details.legal_form

Legal Form [PERSON, COMPANY]

string

O

"invoice_details":{"legal_form":"COMPANY","country_code":"PL","tax_id":"0000000000","company_name":TEST","city":"Warszawa","street":"ul. Testowa","building":"10A","postal_code":"01-997","mail":"test@m...l","registration_data_edited":"true"}

orders.invoice_details.country_code

Country code

string

O

orders.invoice_details.tax_id_prefix

Id prefix

string

O

orders.invoice_details.tax_id

tax identifier

string

O

orders.invoice_details.company_name

Company name

string

O

orders.invoice_details.name

First name

string

O

orders.invoice_details.surname

Last name

string

O

orders.invoice_details.city

City

string

O

orders.invoice_details.street

Street

string

O

orders.invoice_details.building

Building number

string

O

orders.invoice_details.flat

Apartment number

string

O

orders.invoice_details.postal_code

Postal code

string

O

orders.invoice_details.mail

Mail

string

O

orders.invoice_details.registration_data_edited

Registration date

string

O

orders.invoice_details.additional_information

Additional information 

string

O

orders.delivery

Delivery Information

object

Y

orders.delivery.delivery_type

Delivery method. Enum:

[ APM, COURIER ]

string

Y

"delivery_type":"COURIER"

orders.delivery.delivery_date

Delivery date

string($date-time)

Y

"delivery_date":"2023-09-10T12:00:00.000Z"

orders.delivery.delivery_options

The options selected for a delivery

array

O

orders.delivery.delivery_options.delivery_name

Name

string

Y

"delivery_options":[{"delivery_name":"Paczka w Weekend","delivery_code_value":"PWW","delivery_option_price":{"net":5,"gross":"6.15","vat":"1.15"}}]

orders.delivery.delivery_options.delivery_code_value

Option code

string

Y

orders.delivery.delivery_options.delivery_option_price

Delivery option amount

object

Y

orders.delivery.delivery_options.delivery_option_price.net

Net

number ($decimal)

Y

orders.delivery.delivery_options.delivery_option_price.gross

Gross

number ($decimal)

Y

orders.delivery.delivery_options.delivery_option_price.vat

VAT

number ($decimal)

Y

orders.delivery.mail

Mail

string

O

"mail":"test@g..m"

orders.delivery.phone_number

Phone number

object

O

orders.delivery.phone_number.country_prefix

Prefix

string

Y

"phone_number":{"country_prefix":"+48","phone":"600000000"}

orders.delivery.phone_number.phone

Number

string

Y

orders.delivery.delivery_point

Automatic parcel locker delivery site

string

O

"delivery_point":"RSL218"

orders.delivery.delivery_address

Delivery address

object

O

orders.delivery.delivery_address.name

Name

string

Y

"delivery_address":{"name":"Jan Kowalski","country_code":"PL","address":"Testowa 3 ","city":"Test","postal_code":"00-000"}

orders.delivery.delivery_address.country_code

Country code

string

Y

orders.delivery.delivery_address.address

Address

string

Y

orders.delivery.delivery_address.city

City

string

Y

orders.delivery.delivery_address.postal_code

Postal code

string

Y

orders.delivery.delivery_price

Object intended to transfer information related to the cost of delivery

object

Y

orders.delivery.delivery_price.net

Net price

number ($decimal) (10,2)

Y

"delivery_price":{"net":"10.00","gross":"12.30","vat":"2.30"}

orders.delivery.delivery_price.gross

Gross Price (net + VAT)

number ($decimal) (10,2)

Y

orders.delivery.delivery_price.vat

VAT

number ($decimal) (10,2)

Y

orders.delivery.courier_note

Notes for the courier

string

O

" courier_note ":"Proszę o przekazanie przesyłki po godzinie 16"

orders.products

List of the products in an order

array

Y

orders.products.product_id

Product ID assigned by the Merchant

string

Y

"product_id": 26

orders.products.product_category

Product category assigned by the Merchant

string

O

"product_category":20

orders.products.ean

Ean

string

O

"ean":"0"

orders.products.product_name

Product name

string

Y

"product_name": "washpapa backpack"

orders.products.product_description

Product description

string

O

"product_description": "  \r\n\r\nSometimes you just want to leave everything, pack your bags and go to Bieszczady? It's a good plan for holidays. And during the year, simply discover your city again.\r\n\r\ Exploration cannot be successful without a reliable backpack with foldable closings and made of high quality materials, such as our.\r\n\r\nThe cotton straps ensure the convenience of carrying, and washpapa will express your devotion to the nature. Remember! Behind each adventure, there is a good backpack."

orders.products.product_link

Link to the product on the Merchant's website

string

O

"product_link":"https://test.outofthebox.pl/product/plecak-washpapa/"

orders.products.product_image

Link to a photograph of the product. Formats preferable: png, jpg (recommendation: png without background)

string

O

"product_image":"https://test.outofthebox.pl/img/2022/10/INPOST_aranzacje-z-modelami25-1.jpg"

orders.products.additional_product_images

Additional product images.

object

O

-

orders.products.additional_product_images.small_size

Product image. Preferred size 360 x 352

string

Y

-

orders.products.additional_product_images.normal_size

Product image. Preferred size 360 x 504

string

Y

-

orders.products.base_price

Product's base price

object

Y

orders.products.base_price.net

Net price

number ($decimal) (10,2)

Y

"base_price":{"net":"161.79","gross":"199.00","vat":"37.21"}

orders.products.base_price.gross

Gross Price (net + VAT)

number ($decimal) (10,2)

Y

orders.products.base_price.vat

VAT

number ($decimal) (10,2)

Y

orders.products.lowest_price

Object intended to transfer the lowest price of the product over the previous 30 days. Required to handle the Omibus directive

object

O

orders.products.lowest_price.net

Net price

number ($decimal) (10,2)

Y

"lowest_price ":{"net":"160.98","gross":"198.00","vat":"37.02"}

orders.products.lowest_price.gross

Gross Price (net + VAT)

number ($decimal) (10,2)

Y

orders.products.lowest_price.vat

VAT

number ($decimal) (10,2)

Y

orders.products.quantity

Object for reporting the product quantity

object

Y

orders.products.quantity.quantity

product quantity 

number ($decimal)

Y

"quantity":1

orders.products.quantity.quantity_type

Field type quantity. Available values: [DECIMAL, INTEGER]

string

Y

"quantity_type":"INTEGER"

orders.products.quantity.quantity_unit

Quantity unit of the product

string

O

"quantity_unit":"pcs"

orders.products.product_attributes

Object intended to determine the product's attributes

array

O

orders.products.product_attributes.attribute_name

Attribute name

string

Y

"product_attributes ": [{ "attribute_name ": "Dimensions/Capacity", "attribute_value ":"54 cm x 38 cm x 10 cm "}, { "attribute_name ": "Material", "attribute_value": "Washable paper standard + kodura + woven cotton straps"}]

orders.products.product_attributes.attribute_value

Attribute value

string

Y

orders.products.variants

Object intended to transfer products' variants. Object currently not used. The functionality shall be implemented in the app's subsequent versions.

object

O

orders.products.variants.variant_id

Version's Id

string

Y

orders.products.variants.variant_name

Version's name

string

Y

orders.products.variants.variant_description

Version's detailed description

string

O

orders.products.variants.variant_type

Version's type

string

O

orders.products.variants.variant_values

Version's value 

string

O

orders.consents

An object intended to transfer information related to the consents expressed by the customer for a given order

array

Y

orders.consents.consent_id

Consent Id

string

Y

"consent_id":3

orders.consents.consent_version

Consent version 

string

O

"consent_version":1

orders.consents.is_accepted

Information whether the consent has been expressed or not

boolean

Y

"is_accepted": true