W ramach programu ProstaPaczka jest możliwość tworzenia przesyłek w portalu IdoSell.
Możliwość ta jest dostępna w wersji PRO z niektórych modułów.
Włączenie integracji z IdoSell
Aby włączyć moduł IDOSELL należy:
- Posiadać wersję ProstaPaczka PRO
- Przejść do ADMINISTRACJA -> MODUŁY
- Włączyć moduł IDO SELL
Po tej czynności zostanie dodana nowa zakładka „IDO SELL”.
Dodanie klucza API do sklepu
Aby ProstaPaczka mogła się komunikować z API IdoSell musi posiadać klucz API z odpowiednimi uprawnieniami. Aby go wygenerować należy
- Zalogować się do panelu sklepu na platformie IdoSell
- Przejść do strony: Administracja > Api > Klucze dostępowe do Admin API
- Dodać nowy klucz API
- Określić uprawnienia wymagane do tworzenia przesyłek: odczyt i zapis w sekcji OMS
Aktualny opis dostępny jest w pomocy platformy: Pomoc IdoSell – Klucze dostępowe do API
Dodanie konta dostępowego
Aby dodać konto dostępowe należy:
- Wejść do zakładki IDOSELL
- Kliknąć ikonę zębatki aby otworzyć panel ustawień
- Kliknąć przycisk KONTA aby otworzyć okno zarządzania kontami
- Dodać nowe konto definiując jego parametry
- Zapisać zmiany
Parametry dostępne w ramach konta dostępowego:
- GUID – identyfikator konta w ramach programu ProstaPaczka
- Nazwa – nazwa konta do dyspozycji klienta
- Domena: adres sklepu na platformie IdoSell (np. demo270-pl.yourtechnicaldomain.com) używany go tworzenia adresów bramek API
- Klucz API – klucz zdefiniowany w panelu Admin na platformie IdoSell
- Liczba prób – określenie ile razy program ma sprawdzać czy nadany został już numer listu przewozowego
- Czas między próbami – określenie czasu (w sekundach) pomiędzy poszczególnymi sprawdzeniami nadania numeru listu
- Akceptuj gotowe listy – opcja włączająca pobieranie przygotowanych listów (przez IdoSell ) jeżeli zostaną wykryte podczas próby utworzenia listu
Słownik sposobów dostawy
Słownik używanych sposobów dostawy w ramach integracji dostępny jest w:
ProstaPaczka -> zakładka IDO SELL -> ikona zębatki -> przycisk SPOSOBY DOSTAWY
Dodając nowy sposób dostawy należy określić:
- Kod – identyfikator sposobu dostawy z platformy IdoSell
- Nazwa – nazwa wykorzystywana w ramach programu
Identyfikator sposobu dostawy poza panelem IdoSell wyświetlany jest w oknie edycji listu. Uruchamiając ręczne przygotowanie listu i podając numer zamówienia z danym sposobem dostawy w oknie edycji listu będzie wyświetlony identyfikator sposobu dostawy paczki istniejącej w zamówieniu.
Przykładowe identyfikatory sposobu dostawy:
- Orlen Smile: 143104
- Paczkomat Smile: 14310
- UPS Standard: 100191
Warunki działania
Integracja z platformą IdoSell w zakresie tworzenia przesyłek działa inaczej niż w przypadku przewoźników czy brokerów usług kurierskich. Dlatego też nie ma analogicznych możliwości jak w przypadku bezpośredniej integracji z API przewoźnika.
- Możliwe jest tylko tworzenie przesyłek z jedną paczką.
- W ramach zamówienia musi być zdefiniowana paczka.
- Paczka w systemie IdoSell musi mieć określoną wagę przed przystąpieniem do tworzenia listu.
- Tworząc list zawsze trzeba posiadać numer zamówienia z systemu IdoSell
- Nie ma możliwości śledzenia statusów logistycznych do przesyłek utworzonych przez IdoSell
- Link do trackingu jest pobierany w formacie zwracanym przez IdoSell i kieruje do samej platformy a nie bezpośrednio do strony przewoźnika
Jak działa integracja?
Integracja działa w inny sposób niż w przypadku API przewoźników czy pośredników. API IdoSell nie posiada ściśle określonej struktury przesyłki, tylko każdy sposób nadania może mieć własną listę możliwych do użycia właściwości.
- ProstaPaczka pobiera listę zdefiniowanych paczek do zamówienia
- Jeżeli paczka spełnia warunki
- wyświetlane jest okno z parametrami możliwymi do użycia
- Operator uzupełnia atrybuty i zatwierdza zmiany
- ProstaPaczka zleca tworzenie listu systemowi IdoSell
- W przypadku napotkania błędu wyświetlane jest okno z listą atrybutów w którym można je poprawić
- Jeżeli system IdoSell zwróci informację, że trwa generowanie listu, to
- ProstaPaczka kilkukrotnie (wg. ustawień dla konta dostępowego) odpytuje system IdoSell czy numer listu został już przyznany
- Jeżeli po zadanym czasie numeru listu dalej nie będzie to wyświetlone zostanie okno w którym operator będzie mógł podjąć decyzję o dalszym postępowaniu
- Jeżeli system IdoSell zwróci informacje o utworzeniu przesyłki to zostanie pobrana etykieta, zapisany list w systemie i numer listu będzie przekazany do RRP
Parametry przesyłki
Każdy sposób nadania na platformie IdoSell ma przypisane parametry możliwe do użycia. Każdy z tych parametrów ma swój tekstowy identyfikator. Identyfikatory mogą być takie same dla różnych sposobów nadania lub inne nawet jak podaje się podobną wartość.
Przed rozpoczęciem przygotowania listu ProstaPaczka pobiera listę parametrów możliwych do użycia dla danego sposobu dostawy i wyświetla je w oknie edycji listu.
Atrybuty mogą być:
- Tekstowe – wtedy należy wpisać dowolny tekst
- Słownikowe – wtedy należy wybrać odpowiednią opcję z poziomu menu kontekstowego na liście parametrów
Akceptuj gotowe listy
Aktualnie system IdoSell przydziela numery listów przewozowych do 10 min po zleceniu ich utworzenia. W przypadku tworzenia etykiet Paczkomaty Smile na większość etykiet można czekać kilka minut. Wsparcie platformy będzie pracowało w przyszłości nad tym zagadnieniem, ale na dzień obecny nie znany jest termin wprowadzenia usprawnień.
Jako, że platforma IdoSell posiada automatyzację, która samodzielnie może przygotować etykietę kurierską, to dodaliśmy opcję, która pozwoli przygotowany wcześniej list zapisać po stronie programu i przekazać do ERP.
Po włączeniu tej opcji program podczas próby przygotowania listu
- Sprawdzi najpierw czy do zamówienia została utworzona już przesyłka
- Jeżeli nie ma żadnej – przejdzie do tworzenia nowej przesyłki
- Jeżeli jest już przygotowany list przewozowy – program
- pobierze numer listu z systemu IdoSell,
- zapisze numer listu w historii ProstejPaczki
- pobierze i wydrukuje etykietę,
- zwróci numer listu do ERP (tak, jakby przesyłka została przygotowana przez ProstąPaczkę).
Określanie parametrów tworzenia przesyłki z ERP
Jeżeli przesyłka będzie tworzona z modułu systemu ERP, to w ramach ustawień przetwarzania jest możliwość ustawienia niektórych parametrów przesyłki.
Jako, że każdy sposób nadania posiada własną listę możliwych atrybutów, to jednym sposobem na określenie do którego pola ma być wprowadzana wartość jest podanie identyfikatora danego pola.
Najlepiej kopiować identyfikator z okna edycji listu danego sposobu dostawy i wklejanie do ustawień przetwarzania.
W przypadku wartości słownikowych należy podawać identyfikator opcji. Nie są one unormowane i w zależności od atrybutu mogą się różnić, dlatego zalecamy ostrożność.