Allegro REST API

gdzie?

24 października 2023

Udostępniliśmy nową wersję zasobu /sale/tax-settings

Od dziś możesz skorzystać z wersji beta.v1 zasobu /sale/tax-settings, dzięki czemu łatwiej uzyskasz informacje potrzebne do zdefiniowania stawki VAT w ofercie.

Jakie zmiany wdrożyliśmy w wersji beta.v1?

W wersji beta.v1 wdrożyliśmy nową strukturę, w której zwrócimy listę następujących obiektów:

  • “subjects” - tablica zawierająca listę przedmiotów opodatkowania,
  • “rates” - lista stawek VAT (“rates[].rate”) dla poszczególnych krajów (“rates[].countryCode”) Pola “subjects” i “exemptions” są wspólne dla wszystkich krajów, które znajdują się na liście w “rates”,
  • “exemptions” - lista podstaw wyłączenia z VAT.

Aby dostosować się do zmian, wystarczy, że zmienisz wartość w nagłówku Accept z “application/vnd.allegro.public.v1+json” na “application/vnd.allegro.beta.v1+json”.

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.beta.v1+json' \

Przykładowy response:

{
  "subjects": [ - lista przedmiotów opodatkowania
      {
        "label": "Towar",
        "value": "GOODS"
      },
      {
        "label": "Wybierz",
        "value": null
      }
  ],
  "rates": [ - lista stawek VAT
    {
      "countryCode": "PL",
      "values": [
        {
          "label": "23%",
          "value": "23.00",
          "exemptionRequired": false
        },
        {
          "label": "Poza VAT / NP",
          "value": "OUT_OF_SCOPE_OF_VAT",
          "exemptionRequired": true
        },
        {
          "label": "Wybierz",
          "value": null,
          "exemptionRequired": false
        }
      ]
    },
    {
      "countryCode": "CZ",
      "values": [...]
    }
  ],
  "exemptions": [ - podstawy wyłączenia z VAT
      {
        "label": "Wyroby akcyzowe",
        "value": "EXCISE_GOODS"
      },
      {
        "label": "Procedura marży",
        "value": "MARGIN_SCHEME"
      },
      {
        "label": "Wybierz",
        "value": null
      }
   ]
}

Dlaczego wprowadzamy tę zmianę?

Zasób /sale/tax-settings funkcjonuje obecnie w wersji public.v1, jednak struktura odpowiedzi nie jest dostosowana do obiektu “taxSettings”, który wdrożyliśmy 12 kwietnia 2023 roku na zasobach:

gdzie zastąpiliśmy jednocześnie pole “tax”, które oznaczyliśmy jako Deprecated.

Jakie są kolejne kroki?

W przyszłości planujemy przenieść strukturę zasobu w wersji beta.v1 na wersję public.v1, poinformujemy o tym z odpowiednim wyprzedzeniem.