📚 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.
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.
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.
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.
- API Azymutu
- baza po EAN
- porównanie hurtowni
- najlepsza oferta
Automatyczne zamówienia u hurtowni
Ten sam system składa zamówienia w Ateneum i w Platonie i zapisuje wynik w BaseLinkerze.
- BaseLinker
- wybór hurtowni
- zamówienie
- status
Jak pracujemy
Konsultacja
Ustalamy, do czego mają służyć dane z Azymutu: oferta w sklepie, porównanie z innymi hurtowniami czy automatyczne zamówienia.
Dostęp do API
Identyfikator i klucz od Azymutu, sprawdzenie odpowiedzi API i formatu danych na Twoim koncie.
Integracja
Pobranie katalogu do bazy, powiązanie z EAN, dostępność i ceny z obsługą limitu zapytań.
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.
Python i FastAPI
Pobieranie i parsowanie XML, obsługa limitu zapytań, API z ofertami hurtowni.
PostgreSQL
Indeksy Azymutu z EAN, obok danych innych hurtowni.
n8n
Przepływ zamówienia z BaseLinkera, który korzysta z porównania ofert. Integracja n8n →
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
- Odpisujemy w ciągu 1 dnia roboczego.
- Umawiamy 30-minutową rozmowę.
- Przygotowujemy propozycję i wycenę.
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ą.
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ą.
- 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.
- Jedno odświeżenie naraz. Gdy kilka zapytań trafi na przeterminowane dane, odświeżenie startuje raz, a reszta na nie czeka.
- Miękki limit czasu. Po 10 sekundach system odpowiada z poprzednich danych, a odświeżanie kończy się w tle.
- 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.
| Hurtownia | Format | Odświeżanie |
|---|---|---|
| Azymut | API XML: katalog partiami, listy dostępności i cen | dane na żywo, pamięć podręczna ok. 2,5 minuty |
| Ateneum | pliki CSV ze stanami i cenami, EAN z zapytania na pozycję | stany co 10 minut, ceny 3 razy dziennie |
| Platon | plik XML z ceną netto i stanem | co 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ń.

