VulCode

Integracja Apilo przez REST API

Apilo zbiera sprzedaż z marketplace'ów, sklepów i kurierów. Gdy Twój system nie ma z nim gotowego połączenia, łączymy go przez REST API Apilo: zamówienia, dokumenty, magazyn i przesyłki.

Sprzedaż wielokanałowa
Panel sklepu B2B: zapytania do REST API Apilo z jednego dnia, odczyt zamówień zmienionych od poprzedniego odczytu z filtrem daty, zakodowanym plusem strefy czasowej, limitem i przesunięciem, nagłówki zapytania i trzy zamówienia zaktualizowane w sklepie

Kiedy Apilo, a kiedy kod

Apilo ma gotowe integracje z marketplace'ami, sklepami, kurierami, programami księgowymi, WMS i hurtowniami. Kod jest potrzebny tylko tam, gdzie Twój system nie jest jednym z nich.

  • Gotowe integracje Apilo

    Marketplace'y i sklepy
    Np. Allegro, przez gotowe integracje Apilo.
    Kurierzy
    Wysyłka obsługiwana w Apilo.
    Programy księgowe, WMS i hurtownie
    Np. Subiekt podłączony do Apilo.

  • Twój system

    Sklep albo panel B2B na zamówienie
    Zamówienia idą do Apilo po przyjęciu albo opłaceniu, a produkty, ceny i przesyłki wracają do sklepu.
    Własny magazyn
    Produkty, atrybuty i zdjęcia magazynu Apilo, po każdej zmianie w nim.
    System, który ma dostać dokumenty i statusy z Apilo
    Dokumenty sprzedaży po wystawieniu i statusy zamówień według mapy statusów konta.

Autoryzacja i pierwsze zapytania

Apilo używa tokenów dostępowych i odświeżających. Integracja dba, żeby nigdy nie zostać bez ważnego tokena.

Połączenie z Apilo w panelu sklepu B2B: token dostępowy ważny 21 dni z odświeżeniem dobę przed wygaśnięciem, token odświeżający, mapa statusów konta z jednym statusem bez odpowiednika i nagłówki każdego zapytania

  1. Token odświeżany przed wygaśnięciem

    Kod autoryzacyjny wymieniamy na token dostępowy i odświeżający. Nowy token pobieramy przed wygaśnięciem, nie po błędzie.

    POST /rest/auth/token/refresh_token

  2. Mapy zamiast założeń

    Statusy, metody płatności, kurierzy i platformy mają w Apilo własne identyfikatory. Integracja pobiera ich mapy, zamiast wpisywać wartości na sztywno.

    GET /rest/api/orders/status/map/

  3. Te same nagłówki w każdym zapytaniu

    Każde zapytanie, także autoryzacyjne, wymaga nagłówków Accept i Content-Type z application/json.

    Accept: application/jsonAuthorization: Bearer

Apilo w środku, Twój system obok

Typowy układ: Apilo obsługuje kanały i kurierów, a integracja łączy je z tym, czego Apilo nie zna.

Apilo
zamówienia, magazyn, wysyłka
  • Zamówienia ze sklepuprzyjęcie albo opłacenie
  • Statusy zamówieńzmiana po dowolnej stronie
  • Produkty i cenyzmiana w magazynie Apilo
  • Przesyłki i śledzenienadanie paczki
  • Dokumenty sprzedażywystawienie dokumentu

  • Sklep na zamówienie

    zamówienia do Apilo, stany do sklepu

    Opłacone albo przyjęte zamówienia trafiają do Apilo, a stany i numery przesyłek wracają do sklepu.

    • Zamówienia ze sklepu
    • Statusy zamówień
    • Produkty i ceny
    • Przesyłki i śledzenie

    Więcej: Sklepy & E-commerce

  • Allegro i marketplace'y

    gotowe integracje Apilo

    Zamówienia wchodzą do Apilo przez jego gotowe integracje, bez naszego kodu.

  • Subiekt i wFirma

    dokumenty i faktury

    Dokumenty i faktury w programie księgowym podpiętym do Apilo.

    • Dokumenty sprzedaży

    Więcej: Faktury i ERP

  • KSeF

    faktury z programu albo z Twojego kodu

    Faktury do KSeF wysyła zwykle program księgowy podpięty do Apilo albo Twój system.

    • Dokumenty sprzedaży

    Więcej: KSeF

  • Panel B2B

    statusy i przesyłki dla klientów

    Klient widzi status zamówienia i numer przesyłki w swoim panelu.

    • Statusy zamówień
    • Przesyłki i śledzenie

    Więcej: Panele i Dashboardy

Co widzi Twój klient B2B

Kierunki ustalamy osobno dla każdego rodzaju danych. Na ekranie zamówienie w sklepie B2B na telefonie klienta.

Zamówienie w sklepie B2B na telefonie: ścieżka statusów od przyjęcia do wysłania, przesyłka kurierska z numerem i przyciskiem śledzenia, faktura w PDF i pozycje zamówienia

  1. Statusy zamówień

    Statusy płyną w obie strony, przełożone według mapy statusów konta.

    ApiloSklep B2Bzmiana po dowolnej stronie

  2. Przesyłki i śledzenie

    Numer przesyłki trafia do panelu klienta po nadaniu paczki w Apilo.

    ApiloSklep B2Bnadanie paczki

  3. Dokumenty sprzedaży

    Faktura wystawiona do zamówienia trafia do panelu klienta albo do ERP.

    ApiloSklep B2Bwystawienie dokumentu

Na co uważamy przy Apilo

Szczegóły z dokumentacji, które decydują o stabilności integracji.

Zapytanie albo ustawienieWedług dokumentacji ApiloCo robi integracjaPrzed startem
Zapytanie albo ustawienieGET /rest/api/orders/Kilka procesów integracji naraz
Według dokumentacji ApiloLimit 150 zapytań na minutę
Co robi integracjaJeden licznik dla wszystkich procesów, zmiany zbierane w paczki
Obsłużone przed startem
Zapytanie albo ustawienielimit=2000Największa lista z jednego zapytania
Według dokumentacji ApiloDo 2000 pozycji, dalsze strony przez offset
Co robi integracjaPrzy dużym ruchu odczyt przyrostowy, nie cała lista
Obsłużone przed startem
Zapytanie albo ustawienieContent-Type: application/jsonTakże przy POST /rest/auth/token/
Według dokumentacji ApiloAccept i Content-Type z application/json w każdym zapytaniu
Co robi integracjaStałe nagłówki klienta API, także przy autoryzacji
Obsłużone przed startem
Zapytanie albo ustawienie/rest/api/orders/status/map/Statusy i przewoźnicy konta
Według dokumentacji ApiloIdentyfikatory różne na każdym koncie
Co robi integracjaMapy pobierane przy starcie i po zmianach w panelu
Obsłużone przed startem
Zapytanie albo ustawienieupdatedAfter=2026-10-08T09:36:00+02:00Data ze strefą czasową w filtrze GET
Według dokumentacji ApiloPlus strefy zakodowany, inaczej czytany jako spacja
Co robi integracjaPlus wysyłany jako %2B, zakres się nie przesuwa
Obsłużone przed startem
Zapytanie albo ustawienierefresh_tokenToken dostępowy przed wygaśnięciem
Według dokumentacji ApiloNowa para tokenów z POST /rest/auth/token/
Co robi integracjaOdświeżenie przed wygaśnięciem, nie po błędzie
Obsłużone przed startem

6 sprawdzeń, zanim integracja zacznie zapisywać w Apilo

Najczęstsze pytania o integrację z Apilo

Odpowiedzi o wyborze systemu, KSeF, testach i wycenie.

Czytaj dalej

Systemy i integracje, które idą w parze z Apilo.

Co ma się łączyć z Twoim Apilo?

Napisz, jakie kanały masz w Apilo i jaki system ma z nim rozmawiać. Odpowiemy w godzinę z pytaniami i wyceną.