Nazwa pola

Opis

Typ

Wymagalność

Dodatkowe uwagi

order_id

Unikalny identyfikator zamówienia nadawany przez Merchanta

string

Y

Nazwa pola

Opis

Typ

Wymagalność

Dodatkowe uwagi

order_details

Szczegóły zamówienia

object

Y

order_details.order_comments

Uwagi o zmówieniu

string

O

"comments ":"Zamówienie przetwarzane"

order_details.order_id

Identyfikator zmówienia nadawany przez Merchanta

string

Y

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

order_details.customer_order_id

Identyfikator zamówienia prezentowany klientowi oraz wykorzystywany do płatności. W przypadku braku wykorzystywany jest order_id

string

O

"customer_order_id":"3433d1b7”

order_details.pos_id

POS id

string

Y

"pos_id":"V000000000"

order_details.order_creation_date

Data utworzenia zamówienia

string($date-time)

Y

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

order_details.basket_id

Identyfikator koszyka, na podstawie którego zostało utworzone zamówienia

string

Y

"basket_id":"f55646f7-5773-0009-d8ba-000064fae5e1"

order_details.payment_type

Wybrany typ płatności. 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"

order_details.order_merchant_status_description

Status opisowy prezentowany klientowi w aplikacji InPost Pay - każdy Merchant może przekazać status tak, aby statusy prezentowane w InPost Mobile były zgodne ze statusem prezentowanym klientowi w sklepie Merchanta.

string

Y

"order_merchant_status_description":"W trakcie realizacji"

order_details.order_base_price

Cena za zamówienie bez kosztów dostawy

object

Y

order_details.order_base_price.net

Netto

number($decimal)

Y

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

order_details.order_base_price.gross

Brutto

number($decimal)

Y

order_details.order_base_price.vat

VAT

number($decimal)

Y

order_details.order_final_price

Cena za zamówienie z uwzględnieniem kosztów dostawy

object

Y

order_details.order_final_price.net

Netto

number($decimal)

Y

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

order_details.order_final_price.gross

Brutto

number($decimal)

Y

order_details.order_final_price.vat

VAT

number($decimal)

Y

order_details.order_discount

Wartość zastosowanych kodów rabatowych na zamówieniu

number($decimal) 

Y 

"order_discount": 20.2

order_details.currency

Waluta zamówienia (obecnie tylko PLN)

string

Y

"currency":"PLN"

order_details.delivery_references_list

Lista nadanych numerów przesyłek zamówienia

array

O

"delivery_references_list":[12345678]

account_info

Informacje o koncie użytkowania

object

Y

account_info.name

Imię

string

Y

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

account_info.surname

Nazwisko

string

Y

account_info.phone_number

Numer telefonu

object

Y

account_info.phone_number.country_prefix

Prefix

string

Y

account_info.phone_number.phone

Numer telefonu użytkownika

string

Y

account_info.mail

Mail użytkownika aplikacji InPost Pay. Merchant może wykorzystać powyższy mail tylko do np. założenia konta klienta, weryfikacji użytkownika. Jeżeli użytkownik loguje się do InPost Pay z użyciem Apple, adres email konta zawiera hash nadany przez Apple i ma formę np. abc@privaterelay.appleid.com. Aby Merchant mógł komunikować się z klientem używając tego adresu, domena Merchanta musi być dodana na koncie InPost w Apple. Apple limituje liczbę domen przypisanych do konta do 100. W związku z tym InPost przekazuje do Merchanta adres email abc@mail.inpostpay.pl z tym samym hash, ale w domenie mail.inpostpay.pl.

string

Y

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

account_info.client_address

Adres użytkownika

object

Y

account_info.client_address.country_code

Kod kraju

string

Y

"client_address":{"country_code":"PL","city":"TEST","address":"Ustronna 3/9 Ustronna 3 ","postal_code":"00-009"}

account_info.client_address.address

Adres

string

Y

account_info.client_address.city

Miasto

string

Y

account_info.client_address.postal_code

Kod pocztowy

string

Y

invoice_details

Dane do faktury

object

O

invoice_details.legal_form

Forma prawna

Enum:[ PERSON, COMPANY ]

string

O

"invoice_details":{"legal_form":"COMPANY","country_code":"PL","tax_id":"0000000000","company_name":Test","city":"Warszawa","street":"ul. Krakowska","building":"10A","postal_code":"00-000","mail":"test@m..l","registration_data_edited":"true"}

invoice_details.country_code

Kod kraju

string

O

invoice_details.tax_id_prefix

Id prefix

string

O

invoice_details.tax_id

Identyfikator podatkowy

string

O

invoice_details.company_name

Nazwa firmy

string

O

invoice_details.name

Imię

string

O

invoice_details.surname

Nazwisko

string

O

invoice_details.city

Miasto

string

O

invoice_details.street

Ulica

string

O

invoice_details.building

Numer budynku

string

O

invoice_details.flat

Numer mieszkania

string

O

invoice_details.postal_code

Kod pocztowy

string

O

invoice_details.mail

Mail

string

O

invoice_details.registration_data_edited

Data rejestracji

string

O

invoice_details.additional_information

Dodatkowe informacje

string

O

delivery

Informacje o dostawie

object

Y

delivery.delivery_type

Forma dostawy. Enum:[ APM, COURIER, DIGITAL ].  
APM – paczkomat, COURIER – kurier Inpost, DIGITAL - dostawa cyfrowa

string

Y

"delivery_type":"COURIER"

delivery.delivery_date

Data dostawy

string($date-time)

Y

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

delivery.delivery_options

Wybrane opcje dostawy

array

O

delivery.delivery_options.delivery_name

Nazwa

string

Y

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

delivery.delivery_options.delivery_code_value

Kod opcji

string

Y

delivery.delivery_options.delivery_option_price

Kwota opcji dostawy

object

Y

delivery.delivery_options.delivery_option_price.net

Netto

number($decimal)

Y

delivery.delivery_options.delivery_option_price.gross

Brutto

number($decimal)

Y

delivery.delivery_options.delivery_option_price.vat

VAT

number($decimal)

Y

delivery.mail

Zamaskowany adres mail użytkownika w domenie order.inpostpay.pl, który Merchant obligatoryjnie powinien wykorzystać do obsługi utworzonego zamówienia, w szczególności rejestracji/nadania przesyłki (na mail z delivery.mail należy nadać przesyłkę, co umożliwi prawidłowe monitorowanie i powiązanie utworzonego zamówienia z InPost Pay oraz nadanej przesyłki dla zamówienia).

string

O

"mail":"...@order.inpostpay.pl"

delivery.digital_delivery_email

Adres email na jaki ma być wysłany produkt cyfrowy. Przekazywany tylko w przypadku, gdy w koszyk znajduje się produkt cyfrowy. Jeśli adres zawiera hash nadany przez Apple i ma formę np. abc@privaterelay.appleid.com. Aby Merchant mógł komunikować się z klientem używając tego adresu, domena Merchanta musi być dodana na koncie InPost w Apple. Apple limituje liczbę domen przypisanych do konta do 100. W związku z tym InPost przekazuje do Merchanta adres email abc@mail.inpostpay.pl z tym samym hash, ale w domenie mail.inpostpay.pl.

string

O

"digital_delivery_email":"jankowalski@g...m"

delivery.phone_number

Numer telefonu dla dostawy

object

O

delivery.phone_number.country_prefix

Prefix

string

Y

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

delivery.phone_number.phone

Numer telefonu

string

Y

delivery.delivery_point

Punkt dostawy paczkomatu

string

O

"delivery_point":"RSL218"

delivery.delivery_address

Adres dostawy

object

O

delivery.delivery_address.name

Nazwa

string

Y

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

delivery.delivery_address.country_code

Kod kraju

string

Y

delivery.delivery_address.address

Adres

string

Y

delivery.delivery_address.city

Miasto

string

Y

delivery.delivery_address.postal_code

Kod pocztowy

string

Y

delivery.delivery_price

Obiekt służący do przekazania informacji o koszcie dostawy

object

Y

delivery.delivery_price.net

Cena netto

number ($decimal)(10,2)

Y

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

delivery.delivery_price.gross

Cena brutto (netto + VAT)

number ($decimal)(10,2)

Y

delivery.delivery_price.vat

VAT

number ($decimal)(10,2)

Y

delivery.courier_note

Uwagi dla kuriera

string

O

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

products

Lista produktach w zamówieniu

array

Y

products.product_id

Identyfikator produktu nadany przez Merchanta

string

Y

"product_id":26

products.product_category

Kategoria produktu nadana przez Merchanta

string

O

"product_category":20

products.product_type

Pole nieobligatoryjne określające typ produktu. Przyjmuje wartość:

• PRODUCT - produkt fizyczny

• DIGITAL  - produkt cyfrowy.

Jeśli wartość jest null, to aplikacja domyślenie przyjmuje, że produkt jest fizyczny.

string

O

"product_type":"DIGITAL"

products.ean

Ean

string

O

"ean":"0"

products.product_name

Nazwa produktu

string

Y

"product_name":"Plecak washpapa"

products.product_description

Opis produktu

string

O

"product_description":" \r\n\r\nCzasem masz ochotę rzucić wszystko, spakować się i wyjechać w Bieszczady? Jest to dobry plan na wakacje. A w ciągu roku po prostu odkrywaj swoje miasto na nowo.\r\n\r\nUdana eksploracja nie obędzie się bez solidnego plecaka ze zwijanym zamknięciem i uszytego z wysokiej jakości materiałów, takiego jak nasz.\r\n\r\nBawełniane pasy zapewnią wygodę noszenia, a washpapa wyrazi Twoje przywiązanie do natury. Pamiętaj! Za każdą przygodą stoi dobry plecak."

products.product_link

Link do produktu na stronie Merchanta

string

O

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

products.product_image

Link do zdjęcia produktu. Preferowane formaty: png, jpg (rekomendacja: png bez tła)

string

O

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

products.additional_product_images

Obiekt do przekazania dodatkowych zdjęć produktu (lista). Maksymalna ilość zdjęć to 10 (10 obiektów { "normal_size": "string", "small_size": "string" } )

object

O

-

products.additional_product_images.small_size

zdjęcie produktu. Preferowany rozmiar 360 x 352

string

Y

-

products.additional_product_images.normal_size

zdjęcie produktu. Preferowany rozmiar 360 x 504

string

Y

-

products.base_price

Cena produktu uwzględniająca zastosowane rabaty i kody promocyjne na produkcie

object

Y

products.base_price.net

Cena netto

number ($decimal)(10,2)

Y

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

products.base_price.gross

Cena brutto (netto + VAT)

number ($decimal)(10,2)

Y

products.base_price.vat

VAT

number ($decimal)(10,2)

Y

products.quantity

Obiekt do przekazania informacji o ilości produktu

object

Y

products.quantity.quantity

Ilość produktu

number ($decimal)

Y

"quantity":1 

products.quantity.quantity_type

Typ pola quantity. Dostępne wartości: [ DECIMAL, INTEGER ]

string

0

"quantity_type":"INTEGER"

products.quantity.quantity_unit

Jednostka ilości produktu

string

O

"quantity_unit":"pcs"

products.product_attributes

Obiekt służący do określenia atrybutów produktu

array

O

products.product_attributes.attribute_name

Nazwa atrybutu

string

Y

"product_attributes":[{"attribute_name":"Wymiary/Pojemność","attribute_value":"54 cm x 38 cm x 10 cm"},{"attribute_name":"Materiał","attribute_value":"Washable paper standard + kodura + pasy bawełniane tkane"}]

products.product_attributes.attribute_value

Wartość atrybutu

string

Y

consents

Obiekt służący do przekazania informacji o wyrażonych zgodach przez klienta dla danego zamówienia

array

Y

consent_id

Id zgody

string

Y

"consent_id":3

consents.consent_version

Wersja zgody

string

O

"consent_version":1

consents.is_accepted

Informacja, czy została wyrażona zgoda

boolean

Y

"is_accepted": true