Allegro REST API

gdzie?

12 kwietnia 2023

Wprowadzamy zmiany w deklarowaniu stawki VAT w ofercie

Sprzedający, wystawiając ofertę, mogą nam przekazać stawkę VAT na dany przedmiot, którą następnie wykorzystamy do naliczenia podatku e-commerce-VAT.

Do tej pory, mogli ją zdefiniować jedynie dla ofert, dla których krajem dostawy była Polska. Jeśli towar był wysyłany za granicę, konieczne było opłacenie podatku zgodnie z podstawową stawką, która obowiązywała w danym kraju.

Dziś wprowadziliśmy zmiany, które pozwolą zdefiniować stawki obniżone, dzięki którym sprzedający zapłacą mniejszy podatek. Wystarczy, że w ofercie, w nowym polu “taxSettings”, określą stawkę dla danego kraju, do którego będzie wysyłany towar.

Jakie zmiany wprowadziliśmy?

W zasobie /sale/tax-settings, za pomocą którego pobierzesz stawki VAT dla wybranej kategorii, dodaliśmy opcjonalny parametr “countryCode”. Na podstawie podanej wartości zwrócimy ustawienia VAT w obrębie wskazanego kraju. Na tę chwilę wspieramy wartości “PL” oraz “CZ”. Jeśli nie przekażesz parametru, zwrócimy ustawienia VAT dla wszystkich dostępnych krajów. Analogicznie, pole o nazwie “countryCode”, dodaliśmy w odpowiedzi zasobu. Znajdziesz w nim informację, jakiego kraju dotyczy dane ustawienie.

Przykładowy request:

 curl -X GET \
 'https://api.allegro.pl/sale/tax-settings?category.id=315261&countryCode=CZ \
 -H 'Authorization: Bearer {token}'  \
 -H 'Accept: application/vnd.allegro.public.v1+json' \
 -H 'Content-Type: application/vnd.allegro.public.v1+json' \

Przykładowy response:

{
  "settings": [    
    {
        "id": "99dd1919-41fa-4dde-b7ff-3babd14c30ff",
        "rate": {
            "name": "21%",
            "id": "21.00"
        },
        "percentage": null,   – wartość w tym polu zwrócimy tylko dla “countryCode”: “PL”,
        "subject": {
            "name": "Towar",
            "id": "GOODS"
        },
        "exemption": {
            "name": "Procedura marży",
            "id": "MARGIN_SCHEME"
        },
        "countryCode": "CZ"
    },{
      // Kolejne ustawienie
    },
    // Więcej ustawień
  ]
}

Zmieniamy także sposób, w jaki należy zdefiniować stawkę VAT w ofercie. W ramach zasobów do tworzenia, pobierania i edycji oferty, dodaliśmy nowy obiekt “taxSettings”:

  • jest on tożsamy z istniejącym polem “tax”, które aktualnie oznaczyliśmy jako deprecated, jednak usunęliśmy z niego pole “id” oraz “percentage”,
  • w strukturze pola zwrócimy:
    • “subject” - przedmiot opodatkowania,
    • “exemption” - podstawa wyłączenia z VAT,
    • “rates” - listy stawek VAT (“rates[].rate”) dla poszczególnych krajów (“rates[].countryCode”) Pola “subject” i “exemption” będą wspólne dla wszystkich krajów, które znajdują się w liście “rates”. Pole “countryCode” jest wymagane, jeśli sprzedawca definiuje stawki dla konkretnych krajów.
  • jeśli podasz wartości w starym polu “tax”, przepiszemy je do nowego pola “taxSettings”. Nie możesz przekazać wartości w obu polach jednocześnie.

Przykładowa struktura:

  "taxSettings": {
    "subject": "GOODS", 
    "exemption": "EXCISE_GOODS", 
    "rates": [
      {
        "rate": "23.00", 
        "countryCode": "PL" 
      }
    ]
  }

Zmiana dotyczy:

Jakie są kolejne kroki?

W przyszłości zamierzamy usunąć pole “tax”. O wszelkich zmianach będziemy informować na naszej stronie, forum oraz w wiadomościach e-mail.