Page Comparison

basket_id id 

Unikalny identyfikator koszyka nadawany przez merchanta 

string 

Y 

Nazwa pola 

Opis  

Typ 

Wymagalność 

Dodatkowe uwagi 

browser_id id

Unikalny identyfikator przeglądarki zaufanej nadawany przez aplikacje InpostInPost. Pole wykorzystywane tylko w przypadku, gdy klient korzysta z przeglądarki zaufanej i nie ma powiązanego koszyka. W takiej sytuacji po wybraniu „Kup z Inpost InPost Pay” powinna być wywołana metoda PUT z parametrem browser_id. 

string 

O 

"browser_id":"2d387d15-d4fe-43f8-85dc-32d46cfc3b53" 

summary summary

Obiekt służący do przekazania podstawowych danych o koszyku 

object 

Y   

summary.basket_base_price price

Obiekt służący do przekazania ceny podstawowej za koszyk bez kosztów dostawy 

object 

Y   

summary.basket_base_price.net net

Cena netto 

Number ($decimal)(10,2) 

Y 

"summary":{"basket_base_price":{"net":"250.00","gross":"307.50","vat":"57.5 5"}}

summary.basket_base_price.gross gross

Cena brutto (netto + VAT) 

Number ($decimal)(10,2) 

Y 

summary.basket_base_price.vat vat

VAT 

Number ($decimal)(10,2) 

Y 

summary.basket_final_price price

Obiekt służący do przekazania ostatecznej ceny koszyka z uwzględnionym uwzględnioną promocją i kodem rabatowym na koszyku bez kosztów dostawy. Jeśli nie ma zastosowanego kodu rabatowego: final_price = promo_price 
Wartość obniżki na koszyku  wynikająca z zastosowania kodu (kodu promocyjnego, który nie reguluje dyrektywa OMNIBUS), widoczna w podsumowaniu koszyka będzie różnicą pomiędzy promo_price a final_price lub base_price a final_price w przypadku gdy koszyk  nie jest w promocji.

object 

O   

summary.basket_final_price.net net

Cena netto 

Number ($decimal)(10,2) 

Y 

"basket_final_price":{"net":"220.00","gross":"270.60","vat":"50.60"} 

summary.basket_final_price.gross gross

Cena brutto (netto + VAT) 

Number ($decimal)(10,2) 

Y 

summary.basket_final_price.vat vat

VAT 

Number ($decimal)(10,2) 

Y 

summary.basket_promo_price price

Obiekt służący do przekazania ceny koszyka z uwzględnioną promocją na koszyku, ale bez kosztów dostawy zastosowania kodu rabatowego i bez kosztów dostawy.

object 

O 

summary.basket_promo_price.net net

Cena netto 

Number ($decimal)(10,2) 

Y 

"basket_promo_price":{"net":"220.00","gross":"270.60","vat":"50.60"} 

summary.basket_promo_price.gross gross

Cena brutto (netto + VAT) 

Number ($decimal)(10,2) 

Y 

summary.basket_promo_price.vat vat

VAT 

Number ($decimal)(10,2) 

Y 

summary.currency currency

Waluta koszyka. Obecnie obsługiwana tylko waluta PLN 

string 

Y 

"currency":"PLN" 

summary.basket_expiration_date date

Data wygaśnięcia/ważności koszyka. Jest to data, po której koszyk zostanie automatycznie usunięty z aplikacji Inpost Pay (straci ważność). Data nie może być przeszła. 

string($date-time) 

O 

"basket_expiration_date":"2023-09-13T07:40:53.000Z" 

summary.basket_additional_information information

Pole służy do przekazania dodatkowych informacji o koszyku, które z punktu widzenia merchanta mogą być istotne dla klienta 

string 

O 

"basket_additional_information":"Zamów już dziś, a otrzymasz kod promocyjny na przyszłe zakupy" 

summary.payment_type type

Preferowane formy płatności za koszyk. Merchant przekazuje listę preferowanych form płatności dla koszyka z których następnie klient ma możliwość wybrania form płatności. W przypadku przekazania pustej listy, klientowi zostanie zaprezentowana domyślna lista płatności zgodnie z konfiguracją merchnatamerchanta w bramce płatniczej oraz CASH_ON_DELIVERY, gdy dla danej formy dostawy w "delivery" został przekazany "delivery_code_value" ="COD". Lista z możliwymi typami płatności: [ CARD, CARD_TOKEN, GOOGLE_PAY, APPLE_PAY, BLIK_CODE, BLIK_TOKEN, PAY_BY_LINK, SHOPPING_LIMIT, DEFERRED_PAYMENT, CASH_ON_DELIVERY ] 

object array 

Y 

"payment_type":["CARD","CARD_TOKEN","APPLE_PAY","BLIK_CODE","BLIK_TOKEN","PAY_BY_LINK","SHOPPING_LIMIT","DEFERRED_PAYMENT","GOOGLE_PAY"], 

delivery delivery

Obiekt służący do przekazania informacji o preferowanych formach dostawy dla danego koszyka 

array 

Y  

delivery.delivery_type type

Forma dostawy. Enum:[ APM, COURIER ].  

APM – paczkomat, COURIER – kurier Inpost 

string 

Y 

"delivery_type":"APM" 

delivery.delivery_date date

Sugerowana data dostawy 

string($date-time) 

O Y 

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

delivery.delivery_options options

Obiekt służący do przekazania dodatkowych opis dostawy.  Obecnie dostępne dwie dodatkowe opcje dostawy: 

PWW – paczka w weekend  

COD – płatność przy odbierze. W przypadku, gdy dla danego koszyk w payment_type zostanie przekazana wartość CASH_ON_DELIVERY, obligatoryjnie należy przekazać COD jako dodatkową opcje dostawy 

 array

O 

delivery.delivery_options.delivery_name name

Nazwa dodatkowej opcji dostawy 

string 

Y 

"delivery_name": "Paczka w Weekend"  

delivery.delivery_options.delivery_code_value value

Kod dodatkowej opcji dostawy. Obecnie dostępne dwa kody: 

PWW – paczka w weekend  

COD – płatność przy odbierze 

string 

Y 

"delivery_code_value": "PWW" 

delivery.delivery_options.delivery_option_price price

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

object 

Y 

delivery.delivery_options.delivery_option_price.net net

Cena netto 

Number ($decimal)(10,2) 

Y 

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

delivery.delivery_options.delivery_option_price.gorss gross

Cena brutto (netto + VAT) 

Number ($decimal)(10,2) 

Y 

delivery.delivery_options.delivery_option_price.vat vat

VAT 

Number ($decimal)(10,2) 

Y 

delivery.delivery_price 

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

object 

Y 

deliverydelivery.delivery_price.net net

Cena netto 

Number ($decimal)(10,2) 

Y 

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

delivery.delivery_price.gorss gross

Cena brutto (netto + VAT) 

Number ($decimal)(10,2) 

Y 

delivery.delivery_price.vat vat

VAT 

Number ($decimal)(10,2) 

Y 

delivery.free_delivery_minimum_gross_price price

Minimalna wartość koszyka od jakiej koszt dostawy będzie wynosił 0 PLN 

Number ($decimal)(10,2) 

O 

"free_delivery_minimum_gross_price": “100"100.00” 

promo_codes 

Lista kodów promocyjnych zastosowanych na koszyku 

array 

O 

promo_codes.name 

Nazwa kodu. W kolejnej wersji aplikacji pole nie wymagalne 

string 

Y 

"name": "Promocja 5%" 

promo_codes.promo_code_value 

Kod promocyjny 

string 

Y 

"promo_code_value": "INPOST10" 

products 

Lista do przekazania informacji o produktach w koszyku 

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

Preferowane format: png, jpg (rekomendacja: png bez tła) 

products.base_price 

Cena podstawowa z produkt 

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

Cena promocyjna produktu 

object 

O 

products.promo_price.net 

Cena netto 

number ($decimal)(10,2) 

Y 

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

products.promo_price.gorss 

Cena brutto (netto + VAT) 

number ($decimal)(10,2) 

Y 

products.promo_price.vat 

VAT 

Number ($decimal)(10,2) 

Y 

products.lowest_price 

Obiekt służący do przekazania najniższej ceny produktu z ostatnich 30 dni. Wymagane w celu obsłużenia dyrektywy Omibus 

object 

O 

products.lowest_price.net 

Cena netto 

number ($decimal)(10,2) 

Y 

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

products.lowest_price.gorss 

Cena brutto (netto + VAT) 

number ($decimal)(10,2) 

Y 

products.lowest_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 quantity. Dostępne wartości: [ DECIMAL, INTEGER ] 

string 

Y 

"quantity_type":"INTEGER" 

products.quantity.quantity_unit 

Jednostka ilości produktu 

string 

O 

"quantity_unit":"pcs" 

products.quantity.available_quantity 

Ilość dostępnego produktu sklepie 

number ($decimal) 

O 

"available_quantity":26 

products.quantity.max_quantity 

Maksymalna ilość produktu jaką klient może zamówić np. przy jednym zamówieniu 

number ($decimal) 

O 

"max_quantity":26 

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 

products.variants 

Obiekt obecnie nie wykorzystywany. Funkcjonalność będzie wdrażana w kolejnych wersjach aplikacji. 

object 

O 

products.variants.variant_id 

Id wariantu 

string 

Y 

-

products.variants.variant_name 

Nazwa wariantu 

string 

Y 

-

products.variants.variant_description 

Opis szczegółowy wariantu 

string 

O 

-

products.variants.variant_type 

Typ wariantu 

string 

O 

-

products.variants.variant_values 

Wartość wariantu 

string 

O 

-

related_products 

Obiekt służący do przekazania listy produktów sugerowanych dla danego koszyka, które klient może dodać z poziomu aplikacji Inpost Pay 

array 

O 

related_products.product_id 

Identyfikator produktu nadany przez merchanta 

string 

Y 

"product_id":26 

related_products.product_category 

Kategoria produktu nadana przez merchanta 

string 

O 

"product_category":20 

related_products.ean 

Ean 

string 

O 

"ean":"0" 

related_products.product_name 

Nazwa produktu  

string 

Y 

"product_name":"Plecak washpapa" 

related_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." 

related_products.product_link 

Link do produktu na stronie merchanta 

string 

O 

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

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

Preferowane format: png, jpg (rekomendacja: png bez tła) 

related_products.base_price 

Cena podstawowa z produkt 

object 

Y 

related_products.base_price.net 

Cena netto 

number ($decimal)(10,2) 

Y 

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

related_products.base_price.gross 

Cena brutto (netto + VAT) 

number ($decimal)(10,2) 

Y 

related_products.base_price.vat 

VAT 

number ($decimal)(10,2) 

Y 

related_products.promo_price 

Cena promocyjna produktu 

object 

O 

related_products.promo_price.net 

Cena netto 

number ($decimal)(10,2) 

Y 

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

related_products.promo_price.gross 

Cena brutto (netto + VAT) 

number ($decimal)(10,2) 

Y 

related_products.promo_price.vat 

VAT 

number ($decimal)(10,2) 

Y 

related_products.lowest_price 

Obiekt służący do przekazania najniższej ceny produktu z ostatnich 30 dni. Wymagane w celu obsłużenia dyrektywy Omibus 

object 

O 

related_products.lowest_price.net 

Cena netto 

number ($decimal)(10,2) 

Y 

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

related_products.lowest_price.gorss 

Cena brutto (netto + VAT) 

number ($decimal)(10,2) 

Y 

related_products.lowest_price.vat 

VAT 

number ($decimal)(10,2) 

Y 

related_products.quantity 

Obiekt do przekazania informacji o ilości produktu 

object 

Y 

related_products.quantity.quantity 

Ilość produktu 

number ($decimal) 

Y 

"quantity":1 

related_products.quantity.quantity_type 

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

string 

Y 

"quantity_type":"INTEGER" 

related_products.quantity.quantity_unit 

Jednostka ilości produktu 

string 

O 

"quantity_unit":"pcs" 

related_products.quantity.available_quantity 

Ilość dostępnego produktu sklepie 

number($decimal) 

O 

"available_quantity":26 

related_products.quantity.max_quantity 

Maksymalna ilość produktu jaką klient może zamówić np. przy jednym zamówieniu 

number($decimal) 

O 

"max_quantity":26 

related_products.product_attributes 

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

array 

O 

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

related_products.product_attributes.attribute_value 

Wartość atrybutu 

string 

Y 

related_products.variants 

Obiekt obecnie nie wykorzystywany. Funkcjonalność będzie wdrażana w kolejnych wersjach aplikacji. 

object 

O 

related_products.variants.variant_id 

Id wariantu 

string 

Y 

-

related_products.variants.variant_name 

Nazwa wariantu 

string 

Y 

-

related_products.variants.variant_description 

Opis szczegółowy wariantu 

string 

O 

-

related_products.variants.variant_type 

Typ wariantu 

string 

O 

-

related_products.variants.variant_values 

Wartość wariantu 

string 

O 

-

consents 

Obiekt służący do przekazania listy zgód dla danego koszyka 

array 

 Y

consents.consent_id 

Id zgody nadawane przez merchanta 

string 

 Y

"consent_id":3 

consents.consent_link 

Link przekierowujący do pełnej treści zgodny np. do strony merchanta 

string 

 Y

"consent_link":"https://test.outofthebox.pl/zwroty-i-reklamacje/" 

consents.consent_description 

Opis zgody, nie więcej niż 500 znaków 

string 

 Y

consent_description":"zwroty i reklamacje" 

consents.consent_version 

Wersja zgody 

string 

 Y

"consent_version":1 

consents.requirement_type 

Typ zgody. Dostępne wartości: Enum: [OPTIONAL, REQUIRED_ONCE, REQUIRED_ALWAYS ] 

OPTIONAL – Zgoda opcjonalna  

REQUIRED_ONCE - wymagana jednorazowo. Zgoda o takim typie i wersji będzie zapisana w profilu użytkownika, z informacją, że klient wyraził zgodę i w przypadku kolejnych koszyków będzie domyślnie zaznaczona. 

REQUIRED_ALWAYS - wymagana zawsze. Zgoda o takim typie i wersji nie jest zapisywana w profilu użytkownika. Klient za każdym razem musi wyrazić zgodę. 

string 

 Y

"requirement_type":"OPTIONAL" 

00"

delivery.estimate_delivery_time

Funkcjonalność wykorzystująca obiekt dostępna w kolejnych wersjach aplikacji

Obiekt służący do przekazania informacji o szacowanym czasie dostawy w przypadku zamówienia towarów przez klienta w określonym czasie.

array

O

"estimate_delivery_time": [
{
"description": "Kup do 15:00 - dostawa jutro",
"days_available": [
"MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY"
],
"start_hour": "10:00",
"end_hour": "15:00"
}
]
}
],

delivery.estimate_delivery_time.description

Treść komunikatu prezentowana klientowi aplikacji

string

Y

delivery.estimate_delivery_time.days_available

Dni tygodnia w jakich ma być prezentowany komunikat

array

O

delivery.estimate_delivery_time.start_hour

Godzina od której ma być prezentowany komunikat

string

O

delivery.estimate_delivery_time.end_hour

Godzina do której ma być prezentowany komunikat

string

O

promo_codes

Lista kodów promocyjnych zastosowanych na koszyku 

array 

O 

promo_codes.name

Nazwa kodu. W kolejnej wersji aplikacji pole nie wymagalne 

string 

Y 

"name": "Promocja 5%"

promo_codes.promo_code_value

Kod promocyjny 

string 

Y 

"promo_code_value": "INPOST10"

promo_codes.regulation_type

Typ regulacji lub restrykcji, której kod promocyjny podlega.

UWAGA: W przypadku gdy, kod promocyjny jest kodem w myśl dyrektywy OMNIBUS to należy przekazać wartość „OMNIBUS”.

string

O

"regulation_type": "OMNIBUS"

promotions_available

Lista dostępnych kodów promocyjnych, które klient może wykorzystać w koszyku.

array

O

  "promotions_available": [

    {

      "type": "MERCHANT",

      "promo_code_value": "IZI",

      "description": "Super promocja -- 20 PLN ",

      "start_date": "2024-10-03T07:33:13.942Z",

      "end_date": "2024-11-03T07:33:13.942Z",

      "priority": 0,

      "details": {

        "link": " https://inpostpay.pl/ "

      }

    }

  ],

promotions_available.type

Typ kodu:
Enum:[ MERCHANT, ONLY_IN_APP ]
 
MERCHANT -  kod dostępny w sklepie merchanta i InPost Pay (KOD SKLEPU)

ONLY_IN_APP - kod dostępny tylko w aplikacji InPost Pay (TYLKO W APCE).

string 

Y

promotions_available.promo_code_value

Wartość kodu np. DOSTAWA

string 

Y

promotions_available.description

Opis kodu

Max: 60 znaków

string 

Y

promotions_available.start_date

Data początkowa obowiązywania kodu promocyjnego

string($date-time)

O

promotions_available.end_date

Data końcowa obowiązywania kodu promocyjnego

string($date-time)

O

promotions_available.priority

Priorytet kodu
Priorytet służy do określenia kolejności prezentacji kodów w szczegółach koszyka (najwyższy priorytet ma najniższa wartość).

integer

O

promotions_available.details

Szczegóły kodu promocyjnego

object

Y

promotions_available.details.link

Link do szczegółów informacji o kodzie promocyjnym w sklepie merchanta. 

string 

Y

products

Lista do przekazania informacji o produktach w koszyku 

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

Preferowane format: png, jpg (rekomendacja: png bez tła)

products.additional_product_images

Obiekt do przekazania dodatkowych zdjęć produktu (lista)

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 podstawowa z produkt 

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

Cena promocyjna produktu 

object 

O 

products.promo_price.net

Cena netto 

number ($decimal)(10,2) 

Y 

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

products.promo_price.gross

Cena brutto (netto + VAT) 

number ($decimal)(10,2) 

Y 

products.promo_price.vat

VAT 

Number ($decimal)(10,2) 

Y 

products.lowest_price

Obiekt służący do przekazania najniższej ceny produktu z ostatnich 30 dni. Wymagane w celu obsłużenia dyrektywy Omibus. Obiekt należy przekazać obligatoryjnie w przypadku, gdy została przekazania cena promocyjna produktu (obiekt promo_price) oraz został przekazany kod promocyjny z "regulation_type": "OMNIBUS".

object 

O 

products.lowest_price.net

Cena netto 

number ($decimal)(10,2) 

Y 

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

products.lowest_price.gross 

Cena brutto (netto + VAT) 

number ($decimal)(10,2) 

Y 

products.lowest_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 quantity. Dostępne wartości: [ DECIMAL, INTEGER ] 

Jeżeli quantity_type produktu to INTEGER, wtedy Merchant przesyła cenę za 1 sztukę produktu. Jeżeli quantity_type produktu to DECIMAL, wtedy Merchant przesyła cenę za wybraną ilość produktu.  

• Przykład 1) Mamy 5 sztuk koszul w cenie 10 zł za sztukę. W takim przypadku quantity_type, to INTEGER i cena produktu wynosi 10 zł.

• Przykład 2) Mamy 0,35 kg mąki w cenie 5 zł. W takim przypadku quantity_type, to DECIMAL i cena produktu wynosi 5 zł.

string 

Y 

"quantity_type":"INTEGER"

products.quantity.quantity_unit

Jednostka ilości produktu 

string 

O 

"quantity_unit":"pcs"

products.quantity.available_quantity

Ilość dostępnego produktu sklepie 

number ($decimal) 

O 

"available_quantity":26

products.quantity.min_quantity 

Minimalna ilość produktu jaką klient może zamówić np. przy jednym zamówieniu 

number ($decimal) 

O 

"min_quantity": 2

products.quantity.max_quantity

Maksymalna ilość produktu jaką klient może zamówić np. przy jednym zamówieniu 

number ($decimal) 

O 

"max_quantity": 26

products.quantity.quantity_jump

Wartość skoku ilości w przypadku zwiększenia/zmniejszenia ilości produktu przez klienta (np. 0,1 lub 0,5 lub 0,01)

number ($decimal)    

O

"quantity_jump": 0.5

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 

products.delivery_product

Obiekt służący do przekazania informacji o dostępnych formach dostawy dla produktu. Jeśli brak obiektu delivery_product, to oznacza że dostawa dostępna wszystkimi typami

array

O

products.delivery_product.delivery_type

Typ dostawy

string

O

products.delivery_product.if_delivery_available

Flaga informująca czy typ dostawy jest dostępny.

boolean

O

related_products

Obiekt służący do przekazania listy produktów sugerowanych dla danego koszyka, które klient może dodać z poziomu aplikacji InPost Pay 

array 

O 

related_products.product_id

Identyfikator produktu nadany przez merchanta 

string 

Y 

"product_id":26

related_products.product_category

Kategoria produktu nadana przez merchanta 

string 

O 

"product_category":20

related_products.ean 

Ean 

string 

O 

"ean":"0"

related_products.product_name

Nazwa produktu  

string 

Y 

"product_name":"Plecak washpapa"

related_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."

related_products.product_link

Link do produktu na stronie merchanta 

string 

O 

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

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

Preferowane format: png, jpg (rekomendacja: png bez tła) 

related_products.additional_product_images

Obiekt do przekazania dodatkowych zdjęć produktu (lista)

object

O

-

related_products.additional_product_images. small_size

Zdjęcie produktu. Preferowany rozmiar 360 x 352

string

Y

-

related_products.additional_product_images. normal_size

Zdjęcie produktu. Preferowany rozmiar 360 x 504

string

Y

-

related_products.base_price

Cena podstawowa z produkt 

object 

Y 

related_products.base_price.net

Cena netto 

number ($decimal)(10,2) 

Y 

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

related_products.base_price.gross

Cena brutto (netto + VAT) 

number ($decimal)(10,2) 

Y 

related_products.base_price.vat

VAT 

number ($decimal)(10,2) 

Y 

related_products.promo_price

Cena promocyjna produktu 

object 

O 

related_products.promo_price.net

Cena netto 

number ($decimal)(10,2) 

Y 

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

related_products.promo_price.gross

Cena brutto (netto + VAT) 

number ($decimal)(10,2) 

Y 

related_products.promo_price.vat

VAT 

number ($decimal)(10,2) 

Y 

related_products.lowest_price

Obiekt służący do przekazania najniższej ceny produktu z ostatnich 30 dni. Wymagane w celu obsłużenia dyrektywy Omibus. Obiekt należy przekazać obligatoryjnie w przypadku, gdy została przekazania cena promocyjna produktu (obiekt promo_price) oraz został przekazany kod promocyjny z "regulation_type": "OMNIBUS".

object 

O 

related_products.lowest_price.net

Cena netto 

number ($decimal)(10,2) 

Y 

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

related_products.lowest_price.gross

Cena brutto (netto + VAT) 

number ($decimal)(10,2) 

Y 

related_products.lowest_price.vat

VAT 

number ($decimal)(10,2) 

Y 

related_products.quantity

Obiekt do przekazania informacji o ilości produktu 

object 

Y 

related_products.quantity.quantity

Ilość produktu 

number ($decimal) 

Y 

"quantity":1

related_products.quantity.quantity_type

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

string 

Y 

"quantity_type":"INTEGER"

related_products.quantity.quantity_unit

Jednostka ilości produktu 

string 

O 

"quantity_unit":"pcs"

related_products.quantity.available_quantity

Ilość dostępnego produktu sklepie 

number($decimal) 

O 

"available_quantity":26

related_products.quantity.min_quantity 

Minimalna  ilość produktu jaką klient może zamówić np. przy jednym zamówieniu 

number ($decimal) 

O 

"min_quantity":2 

related_products.quantity.max_quantity

Maksymalna ilość produktu jaką klient może zamówić np. przy jednym zamówieniu 

number($decimal) 

O 

"max_quantity": 26

related_products.quantity.quantity_jump

Wartość skoku ilości w przypadku zwiększenia/zmniejszenia ilości produktu przez klienta (np. 0,1 lub 0,5 lub 0,01)

number ($decimal)    

O

"quantity_jump": 0.5

related_products.product_attributes

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

array 

O 

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

related_products.product_attributes.attribute_value

Wartość atrybutu 

string 

Y 

related_products.delivery_related_products

Obiekt służący do przekazania informacji o dostępnych formach dostawy dla produktu. Jeśli brak obiektu delivery_product, to oznacza że dostawa dostępna wszystkimi typami

array

O

related_products.delivery_related_products.delivery_type

Typ dostawy

string

O

related_products.delivery_related_products.if_delivery_available

Flaga informująca czy typ dostawy dostępna

boolean

O

related_products.delivery_related_products.if_delivery_free

Flaga informująca czy po dodaniu produktu sugerowanego do koszyka, klient będzie miał darmową dostawę. W przypadku, gdy if_delivery_free=true jest na danym produkcie sugerowanym, klientowi zostanie zaprezentowany odpowiedni komunikat na tym produkcie

boolean

O

consents

Obiekt służący do przekazania listy zgód dla danego koszyka.
Maksymalna ilość zgód dla koszyka: 10

array 

 Y

consents.consent_id

Id zgody nadawane przez merchanta 

string 

 Y

"consent_id":3

consents.consent_link

Link przekierowujący do pełnej treści zgodny np. do strony merchanta 

string 

 Y

"consent_link":"https://test.outofthebox.pl/zwroty-i-reklamacje/"

consents.label_link

Label do linku przekazanego w consent_link

string

O

"label_link": "Regulaminu",

consents.additional_consent_links

Obiekt służący do przekazania dodatkowego linku do zgody/regulaminu

object

O

consents.additional_consent_links.id

Id zgody nadawane przez merchanta

string

O

"id": "0"

consents.additional_consent_links.consent_link

Link przekierowujący do pełnej treści zgodny np. do strony merchanta

string

O

"consent_link": "https://uat.outofthebox.pl/privacy-policy/",

consents.additional_consent_links.label_link

Label do linku przekazanego w consent_link

string

O

"label_link": "Polityką prywatności"

consents.consent_description

Opis zgody, nie więcej niż 500 znaków 

string 

 Y

consent_description":"zwroty i reklamacje"

consents.consent_version

Wersja zgody 

string 

 Y

"consent_version":1

consents.requirement_type

Typ zgody. Dostępne wartości: Enum: [OPTIONAL, REQUIRED_ONCE, REQUIRED_ALWAYS ] 

OPTIONAL – Zgoda opcjonalna  

REQUIRED_ONCE - wymagana jednorazowo. Zgoda o takim typie i wersji będzie zapisana w profilu użytkownika, z informacją, że klient wyraził zgodę i w przypadku kolejnych koszyków będzie domyślnie zaznaczona. 

REQUIRED_ALWAYS - wymagana zawsze. Zgoda o takim typie i wersji nie jest zapisywana w profilu użytkownika. Klient za każdym razem musi wyrazić zgodę. 

string 

 Y

"requirement_type":"OPTIONAL"

merchant_store

Obiekt służący do przekazania cookie koszyka klienta w celu umożliwienia przejścia ze aplikacji InPost Pay do koszyka w sklepie merchanta

object

O

-

merchant_store.url

url sklepu 

string

Y

"url": "https://uat.outofthebox.pl/cart/",

merchant_store.cookies

Obiekt do przekazania cookie

array

Y

-

merchant_store.cookies.domain

Domena pliku cookie reprezentowana przez parę key-value

string

Y

"domain": "uat.outofthebox.pl",

merchant_store.cookies.key

Cookie key

string

Y

"key": "wp_woocommerce_session_f3cd21b400c074e165b59837d7a9d0a4",

merchant_store.cookies.value

Cookie value

string

Y

"value": "t_f13664beda2ec455d97546c1ddab8b%7C%7C1699438060%7C%7C1699434460%7C%7Cf77d310ce1f0440cb4812f5043736989",

merchant_store.cookies.path

Cookie path

string

Y

"path": "/",

merchant_store.cookies.expires

Czas wygaśnięcia pliku cookie lub maxAge

string($date-time)

O

"expires": "2025-01-16T14:17:02.486Z",

merchant_store.cookies.secure

Informacje o bezpieczeństwie plików cookie

boolean

O

"secure": false,

merchant_store.cookies.http_only

Informacje http o plikach cookie

boolean

O

"http_only": true,

merchant_store.cookies.same_site

Informacje o pliku cookie sameSite [ STRICT, LAX, NONE ]

string

O

"same_site": "LAX",

merchant_store.cookies.priority

Priorytet plików cookie [ LOW, MEDIUM, HIGH ]

string

O

"priority": "MEDIUM",

merchant_store.cookies.max_age

Maksymalny czas cookie

integer($int32)

O

"max_age": 0

Nazwa pola 

Opis  

Typ 

Wymagalność 

Dodatkowe uwagi 

inpost_basket_id 

Identyfikator koszyka nadawany przez aplikacje InPost Pay 

Dana nie wykorzystywana przez merchanta. Identyfikator docelowo wykorzystywany przez widget w celu umożliwienia prawidłowego przekierowania z poziomu widget do aplikacji InPost Pay 

string 

Y 

"inpost_basket_id": " 866e5bf6-4e8a-443e-98f5-f9b0c5c149dd"