Order Response | eConnect

Gdy jako dostawca otrzymają Państwo zamówienie, zmianę lub anulowanie, wysyłają Order Response, aby poinformować nabywcę o podjętych działaniach. Order Response jest kluczowym elementem profilu Peppol Advanced Ordering.

Endpoint

POST /api/v1/{partyId}/salesOrder/{documentId}/response

{partyId} to identyfikator Peppol dostawcy. {documentId} to ID odebranego zamówienia, na które się odpowiada.

Kody statusu

Order Response zawiera kod statusu wskazujący, co się zrobi z zamówieniem:

Kod

Nazwa

Kiedy stosować

Acknowledged

Zamówienie zostało odebrane i jest czytelne. Używane jako tymczasowe potwierdzenie podczas oceny zamówienia.

Accepted

Zamówienie jest w pełni akceptowane i zostanie zrealizowane.

Conditionally Accepted

Zamówienie jest akceptowane, ale ze zmianami (np. zmieniony czas dostawy lub ilości). Zmienione pozycje zamówienia dodaje się do odpowiedzi.

Rejected

Zamówienie jest odrzucane. Nabywca musi złożyć nowe zamówienie, jeśli zamówienie ma być mimo to zrealizowane.

Wskazówka: można wysyłać wiele odpowiedzi na to samo zamówienie. Można np. zacząć od AB (potwierdzenie odbioru), a później wysłać AP (zaakceptowane), gdy zamówienie zostanie wewnętrznie zatwierdzone.

Przykładowy przepływ

Typowy scenariusz Advanced Ordering:

Nabywca wysyła zamówienie przez POST /{partyId}/purchaseOrder/send
Dostawca odbiera zamówienie przez webhook OrderReceived
Dostawca pobiera zamówienie przez GET /{partyId}/salesOrder/{documentId}/download
Dostawca wysyła odpowiedź AB (potwierdzenie odbioru)
Dostawca ocenia zamówienie wewnętrznie
Dostawca wysyła odpowiedź AP (zamówienie zaakceptowane)
Nabywca odbiera odpowiedź przez webhook OrderResponseReceived

Akceptacja warunkowa (CA)

Przy odpowiedzi CA (Conditionally Accepted) wskazuje się, że zamówienie jest akceptowane, ale ze zmianami. Odpowiedź zawiera zmienioną wersję pozycji zamówienia. Nabywca może na tej podstawie zdecydować, czy zmienione zamówienie jest do zaakceptowania.

Możliwe powody odpowiedzi CA to m.in. zmieniony czas dostawy, zmieniona ilość (ograniczone zapasy) lub artykuły zastępcze.

Topiki webhook

Topik

Kierunek

Kiedy

OrderResponseSent

Dostawca

Odpowiedź została pomyślnie wysłana do nabywcy

OrderResponseReceived

Nabywca

Odpowiedź dostawcy została odebrana

Ciało żądania

Odpowiedź jest wysyłana jako dokument UBL OrderResponse XML w ciele żądania, z content-type application/xml. Dokument musi zawierać prawidłowe odwołanie do oryginalnego zamówienia.

Dokumentacja Swagger na psb.econnect.eu zawiera dokładną strukturę XML i wymagane pola.

Często zadawane pytania

Kiedy używać AB, AP, CA lub RE w Order Response?

AB oznacza, że zamówienie zostało otrzymane i jest czytelne, często jako krok pośredni. AP to pełna akceptacja i realizacja. CA to akceptacja ze zmianami; dodaje się skorygowane pozycje zamówienia. RE odrzuca zamówienie; kupujący musi wtedy złożyć nowe zamówienie, jeśli zakup ma zostać zrealizowany.

Czy mogę wysłać wiele Order Response dla tego samego zamówienia?

Tak. Można na przykład najpierw wysłać AB po przyjęciu zamówienia, a później AP po uzyskaniu wewnętrznej akceptacji. Odpowiada to typowemu łańcuchowi Advanced Ordering z webhookiem OrderResponseReceived po stronie kupującego.

Jak technicznie wywołać endpoint Order Response?

Należy użyć POST /api/v1/{partyId}/salesOrder/{documentId}/response z {partyId} jako identyfikatorem Peppol dostawcy i {documentId} jako ID otrzymanego zamówienia. Body to XML UBL OrderResponse z Content-Type: application/xml i prawidłowym odniesieniem do pierwotnego zamówienia.

Pełna specyfikacja API dostępna jest na psb.econnect.eu z przykładowymi payloadami i komunikatami o błędach.

Otwórz referencję API

Powiązane