Versions Compared

Key

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

Dodanie możliwości przekazywania serwisów SMART przy tworzeniu przesyłek inpost_locker_allegro_smart

Na tej stronie

Table of Contents

Struktura

Zasób Shipment dla przesyłek Allegro Smart posiada takie same atrybuty jak w trybie uproszczonym. Jedyną różnicą jest parametr cod:

Parametr

Typ

Opis

Walidacja

cod

Cod

Wartość pobrania.

Atrybut nie jest wymagany.


Uwierzytelnianie

Dostęp do zasobu wymaga podania prawidłowego i ważnego access tokenu.


Dotychczasowe paczki allegro

W przypadku przesyłek allegro nie ma już wymagania wysyłania w custom_attributes parametrów allegro_transaction_id oraz allegro_user_id, wystarczy wysłać kompletny zamaskowany email allegro,  e-mail będzie mieć postać stałykodnadawcy+identyfikatortransakcji@allegromail.com, na przykład 8awgqyk6a5+cub31c122@allegromail.com.


Tworzenie paczek SMART

Paczki z serwisami SMART można tworzyć jedynie na email z domeny allegro:

W przypadku gdy na dany email został już wykorzystany limit SMART, serwis zostanie automatycznie zmieniony na jego odpowiednik bez _smart.

W przypadku podania emaila z domeny allegro i serwisu  inpost_locker_allegro, gdy na dany email przysługuje klientowi limit SMART, serwis zostanie automatycznie zmieniony na jego odpowiednik ze _smart


Poniżej przedstawiamy jakich serwisów należy użyć dla dostępnych metod dostawy:

Metoda dostawy - Allegro Paczkomaty Paczkomat® 24/7 InPost:

  • bez Allegro Smart   -   używamy serwisu inpost_locker_allegro

  • z Allegro Smart  -   używamy serwisu inpost_locker_allegro serwis zostanie zmieniony na inpost_locker_allegro_smart gdy smart gdy na dany email przysługuje klientowi limit SMART

Note

Błędny serwis dla metody dostawy

W przypadku podania nieodpowiedniego serwisu dla metody dostawy (np. serwisu inpost_locker_standard dla metody Allegro Paczkomaty Paczkomat® 24/7), usługa SMART nie będzie dostępna.


Przykładowe zapytania dostępne są na stronie Tworzenie stronie [1.9.0] Tworzenie przesyłki w trybie uproszczonym.


Przykładowe zapytanie do tworzenia paczki dla metody dostawy - Allegro Paczkomaty Paczkomat® 24/7 InPost:

Code Block
languagejson
POST /curl --location 'https://api-shipx-pl.easypack24.net/v1/organizations/123115/shipments HTTP/1.1
Host: api-shipx-pl.easypack24.net
' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer lkfjasd9f70y43ohriweyJhbGciOiJSUzI...[ommited' for brevity]...
  
\
--data-raw '{
    "commentssender": {
 "dowolny  komentarz",     "receivercompany_name": {"Company_name",
        "first_name": "Janfirst_name",
        "last_name": "Kowalskilast_name",
        "nameemail": "Nazwatest@grupainteger.pl",
        "emailphone": "jinfq3pjv+4c5547c60@user.allegrogroup.pl321321321",
        "phoneaddress": {
            "street": "888000000Czerniakowska",
        "address    "building_number": {"87A",
            "idcity": "123Warszawa",
            "streetpost_code": "Malborska00-718",
            "buildingcountry_numbercode": "130"PL"
        }
    },
    "receiver": {
        "citycompany_name": "Krakówcompany_name",
        "first_name": "first_name",
  "post_code      "last_name": "30-624last_name",
        "email": "kz9576590l+378a831e0@user.allegrogroup.pl",
        "country_codephone": "PL888000000"       
 }     },
    "parcels": [
        {
            "template": "medium"
        }
    ],
    "custom_attributes": {
        "sending_method": "dispatch_order",
        "target_point": "BBI01AKRA012"
    },
    "service": "inpost_locker_allegro",
    "reference": "Numer_zamówienia"
}'

W odpowiedzi serwer zwróci status 201

Code Block
languagejson
HTTP/1.1 201 CREATED
Content-Type: application/json
  
{
    "href": "https://api-shipx-pl.easypack24.net/v1/organizations/1/shipments/123456789012280001",
    "id": "1234567890"12280001,
    "status": "created",
    "tracking_number": null,
    "return_tracking_number": null,
    "service": "inpost_locker_allegro_smart",
    "reference": null"Numer_zamówienia",
    "is_return": false,
    "application_id": 11070,
    "created_by_id": null,
    "external_customer_id": null,
    "sending_method": null"dispatch_order",
    "mpkend_of_week_collection": nullfalse,
    "comments": "dowolny komentarz"null,
    "mpk": null,
    "additional_services": [],
    "custom_attributes": {
        "target_point": "KRA012",
        "BBI01A"sending_method": "dispatch_order"
    },
    "cod": {
        "amount": null,
        "currency": null
    },
    "insurance": {
        "amount": null5000,
        "currency": null"PLN"
    },
    "sender": {
        "id": 286024563418,
        "name": null,
        "company_name": "Inittec Sp. z o.o. (API Tests)Company_name",
        "first_name": "Robertfirst_name",
        "last_name": "Dzikowskilast_name",
        "email": "rdzikowski@grupaintegertest@grupainteger.pl",
        "phone": "121323123321321321",
        "address": {
            "id": 282423260657,
            "street": "ZawiłaCzerniakowska",
            "building_number": "65 L87A",
            "line1": null,
            "line2": null,
            "city": "KrakówWarszawa",
            "post_code": "3000-390718",
            "country_code": "PL"
        }
    },
    "receiver": {
        "id": 285924563417,
        "name": "Nazwa"null,
        "company_name": null"company_name",
        "first_name": "Janfirst_name",
        "last_name": "Kowalskilast_name",
        "email": "jinfq3pjvkz9576590l+4c5547c60@user378a831e0@user.allegrogroup.pl",
        "phone": "888000000",
        "address": {null
            "id": 2823,
 },
          "street"selected_offer": "Malborska",
       null,
    "building_numberoffers": "130",
       [],
    "line1transactions": null[],
 
          "line2"parcels": null,[
        {
   "city": "Kraków",
            "post_codeid": "30-624"13041562,
            "countryidentify_codenumber": "PL"
        }
    },
    "selected_offer": null,
    "offers": [],     "transactions": [],     "parcels": [
        {
            "id": 1494,
            "tracking_number": null,
            "is_non_standard": false,
            "template": "medium",
            "dimensions": {
                "length": 380.0,
                "width": 640.0,
                "height": 190.0,
                "unit": "mm"
            },
            "weight": {
                "amount": 25.0,
                "unit": "kg"
            }
        }
    ],
    "created_at": "2023-10-25T15:13:40.761+02:00",
    "updated_at": "2023-10-25T15:13:40.761+02:00"
}