Kod API (token API) to pewien rodzaj klucza dostępu, który identyfikuje Ciebie jako użytkownika naszego systemu w integracjach z innymi platformami. Kod API przekazuje się do zewnętrznego programu (np. platformy e-commerce), żeby ten miał dostęp do konta w Fakturowni i mógł wysyłać rozkazy (API requesty) do Fakturowni, w celu wykonywania zadanych akcji w systemie. Akcje, które mogą być wykonywane w ten sposób, opisujemy w naszej bibliotece API.
Dowiedz się, jak skorzystać z tej funkcji, korzystając z interaktywnego przewodnika.
- Za pomocą kodu autoryzacyjnego API możesz zintegrować swoje konto w Fakturowni z systemem Sugester CRM/Helpdesk. Dzięki temu możesz w jednym miejscu przeglądać informacje o swoich klientach (CRM) i prowadzić z nimi kontakt (mail, chat, VoIP) oraz kontrolować przeprowadzane z nimi transakcje. Szczegółowy opis integracji z systemiem Sugester znajdziesz w artykule Integracja z Sugesterem.
- API umożliwia również integrację z Fiskatorem, modułem fiskalnym umożliwiającym wygodny wydruk paragonu lub faktury na drukarce fiskalnej bezpośrednio z Twojego konta w Fakturowni.
Skąd pobrać kod autoryzacyjny API?
Kod autoryzacyjny możesz wygenerować po przejściu do zakładki Ustawienia > Ustawienia konta > Integracja > Kod autoryzacyjny API > Zobacz APITokeny.
Po przejściu do listy tokenów API system wyświetli listę aktywnych tokenów. Tokeny systemowe są zawsze zamaskowane gwiazdkami.
Token ręczny, który tworzysz samodzielnie do własnej integracji, jest widoczny w pełnej wartości przez 60 minut od utworzenia lub do pierwszego użycia (co nastąpi pierwsze) - żebyś zdążył go skopiować. Po tym czasie (lub po pierwszym użyciu) również zostaje zasłonięty gwiazdkami i nie ma możliwości ponownego podejrzenia go w całości.
W formularzu tworzenia tokenu API dostępne są dwa pola:
- rodzaj - to pole pozwala wybrać rodzaj tworzonego tokenu jako token lub token z prefiksem, czyli nazwą konta w systemie;
- opis - to pole możesz uzupełnić nazwą integracji, do której wykorzystasz dany token, jest to pole informacyjne widoczne wyłącznie w systemie.
Pamiętaj, że wygenerowany token API działa wyłącznie na tym koncie, na którym został utworzony. Jeśli posiadasz kilka kont w Fakturowni zarejestrowanych na ten sam adres e-mail, token z jednego konta nie zadziała na pozostałych - na każdym koncie, które chcesz zintegrować, musisz zalogować się osobno i wygenerować dla niego własny token.
Jeśli natomiast masz w ramach jednego konta kilka firm lub działów (funkcja wiele firm, wiele działów), jeden token API obsługuje wszystkie z nich - konkretną firmę/dział wskazujesz w zapytaniu API parametrem department_id.
Usuwanie i wyłączanie tokenu API
Jeśli token API jest powiązany z aktywną integracją, próba jego usunięcia lub wyłączenia wyświetli dodatkowe potwierdzenie z informacją, co dokładnie przestanie działać po tej operacji. W zależności od integracji zobaczysz jej nazwę (np. aplikacja mobilna, Brutto) albo nazwę zakładki, w której ją skonfigurowano (np. KSeF, drukarki fiskalne), a czasem też wartość konkretnego tokenu, jeśli masz ich kilka dla tej samej integracji. Dopiero świadomie kliknięcie przycisku Usuń połączenie usunie konkretny token. Treśc komunikatu może się różnić w zależności od aktywnych integracji.
Zwykłe tokeny API, które nie zostały utworzone automatycznie przez integrację, można usunąć bez tego dodatkowego potwierdzenia.
Interaktywny przewodnik poprowadzi Cię krok po kroku na rzeczywistych ekranach Fakturowni, umożliwiając łatwe zrozumienie i wykonanie potrzebnych działań.
Kliknij Start aby rozpocząć, a następnie klikaj w niebieskie pola, lub użyj strzałek w prawym dolnym rogu do nawigowania po instrukcji.