Taxxo umożliwia zamianę „obrazu” faktury w dane. Zapewniamy zarówno w modelu czysto maszynowym (OCR), jak również procesie pełnej digitalizacji (wspomaganej zespołem korektorów).
Jak wykorzystać usługę digitalizację w Taxxo na potrzebny zewnętrznego systemu przy pomocy API?
Krok 1. Należy posiadać Klucz API (API - Jak rozpocząć integrację z Taxxo wykorzystując API?) i zapoznać się ze sposobem autoryzacji (API - Proces autoryzacji na przykładzie pobrania listy faktur sprzedaży z e-Faktury)
Pełna dokumentacja Taxxo API - https://platforma2.taxxo.pl/api/documentation/
Krok 2. Kiedy w systemie zewnętrznym pojawi się dokument (np. PDF) do digitalizacji należy go wysłać do Taxxo za pomocą metody POST /api/public/document. Szczegółowy przykład jak to zrobić jest tutaj (link do artykułu powyżej) Mapowanie danych pomiędzy Taxxo a systemem zewnętrznym
- W odpowiedzi w sekcji „Data” zostanie zwrócone ID dokumentu w Taxxo – można je zapamiętać w systemie zewnętrznym, aby po otrzymaniu wyników skojarzyć z dokumentem źródłowym
- Innym rozwiązaniem jest wpisanie w jakieś pole niepodlegające digitalizacji (np. Notes, ExternalDocumentId, itp.) identyfikatora dokumentu w systemie zewnętrznym przed przesłaniem do Taxxo. Wówczas podczas pobierania danych po digitalizacji ta informacja będzie dostępna.
Krok 3. Cyklicznie odpytywać metodę GET /api/public/documents/readyToExternalProcess – która zwraca wszystkie dokumenty, które są już po procesie digitalizacji, ale nie przetworzone przez system zewnętrzny (zalecamy odpytywać nie częściej niż co 15 min i limitować ilość pobieranych równocześnie dokumentów do 50-100)
Krok 4. Po przetworzeniu dokumentu przez system zewnętrzny – oznaczyć ten fakt w Taxxo za pomocą wywołania metody PUT /api/public/document/{documentId}/setAsProcessed. Tak oznaczony dokument nie będzie pojawiał się w liście readyToExternalProcess.
Pakiet Taxxo Ultimate
Jeżeli posiadają Państwo konto Taxxo Ultimate – w module e-Dokumenty będzie dostępna opcja „Outsourcing”, dzięki której z poziomu Platformy Taxxo można sprawdzić status przetworzenia dokumentu przez system zewnętrzny, datę przetworzenia jak i skierować dokument do ponownej wysyłki do systemu zewnętrznego.
Dodatkowo w ramach konta poziomu Taxxo Ultimate możliwe jest:
- digitalizować dokumenty wszystkich spółek z grupy bez rozdzielania ich przed procesem digitalizacji, poprzez podanie wielu numerów NIP spółek z grupy, których dokumenty mogą trafić z systemu zewnętrznego i zostaną zaakceptowane w procesie digitalizacji (standardowo na jedno konto API przypada jeden NIP).
- Ustawić pobierania danych pełno-tekstowych znalezionych przez proces OCR i pobierać do systemu zewnętrznego w celu wyszukiwania dodatkowych informacji (wymaga użycia metody GET /api/public/document/{documentId} dla każdego zdigitalizowanego dokumentu)
Kontakt w sprawie API – api@taxxo.pl