Allegro REST API

gdzie?

Polska | polski | PLN
Jak zacząć Jak zacząć
  • Pierwsze kroki
  • Informacje podstawowe
  • Główne procesy
  • Uwierzytelnianie i autoryzacja
  • Wzorzec Command
  • Glosariusz
  • Lista metod
Poradniki Poradniki
  • 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 i reklamacje
  • Konto i dane użytkownika
  • Centrum wiadomości
  • Sprawdzanie opłat
  • Wystawianie ogłoszeń
  • Afiliacja
  • Publiczne oferty
FAQCo nowego Co nowego
  • Aktualności
  • Changelog
DokumentacjaRegulaminKontaktZarządzaj API Zarządzaj API
  • Moje aplikacje
  • Moje aplikacje (sandbox)
  • Newsletter
  • API Status
  • 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 i reklamacje
  • Konto i dane użytkownika
  • Centrum wiadomości
  • Sprawdzanie opłat
  • Wystawianie ogłoszeń
  • Afiliacja
  • Publiczne oferty
FAQ
  • Aktualności
  • Changelog
DokumentacjaRegulaminKontakt
  • Moje aplikacje
  • Moje aplikacje (sandbox)
  • Newsletter
  • API Status
  1. Allegro REST API
  2. Aktualności
  3. Wprowadzamy zmiany w deklarowaniu stawki VAT w ofercie

12 kwietnia 2023

Wprowadzamy zmiany w deklarowaniu stawki VAT w ofercie

Wprowadzamy zmiany w deklarowaniu stawki VAT w ofercie

Dziś wprowadziliśmy zmiany, które pozwolą zdefiniować stawki obniżone, dzięki którym sprzedający zapłacą mniejszy podatek.

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.

Allegro

Serwisy Grupy Allegro

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

Dostosuj ustawienia wyświetlania

ustawienia dotyczą tylko tej przeglądarki