Utworzenie zamówienia

Utworzenie zamówienia

Metoda do utworzenia zamówienia

W danej metodzie wymagamy implementacji wszystkich pól wymienionych w tabeli, ponieważ składają się na całość usługi InPost Pay. Część poniższych pól w kolumnie 'Wymagalność' jest oznaczona jako 'O' tj. opcjonalna ze względu na to, że nie wszystkie produkty/koszyki w sklepach internetowych mają przypisane wszystkie parametry, więc koszyk może zostać utworzony, a zamówienie złożone bez nich. Jednak implementacja/wdrożenie wszystkich pól jest biznesowo WYMAGANE.

POST /v1/izi/order

Parameters - brak

Request

Nazwa pola

Opis

Typ

Wymagalność

Dodatkowe uwagi

order_details

Dane do utworzenia zamówienia

object

Y

 

order_details.order_comments

Dodatkowe informacje o zamówieniu

string

O

"comments":"Zamówienie test"

order_details.basket_id

Identyfikator koszyka nadany przez merchanta na podstawie którego ma być utworzone zamówienie

string

Y

"basket_id":"4734da95-458b-44da-8d6e-854b2e501066"

order_details.currency

Waluta. Obecnie tylko PLN

string

Y

"currency":"PLN"

order_details.basket_price

Całkowita wartość koszyka wraz z kosztami dostawy

object

Y

 

order_details.basket_price.net

Netto

number($decimal)

Y

"basket_price":{"net":584.62,"gross":584.62,"vat":0}

order_details.basket_price.gross

Brutto

number($decimal)

Y

order_details.basket_price.vat

VAT

number($decimal)

Y

order_details.payment_type

Wybrana forma płatności przez użytkownika. Dostępne formy 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":"PAY_BY_LINK"

account_info

Informacje o koncie użytkowania

object

Y

 

account_info.name

Imię

string

Y

"name":"Jan"

account_info.surname

Nazwisko

string

Y

"surname":"Kowalski"

account_info.phone_number

Numer telefonu

object

Y

 

account_info.phone_number.country_prefix

Prefix

string

Y

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

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":"jan.nowak@t...l"

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":"POZNAN","address":"Testowa 100","postal_code":"00-000","address_details":{"street":"Testowa","building":"100"}}

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

account_info.client_address.address_details

Obiekt do przekazania rozparsowanego adresu

object

O

account_info.client_address.address_details.street

Ulica

string

O

account_info.client_address.address_details.building

Numer budynku

string

O

account_info.client_address.address_details.flat

Numer mieszkania

string

O

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":"APM"

delivery.delivery_codes

Wybrane opcje dostawy - lista

array

O

"delivery_codes":["PWW"]

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

object

O

 

delivery.phone_number.country_prefix

Prefix

string

Y

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

delivery.phone_number.phone

Numer

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

"name":"Jan Kowalski"

delivery.delivery_address.country_code

Kod kraju

string

O

"country_code":"PL"

delivery.delivery_address.address

Adres

string

Y

"address":"SW.Jana 100"

delivery.delivery_address.city

Miasto

string

Y

"city":"POZNAN"

delivery.delivery_address.postal_code

Kod pocztowy

string

Y

"postal_code":"11-005"

address_details

Rozprasowany adres

object

O



address_details.street

Ulica

string

O

"address_details":{"street":"Swmichala","building":"100"}

address_details.building

Numer budynku

string

O

address_details.flat

Numer lokalu

string

O

delivery.courier_note

Uwagi dla kuriera

string

O

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

consents

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

array

Y

 

consents.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

 

Response

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) 

"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]

order_details. order_additional_parameters

Obiekt służący do przekazania dodatkowych parametrów zamówienia, które są zapisane w szczegółach zamówienia. Merchant może wykorzystać obiekt np. do zapisania parametrów które umożliwią identyfikacji/powiązanie zamówienia z kampanią. Dodatkowe parametry nie są prezentowane w aplikacji.

array

O

 

order_details. order_additional_parameters.key

Klucz

string

Y

 

order_details. order_additional_parameters.value

Wartość

string

Y

 

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