Allegro REST API

gdzie?

Polska | polski | PLN
  • Pierwsze kroki
  • Informacje podstawowe
  • Główne procesy
  • Uwierzytelnianie i autoryzacja
  • Wzorzec Command
  • Glosariusz
  • Lista metod
  • Wystawianie oferty produktu
  • Serwisy zagraniczne Allegro
  • Zarządzanie ofertami
  • Oferty wielowariantowe
  • Pasuje do
  • Zarządzanie zgłoszeniami ofert do kampanii
  • Rabaty i promocje
  • Zamówienia
  • Wysyłam z Allegro
  • One Fulfillment by Allegro
  • Dyskusje
  • Konto i dane użytkownika
  • Centrum wiadomości
  • Sprawdzanie opłat
  • Wystawianie ogłoszeń
  • Publiczne oferty
FAQ
  • Aktualności
  • Changelog
Dokumentacja
Regulamin
Kontakt
  • Moje aplikacje
  • Moje aplikacje (sandbox)
  • Newsletter
  • API Status
  1. Allegro REST API
  2. Aktualności
  3. Udostępniliśmy nową wersję zasobu /sale/tax-settings

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:

  • GET /sale/product-offers/{offerID},
  • PATCH /sale/product-offers/{offerID},
  • POST /sale/product-offers,
  • GET /sale/offers/{offerID},
  • PUT /sale/offers/{offerID},
  • POST /sale/offers,

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.

Allegro

Serwisy Grupy Allegro

  • Allegro.cz
  • Allegro.sk
  • Allegro.hu
  • Mall.hr
  • Mimovrste.com
  • Onedelivery.cz
zamknij

Dostosuj ustawienia wyświetlania

ustawienia dotyczą tylko tej przeglądarki