Integracje
Integracja: hurtowe ładowanie danych (CSV)
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 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. |
