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:
- 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.
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.