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