Integracje

⌘K
  1. Strona główna
  2. Dokumentacja
  3. Integracje
  4. Marketplace – Amazon
  5. Pobieranie numeru NIP z raportu Amazon

Pobieranie numeru NIP z raportu Amazon

W integracji Amazon numer NIP kupującego nie jest pobierany bezpośrednio ze standardowego API zamówień. Jeżeli chcesz, aby xSale uzupełniał NIP na zamówieniu, trzeba skorzystać z danych dostępnych w raporcie Amazon.

Ta instrukcja pokazuje, jak działa ten mechanizm, jak przygotować raport po stronie Amazon i co trzeba włączyć, aby funkcja działała poprawnie.

W tym artykule znajdziesz

Jak działa pobieranie numeru NIP

Zamówienie z Amazon trafia do xSale ze statusem Niezatwierdzone (Amazon). Amazon nie przekazuje numeru NIP w standardowym API zamówień, dlatego xSale pobiera go z raportu sprzedażowego Amazon.

Po wygenerowaniu raportu xSale może:

  • uzupełnić numer NIP na adresie zamówienia,
  • ustawić go dla Nabywcy i Płatnika,
  • 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 do około 30 minut, dlatego NIP nie pojawia się w xSale od razu po imporcie zamówienia.

Jak przygotować raport w Amazon

Aby xSale mogło prawidłowo pobrać dane z raportu, najpierw trzeba odpowiednio skonfigurować kolumny po stronie Amazon.

W panelu Amazon przejdź do ustawienia Add or remove order report columns, a następnie włącz:

  • Business orders,
  • Buyer tax identifiers,
  • Billing,
  • Buyer company name.

Po zapisaniu zmian odpowiednie dane zaczną pojawiać się w raportach.

Jakie kolumny muszą być włączone

Po poprawnej konfiguracji raport powinien zawierać co najmniej następujące kolumny:

  1. is-business-order – informacja, czy zamówienie zostało złożone przez klienta Amazon Business,
  2. buyer-tax-registration-id – numer identyfikacji podatkowej kupującego,
  3. buyer-tax-registration-country – kraj rejestracji numeru podatkowego,
  4. buyer-tax-registration-type – typ rejestracji podatkowej kupującego,
  5. buyer-company-name – nazwa firmy kupującego,
  6. bill-address-1 – adres rozliczeniowy kupującego.

W praktyce numer VAT jest pobierany z kolumny buyer-vat-number lub buyer-tax-registration-id. Często jedna z tych wartości pozostaje pusta, dlatego xSale sprawdza oba pola.

Różnice dla zamówień FBM i FBA

Dla zamówień realizowanych przez sprzedawcę (FBM) wszystkie wymagane kolumny znajdują się w raporcie Order reports.

Dla zamówień FBA:

  • kolumny od 1 do 5 znajdują się w raporcie All Orders report,
  • kolumna bill-address-1 znajduje się w raporcie Fulfilled Shipments.

W API raport ten występuje pod kodem GET_FLAT_FILE_ORDER_REPORT_DATA_INVOICING.

Jak włączyć funkcję w xSale

Domyślnie funkcja pobierania numeru NIP z Amazon jest wyłączona. Nie można jej samodzielnie włączyć z poziomu panelu xSale.

Aby uruchomić tę funkcję, skontaktuj się z zespołem wsparcia xSale.

Uwaga techniczna: Włączenie funkcji odbywa się na poziomie bazy danych. Dla integracji trzeba ustawić opcję ImportInvoicingData_Enabled oraz aktywować worker import_orders_invoicing_data.