API pozwala Twojemu systemowi składać zamówienia w Ikonce bez udziału pracownika. Ceny i warunki są te same co w sklepie, a znika przepisywanie i pomyłki w kodach. Dostęp jest bezpłatny i otwarty dla wszystkich kontrahentów. Wyjaśniamy, jak to działa, co zyskuje Twoja firma i jak zacząć.
Czym jest API?
API to umówiony sposób, w jaki dwa programy wymieniają dane bez udziału człowieka. Najprościej myśleć o nim jak o stałym formularzu zamówienia, który wypełnia Twój system, a nie pracownik.
Dziś zamówienie w hurtowni wygląda zwykle tak: ktoś zbiera potrzeby, loguje się do sklepu, wpisuje kody i ilości, wybiera dostawę i klika „zamów”. Przy kilkudziesięciu pozycjach w tygodniu to godziny pracy i ryzyko pomyłki w kodzie albo ilości.
Z API Twój system - sklep internetowy, ERP albo program magazynowy - wysyła zamówienie do Ikonki sam, w kilka sekund. Odpowiedź wraca od razu: numer zamówienia albo dokładna informacja, co trzeba poprawić.
Jeśli pobierasz już od nas plik XML z ofertą, stanami i cenami, połowę drogi masz za sobą. Oferta płynie do Ciebie automatycznie, a API zamyka drugi kierunek: zamówienia wracają do nas tą samą, automatyczną drogą.
Co zyskujesz?
API nie zmienia warunków współpracy, tylko sposób dostarczenia zamówienia. Zamiast człowieka robi to system, a Twój zespół zajmuje się sprzedażą, nie przepisywaniem.
Mniej czasu na zamówienia. Dziś ktoś musi wpisać każdą pozycję ręcznie. Przez API Twój system wysyła całe zamówienie w kilka sekund.
Mniej pomyłek. Literówka w kodzie, zła ilość czy pominięta pozycja przestają być problemem. Każde zamówienie jest sprawdzane, zanim do nas trafi, a jeśli coś się nie zgadza, dostajesz od razu wszystkie uwagi naraz, z podpowiedzią, co poprawić.
Zamawiasz wtedy, kiedy potrzebujesz. Nie musisz czekać, aż dział zakupów usiądzie do komputera.
Te same warunki. Cennik, rabaty ilościowe i za pełne kartony, koszty dostawy i termin płatności są dokładnie takie same jak przy zamówieniu w sklepie.
Bez podwójnych zamówień. Przy ręcznym zamawianiu łatwo wpisać to samo zamówienie dwa razy. Przez API zamówienie wysłane ponownie z tym samym numerem nie tworzy drugiego.
Spokojniejszy sezon. Więcej zamówień nie oznacza więcej ręcznej pracy, więc szczyt sprzedaży obsłużysz bez dokładania etatów.
Jak się podłączyć?
Podłączenie to jednorazowa praca dla programisty po Twojej stronie albo firmy, która obsługuje Twój system. Integracja obejmuje dwie rzeczy: pobranie dostępnych form dostawy i płatności oraz wysyłanie zamówień.
1. Konto B2B w sklepie Ikonki. Jeśli zamawiasz u nas, już je masz. API loguje się tym samym e-mailem i hasłem, więc nie zakładasz nowych kont.
2. Dokumentacja dla Twojego IT. Programista albo firma wdrożeniowa dostaje dokumentację po polsku i po angielsku, z gotowymi przykładami: https://orders-api.ikonka.eu/docs/pl
3. Testy bez ryzyka. Każde zamówienie można najpierw tylko sprawdzić: przechodzi pełną weryfikację, ale nie zostaje złożone. Integrację testujesz na prawdziwych kodach i ilościach.
4. Pierwsze zamówienie. Gdy sprawdzenie przechodzi, Twój system wysyła to samo zamówienie naprawdę i dostaje numer zamówienia w Ikonce. Od tej chwili działa to samo.
Po Twojej stronie potrzebny jest system, który potrafi wysłać zapytanie przez internet. Robi to większość systemów ERP i platform sklepowych. Jeśli nie masz pewności, zapytaj dostawcę swojego systemu albo firmę, która go obsługuje.
Czego API nie robi?
API służy do składania zamówień. Pozostałe sprawy załatwiasz tak jak dziś.
- Status, numer przesyłki i faktura. Widzisz je na swoim koncie w sklepie, jak przy każdym innym zamówieniu. Stamtąd weźmiesz też numer przesyłki dla swojego klienta.
- Oferta i stany. Do tego służy plik XML.
- Zmiana i anulowanie zamówienia. Obsługujemy je tak jak przy zamówieniach składanych w sklepie.
Najczęstsze pytania
Czy dostęp do API jest płatny?
Nie, dostęp jest bezpłatny.
Czy muszę wymieniać swój system?
Nie. Programista raz łączy go z Ikonką, a potem zamówienia płyną same, bez zmian w codziennej pracy zespołu.
Czy nadal mogę zamawiać ręcznie?
Tak. Sklep działa jak dotąd, a oba sposoby możesz łączyć.
Czy przez API zapłacę inne ceny?
Nie. Ceny, rabaty, koszty dostawy i termin płatności wynikają z warunków Twojego konta, tak samo jak w sklepie.
Co, jeśli zabraknie jednego produktu?
Zamówienie nie przejdzie, a Twój system dostanie listę braków. Może od razu wysłać je ponownie bez brakujących pozycji.
Czy przed złożeniem zobaczę wartość zamówienia?
Tak. Sprawdzenie bez składania podaje wartość produktów, koszt dostawy i liczbę paczek.
A jeśli połączenie zerwie się w trakcie wysyłania?
Twój system wysyła zamówienie jeszcze raz, z tym samym numerem. Nie powstanie drugie zamówienie ani druga paczka.
W skrócie
API zmienia tylko drogę, którą zamówienie trafia do Ikonki. Ceny, warunki i obsługa zostają takie same, a czas Twojego zespołu wraca do sprzedaży.
🔗 https://orders-api.ikonka.eu/docs/pl
