Page Comparison

Ten artykuł zawiera listę zmian wprowadzonych w dokumentacji wraz z linkami do poszczególnych artykułów. Lista zmian jest uporządkowana według dat modyfikacji.

Kategoria zamian:

• Status
  colour Red title major

  - używana do określania zmian niekompatybilnych wstecznie lub przełomowych względem opublikowanej aktualnie dokumentacji oraz obowiązującej wersji interfejsu API.

• Status
  colour Yellow title minor

  - używana do określenia kolejnych przyrostów funkcjonalności w dokumentacji oraz interfejsu API, nie powodująca niekompatybilności.

• Status
  colour Green title patch

  - określająca zmiany/poprawki nie powodujące niekompatybilności wstecznej ani przyrostów funkcjonalności oraz zamiany informacyjne.

18.06.2024

Status
colour Yellow title MINOR

- Informacja o dostępnej dostawie dla produktu w koszyku

Merchant przekazując do InPost Pay koszyk będzie miał możliwość zdefiniowania jakie są dostępne metody dostawy dla danego produktu w koszyku oraz produktów powiązanych. Do przekazywania powyższej informacji służyć będą obiekty: 

delivery_product dla produktów

oraz delivery_related_products dla produktów powiązanych

Użytkownikowi aplikacji InPost Pay w szczegółach koszyka na produkcie, który ma niedostępną formę dostawy zostanie zaprezentowany odpowiedni komunikat.

Przykład:

Logika przekazywania informacji o dostępnych formach dostawy dla produktu:

Jeśli produkt w koszyku lub produkt powiązany ma dodatkowe ograniczenia w zakresie formy dostawy w stosunku do przekazanych form dostawy w obiekcie delivery, merchant powinien przekazać informacje o formach dostawy dla produktu w delivery_product lub dla produktów powiązanych w delivery_related_products zgodnie z logiką:

• Obiekt delivery_product/delivery_related_products  powinien zawierać informacje o wszystkich formach dostawy, które zostały przekazane w koszyku w obiekcie delivery (czyli jeśli w obiekcie delivery są zdefiniowane APM i CURRIER, to w delivery_product/delivery_related_products  powinna być również informacja o dostępności APM i CURRIER).

  • Jeśli merchant chce zdefiniować, że dana forma dostawy jest dostępna dla danego produktu, to powinien przekazać w delivery_type - forma dostawy np. "APM" i wartość flagi if_delivery_available=true.

    Code Block
    { "delivery_type": "APM" "if_delivery_available": true }

     

  • Jeśli merchant chce zdefiniować, że dana forma dostawy jest niedostępna dla danego produktu, to powinien przekazać w delivery_type - forma dostawy np. "APM" i wartość flagi if_delivery_available=false.

    Code Block
    { "delivery_type": "APM" "if_delivery_available": false }

     

• W przypadku, gdy w koszyku w obiekcie delivery są zdefiniowane więcej niż jedna forma dostawy (np. AMP i CURRIER) i merchant w produkcie w obiekcie delivery_product/delivery_related_products przekaże tylko informacje o dostępności jednej formy dostawy, to forma dostawy która nie została zdefiniowana w delivery_product/delivery_related_products będzie interpretowana jako niedostępna. 

  • Brak przekazania obiektu delivery_product/delivery_related_products w produkcie oznacza, że dla produktu są dostępne wszystkie formy dostawy, które zostały przekazane w delivery w koszyku.

Obiekt  delivery_product oraz delivery_related_products dodano do:

• Aktualizacja lub dodanie koszyka - Developer Documentations - Confluence (atlassian.net)

• Pobranie listy koszyków - Developer Documentations - Confluence (atlassian.net)

• Potwierdzenie powiązania koszyka - Developer Documentations - Confluence (atlassian.net)

• Pobranie szczegółów koszyka - Developer Documentations - Confluence (atlassian.net)

• Aktualizacja koszyka - Developer Documentations - Confluence (atlassian.net)

Status
colour Yellow title MINOR

- Informacja, czy po dodaniu produktu sugerowanego koszyk będzie miał darmową formę dostawy

W produkcie sugerowanym dla danego koszyka merchant ma możliwość przekazania informacji, czy po dodaniu produktu do koszyka wybrana forma dostawy będzie darmowa. Aby przekazać, że wybrana forma dostawy będzie darmowa w obiekcie delivery_related_products należy przekazać:

• formę dostawy w delivery_type,

• informacje czy dostawa jest dostępna if_delivery_available = true

• oraz czy po dodaniu produktu do koszyka dostępna będzie darmowa forma dostawy if_delivery_free=true. Przykład:

        {
          "delivery_type": "APM",
          "if_delivery_available": true,
          "if_delivery_free": true
        } 

Aplikacja InPost Pay po otrzymaniu if_delivery_free=true dla danego produktu sugerowanego zaprezentuje odpowiedni komunikat klientowi.

Dano if_delivery_free:

do API:

• Aktualizacja lub dodanie koszyka - Developer Documentations - Confluence (atlassian.net)

• Pobranie listy koszyków - Developer Documentations - Confluence (atlassian.net)

• Potwierdzenie powiązania koszyka - Developer Documentations - Confluence (atlassian.net)

• Pobranie szczegółów koszyka - Developer Documentations - Confluence (atlassian.net)

• Aktualizacja koszyka - Developer Documentations - Confluence (atlassian.net)

13.06.2024

Status
colour Red title MAJOR

- Obsługa Dyrektywy Omnibus

Wymaganie:

Merchant w przypadku zastosowania kodu, który spełnia warunki określone w Dyrektywie Omnibus na produkcie lub grupie produktów jest zobowiązany do przekazania informacji w szczegółach koszyka:​

• Wartość produktu po zastosowaniu kodu promocyjnego (products.promo_price)

• Oznaczenie kodu promocyjnego jako „OMNIBUS” (promo_codes."regulation_type": "OMNIBUS")​

• Wartość najniższej ceny produktu z ostatnich 30 dni przed wprowadzeniem promocji na produktach w koszyku dla których został zastosowanych kod omnibusowy (products.lowest_price)

​Opis biznesowy:

Przypadek 1: Wykorzystanie przez użytkownika kodu rabatowego merchanta​, który spełnia warunki określone w Dyrektywie OMNIBUS.

• Merchant musi oznaczyć kod promocyjny jako Omnibus​  (promo_codes."regulation_type": "OMNIBUS")

• ​Merchant musi przesłać dla każdego produktu, na który ma wpływ zastosowany kod Omnibusowy, cenę Omnibusową na koszyku oraz na szczegółach dodanego do koszyka produktu (products.lowest_price) oraz cenę promocyjną (products.promo_price) 

• W aplikacji InPost Pay na koszyku dla produktów, dla których został zastosowany kod Omnibusowy zostanie zaprezentowana zarówno cena do zapłaty (products.promo_price) pokazana na czerwono, oraz przekreśloną cenę Omnibusową wraz z informacją, że jest to najniższa cena z 30 dni przed wprowadzeniem promocji (products.lowest_price).

• Aplikacja InPost Pay w​ podsumowaniu koszyka nie będzie prezentowała wartość zastosowanego rabatu („Kod rabatowy sklepu”)​.

Przypadek 2: Wykorzystanie przez użytkownika kodu rabatowego merchanta, który nie spełnia warunków określonych w Dyrektywie OMNIBUS.

• Merchant nie powinien przesyłać dla produktów w koszyku ceny Omnibusowej​ (products.lowest_price) oraz (products.promo_price).

• Aplikacja InPost Pay zaprezentuje przy każdym produkcie cenę podstawową (products.base_price) na czarno.

• W przypadku gdy zostanie przekazana wartość w parametrze products.promo_price,tow aplikacji przy produkcie zostanie zaprezentowana cena z products.promo_pricena czarno.

• Aplikacja InPost Pay w podsumowaniu koszyka zaprezentuje informację „Kod rabatowy sklepu” wraz z sumą obniżki, jaka wynika z zastosowanych kodów rabatowych sklepu. Jeśli zostały zastosowane kody rabatowe na koszyku (nie na produkcie), to wartość zastosowanych rabatów powinna być uwzględniona w basket_promo_price i basket_final_price zgodnie z opisem w dokumentacji.

Dodano: regulation_type

do API:

• Aktualizacja lub dodanie koszyka

• Pobranie listy koszyków

• Potwierdzenie powiązania koszyka

• Pobranie szczegółów koszyka

• Aktualizacja koszyka

19.04.2024

Status
colour Yellow title MiNOR

- Umożliwienie klientowi przejścia do koszyka w sklepie Merchanta ze szczegółów koszyka w aplikacji InPost Pay.

Użytkownik aplikacji InPost Pay będzie miał możliwości z poziomu szczegółów powiązanego koszyka, przejść do koszyka w sklepie Merchanta. Funkcjonalność będzie dostępna dla koszyków, których Merchant przekaże dane w nowym obiekcie merchant_store umożlwiające poprawne przekierowanie do koszyka użytkownika w sklepie Merchanta z poziomu aplikacji InPost Pay

Dodano obiekt merchant_store

do API:

• Aktualizacja lub dodanie koszyka - Developer Documentations - Confluence (atlassian.net)

• Pobranie listy koszyków - Developer Documentations - Confluence (atlassian.net)

• Potwierdzenie powiązania koszyka - Developer Documentations - Confluence (atlassian.net)

• Pobranie szczegółów koszyka - Developer Documentations - Confluence (atlassian.net)

• Aktualizacja koszyka - Developer Documentations - Confluence (atlassian.net)

17.04.2024

Status
colour Yellow title MiNOR

- dodanie metody umożliwiającej sprawdzenie Merchantowi dostępnych metod płatności, jakimi mogą być opłacone utworzone zamówienia w aplikacji InPost Pay. 

https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/365330441/P+atno+ci#Pobranie-listy-dost%C4%99pnych-p%C5%82atno%C5%9Bci-w-InPost-Pay

28.03.2024

Status
colour Yellow title MiNOR

- Umożliwienie przekazania dodatkowych zdjęć produktów w koszyku.

Zmiana umożliwia przekazanie więcej, niż jednego zdjęcia produktu w koszyku. Po przekazaniu dodatkowych zdjęć, klient będzie miał możliwość w aplikacji InPost Pay na szczegółach produktu przejrzenia przesłanych zdjęć produktu, a tym samy uzyskanie dodatkowych informacji o kupowanym produkcie.

Dodano:

do API:

• Aktualizacja lub dodanie koszyka

• Potwierdzenie powiązania koszyka

• Pobranie szczegółów koszyka

• Aktualizacja koszyka

Status
colour Yellow title MiNOR

- Dodanie nowych miejsc osadzenia dla InPost Pay widget.

Nowe miejsca osadzenia widget:

• LOGIN_PAGE – strona logowania.

• CHECKOUT_PAGE – stona checkout

• REGISTERFORM_PAGE – strona rejestracji

• MINICART_PAGE - minikarta

Dodano: LOGIN_PAGE, CHECKOUT_PAGE, REGISTERFORM_PAGE, MINICART_PAGE do binding_place w request metody POST/v1/izi/basket/{basket_id}/binding

Status
colour Yellow title MiNOR

- Dodanie flagi if_delivery_free w produkcie sugerowanym w koszyku.

w API:

• Aktualizacja lub dodanie koszyka

• Pobranie listy koszyków

• Potwierdzenie powiązania koszyka

• Pobranie szczegółów koszyka

• Aktualizacja koszyka

27.03.2024

Status
colour Green title PATCH

- Dodanie maksymalnej ilości zgód w koszyku.

Maksymalna ilość obsługiwanych zgód dla koszyka to 10. W przypadku, gdy w obiekcie consents dla koszyka zostanie przekazanych więcej niż 10 zgód, to w aplikacji InPost Pay będzie obsługiwanych dziesięć pierwszych zgód z obiektu consents. Opis obiektu consents zaktualizowany w artykułach:

• Aktualizacja lub dodanie koszyka - Developer Documentations - Confluence (atlassian.net)

• Pobranie listy koszyków - Developer Documentations - Confluence (atlassian.net)

• Potwierdzenie powiązania koszyka - Developer Documentations - Confluence (atlassian.net)

• Pobranie szczegółów koszyka - Developer Documentations - Confluence (atlassian.net)

06.03.2024

Status
colour Yellow title MINOR

- Przekazanie więcej, niż jednego linku dla jednej zgody w koszyku do InPost Pay.

Zmiana umożliwia obsługę i prezentacje zgód w aplikacji InPost Pay które mają więcej niż jeden link w treści

Obiekt consents rozszerzony w api:

• Aktualizacja lub dodanie koszyka - Developer Documentations - Confluence (atlassian.net)

• Pobranie listy koszyków - Developer Documentations - Confluence (atlassian.net)

• Potwierdzenie powiązania koszyka - Developer Documentations - Confluence (atlassian.net)

• Pobranie szczegółów koszyka - Developer Documentations - Confluence (atlassian.net)

o dane:

Status
colour Yellow title MINOR

- Umożliwienie przekazania dodatkowego identyfikatora zamówienia przez Merchanta.

Zmiana umożliwia przekazania dodatkowego identyfikatora zamówienia w przypadku, gdy Merchant ma rozwiązanie obsługi zamówień oparte o dwa identyfikatory (jeden służący do komunikacji pomiędzy systemami, drugi do komunikacji i prezentacji klientowi).

Dodano:

w api:

• Pobranie listy zamówień - Developer Documentations - Confluence (atlassian.net)

• Utworzenie zamówienia - Developer Documentations - Confluence (atlassian.net)

• Pobranie szczegółów zamówienia - Developer Documentations - Confluence (atlassian.net)

Status
colour Yellow title MINOR

- Dodanie pola umożliwiającego przekazania przez Merchanta informacji o wartości zastosowanych rabatów w zamówieniu.

Wartość będzie prezentowana klientowi na podsumowaniu zamówieniu w aplikacji InPost Pay. Dodano:

 w api:

• Pobranie listy zamówień - Developer Documentations - Confluence (atlassian.net)

• Utworzenie zamówienia - Developer Documentations - Confluence (atlassian.net)

• Pobranie szczegółów zamówienia - Developer Documentations - Confluence (atlassian.net)

26.02.2024

Status
colour Yellow title MINOR

- Dodano nowy parametr min_height w kodzie widgetu - Widget - frontend

07.02.2024

Status
colour Yellow title MINOR

- Aktualizacja opisu parametru lowest_price w zakresie wymagalności dla metod:

• Aktualizacja lub dodanie koszyka

• Pobranie listy koszyków

• Potwierdzenie powiązania koszyka

• Pobranie szczegółów koszyka

• Aktualizacja koszyka

Parametr lowest_price należy przekazać obligatoryjnie, gdy została przekazana cena promocyjna promo_price.

29.01.2024

Status
colour Green title PATH

- Aktualizacja opisu parametrów account_info.mail i delivery.mailw opisie metody służącej do utworzenia zamówienia-Utworzenie zamówienia

18.12.2023

Status
colour Green title PATCH

- Aktualizacji opisu metod udostępnionych przez InPost Pay (Basket App) poprzez podanie fragmentów kodu i przykładów implementacji w języku PHP.

14.12.2023

Status
colour Green title PATCH

- Aktualizacja opisu dla parametru order_id metody GET /v1/izi/transaction w Zwroty i transakcje

13.12.2023

Status
colour Red title MAJOR

- Dodano nowe parametry max_width oraz frame_style w kodzie html widgetu https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/131072001/Widget+-+frontend#Osadzenie-html

08.11.2023

Status
colour Green title PATCH

- Aktualizacja opisu dla metody iziBindingDelete o uwagi dla developera w https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/131072001/Widget+-+frontend#iziBindingDelete

03.11.2023

Status
colour Green title PATCH

- Aktualizacja opisu dla parametrów summary.basket_final_price i summary.basket_promo_price w Aktualizacja lub dodanie koszyka ,Potwierdzenie powiązania koszyka ,Pobranie szczegółów koszyka , Aktualizacja koszyka.

30.10.2023

Status
colour Green title PATCH

Uzupełnienie opisu metod iziGetPayData, iziGetIsBound, iziAddToCart dla Widget frontend o przykłady implementacji i przykłady odpowiedzi. Uzupełnienie opisu używanych parametrów o przykłady zastosowania dla https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/131072001/Widget+-+frontend#Osadzenie-html

12.10.2023

Status
colour Green title PATCH

Aktualizacja Swagger o opis dla obiektu related_products_event_data - Merchant Backend API

02.10.2023

Status
colour Green title PATCH

Uzupełniono opis metod dla InPost API i Merchant Backend API wraz z parametrami

27.09.2023

Status
colour Green title PATCH

Aktualizacja Swagger - InPost Pay (Basket App)

Status
colour Green title PATCH

Aktualizacja Swagger - Merchant Backend API

15.09.2023

Status
colour Green title PATCH

Aktualizacja Swagger o opis dla delivery_options - InPost Pay (Basket App)

Status
colour Green title PATCH

Aktualizacja Swagger o opis dla delivery_options - Merchant Backend API

Status
colour Yellow title MINOR

Aktualizacja opisu iziMobileLink - https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/131072001/Widget+-+frontend#iziMobileLink

07.09.2023

Status
colour Yellow title minor

Aktualizacja Swagger o dodanie free_delivery_minimum_gross_price do metod zwracających szczegóły koszyka i opisanie kodów błędów dla metod API - InPost Pay (Basket App)

Status
colour Yellow title minor

Aktualizacja Swagger o dodanie free_delivery_minimum_gross_price do metod zwracających szczegóły koszyka i opisanie kodów błędów dla metod API - Merchant Backend API

28.08.2023

Status
colour Red title major

Aktualizacja Swagger o dodanie wymagalności pola order_final_price - InPost Pay (Basket App)

Status
colour Red title major

Aktualizacja Swagger o dodanie wymagalności pola order_final_price, usunięcie obiektu address_details z response POST/v1/izi/order oraz GET/v1/izi/order/{order_id} - Merchant Backend API

25.08.2023

Status
colour Yellow title minor

Aktualizacja Swagger - Merchant Backend API

08.08.2023

Status
colour Yellow title minor

Uaktualnienie sandbox / prod js link - https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/131072001/Widget+-+frontend#Pobranie-skryptu

07.08.2023

Status
colour Green title patch

Dodano opis dla wartości pola binding_place - https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/131072001/Widget+-+frontend#Osadzenie-html

Status
colour Yellow title minor

Aktualizacja Swagger o dopisanie kodów błędów - InPost Pay (Basket App)

04.08.2023

Status
colour Green title patch

Zaktualizowano diagramy sekwencji wraz z opisem dla:

• https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/136806401/Diagramy+sekwencji+dla+InPost+Pay+Widget#UC.02-Wi%C4%85zanie-koszyka-z-InPost-Pay-z-wykorzystaniem-qrCode

• https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/136806401/Diagramy+sekwencji+dla+InPost+Pay+Widget#UC.03-Wi%C4%85zanie-koszyka-z-InPost-Pay-z-wykorzystaniem-numeru-telefonu

• https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/136806401/Diagramy+sekwencji+dla+InPost+Pay+Widget#UC.04-Synchronizacja-koszyka-oraz-zam%C3%B3wienia

Status
colour Yellow title minor

Aktualizacja Swagger - Merchant Backend API

02.08.2023

Status
colour Yellow title minor

Aktualizacja w Swagger dla
DELETE /v1/izi/basket/{basket_id}/binding oraz DELETE /v1/izi/browser/{browser_id}/binding -InPost Pay (Basket App)
POST /v1/izi/order - Merchant Backend API

01.08.2023

Status
colour Yellow title MINOR

Zaktualizowano diagram sekwencji dla koszyka powiązanego z InPost Pay - https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/136806401/Diagramy+sekwencji+dla+InPost+Pay+Widget#UC.01-Koszyk-powi%C4%85zany-z-InPost-Pay

31.07.2023

Status
colour Yellow title MINOR

Zaktualizowano html w sekcji Osadzanie HTML - https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/131072001/Widget+-+frontend#Osadzenie-html

Status
colour Yellow title MINOR

Dodano informacje o wyświetlaniu w zależności od danych z serwera - https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/131072001/Widget+-+frontend#Wy%C5%9Bwietlanie-w-zale%C5%BCno%C5%9Bci-od-parametr%C3%B3w-bindowania

21.07.2023

Status
colour Green title patch

Aktualizacja opisu dla “Połączenie koszyka z innym numerem telefonu (Usunięcie/desynchronizacja koszyka powiązanego z InPost Pay) [12-22]: “ - https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/136806401/Diagramy+sekwencji+dla+InPost+Pay+Widget#UC.01-Koszyk-powi%C4%85zany-z-InPost-Pay

18.07.2023

Status
colour Yellow title minor

Uzupełnienie iziGetOrderComplete i dodanie informacji o aktualizacji liczby produktów na przycisku - Widget - frontend

Status
colour Yellow title minor

Dodano iziGetBrowserData; handleThankYouNode; opis BrowserId - https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/131072001/Widget+-+frontend#iziGetBrowserData

Status
colour Green title patch

Poprawiono opis iziAddToCart - https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/131072001/Widget+-+frontend#iziAddToCart

07.07.2023

Status
colour Yellow title minor

Aktualizacja opisu “Signature verification algorithm” - https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/158728206/Merchant+Backend+API#Algorytm-weryfikacji-sygnatury

06.07.2023

Status
colour Yellow title minor

Aktualizacja w obszarze Widget - frontend:

Status
colour Yellow title minor

Dodanie iziGetPayData - https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/131072001/Widget+-+frontend#iziGetPayData / deprecated iziGetBingingData - https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/131072001/Widget+-+frontend#iziGetBindingData-(deprecated)

Status
colour Yellow title minor

Dodanie iziMobileLink - https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/131072001/Widget+-+frontend#iziMobileLink

05.07.2023

Status
colour Yellow title minor

Aktualizacja opisu “Signature verification algorithm” - https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/158728206/Merchant+Backend+API#Algorytm-weryfikacji-sygnatury

04.07.2023

Status
colour Green title patch

Uaktualnienie iziAddToCart - https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/131072001/Widget+-+frontend#iziAddToCart

Status
colour Green title patch

Uaktualnienie opisu metod

Status
colour Blue title GET

/v1/izi/baskets i

Status
colour Blue title GET

/v1/izi/orders w https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/129794052/InPost+Pay+Basket+App#InPost-Pay-API%5BhardBreak%5D

30.06.2023

Status
colour Yellow title minor

Uaktualnienie iziGetOrderComplete - https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/131072001/Widget+-+frontend#iziGetOrderComplete

29.06.2023

Status
colour Yellow title minor

Uaktualnienie iziGetIsBound - https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/131072001/Widget+-+frontend#iziGetIsBound%5BhardBreak%5D