Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Webhook jest efektywną i prostą metodą komunikacji pomiędzy aplikacjami pozwalający na wysyłanie powiadomień pod ustalony adres URL, bezpośrednio po zmianie statusu przesyłki. Dzięki temu zintegrowane aplikacje zewnętrzne zostają natychmiast powiadomione o wystąpieniu zmian bez wymogu powtarzającego się odpytywania API o status przesyłki.

Info


Dla środowiska produkcyjnego adres webhook można dodać na stronie https://manager.paczkomaty.pl/zaloguj  w zakładce Moje konto >API.

Dla środowiska sandbox adres webhook można dodać na stronie https://sandbox-manager.paczkomaty.pl/  w zakładce Moje konto >API.

Na tej stronie

Table of Content Zone
minLevel1
maxLevel7
Table of Contents


Struktura

Przekazany adres musi spełniać 3 podstawowe warunki

  • poprawna budowa adresu URL

  • dostęp do zasobu, do którego kieruje wprowadzony adres URL

  • zasób powinien odpowiedzieć kodem HTTP 200 na zapytanie GET


Przykładowa struktura adresu:

Code Block
languagehtml
https://www.serwer.pl:8080/katalog1/katalog2/plik.xxx

Gdzie:

  • https (protokół)

  • www.serwer.pl (adres)

  • 8080 (port)

  • /katalog1/katalog2/plik.xxx (ścieżka do pliku, proszę podawać małą literą)

Info

Należy pamiętać, że webhooki są wysyłane z zakresu adresów IP 91.216.25.0/24. Ten zakres adresów IP ma zastosowanie do webhooków wysyłanych w środowisku produkcujnym jak i sandbox.


Dane wysyłane w przypadku gdy przesyłka zostanie utworzona

Code Block
languagejson
{
  "event_ts": "2020-03-20 15:08:06 +0100",
  "event": "shipment_confirmed",
  "organization_id": 1,
  "payload": {
    "shipment_id": 49,
    "tracking_number": null"602677439331630337653846"
  }
}

Dane wysłane w przypadku gdy status przesyłki uległ zmianie

Code Block
languagejson
{
  "event_ts": "2020-03-20 15:08:42 +0100",
  "event": "shipment_status_changed",
  "organization_id": 1,
  "payload": {
    "shipment_id": 49,
    "status": "delivered",
    "tracking_number": null"602677439331630337653846"
  }
}

Dane wysyłane w przypadku gdy przesyłka zostanie utworzona w statusie offers_prepared (przesyłka tworzona w trybie ofertowym)

Code Block
languagejson
{
     "event_ts": "20202023-0312-1318 1012:4831:0158 +0100",
     "event": "offers_prepared",
     "organization_id": 1,
     "payload": {
          "shipment_id": 3491234567890,
           "offers": [
                {
                     "id": 4811421884561,
                      "status": "unavailable",
                      "expires_at": null,
        "rate": null,
        "currency": null,
        "rateadditional_services": null,[
          "email",
               "currencysms":
null,        ],
        "carrier": {
          "id": "additionalinpost_serviceslocker": [],
          "name": "InPost Paczkomaty",
            "carrier  "description": {"InPost Paczkomaty - Przesyłki paczkomatowe"
        },
        "service": {
          "id": "inpost_locker_allegro",
                          "name": "InPost PaczkomatyAllegro Paczkomaty24/7 InPost",
          "description": "Przesyłka paczkomatowa Allegro Paczkomat 24/7 InPost"
        },
        "descriptionunavailability_reasons": "InPost[
Paczkomaty  -  Przesyłki  paczkomatowe"    {
            "key": "additional_service_email_unavailable",
           },
                "service": {
                    "id": "inpost_locker_standard_smart",
                    "name": "Paczkomatowa standardowa",
                    "description": "Przesyłka paczkomatowa standardowa"
                },
                "unavailability_reasons": [
                    {
                        "key": "allegro_email_invalid",
                        "message": "allegro_email_invalid"
                    }
                ]
            },
            {
                "id": 480,
                "status": "unavailable",
                "expires_at": null,
                "rate": null,
                "currency": null,
                "additional_services": [],
                "carrier": {
                    "id": "inpost_locker",
                    "name": "InPost Paczkomaty",
                      "message": "translation missing: keys.errors.messages.additional_service_email_unavailable"
          },
          {
            "key": "additional_service_sms_unavailable",
            "message": "translation missing: keys.errors.messages.additional_service_sms_unavailable"
          },
          {
            "key": "sending_method_required",
            "message": "sending_method_required"
          },
          {
            "key": "allegro_email_invalid",
            "message": "allegro_email_invalid"
          }
        ]
      },
      {
        "id": 1421884563,
        "status": "unavailable",
        "expires_at": null,
        "rate": null,
        "currency": null,
        "additional_services": [
          "email",
          "sms"
        ],
        "carrier": {
          "id": "inpost_locker",
          "name": "InPost Paczkomaty",
          "description": "InPost Paczkomaty - Przesyłki paczkomatowe"
        },
        "service": {
          "id": "inpost_locker_pass_thru",
          "name": "Podaj dalej",
          "description": "Przesyłka paczkomatowa Podaj Dalej"
        },
        "unavailability_reasons": [
          {
            "key": "additional_service_email_unavailable",
            "message": "translation missing: keys.errors.messages.additional_service_email_unavailable"
          },
          {
            "key": "additional_service_sms_unavailable",
            "message": "translation missing: keys.errors.messages.additional_service_sms_unavailable"
          },
          {
            "key": "dropoff_and_target_points_must_be_equal",
            "message": "Dropoff point and target point must be equal for selected service."
          }
        ]
      },
      {
        "id": 1421884564,
        "status": "unavailable",
        "expires_at": null,
        "rate": null,
        "currency": null,
        "additional_services": [
          "email",
          "sms"
        ],
        "carrier": {
          "id": "inpost_locker",
          "name": "InPost Paczkomaty",
          "description": "InPost Paczkomaty - Przesyłki paczkomatowe"
        },
        "service": {
         }  "id": "inpost_locker_standard",
          "name": "Paczkomatowa standardowa",
          "description": "Przesyłka paczkomatowa "servicestandardowa":
{        },
        "unavailability_reasons": [
          {
            "idkey": "inpostadditional_lockerservice_allegroemail_smartunavailable",
            "message": "translation missing: keys.errors.messages.additional_service_email_unavailable"
          },
        "name": "Allegro Paczkomaty24/7 InPost",
                    "description": "Przesyłka paczkomatowa Allegro Paczkomaty24/7 InPost"
                },
                "unavailability_reasons": [
                    {
                        "key": "invalid_target_point_function",
                        "message": "Invalid target point function."
                    },
                    {
                        "message": "allegro_email_invalid"
                    }
                ]
            },
            {
                "id": 479,
                "status": "available",
                "expires_at": "2020-03-13T10:53:01.852+01:00",
                "rate": null,
                "currency": "PLN",
                "additional_services": [],
                "carrier": {
                    "id": "inpost_courier",
                    "name": "InPost Kurier",
                    "description": "InPost Express - Przesyłki kurierskie"
                },
                "service": {
                      {
            "key": "additional_service_sms_unavailable",
            "message": "translation missing: keys.errors.messages.additional_service_sms_unavailable"
          }
        ]
      },
      {
        "id": 1421884566,
        "status": "unavailable",
        "expires_at": null,
        "rate": null,
        "currency": null,
        "additional_services": [
          "email",
          "sms"
        ],
        "carrier": {
          "id": "inpost_letter",
          "name": "InPost Listy",
          "description": "Inpost Letter - Przesyłki listowe"
        },
        "service": {
          "id": "inpost_letter_allegro",
          "name": "Allegro miniKurier24 InPost",
          "description": "Przesyłka listowa Allegro miniKurier24 InPost"
        },
        "unavailability_reasons": [
          {
            "key": "additional_service_email_unavailable",
            "message": "translation missing: keys.errors.messages.additional_service_email_unavailable"
          },
          {
            "key": "additional_service_sms_unavailable",
            "message": "translation missing: keys.errors.messages.additional_service_sms_unavailable"
          },
          {
            "key": "parcels_size_invalid",
            "message": "Parcel is too large or too heavy."
          },
          {
            "key": "sending_method_required",
            "message": "sending_method_required"
          },
          {
            "key": "allegro_email_invalid",
            "message": "allegro_email_invalid"
          }
        ]
      },
      {
        "id": 1421884567,
        "status": "unavailable",
        "expires_at": null,
        "rate": null,
        "currency": null,
        "additional_services": [
          "email",
          "sms"
        ],
        "carrier": {
          "id": "inpost_locker",
          "name": "InPost Paczkomaty",
          "description": "InPost Paczkomaty - Przesyłki paczkomatowe"
        },
        "service": {
          "id": "inpost_courier_c2callegro",
                          "name": "KurierAllegro Kurier24 standardInPost",
          "description": "Przesyłka kurierska Allegro Kurier24 InPost"
        },
        "descriptionunavailability_reasons": "Przesyłka[
kurierska  standardowa"        {
            "key": "additional_service_email_unavailable",
        },    "message": "translation missing: keys.errors.messages.additional_service_email_unavailable"
          },
         "unavailability_reasons": null
            },
            {
                "id": 478,
                "status": "available",
                "expires_at": "2020-03-13T10:53:01.674+01:00",
                "rate": null,
                "currency": "PLN",
                "additional_services": [],
                "carrier": {
                    "id": "inpost_courier",
                    "name": "InPost Kurier",
                    "description": "InPost Express - Przesyłki kurierskie"
                },
                "key": "allegro_email_invalid",
                "service": {
                    "id": "inpost_courier_local_super_express",
                    "name": "Kurier lokalny SuperExpress",
                    "description": "Przesyłka kurierska lokalna super expresowa"
                },
                "unavailability_reasons": null
            },
            {
                "id": 477,
                "status": "available",
                "expires_at": "2020-03-13T10:53:00.941+01:00",
                "rate": null,
                 {
            "key": "additional_service_sms_unavailable",
            "message": "translation missing: keys.errors.messages.additional_service_sms_unavailable"
          },
          {
            "key": "parcels_size_invalid",
            "message": "Parcel is too large or too heavy."
          },
          {
            "key": "sending_method_required",
            "message": "sending_method_required"
          },
          {
            "key": "allegro_email_invalid",
            "message": "allegro_email_invalid"
          }
        ]
      },
      {
        "id": 1421884568,
        "status": "available",
        "expires_at": "2023-12-18T12:36:58.279+01:00",
        "rate": null,
        "currency": "PLN",
        "additional_services": [
          "email",
          "sms"
        ],
        "carrier": {
          "id": "inpost_courier",
          "name": "InPost Kurier",
          "description": "InPost Express - Przesyłki kurierskie"
        },
        "service": {
          "id": "inpost_courier_standard",
          "name": "Kurier standard",
          "description": "Przesyłka kurierska standardowa"
        },
        "unavailability_reasons": null
      },
      {
        "id": 1421884569,
        "status": "available",
        "expires_at": "2023-12-18T12:36:58.279+01:00",
        "rate": null,
        "currency": "PLN",
        "additional_services": [
          "email",
          "sms"
        ],
        "carrier": {
          "id": "inpost_courier",
          "name": "InPost Kurier",
          "description": "InPost Express - Przesyłki kurierskie"
        },
        "service": {
          "id": "inpost_courier_express_1000",
          "name": "Kurier doręczenie 10:00",
          "description": "Przesyłka kurierska z doręczeniem do godziny 10:00 następnego dnia"
        },
        "unavailability_reasons": null
      },
      {
        "id": 1421884570,
        "status": "available",
        "expires_at": "2023-12-18T12:36:58.279+01:00",
        "rate": null,
        "currency": "PLN",
                     "additional_services": [],
          "email",
              "carrier": {
                      "sms"
        ],
        "carrier": {
          "id": "inpost_courier",
                          "name": "InPost Kurier",
                           "description": "InPost Express - Przesyłki kurierskie"
        },
        "service": {
           }"id": "inpost_courier_express_1200",
          "name": "Kurier doręczenie 12:00",
            "servicedescription": {"Przesyłka kurierska z doręczeniem do godziny 12:00 następnego dnia"
        },
           "idunavailability_reasons": "inpost_courier_local_express",
                    "name": "Kurier lokalny Express",
                    "description": "Przesyłka kurierska lokalna expresowa"
                },
                "unavailability_reasons": null
            },
            {
                "id": 476,
                "status": "available",
                "expires_at": "2020-03-13T10:53:00.344+01:00",
                "rate": null,
                "currency": "PLN",
                null
      },
      {
        "id": 1421884572,
        "status": "available",
        "expires_at": "2023-12-18T12:36:58.279+01:00",
        "rate": null,
        "currency": "PLN",
        "additional_services": [
          "email",
          "sms"
        ],
        "carrier": {
          "id": "inpost_courier",
          "name": "InPost Kurier",
          "description": "InPost Express - Przesyłki kurierskie"
        },
        "service": {
          "id": "inpost_courier_express_1700",
          "name": "Kurier doręczenie 17:00",
          "description": "Przesyłka kurierska z doręczeniem do godziny 17:00 następnego dnia"
        },
        "unavailability_reasons": null
      },
      {
        "id": 1421884574,
        "status": "unavailable",
        "expires_at": null,
        "rate": null,
        "currency": null,
        "additional_services": [],
          "email",
               "carriersms":
{        ],
        "carrier": {
               "id": "inpost_courierlocker",
                           "name": "InPost KurierPaczkomaty",
                           "description": "InPost ExpressPaczkomaty - Przesyłki kurierskiepaczkomatowe"
                     },
                     "service": {
                          "id": "inpost_courier_local_standardc2c",
          "name": "Kurier standard",
               "name    "description": "KurierPrzesyłka lokalnykurierska Standardstandardowa",
        },
        "unavailability_reasons": [
          {
      "description      "key": "Przesyłka kurierska lokalna standardowa"
               additional_service_email_unavailable",
            "message": "translation missing: keys.errors.messages.additional_service_email_unavailable"
          },
          {
               "unavailability_reasons": null
             "key": "additional_service_sms_unavailable",
            "message": "translation missing: keys.errors.messages.additional_service_sms_unavailable"
          },
                 {
            "key": "sending_method_required",
              "idmessage": 475,
                "status": "available",
               "sending_method_required"
          }
        ]
      },
      {
        "id": 1421884576,
        "status": "unavailable",
        "expires_at": "2020-03-13T10:52:59.408+01:00"null,
        "rate": null,
              "ratecurrency": null,
        "additional_services": [
          "email",
        "currency":  "PLNsms",
        ],
        "carrier": {
          "additional_servicesid": []"inpost_locker",
          "name": "InPost Paczkomaty",
            "carrier  "description": {"InPost Paczkomaty - Przesyłki paczkomatowe"
        },
        "service": {
          "id": "inpost_courierlocker_standard_smart",
                          "name": "InPostPaczkomatowa Kurierstandardowa",
          "description": "Przesyłka paczkomatowa standardowa"
        },
          "descriptionunavailability_reasons": "InPost[
Express  -  Przesyłki  kurierskie"    {
            "key": "additional_service_email_unavailable",
           },
                "service": {
                    "id": "inpost_courier_express_1700",
                    "name": "Kurier doręczenie 17:00",
                    "description": "Przesyłka kurierska z doręczeniem do godziny 17:00 następnego dnia"
                },
                "unavailability_reasons": null
            },
            {
                "id": 474,
                "status": "available",
                "expires_at": "2020-03-13T10:52:59.054+01:00",
                "rate": null,
                "currency": "PLN",
                "additional_services": [],
                "carrier": {
                    "id": "inpost_courier",
                    "name": "InPost Kurier",
                    "description": "InPost Express - Przesyłki kurierskie"
                },
                "service": {
                    "id": "inpost_courier_express_1200",
                    "name": "Kurier doręczenie 12:00",
                    "description": "Przesyłka kurierska z doręczeniem do godziny 12:00 następnego dnia"
                },
                "unavailability_reasons": null
            },
            {
                "id": 473,
                "status": "available",
                "expires_at": "2020-03-13T10:52:57.679+01:00",
                "rate": null,
                "currency": "PLN",
                "additional_services": [],
                "carrier": {
                    "id": "inpost_courier",
                    "name": "InPost Kurier",
                    "description": "InPost Express - Przesyłki kurierskie"
                },
                "service": {
                    "id": "inpost_courier_express_1000",
                    "name": "Kurier doręczenie 10:00",
                    "description": "Przesyłka kurierska z doręczeniem do godziny 10:00 następnego dnia"
                },
                "unavailability_reasons": null
            },
            {
                "id": 472,
                "status": "unavailable",
                "expires_at": null,
                "rate": null,
                "currency": null,
                "additional_services": [],
                "carrier": {
                    "id": "inpost_courier",
                    "name": "InPost Kurier",
                    "description": "InPost Express - Przesyłki kurierskie"
                },
                "service": {
                    "id": "inpost_courier_allegro",
                    "name": "Allegro Kurier24 InPost",
                    "description": "Przesyłka kurierska Allegro Kurier24 InPost"
                },
                "unavailability_reasons": [
                    {
                        "key": "parcels_size_invalid",
                        "message": "Parcel is too large or too heavy."
                    },
                    {
                        "message": "allegro_email_invalid"
                    }
                ]
            },
            {
                "id": 471,
                "status": "available",
                "expires_at": "2020-03-13T10:52:57.115+01:00",
                "rate": null,
                "currency": "PLN",
                "additional_services": [],
                "carrier": {
                    "key": "allegro_email_invalid",
                    "id": "inpost_courier",
                    "name": "InPost Kurier",
                    "description": "InPost Express - Przesyłki kurierskie"
                },
                "service": {
                    "id": "inpost_courier_standard",
                    "name": "Kurier standard",
                    "description": "Przesyłka kurierska standardowa"
                },
                "unavailability_reasons": null
            },
            {
                "id": 470,
                "status": "unavailable",
                "expires_at": null,
                "rate": null,
                "currency": null,
                "additional_services": [],
                "carrier": {
                    "id": "inpost_letter",
                    "name": "InPost Listy",
                    "description": "Inpost Letter - Przesyłki listowe"
                },
                "service": {
                    "id": "inpost_letter_allegro",
                    "name": "Allegro miniKurier24 InPost",
                    "description": "Przesyłka listowa Allegro miniKurier24 InPost"
                },
                "unavailability_reasons": [
                    {
                        "key": "parcels_size_invalid",
                        "message": "Parcel is too large or too heavy."
                    },
                    {
                        "message": "allegro_email_invalid"
                    }
                ]
            },
            {
                "id": 469,
                "status": "unavailable",
                "expires_at": null,
                "rate": null,
                "currency": null,
                "additional_services": [],
                "key": "allegro_email_invalid",
                "carrier": {
                    "id": "inpost_locker",
                    "name": "InPost Paczkomaty",
                    "description": "InPost Paczkomaty - Przesyłki paczkomatowe"
                },
                "service": {
                    "id": "inpost_locker_pass_thru",
                    "name": "Podaj dalej",
                    "description": "Przesyłka paczkomatowa Podaj Dalej"
                },
                "unavailability_reasons": [
                    {
                        "key": "dropoff_and_target_points_must_be_equal",
                        "message": "Dropoff point and target point must be equal for selected service."
                    }
                ]
            },
            {
                "id": 468,
                "status": "unavailable",
                "expires_at": null,
                "rate": null,
                "currency": null,
                "additional_services": [],
                "carrier": {
                    "id": "inpost_locker",
                    "name": "InPost Paczkomaty",
                    "description": "InPost Paczkomaty - Przesyłki paczkomatowe"
                },
                "service": {
                    "id": "inpost_locker_allegro",
                    "name": "Allegro Paczkomaty24/7 InPost",
                    "description": "Przesyłka paczkomatowa Allegro Paczkomaty24/7 InPost"
                },
                "unavailability_reasons": [
                    {
                        "key": "invalid_target_point_function",
                        "message": "Invalid target point function."
                    },
                    {
                        "message": "allegro_email_invalid"
                    }
                ]
            },
            {
                "key": "allegro_email_invalid",
                "id": 467,
                "status": "unavailable",
                "expires_at": null,
                "rate": null,
                "currency": null,
                "additional_services": [],
                "carrier": {
                    "id": "inpost_locker",
                    "name": "InPost Paczkomaty",
                    "description": "InPost Paczkomaty - Przesyłki paczkomatowe"
                },
                "service": {
                    "id": "inpost_locker_standard",
                    "name": "Paczkomatowa standardowa",
                    "description": "Przesyłka paczkomatowa standardowa"
                },
                "unavailability_reasons": [
                    {
                        "target_point": "translation missing: keys.errors.attributes.target_point.invalid"
                    }
                ]
            }
        ]
    "message": "translation missing: keys.errors.messages.additional_service_email_unavailable"
          },
          {
            "key": "additional_service_sms_unavailable",
            "message": "translation missing: keys.errors.messages.additional_service_sms_unavailable"
          },
          {
            "key": "allegro_email_invalid",
            "message": "allegro_email_invalid"
          }
        ]
      },
      {
        "id": 1421884577,
        "status": "unavailable",
        "expires_at": null,
        "rate": null,
        "currency": null,
        "additional_services": [
          "email",
          "sms"
        ],
        "carrier": {
          "id": "inpost_locker",
          "name": "InPost Paczkomaty",
          "description": "InPost Paczkomaty - Przesyłki paczkomatowe"
        },
        "service": {
          "id": "inpost_locker_allegro_smart",
          "name": "Allegro Paczkomaty24/7 InPost",
          "description": "Przesyłka paczkomatowa Allegro Paczkomat 24/7 InPost"
        },
        "unavailability_reasons": [
          {
            "key": "additional_service_email_unavailable",
            "message": "translation missing: keys.errors.messages.additional_service_email_unavailable"
          },
          {
            "key": "additional_service_sms_unavailable",
            "message": "translation missing: keys.errors.messages.additional_service_sms_unavailable"
          },
          {
            "key": "sending_method_required",
            "message": "sending_method_required"
          },
          {
            "key": "allegro_email_invalid",
            "message": "allegro_email_invalid"
          }
        ]
      }
    ]
  }
}

Dane wysyłane w przypadku gdy przesyłka otrzyma status ZDN (Zwrot do Nadawcy - returned_to_sender)

Code Block
languagejson
{
"event_ts": "2023-05-23 14:56:01 +0200",
"event": "shipment_status_changed",
"organization_id": 12345,
"payload": {
"shipment_id": 709709700,
"status": "returned_to_sender",
"tracking_number": "630055758325001130630004",
"return_tracking_number": "520107015145404000176000"
 }
}