Dla wszystkich metod dostawy, które dodajesz do cenników dostawy, możesz określić:

• cenę pierwszej sztuki w paczce,
• maksymalną liczbę sztuk przedmiotu w paczce,
• dopłatę za kolejne sztuki przedmiotu w paczce.

Co zmieniliśmy?

Od dziś przy wybranych metodach dostawy udostępniliśmy nową opcję, dzięki której możesz określić również maksymalną wagę jednej paczki.

Dlatego rozszerzyliśmy:

• GET /sale/delivery-methods - o nową strukturę deliveryMethods[].shippingRatesConstraints.maxPackageWeight z polami:
  • supported - flaga określająca, czy możesz definiować maksymalną wagę paczki dla danej metody dostawy,
  • min - minimalna dopuszczalna waga paczki,
  • max - maksymalna dopuszczalna waga paczki,
  • unit - jednostka wagi. Przykładowa struktura response’a:

```
{
    "id": "0e4c7d59-64b6-4b06-89c3-c1d941506dd0",
    "name": "Allegro Kurier UPS",
    "paymentPolicy": "IN_ADVANCE",
    "allegroEndorsed": false,
    "shippingRatesConstraints": {
       ...
        "maxPackageWeight": {
            "supported": true,        -- czy dopuszczamy możliwość
                                    zadeklarowania maksymalnej wagi
                                    paczki,
            "min": "15.000",        -- minimalna dopuszczalna wartość,
            "max": "20.000",        -- maksymalna dopuszczalna wartość,
            "unit": "KILOGRAM"        -- jednostka wagi.
        },
        ...
        }
    }
}
```

• POST /sale/shipping-rates oraz GET /sale/shipping-rates/{id} - o nową strukturę rates[].maxPackageWeight z polami:
  • value - wartość maksymalnej wagi paczki dla danej metody dostawy w cenniku dostawy,
  • unit - jednostka wagi. Przykładowy request:

```
curl -X POST \
‘https://api.allegro.pl/sale/shipping-rates’ \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Authorization: {token}' \
-H 'Content-Type: application/vnd.allegro.public.v1+json' \
-d ‘{
    "id": "74989fd0-0e91-47e6-b446-d77ebd2a6ac8",
    "name": "Cennik - elektronika",
    "rates": [{
            "deliveryMethod": {
                "id": "0e4c7d59-64b6-4b06-89c3-c1d941506dd0"
            },
            "maxQuantityPerPackage": 5,
            "maxPackageWeight": {
                "value": "19.000",        -- deklarowana maksymalna waga
                                        paczki,
                "unit": "KILOGRAM"        -- jednostka wagi, obecnie obsługujemy
                                        tylko ‘KILOGRAM’.
            },
            "firstItemRate": {
                "amount": "10.00",
                "currency": "PLN"
            },
            "nextItemRate": {
                "amount": "0.00",
                "currency": "PLN"
            },
            "shippingTime": null
        }
    ],
}’
```

Nie musisz podawać w cenniku maksymalnej wagi paczki – nie wymagamy tej wartości.

Uwzględnienie wagi przy wyliczeniu kosztu przesyłki w zamówieniu bazuje na parametrze “Waga produktu z opakowaniem jednostkowym” (id parametru: 17448).

Jeżeli chociaż jedna oferta w zamówieniu nie ma uzupełnionego parametru wagowego, wówczas koszt przesyłki wyliczymy na podstawie zadeklarowanej maksymalnej liczby sztuk w paczce.

Dodatkowo w przypadku, gdy ustawisz w cenniku dostawy dwie wartości: maksymalną liczbę sztuk w paczce oraz maksymalną wagę paczki, przy określeniu ostatecznej ceny dostawy weźmiemy pod uwagę każdą z nich. Jeśli kupujący przekroczy limit w przynajmniej jednej z tych wartości, naliczymy koszt kolejnej paczki.

Jeśli określisz maksymalną wagę dla metody dostawy z płatnością z góry i analogiczna pobraniowa metoda dostawy także dostępna będzie w danym cenniku - to obie metody muszą mieć określoną tą samą wartość w polu rates[].maxPackageWeight.value.

Aktualnie maksymalną wagę paczki określisz dla metod dostawy:

• Allegro Kurier UPS (id: 0e4c7d59-64b6-4b06-89c3-c1d941506dd0),
• Allegro Kurier UPS pobranie (id: 199d2a2a-7c90-4ca7-aaf3-c1d941506dd0).

W kolejnych miesiącach planujemy udostępnić tą możliwość również dla innych metod dostawy.

Więcej informacji na temat cenników dostawy znajdziesz w naszym poradniku oraz na stronie dla sprzedających.