Today Automate logo

📚 Hurtownia Azymut przez API XML

Integracja z hurtownią Azymut

Katalog, dostępność i ceny z Azymutu w Twojej bazie, z EAN jako wspólnym kluczem z innymi hurtowniami. Zbudowaliśmy i uruchomiliśmy taką integrację dla księgarni internetowej, razem z obsługą limitu zapytań, który Azymut nakłada na swoje API.

Wykresy z lupą, symbol porównania cen i stanów hurtowni

Integracja z hurtownią Azymut w skrócie

Integracja z hurtownią Azymut to połączenie API XML Azymutu z Twoim systemem, dzięki któremu katalog książek, dostępność i ceny trafiają do Twojej bazy bez ręcznego pobierania plików i sprawdzania panelu hurtowni. W naszym wdrożeniu system porównywał dane z Azymutu po EAN z ofertą Ateneum i Platona, żeby dla każdej pozycji zamówienia wskazać najtańszą hurtownię z towarem.

  • Katalog partiami.

    Każda odebrana partia jest potwierdzana, a niepotwierdzona wraca przy kolejnym pobraniu, więc nic nie ginie przy zerwanym połączeniu.

  • EAN jako klucz.

    Indeks Azymutu powiązany z kodem kreskowym, żeby porównać ofertę z innymi hurtowniami i z produktami w sklepie.

  • Dostępność i ceny na żywo.

    Pełne listy trzymane w pamięci przez ok. 2,5 minuty i odświeżane w tle.

  • Limit zapytań.

    Gdy API odpowie, że pytamy za często, integracja czeka podany czas z zapasem i dopiero wtedy ponawia.

Notes z ołówkiem, symbol katalogu książek

Oferta Azymutu bez ręcznego sprawdzania

Dziś: Ceny i stany Azymutu sprawdzane ręcznie w panelu hurtowni

Po wdrożeniu: Dostępność i ceny Azymutu w Twojej bazie, odświeżane w tle

Dziś: Porównanie z innymi hurtowniami w arkuszu

Po wdrożeniu: Porównanie po EAN z innymi hurtowniami w jednym zapytaniu

Dziś: Zbyt częste zapytania kończą się odmową API

Po wdrożeniu: Integracja czeka czas podany przez API i ponawia zapytanie

Dziś: Zerwane pobieranie katalogu trzeba zaczynać od nowa

Po wdrożeniu: Niepotwierdzona partia katalogu wraca przy kolejnym pobraniu

Dziś: Indeks hurtowni nie pasuje do produktów w sklepie

Po wdrożeniu: Indeks Azymutu powiązany z EAN, tym samym co w sklepie

Azymut staje się jedną z hurtowni w porównaniu, a nie osobnym panelem do sprawdzania.

Co łączymy z API Azymutu

Zakres ustalamy na konsultacji. W naszym wdrożeniu objął te elementy.

  • Katalog do bazy.

    Pobieranie katalogu partiami: indeks, tytuł, autorzy, wydawca, cena detaliczna i hurtowa, ISBN i kod kreskowy.

  • Powiązanie z EAN.

    Kod kreskowy z katalogu jako EAN, wspólny klucz z innymi hurtowniami i z produktami w sklepie.

  • Dostępność i ceny.

    Pełne listy dostępności i cen, a odczyt dla konkretnego indeksu z pamięci podręcznej, bez osobnego zapytania.

  • Obsługa limitu zapytań.

    Osobna blokada dla zapytań o dostępność i o ceny, czas oczekiwania z odpowiedzi API plus zapas.

  • Odpowiedź bez czekania.

    Gdy odświeżenie trwa dłużej niż 10 sekund, system odpowiada z poprzednich danych, a odświeżanie kończy się w tle.

  • Porównanie z innymi hurtowniami.

    Oferta Azymutu w tym samym API co Ateneum i Platon: najtańsza hurtownia, która ma towar.

Niebieskie koła zębate, symbol połączenia z API hurtowni

Azymut w naszych wdrożeniach

  • Księgarnia internetowa: porównanie hurtowni książek

    Zbudowaliśmy i uruchomiliśmy integrację z API Azymutu jako część systemu, który dla każdej pozycji zamówienia z BaseLinkera wybiera najtańszą hurtownię z towarem.

    1. API Azymutu
    2. baza po EAN
    3. porównanie hurtowni
    4. najlepsza oferta
    Czytaj case study →
  • Automatyczne zamówienia u hurtowni

    Ten sam system składa zamówienia w Ateneum i w Platonie i zapisuje wynik w BaseLinkerze.

    1. BaseLinker
    2. wybór hurtowni
    3. zamówienie
    4. status
    Zobacz integrację →

Jak pracujemy

  1. Konsultacja

    Ustalamy, do czego mają służyć dane z Azymutu: oferta w sklepie, porównanie z innymi hurtowniami czy automatyczne zamówienia.

  2. Dostęp do API

    Identyfikator i klucz od Azymutu, sprawdzenie odpowiedzi API i formatu danych na Twoim koncie.

  3. Integracja

    Pobranie katalogu do bazy, powiązanie z EAN, dostępność i ceny z obsługą limitu zapytań.

  4. Test i uruchomienie

    Porównanie danych z panelem hurtowni na wybranych pozycjach, potem start i opieka po wdrożeniu.

Czego nie robimy

  • Nie odpytujemy API Azymutu o każdą pozycję osobno, gdy wystarcza pełna lista dostępności i cen.
  • Nie ponawiamy zapytania od razu po odmowie: czekamy tyle, ile podaje API, i jeszcze chwilę.
  • Nie zapisujemy całych odpowiedzi hurtowni do plików i logów, bo szybko zapełniają dysk serwera.
  • Nie piszemy własnej integracji, gdy wystarcza gotowa integracja Azymutu w Base, np. do samej synchronizacji ofert.

Narzędzia

  • API XML Azymutu

    Katalog partiami, listy dostępności i cen.

  • Logo Python

    Python i FastAPI

    Pobieranie i parsowanie XML, obsługa limitu zapytań, API z ofertami hurtowni.

  • Logo PostgreSQL

    PostgreSQL

    Indeksy Azymutu z EAN, obok danych innych hurtowni.

  • Logo n8n

    n8n

    Przepływ zamówienia z BaseLinkera, który korzysta z porównania ofert. Integracja n8n →

  • Logo Baselinker

    BaseLinker API

    Zamówienia, dla których system szuka najtańszej hurtowni. BaseLinker API →

Opisz, co chcesz połączyć z Azymutem

Napisz, czym zajmuje się Twoja firma i co chcesz usprawnić.

Wrócimy z konkretną propozycją, a nie z ogólną prezentacją.

Co dzieje się dalej

  1. Odpisujemy w ciągu 1 dnia roboczego.
  2. Umawiamy 30-minutową rozmowę.
  3. Przygotowujemy propozycję i wycenę.

pole wymagane

Administratorem Twoich danych jest Today Group spółka z ograniczoną odpowiedzialnością (KRS 0001253446, NIP 9542911671). Użyjemy ich tylko po to, żeby odpowiedzieć na Twoje zapytanie. Podstawą jest nasz uzasadniony interes, czyli odpowiedź na Twoje zapytanie (art. 6 ust. 1 lit. f RODO). Masz prawo dostępu do danych, ich poprawienia, usunięcia i sprzeciwu. Szczegóły są w polityce prywatności.

Najczęstsze pytania

Jak zintegrować sklep z hurtownią Azymut?

Przez API XML Azymutu albo przez gotową integrację w Base (BaseLinkerze). Gotowa integracja wystarcza do synchronizacji stanów i cen w ofertach. Własną integrację przez API budujemy, gdy dane z Azymutu mają trafić do Twojej bazy, np. żeby porównać je z innymi hurtowniami po EAN albo użyć w automatycznych zamówieniach.

Jak działa API hurtowni Azymut?

API Azymutu odpowiada w XML, a tryb pracy wybiera się parametrem w adresie. W naszym wdrożeniu używaliśmy pobierania katalogu partiami, z potwierdzeniem odbioru każdej partii identyfikatorem transakcji, oraz pełnych list dostępności i cen. Każde zapytanie wymaga identyfikatora i klucza od Azymutu.

Dlaczego API Azymutu odpowiada, że pytamy za często?

Bo API ogranicza częstotliwość zapytań i w takiej odpowiedzi podaje, po ilu milisekundach można spytać ponownie. Integracja zapamiętuje ten czas osobno dla dostępności i dla cen, czeka z zapasem ok. 2 sekund i dopiero wtedy ponawia zapytanie. W tym czasie odpowiada z poprzednio pobranych danych.

Jak często odświeżają się stany i ceny z Azymutu?

W naszym wdrożeniu pełne listy dostępności i cen były ważne przez ok. 2,5 minuty. Pierwsze zapytanie po tym czasie uruchamiało odświeżenie w tle, a gdy trwało ono dłużej niż 10 sekund, system odpowiadał z poprzednich danych.

Jak porównać ceny Azymutu z innymi hurtowniami?

Po EAN. Katalog Azymutu wiąże indeks hurtowni z kodem kreskowym, a ten sam kod mają produkty w innych hurtowniach i w sklepie. Dla zamawianego EAN i ilości system zbiera oferty wszystkich hurtowni i wybiera najtańszą, która ma towar w potrzebnej ilości. Tak działa automatyczne zamawianie u hurtowni.

Czy Azymut ma integrację z BaseLinkerem?

Tak, w Base (BaseLinkerze) jest integracja z hurtownią OSDW Azymut, która synchronizuje stany i ceny ofert (stan na listopad 2026). Sam Azymut oferuje też współpracę w modelu dropshipping. Własne połączenie przez API ma sens, gdy potrzebujesz logiki, której gotowa integracja nie daje, np. wyboru najtańszej z kilku hurtowni dla każdej pozycji zamówienia.

Jak działa API hurtowni Azymut?

API Azymutu to usługa HTTP, która zwraca dane w XML. Tryb wybiera się parametrem w adresie, a każde zapytanie zawiera identyfikator klienta i klucz. W naszym wdrożeniu korzystaliśmy z trzech rodzajów danych.

  • Katalog partiami. Każde pobranie zwraca partię książek i identyfikator transakcji. Dopiero potwierdzenie tym identyfikatorem zdejmuje partię z kolejki, więc partia odebrana z błędem wraca przy kolejnym pobraniu.
  • Dostępność. Pełna lista indeksów z liczbą egzemplarzy. Gdy hurtownia podaje zakres, bierzemy dolną granicę.
  • Ceny. Pełna lista indeksów z ceną.
Kod kreskowy, nie ISBN. Do porównań z innymi hurtowniami używamy pola z kodem kreskowym jako EAN. ISBN zostaje w katalogu, ale nie jest kluczem.

Jak pobierać stany z Azymutu bez blokady API?

Azymut ogranicza, jak często można pytać o dostępność i ceny. Przy zbyt częstym zapytaniu API zamiast XML zwraca komunikat z czasem, po którym wolno spytać ponownie. Gdyby każde zamówienie odpytywało Azymut osobno, część zapytań kończyłaby się odmową.

  1. Pamięć podręczna. Pełne listy dostępności i cen są ważne przez ok. 2,5 minuty, a odczyt dla konkretnego indeksu idzie z pamięci.
  2. Jedno odświeżenie naraz. Gdy kilka zapytań trafi na przeterminowane dane, odświeżenie startuje raz, a reszta na nie czeka.
  3. Miękki limit czasu. Po 10 sekundach system odpowiada z poprzednich danych, a odświeżanie kończy się w tle.
  4. Czekanie z zapasem. Po odmowie integracja czeka czas z komunikatu plus ok. 2 sekundy, a przy kolejnych odmowach trochę dłużej.

Azymut, Ateneum i Platon: porównanie hurtowni książek po EAN

W systemie dla księgarni internetowej dane z trzech hurtowni trafiały do jednej bazy. Każda udostępnia je inaczej, więc każda ma własny moduł synchronizacji, a wspólny jest tylko klucz: EAN.

Jak hurtownie udostępniały dane w naszym wdrożeniu
HurtowniaFormatOdświeżanie
AzymutAPI XML: katalog partiami, listy dostępności i cendane na żywo, pamięć podręczna ok. 2,5 minuty
Ateneumpliki CSV ze stanami i cenami, EAN z zapytania na pozycjęstany co 10 minut, ceny 3 razy dziennie
Platonplik XML z ceną netto i stanemco 15 minut

Pozostałe hurtownie, z którymi się łączymy, znajdziesz na stronie integracje z hurtowniami.

Integracja Azymut z BaseLinkerem: gotowa czy własna?

Gotowa integracja z hurtownią OSDW Azymut w Base wystarcza, gdy chcesz wystawiać produkty Azymutu i synchronizować ich stany i ceny w ofertach. Własna integracja przez API ma sens, gdy dane z Azymutu są częścią większej logiki: porównania kilku hurtowni, wyboru dostawcy dla każdej pozycji zamówienia albo raportów zakupowych.

W naszym wdrożeniu Azymut był jedną z trzech hurtowni w API, które wybiera najtańszą ofertę. Azymut i Platon mają w nim przełącznik w konfiguracji, więc wyłączenie jednej hurtowni nie zmienia pracy pozostałych. Opis całego wdrożenia znajdziesz w case study automatyzacji zamówień.