Import kontrahentów (CSV / XLSX)

Ten artykuł opisuje wszystkie pola, które mogą zostać zaimportowane do systemu Zamawiaj24 dla kontrahentów, oraz wszystkie rozpoznawane nazwy kolumn w plikach Excel (XLSX) i CSV.

Import jest odporny na różnice w zapisie nagłówków (język, wielkość liter, spacje, myślniki, kropki).

SPIS TREŚCI

• Obsługiwane formaty plików
• Jak system interpretuje nazwy kolumn (ważne)
• Lista obsługiwanych pól importu
  • 1. Nazwa kontrahenta (pole wymagane)
  • 2. NIP / identyfikator podatkowy
  • 3. Miasto
  • 4. Kod pocztowy
  • 5. Ulica / adres
  • 6. Numer domu
  • 7. Numer lokalu
  • 8. Telefon
  • 9. Adres e-mail
  • 10. Kod / identyfikator kontrahenta
  • 11. Szerokość geograficzna
  • 12. Długość geograficzna
  • 13. Dystrybutor (tak / nie)
  • 14. Aktywny kontrahent
  • 15. Kategoria kontrahenta (nazwa)
  • 16. Status kontrahenta (nazwa)
  • 17. ID zewnętrzne
  • 18. Obszar / region (nazwa)
  • 19. Sieć handlowa (nazwa)
• Specjalne wartości
• CSV – separator
• Rekomendowany komplet kolumn (pełny import)

Obsługiwane formaty plików

• XLSX (Excel)

• CSV

Wymagania techniczne:

• pierwszy wiersz musi zawierać nagłówki kolumn,

• kolejne wiersze zawierają dane kontrahentów,

• maksymalnie 1000 wierszy na jeden import.

Jak system interpretuje nazwy kolumn (ważne)

Podczas importu:

• wielkość liter nie ma znaczenia,

• spacje, myślniki, kropki i ukośniki są traktowane równoważnie,

• polskie znaki są automatycznie normalizowane.

Przykłady nagłówków, które zostaną rozpoznane identycznie:

• Kod pocztowy

• kod-pocztowy

• kod.pocztowy

• kod_pocztowy

? Nie ma potrzeby dostosowywania nazw kolumn do technicznego formatu.

Lista obsługiwanych pól importu

Poniżej znajduje się pełna lista pól, które system potrafi zaimportować, wraz z rozpoznawanymi nazwami kolumn.

1. Nazwa kontrahenta (pole wymagane)

Pole systemowe: name

Rozpoznawane nazwy kolumn:

• name

• nazwa

• kontrahent

• firma

Uwagi:

• pole wymagane,

• brak nazwy powoduje ostrzeżenie: „Brak nazwy”.

2. NIP / identyfikator podatkowy

Pole systemowe: nip

Rozpoznawane nazwy kolumn:

• nip

• taxid

• niptax

• tax id

• nip oczyszczony

Uwagi techniczne:

• system usuwa wszystkie znaki poza cyframi i literami,

• puste, null, -, n/a, brak → traktowane jako brak danych.

3. Miasto

Pole systemowe: city

Rozpoznawane nazwy kolumn:

• city

• miasto

• miejscowosc

4. Kod pocztowy

Pole systemowe: zip

Rozpoznawane nazwy kolumn:

• zip

• kod

• kod pocztowy

• postal code

5. Ulica / adres

Pole systemowe: street

Rozpoznawane nazwy kolumn:

• street

• ulica

• adres

• address

6. Numer domu

Pole systemowe: home_number

Rozpoznawane nazwy kolumn:

• home number

• nr domu

• dom

• budynek

• homenumber

7. Numer lokalu

Pole systemowe: local_number

Rozpoznawane nazwy kolumn:

• local number

• lokal

• mieszkanie

• nr lokalu

• localnumber

8. Telefon

Pole systemowe: phone

Rozpoznawane nazwy kolumn:

• phone

• telefon

• tel

9. Adres e-mail

Pole systemowe: email

Rozpoznawane nazwy kolumn:

• email

• mail

• e mail

10. Kod / identyfikator kontrahenta

Pole systemowe: identifier

Rozpoznawane nazwy kolumn:

• identifier

• id klienta

• symbol

• kod

• identyfikator

• nazwa skrócona

11. Szerokość geograficzna

Pole systemowe: latitude

Rozpoznawane nazwy kolumn:

• latitude

• lat

• szerokosc geograficzna

• szerokosc geogr

12. Długość geograficzna

Pole systemowe: longitude

Rozpoznawane nazwy kolumn:

• longitude

• lon

• lng

• długosc geograficzna

• długosc geogr

13. Dystrybutor (tak / nie)

Pole systemowe: is_distributor

Rozpoznawane nazwy kolumn:

• is distributor

• dystrybutor

• czy dystrybutor

• distributor

Rozpoznawane wartości:

• TAK: 1, true, tak, yes, checked

• NIE: 0, false, nie, no, unchecked

Domyślnie: NIE

14. Aktywny kontrahent

Pole systemowe: is_active

Rozpoznawane nazwy kolumn:

• is active

• aktywny

• czy aktywny

• active

• enabled

Domyślnie: TAK

15. Kategoria kontrahenta (nazwa)

Pole systemowe: contractor_category_name

Rozpoznawane nazwy kolumn:

• contractor category name

• kategoria

• category

Importowana jest nazwa kategorii (ID przypisywane jest później).

16. Status kontrahenta (nazwa)

Pole systemowe: contractor_status_name

Rozpoznawane nazwy kolumn:

• contractor status name

• status

17. ID zewnętrzne

Pole systemowe: external_id

Rozpoznawane nazwy kolumn:

• external id

• externalid

• ext id

• id zewnetrzny

• zew id

18. Obszar / region (nazwa)

Pole systemowe: area_name

Rozpoznawane nazwy kolumn:

• area name

• powierzchnia

Importowana jest nazwa obszaru, nie ID.

19. Sieć handlowa (nazwa)

Pole systemowe: retail_chain_name

Rozpoznawane nazwy kolumn:

• retail chain name

• retail chain

• siec

• siec handlowa

• chain

Importowana jest nazwa sieci, nie ID.

Specjalne wartości

W każdej kolumnie wartości:

• null

• n/a

• brak

• -

• puste pole

…są traktowane jako brak danych.

CSV – separator

Dla plików CSV:

• system automatycznie rozpoznaje separator ; lub ,,

• jeśli separator zostanie podany ręcznie – ma pierwszeństwo.

Rekomendowany komplet kolumn (pełny import)

Przykładowy zestaw kolumn dla pełnego importu kontrahentów:

• Nazwa

• NIP

• Miasto

• Kod pocztowy

• Ulica

• Nr domu

• Nr lokalu

• Telefon

• Email

• Kategoria

• Status

• Dystrybutor

• Aktywny

• Sieć handlowa

• Obszar