Zaczynamy Apilo Days – wybierz jedną z 3 promocji i ciesz się oszczędnościami! :point_right: Dowiedz się więcej.
Apilo

Witaj w centrum pomocy Apilo

[API] Jak przekazać informację do Apilo o utworzonej poza Apilo przesyłce

FAQ – Najczęściej zadawane pytania Mam Apilo – od czego zacząć? Jak stworzyć wspólną bazę produktów w Apilo? BOK Zamówienia i statusy zamówień Proponowany schemat realizacji zamówień (automatyzacja) Jak często Apilo synchronizuje dane? Jak dodać nowego użytkownika z własnym hasłem i uprawnieniami Lista programów magazynowo – księgowych, które podłączysz pod Apilo Allegro – zwroty płatności i prowizji Czy drukowanie etykiet jest możliwe dla każdego przewoźnika? Abonament Apilo – wszystko co musisz wiedzieć o naliczaniu opłat Jak aktywować kod rabatowy? Obsługa zamówień z wykorzystaniem skanera kodów kreskowych Czy moje dane są bezpieczne?
Połączenie z CDiscount Połączenie z Shoper Połączenie z kontem Allegro Połączenie z Erli.pl Połączenie z kontem eBay Połączenie z kontem Amazon Połączenie z Empik Połączenie z Castorama Połączenie z Decathlon Połączenie z OLX Połączenie z Morele Marketplace Połączenie z Ceneo.pl Lista programów magazynowo – księgowych, które podłączysz pod Apilo Połączenie z Kaufland DE / PL / CZ / SK Połączenie z Shopify Połączenie z Etsy.com Połączenie z InPost Fresh Połączenie z IdoSell Połączenie z Prestashop Połączenie z WooCommerce Połączenie z ShopGold Połączenie z eMag Połączenie z RedCart Połączenie z Labelcall Połączenie z Magento Połączenie z kurierem Inpost Wysyłam z Allegro, Allegro Smart, Allegro One Połączenie z kurierem Rohling Suus Połączenie z kurierem DPD Połączenie z kurierem GLS Połączenie z kurierem UPS Połączenie z kurierem DHL Polska Połączenie z kurierem Poczta Polska Połączenie z Orlen Paczka Połączenie z Eurohermes Połączenie z kurierem Raben Połączenie z kurierem DPD (Niemcy) Połączenie z kurierem DHL (Niemcy) Połączenie z brokerem Erli.pl Połączenie z brokerem Furgonetka.pl Połączenie z brokerem Apaczka Połączenie z brokerem BliskaPaczka Lista wszystkich kurierów i brokerów, których podłączysz pod Apilo Magazyn Apilo – na podstawie zewnętrznego programu magazynowo – księgowego typu ERP Połączenie z wFirma.pl – faktury i paragony Połączenie z FakturaXL – faktury Połączenie z Fakturownia.pl – faktury i paragony Połączenie z inFakt Połączenie z Shoper Faktury i Magazyn Połączenie z iFirma.pl Połączenie z Subiekt GT – łącznik Sellintegro Połączenie z Subiekt GT/Nexo/Nexo Pro – łącznik integratory.pl Paragony – podłączenie drukarki fiskalnej Obsługa zamówień z wykorzystaniem skanera kodów kreskowych Kody kreskowe EAN – Skaner kodów kreskowych Etykiety – Podłączenie etykieciarki i drukowanie etykiet prosto na drukarkę (PrintNode)
Shoper – Allegro inpost SMART – jak wysłać zamówienia pobrane z Apilo Autoresponder wiadomości od kupujących Allegro Połączenie z kontem Allegro Migracja powiązań aukcji Allegro z produktami z Shoper Shoper – jak dodać produkty z Apilo do sklepu Manager Allegro – Szukaj Powiązań Allegro – konfiguracja dodatkowa eSklep > Apilo > Platformy sprzedaży. Zasilaj magazyn Apilo o ilości/ceny z eSklep. Shoper > Apilo > Platformy sprzedaży. Zasilaj magazyn Apilo o ilości/ceny z Shoper. Gdzie zarządzać magazynem – w Apilo czy Shoper? Opisy AI – jak zaktualizować opisy w Shoper Synchronizacja ilości/cen Allegro i Shoper za pomocą magazynu Apilo Eksport zamówień z Apilo do Shoper
Allegro – masowa aktualizacja i modyfikacja tytułów/opisów aukcji Allegro – wystawianie aukcji i podstawowa konfiguracja Shoper – jak dodać produkty z Apilo do sklepu Shoper – dodawanie produktów do sklepu Sprzedaż > Shoper > Wystaw Shoper – dodaj aukcje Allegro do Shoper jako produkty Shoper – wystaw produkty Shoper jako aukcje do Allegro Shoper – dodawanie produktów do sklepu plikiem CSV Amazon – wystawianie ofert i produktów OLX – wystawianie ofert Empik – wystawianie ofert Castorama – wystawianie ofert Decathlon – wystawianie ofert Modivo – wystawianie produktów/ofert Erli – wystawianie ofert Amazon – „Nie udało się utworzyć produktu”, co dalej? PrestaShop – eksport produktów do sklepu plikiem CSV InPost Fresh – wystawianie i zarządzanie ofertami Manager Sprzedaży – wznawianie, wystawianie ponowne i kończenie ofert Moduł Cenników – indywidualne ceny na kanałach sprzedaży Opisy AI – przykłady użycia w Apilo Opisy AI – jak zaktualizować opisy w Shoper
Jak stworzyć wspólną bazę produktów w Apilo? Magazyn Apilo – na podstawie platformy sprzedaży Relacje produktów – czyli jak włączyć synchronizacje? Lista programów magazynowo – księgowych, które podłączysz pod Apilo Magazyn Apilo – na podstawie programu księgowego online (wFirma, Fakturownia, Favato, FakturaXL) Plik CSV – import produktów, jak stworzyć magazyn Plik CSV – aktualizacja magazynu na podstawie pliku Usunięcie produktów i ofert z Apilo Podłączenie hurtowni Magazyn Apilo – na podstawie zewnętrznego programu magazynowo – księgowego typu ERP Moduł Cenników – indywidualne ceny na kanałach sprzedaży eSklep > Apilo > Platformy sprzedaży. Zasilaj magazyn Apilo o ilości/ceny z eSklep. Shoper > Apilo > Platformy sprzedaży. Zasilaj magazyn Apilo o ilości/ceny z Shoper. Zestaw produktów – do czego służy i jak utworzyć Magazyn Apilo – jak dodać produkt Gdzie zarządzać magazynem – w Apilo czy eSklep Home.pl? Gdzie zarządzać magazynem – w Apilo czy Shoper? Opisy AI – jak zaktualizować opisy w Shoper Opisy AI – automatyczne generowanie opisów w Apilo
Jak stworzyć wspólną bazę produktów w Apilo? Relacje produktów – czyli jak włączyć synchronizacje? Jak często Apilo synchronizuje dane? Manager Sprzedaży – wznawianie, wystawianie ponowne i kończenie ofert Moduł Cenników – indywidualne ceny na kanałach sprzedaży
Jak wysłać produkty z hurtowni do sklepu Shoper? Podłączenie hurtowni
Autoresponder wiadomości od kupujących Allegro BOK Zamówienia i statusy zamówień Proponowany schemat realizacji zamówień (automatyzacja) Jak dodać nowego użytkownika z własnym hasłem i uprawnieniami Generowanie etykiet – konfiguracja Allegro – zwroty płatności i prowizji Konfiguracja modułu Fakturowania / Paragonów Jak wygenerować etykietę do zamówienia E-maile do klientów i szablony wiadomości Zamówienie ręczne z innego źródła Zadania automatyczne Paragony – podłączenie drukarki fiskalnej Obsługa zamówień z wykorzystaniem skanera kodów kreskowych Kody kreskowe EAN – Skaner kodów kreskowych Etykiety – Podłączenie etykieciarki i drukowanie etykiet prosto na drukarkę (PrintNode) Eksport zamówień z Apilo do eSklep Home.pl Eksport zamówień z Apilo do Shoper
Autoresponder wiadomości od kupujących Allegro Generowanie etykiet – konfiguracja Konfiguracja modułu Fakturowania / Paragonów Manager Sprzedaży – wznawianie, wystawianie ponowne i kończenie ofert Opisy AI – przykłady użycia w Apilo Opisy AI – jak zaktualizować opisy w Shoper Opisy AI – automatyczne generowanie opisów w Apilo Zadania automatyczne Obsługa zamówień z wykorzystaniem skanera kodów kreskowych
Lista programów magazynowo – księgowych, które podłączysz pod Apilo Magazyn Apilo – na podstawie programu księgowego online (wFirma, Fakturownia, Favato, FakturaXL) Konfiguracja modułu Fakturowania / Paragonów Magazyn Apilo – na podstawie zewnętrznego programu magazynowo – księgowego typu ERP Połączenie z wFirma.pl – faktury i paragony Połączenie z FakturaXL – faktury Połączenie z Fakturownia.pl – faktury i paragony Połączenie z inFakt Połączenie z Shoper Faktury i Magazyn Połączenie z iFirma.pl Połączenie z Subiekt GT/Nexo/Nexo Pro – łącznik integratory.pl Zadania automatyczne Paragony – podłączenie drukarki fiskalnej
Generowanie etykiet – konfiguracja Wysyłam z Allegro, Allegro Smart, Allegro One Połączenie z kurierem Rohling Suus Czy drukowanie etykiet jest możliwe dla każdego przewoźnika? Jak wygenerować etykietę do zamówienia Do czego służy kurier zewnętrzny? Etykiety – Podłączenie etykieciarki i drukowanie etykiet prosto na drukarkę (PrintNode)
Aplikacja 'Integracje z hurtowniami’ czy 'Dropshipping moduł Apilo’ – co wybrać? Aplikacje Shoper – specyfikacja i FAQ Shoper – dodawanie produktów do sklepu Sprzedaż > Shoper > Wystaw Instalacja i założenie konta Apilo – 'Dropshipping moduł Apilo’ i 'Pakiet Hurtownie’ w sklepie Shoper Podłączenie hurtowni do Apilo [Aplikacje Shoper 'Integracje z Hurtowniami’ oraz 'Dropshipping moduł Apilo’] Shoper – dodawanie produktów do sklepu plikiem CSV Jak wysłać produkty z hurtowni do sklepu Shoper?
Allegro – masowa aktualizacja i modyfikacja tytułów/opisów aukcji Autoresponder wiadomości od kupujących Allegro Połączenie z kontem Allegro Allegro – wystawianie aukcji i podstawowa konfiguracja Magazyn Apilo – na podstawie platformy sprzedaży Relacje produktów – czyli jak włączyć synchronizacje? Generowanie etykiet – konfiguracja Wysyłam z Allegro, Allegro Smart, Allegro One Allegro – zwroty płatności i prowizji Konfiguracja modułu Fakturowania / Paragonów Allegro – konfiguracja dodatkowa Obsługa zamówień z wykorzystaniem skanera kodów kreskowych
[API] Dokumenty powiązane w zamówieniach [API] Zamówienia – pobieranie listy, szczegółów. Tworzenie zamówień [API] Jak przekazać informację do Apilo o utworzonej poza Apilo przesyłce [API] Tworzenie nowej przesyłki w Apilo
Rozszerzenie 'Apilo Booster’

Spis treści

1. Podstawowy endpoint 2. Jak uzyskać carrierProvideId? 3. Jak uzyskać media UUID?

Aby poinformować Apilo o przesyłce utworzonej poza systemem Apilo należy skorzystać z endpointu:

POST http://{{apilo_client_account}}.apilo.com/rest/api/orders/{{example_order_id}}/shipment/

i przesłać treść:

{
"idExternal": "AL240800063",
"tracking": "521000019901900018413826",
"carrierProviderId": 144,
"postDate": "2024-09-05T15:19:22+0200",
"media": "2dcb6011-5d20-4af6-bc73-659538569b9e"
}

gdzie:

idExternal – Numer przesyłki zewnętrzny (np. w InPost)

tracking – Numer śledzenia przesyłki (może ulegać zmianie, np. gdy przeadresujemy paczkę u kuriera

carrierProviderId – Identyfikator przewoźnika

postDate – Data nadania paczki (opcjonalna; domyślnie data dzisiejsza)

media – UUID pliku z etykietą

Jak uzyskać carrierProvideId? (kontekst informowania o przesyłce tworzonej poza Apilo)

 

GET https://{{apilo_client_account}}.apilo.com/rest/api/orders/carrier/map/

UWAGA: Zostanie zwrócona lista obiektów, którą należy podać uważnej ocenie, a zwłaszcza właściwość „isBroker”.

Standardowi przewoźnicy tacy jak: GLS, DPD, InPost będą mieli dla tego pola wartość false.

Natomiast przewoźnicy tacy jak: Apaczka, Bliska Paczka, Wysyłam z Allegro będą mieli dla tego pola wartość true.

Co to zmienia? Otóż dla Apilo oraz zewnętrznych integracji z którymi jest połączone,
najważniejszym jest kto finalnie przewozi paczkę, a nie kto pośredniczy w tym procesie.

Dlatego w endpoint-cie do informowania Apilo o przesyłce należy podawać ID tych przewoźników, którzy mają wartość pola „isBroker” = false.

[

{
"id": 3,
"key": "CARRIER_253",
"name": "Inpost (Kurier, Paczkomaty, Allegro)",333
"description": null,
"isBroker": false
},

{
"id": 143,
"key": "CARRIER_258",
"name": "Wysyłam z Allegro",
"description": null,
"isBroker": true
},

{
"id": 5,
"key": "CARRIER_257",
"name": "Poczta Polska",
"description": null,
"isBroker": false
},

{
"id": 25,
"key": "CARRIER_249",
"name": "DPD Polska",
"description": null,
"isBroker": false
},

{
"id": 6,
"key": "CARRIER_252",
"name": "GLS Polska",
"description": null,
"isBroker": false
},

{
"id": 111,
"key": "CARRIER_265",
"name": "UPS",
"description": null,
"isBroker": false
},

{
"id": 110,
"key": "CARRIER_256",
"name": "ORLEN Paczka",
"description": null,
"isBroker": false
},

{
"id": 160,
"key": "CARRIER_375",
"name": "ShipCenter",
"description": null,
"isBroker": true
},

{
"id": 145,
"key": "CARRIER_236",
"name": "Furgonetka",
"description": null,
"isBroker": true
},

{
"id": 142,
"key": "CARRIER_245",
"name": "Apaczka",
"description": null,
"isBroker": true
},

{
"id": 28,
"key": "CARRIER_231",
"name": "DHL Polska",
"description": null,
"isBroker": false
},

{
"id": 115,
"key": "CARRIER_250",
"name": "Fedex Polska",
"description": null,
"isBroker": false
},

{
"id": 149,
"key": "CARRIER_251",
"name": "Global24",
"description": null,
"isBroker": true
},

{
"id": 141,
"key": "CARRIER_246",
"name": "Bliska Paczka (SendIT)",
"description": null,
"isBroker": true
},

{
"id": 146,
"key": "CARRIER_235",
"name": "Dostawy Erli.pl",
"description": null,
"isBroker": true
},

{
"id": 140,
"key": "CARRIER_232",
"name": "Eurohermes",
"description": null,
"isBroker": true
},

{
"id": 119,
"key": "CARRIER_233",
"name": "Geodis",
"description": null,
"isBroker": false
},

{
"id": 112,
"key": "CARRIER_254",
"name": "Kurier zewnętrzny",
"description": null,
"isBroker": false
},

{
"id": 144,
"key": "CARRIER_144",
"name": "AllegroOneBox",
"description": null,
"isBroker": false
}
...
]

Uwaga: Allegro pojawiło się na liście dwa razy.

Allegro prócz bycia brokerem ma też swoją własną metodę wysyłki, tj. Allegro One Box.

Jak uzyskać media UUID? (kontekst informowania o przesyłce tworzonej poza Apilo)

 

UUID jest nadawany plikowi w momencie jego tworzenia, a w tym przypadku podczas wysyłania żądania HTTP z nagłówkiem informującym o nazwie pliku i plikiem w treści żądania (body)

POST http://{{apilo_client_account}}.apilo.com/rest/api/media/

Authorization: Bearer {{access_token}}

Content-Disposition: filename=inpost-label-nr-987654.pdf

W odpowiedzi zostanie zwrócony m.in. UUID.

{

„uuid”: „f419bdcf-1a4c-56bf-b28c-15a59a32fbad”,

„name”: „inpost-label-nr-987654.pdf”,

„type”: „application\/pdf”,

„expiresAt”: „2024-09-25T16:07:44+0200”

}

Nadal potrzebujesz pomocy?

Porozmawiaj z konsultantem