Integracje

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

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
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
receiverEmail	Adres e-mail odbiorcy	Maksymalnie 60 znaków, np.: nazwa@domena
receiverPhoneNumber	Numer telefonu odbiorcy	Maksymalnie 9 znaków (ciąg liczb bez spacji)
operatorName	Nazwa operatora	RUCH / POCZTA / INPOST / DPD / UPS
postingCode	Kod punkty nadawczego	Dostępny dla danego operatora kod punktu * Nadanie paczki nie jest możliwe w punktach partnerskich operatorów (tj. Orlen, FreshMarket, Żabka etc.).
destinationCode	Kod punktu odbiorczego	Dostępny dla danego operatora kod punktu * W przypadku zleceń za pobraniem należy wybrać punkt obsługujący przesyłki z COD.
length	Długość	Minimum 0.01 cm. Liczba w formacie 10 przed przecinkiem i 2 po przecinku.
width	Szerokość	Minimum 0.01 cm. Liczba w formacie 10 przed przecinkiem i 2 po przecinku.
height	Wysokość	Minimum 0.01 cm. Liczba w formacie 10 przed przecinkiem i 2 po przecinku.
weight	Waga	Minimum 0.01 kg. Liczba w formacie 10 przed przecinkiem i 2 po przecinku.
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 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.