Integracje

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.

2. 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.