Integracje

Integracja: hurtowe ładowanie danych (CSV)

Ostatnia aktualizacja instrukcji: 20.11.2019r.

Zapewniamy najbardziej bazową, ale też najpopularniejszą formę integracji, poprzez plik CSV. Dzięki temu masz możliwość w prosty sposób zaimportować większą ilość przesyłek do naszego systemu i hurtowo przetwarzać zlecenia.

  1. Jak uruchomić narzędzie?

Po zalogowaniu do konta użytkownika Bliskapaczka.pl należy przejść  do zakładki NARZĘDZIA/IMPORT ZLECEŃ i wgrać wybrany plik w formacie CSV lub przeciągnąć go we wskazane miejsce.

  1. Jak utworzyć poprawny plik w formacie CSV?

Przykład pliku zapisanego w formacie CSV znajduje się w zakładce Narzędzia -> Import zleceń

Wytyczne dla poprawnego pliku w formacie CSV:

  • mechanizm obsługuje tekstowe pliki zapisane w formacie CSV,  w którym poszczególne kolumny rozdzielane są średnikiem (;),
  • pliki powinny być zakodowane jako Windows-1250/WinLatin 2 (o ile wartości kolumn zawierają polskie znaki),
  • plik CSV obsługuje wszystkich Przewoźników zgodnie z wytycznymi oferty serwisu Bliskapaczka.pl
  • wszystkie kolumny są opcjonalne, natomiast niektóre są między sobą zależne (podając punkt nadawczy lub punkt odbiorczy kolumna operatorName staje się wymagana, podobnie podając codValue wymagana zostaje kolumna codPayoutBankAccountNumber),
  • w kolumnie z numerem rachunku bankowego (codPayoutBankAccountNumber) należy zmienić typ kolumny na Tekst,
Microsoft Excel LibreOffice
  • maksymalna ilość paczek w jednym pliku wynosi 1 000,
  • jedno zlecenie (tj. jeden wiersz w pliku CSV) stanowi pojedynczą paczkę,
  • kolejność nagłówków w pliku CSV jest dowolna,
  • wielkość liter w nagłówkach pliku CSV musi być zgodna z szablonem pliku,
  • dla przesyłek DPD oraz FedEx z kwotą pobrania powyżej 1 000,00 zł przesyłka obowiązkowo podlega dodatkowemu ubezpieczeniu równemu kwocie pobrania,
  • liczby dziesiętne powinny być oddzielane znakiem kropki (.), np. X.XX zł.

W przypadku danych w pliku CSV niezgodnych z wymaganiami niniejszego poradnika i/lub oferty serwisu Bliskapaczka.pl po wczytaniu CSV zlecenia otrzymają komunikat o błędzie oznaczony kolorem czerwonym, a po ich zapisie nie zostaną zaimportowane.

Poniżej tabela z instrukcjami dla poszczególnych kolumn pliku CSV.

 

Tabela 1. Objaśnienia dla parametrów pliku CSV oraz ich poprawny format.

* Pola oznaczone gwiazdką są wymagane przez formularz nadania Bliskapaczka.pl

senderFirstName* Imię nadawcy Maksymalnie 30 znaków.
senderLastName* Nazwisko nadawcy Maksymalnie 30 znaków.
senderPhoneNumber* Numer telefonu nadawcy Maksymalnie 9 znaków (ciąg liczb bez spacji).
senderEmail* Adres e-mail nadawcy Maksymalnie 60 znaków, np.: nazwa@domena.pl.
senderStreet* Ulica nadawcy Maksymalnie 30 znaków.
senderBuildingNumber* Numer budynku nadawcy Maksymalnie 10 znaków.
senderFlatNumber Numer lokalu nadawcy Maksymalnie 10 znaków.
senderPostCode* Kod pocztowy nadawcy Format: 2 cyfry – 3 cyfry (XX-XXX).
senderCity* Miasto nadawcy Maksymalnie 30 znaków.
receiverFirstName* Imię odbiorcy Maksymalnie 30 znaków.
receiverLastName* Nazwisko odbiorcy Maksymalnie 30 znaków.
receiverPhoneNumber* Adres e-mail odbiorcy Maksymalnie 60 znaków, np.: nazwa@domena.pl.
receiverEmail* Numer telefonu odbiorcy Maksymalnie 9 znaków (ciąg liczb bez spacji).
receiverStreet* Ulica nadawcy Maksymalnie 30 znaków.
receiverBuildingNumber* Numer budynku nadawcy Maksymalnie 10 znaków.
receiverFlatNumber Numer lokalu nadawcy Maksymalnie 10 znaków.
receiverPostCode* Kod pocztowy nadawcy Format: 2 cyfry – 3 cyfry (XX-XXX).
receiverCity* Miasto nadawcy Maksymalnie 30 znaków.
operatorName* Nazwa operatora RUCH / POCZTA / INPOST / DPD / UPS/ FedEx
postingCode* Kod punkty nadawczego Dostępny dla danego operatora kod punktu
Nadanie paczki nie jest możliwe w punktach partnerskich operatorów (tj. Orlen, Żabka etc.).
destinationCode* Kod punktu odbiorczego Dostępny dla danego operatora kod punktu
W przypadku zleceń za pobraniem należy wybrać punkt odbioru obsługujący przesyłki z COD.
length* Długość Minimum 1 cm. Wyłącznie liczby całkowite.
width* Szerokość Minimum 1 cm. Wyłącznie liczby całkowite.
height* Wysokość Minimum 1 cm. Wyłącznie liczby całkowite.
weight* Waga Minimum 0.1 kg.
insuranceValue* Dodatkowe ubezpieczenie Wartość dodatkowego ubezpieczenia w PLN.
Minimum 0.01 zł.
codValue* Kwota pobrania Wartość pobrania w PLN. Minimum 1.00 zł
Przesyłki DPD oraz FedEx z kwotą pobrania powyżej 1 000 zł podlegają obowiązkowemu (dodatkowemu) ubezpieczeniu
o wartości kwoty pobrania.
codPayoutBankAccountNumber* Numer rachunku bankowego do zwrotu kwoty pobrania Poprawny numer konta bankowego (ciąg liczb bez spacji)
W pliku należy zmienić właściwości kolumny na tekstowy.
additionalInformation Dodatkowe informacje/uwagi Maksymalnie 100 znaków.
deliveryType* Rodzaj usługi wybranej
do transportu przesyłki
D2D – od drzwi do drzwi, P2P – z punktu do punktu,

P2D – z punktu do drzwi, D2P – od drzwi do punktu.

* Nie każdy przewoźnik dysponuje pełną listą rodzaju usług.

Do góry