Versions Compared

Old Version 5

changes.mady.by.user Michał Machowski

Saved on

compared with

New Version Current

changes.mady.by.user Michał Machowski

Saved on

Key

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

Dodanie możliwości przekazywania serwisów SMART przy tworzeniu przesylek (inpost_locker_standard_smart, przesyłek inpost_locker_allegro_smart)

panel

bgColor#f0f0f0titleBGColor#f0f0f0title

Na tej stronie

Table of Contents
minLevel2
 

Struktura

Zasób Shipment dla przesyłek Allegro Smart posiada takie same atrybuty jak

w Tworzenie przesyłki w trybie

w trybie uproszczonym. Jedyną różnicą jest parametr cod:

Parametr

Typ

Opis

Walidacja

cod

CodForm

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ć 

postać stałykodnadawcy+identyfikatortransakcji@allegromail.com, na

przykład 

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 

serwisu  inpost_locker_

standard lub 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

- Paczkomaty 24/7:bez Allegro Smart  Metoda dostawy - Allegro Paczkomaty

-

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

    •  Allegro 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

    infoUwaga!

    Note

    title

    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 [1.9.0] Tworzenie przesyłki w trybie uproszczonym.


    Przykładowe zapytanie do tworzenia paczki dla

    metody

    metody dostawy - Allegro

    Paczkomaty

    Paczkomat® 24/7 InPost:

    Code Block

    POST /

    languagejson
    curl --location 'https://api-shipx-pl.easypack24.net/v1/organizations/

    123

    115/shipments'

    HTTP/1.1 Host: api-shipx-pl.easypack24.net 

    \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer

    lkfjasd9f70y43ohriw

    eyJhbGciOiJSUzI...

    [ommited

    '

    for brevity]... 

    \
--data-raw '{
    "

    comments

    sender": {

    "dowolny komentarz",

            "

    receiver

    company_name":

    {

    "Company_name",
        "first_name": "

    Jan

    first_name",
        "last_name": "

    Kowalski

    last_name",
        "

    name

    email": "

    Nazwa

    test@grupainteger.pl",
        "

    email

    phone": "

    jinfq3pjv+4c5547c60@user.allegrogroup.pl",

    321321321",
        "address": {
            "

    phone

    street": "

    888000000

    Czerniakowska",
            "

    address

    building_number":

    {

    "87A",
            "

    id

    city": "

    123

    Warszawa",
            "

    street

    post_code": "

    Malborska

    00-718",
            "

    building

    country_

    number

    code": "

    130"

    PL"
        }
    },
    "receiver": {
        "

    city

    company_name": "

    Kraków

    company_name",
        "first_name": "first_name",
        "

    post

    last_

    code

    name": "

    30-624

    last_name",
        "email": "kz9576590l+378a831e0@user.allegrogroup.pl",
        "

    country_code

    phone": "

    PL

    888000000"

    }

    
    },
    "parcels": [
        {
            "template": "medium"
        }
    ],
    "custom_attributes": {
        "sending_method": "dispatch_order",
        "target_point": "

    BBI01A

    KRA012"
    },
    "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/
    1234567890
    12280001",
    "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":
    1
    1070,
    "created_by_id": null,
    "external_customer_id": null,
    "sending_method":
    null
    "dispatch_order",
    "
    mpk
    end_of_week_collection":
    null
    false,
    "comments": null,
    "mpk"
    dowolny
    :
    komentarz"
    null,
    "additional_services": [],
    "custom_attributes": {
        "target_point": "
    BBI01A
    KRA012",
        "sending_method": "dispatch_order"
    },
    "cod": {
        "amount": null,
        "currency": null
    },
    "insurance": {
        "amount":
    null
    5000,
        "currency":
    null
    "PLN"
    },
    "sender": {
        "id":
    2860
    24563418,
        "name": null,
        "company_name": "
    Inittec Sp. z o.o. (API Tests)
    Company_name",
        "first_name": "
    Robert
    first_name",
        "last_name": "
    Dzikowski
    last_name",
        "email": "
    rdzikowski@grupainteger
    test@grupainteger.pl",
        "phone": "
    121323123
    321321321",
        "address": {
            "id":
    2824
    23260657,
            "street": "
    Zawiła
    Czerniakowska",
            "building_number": "
    65 L
    87A",
            "line1": null,
            "line2": null,
            "city": "
    Kraków
    Warszawa",
            "post_code": "
    30
    00-
    390
    718",
            "country_code": "PL"
        }
    },
    "receiver": {
        "id":
    2859
    24563417,
        "name":
    "Nazwa"
    null,
        "company_name":
    null
    "company_name",
        "first_name": "
    Jan
    first_name",
        "last_name": "
    Kowalski
    last_name",
        "email": "
    jinfq3pjv
    kz9576590l+
    4c5547c60@user
    378a831e0@user.allegrogroup.pl",
        "phone": "888000000",
        "address":
    {
    null
    "id": 2823
    },
    "street
    "selected_offer":
    "Malborska", 
    null,
    "building_number
    "offers":
    "130"
    [],
    "line1
    "transactions":
    null, 
    [],
    "
    line2
    parcels":
    null,
    [
        {
    "city":
    "Kraków", 
            
    "
    post_code
    id":
    "30-624"
    13041562,
            "
    country_code": "PL" } }, "selected_offer": null, "offers": []
    identify_number": null,
    "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"
}