Pobieranie numeru NIP z raportu Amazon

W integracji Amazon numer NIP kupującego nie jest pobierany bezpośrednio ze standardowego API zamówień. xSale uzupełnia go z raportów Amazon, ale wybór raportu zależy od sposobu realizacji zamówienia oraz ustawień fakturowania w integracji.

Najważniejsza zasada: dla zamówień FBM używany jest dotychczasowy raport zamówień do fakturowania, a dla zamówień FBA z włączonym VCS używany jest raport VAT Invoice Data.

W tym artykule znajdziesz

• jak działa pobieranie numeru NIP do xSale
• jak xSale wybiera raport Amazon
• jak działa ścieżka FBM
• jak działa ścieżka FBA z VCS
• jakie kolumny są sprawdzane
• jakie raporty pobieramy do weryfikacji problemu
• jak włączyć funkcję w xSale

Jak działa pobieranie numeru NIP

Zamówienie z Amazon trafia do xSale ze statusem Niezatwierdzone (Amazon). Następnie xSale zleca wygenerowanie odpowiedniego raportu Amazon, pobiera dokument raportu i próbuje odnaleźć dane podatkowe kupującego.

Po poprawnym odczytaniu danych xSale może:

• uzupełnić numer NIP/VAT na adresie zamówienia,
• ustawić go dla Nabywcy i Płatnika,
• zachować kod kraju numeru podatkowego, jeżeli raport go przekazuje lub można go odczytać z prefiksu numeru,
• zmienić status zamówienia na Nowe,
• przekazać zamówienie dalej do ERP.

Uwaga: Raport nie jest dostępny natychmiast. Amazon może wygenerować go z opóźnieniem, dlatego NIP nie musi pojawić się w xSale od razu po imporcie zamówienia.

Jak xSale wybiera raport Amazon

xSale rozróżnia ścieżkę po konfiguracji integracji Amazon:

• FBM albo FBA bez ścieżki VCS: xSale używa raportu GET_FLAT_FILE_ORDER_REPORT_DATA_INVOICING.
• FBA + VCS, gdy w polu Ścieżka fakturowania wybrano jedną z dwóch pierwszych opcji VCS: xSale używa raportu GET_FLAT_FILE_VAT_INVOICE_DATA_REPORT z opcją reportOptions: {„ReportOption=All”: „true”}.

Za ścieżkę VCS uznajemy ustawienia, w których sprzedawca jest zarejestrowany w Amazon VAT Calculation Service, czyli:

• Jestem zarejestrowany w VCS, Amazon wystawia faktury dla moich zamówień,
• Jestem zarejestrowany w VCS, sam wystawiam faktury w moim systemie i chcę je eksportować do Amazon przez xSale.

Ścieżka FBM

Dla zamówień realizowanych przez sprzedawcę (FBM) xSale pobiera raport:

GET_FLAT_FILE_ORDER_REPORT_DATA_INVOICING

W tej ścieżce numer NIP/VAT jest odczytywany przede wszystkim z kolumn:

• buyer-vat-number,
• buyer-tax-registration-id.

Kod kraju numeru podatkowego jest odczytywany z buyer-tax-registration-country, a jeżeli ta kolumna jest pusta, xSale próbuje użyć prefiksu numeru VAT albo kraju z adresu rozliczeniowego.

Ścieżka FBA z VCS

Dla zamówień realizowanych przez Amazon (FBA) i integracji z jedną z dwóch pierwszych ścieżek VCS xSale pobiera raport:

GET_FLAT_FILE_VAT_INVOICE_DATA_REPORT

Raport jest pobierany z opcją SP-API reportOptions: {„ReportOption=All”: „true”}. xSale bierze z niego tylko wiersze oznaczone jako fulfilled-by = FBA.

W tej ścieżce numer NIP/VAT jest odczytywany z kolumn:

• buyer-vat-number,
• buyer-nip.

Jeżeli sprzedawca nie jest zarejestrowany w VCS, Amazon może zwrócić komunikat, że raport VAT Invoice Data jest niedostępny, ponieważ konto musi być zapisane do Amazon VAT Calculation Service. W takim przypadku xSale nie ma z tego raportu źródła danych NIP dla FBA.

Jakie kolumny są sprawdzane

W zależności od raportu xSale sprawdza różne nazwy kolumn, ponieważ Amazon nie udostępnia tych samych pól w każdym typie raportu.

Scenariusz	Raport API	Kolumny z numerem NIP/VAT	Dodatkowe dane
FBM	GET_FLAT_FILE_ORDER_REPORT_DATA_INVOICING	buyer-vat-number, buyer-tax-registration-id	buyer-tax-registration-country, buyer-company-name, dane billingowe
FBA + VCS	GET_FLAT_FILE_VAT_INVOICE_DATA_REPORT	buyer-vat-number, buyer-nip	fulfilled-by, buyer-company-name, dane billingowe

Raporty do weryfikacji problemu

Podczas diagnostyki sprawdzamy raport właściwy dla konfiguracji integracji oraz raporty pomocnicze, jeżeli trzeba potwierdzić różnicę między danymi widocznymi w Seller Central i danymi dostępnymi przez API.

• Dla FBM weryfikujemy GET_FLAT_FILE_ORDER_REPORT_DATA_INVOICING i szukamy kolumn buyer-vat-number oraz buyer-tax-registration-id.
• Dla FBA + VCS weryfikujemy GET_FLAT_FILE_VAT_INVOICE_DATA_REPORT z opcją reportOptions: {„ReportOption=All”: „true”} i szukamy kolumn buyer-vat-number oraz buyer-nip.
• Raport All Orders z Seller Central może pokazywać dane pomocnicze, ale nie zawsze jest równoważny z danymi zwracanymi przez API dla FBA.
• Raport GET_AMAZON_FULFILLED_SHIPMENTS_DATA_TAX nie jest podstawowym źródłem NIP w tej funkcji. Jeżeli Amazon odmawia dostępu do tego raportu, nie oznacza to jeszcze, że nie da się pobrać NIP przez właściwą ścieżkę VCS.

Jak włączyć funkcję w xSale

Funkcję pobierania numeru NIP z raportu Amazon włączysz w konfiguracji integracji Amazon.

1. Przejdź do sekcji Integracje → Integracje.
2. Otwórz edycję integracji Amazon.
3. Przejdź do zakładki Synchronizacja zamówień.
4. Włącz przełącznik Pobierać numer NIP.
5. Jeżeli integracja dotyczy FBA, sprawdź w zakładce Połączenia pole Ścieżka fakturowania.
6. Kliknij Zapisz.

Po włączeniu tej opcji xSale będzie próbował uzupełnić numer NIP na zamówieniu na podstawie danych z właściwego raportu Amazon. Mechanizm zadziała tylko wtedy, gdy raport Amazon zawiera dane podatkowe kupującego.

Ważne: Włączenie przełącznika w xSale nie tworzy danych podatkowych po stronie Amazon. Jeżeli Amazon nie udostępni numeru NIP/VAT w raporcie właściwym dla danego typu zamówienia, xSale nie będzie miał z czego uzupełnić numeru na zamówieniu.