Přeskočit na hlavní obsah

Přehled funkcí pro zpracování faktur pomocí AI

Tato část dokumentace popisuje sadu funkcí, které umožňují automatické zpracování faktur pomocí umělé inteligence (AI) v rámci systému EspoCRM. Hlavním cílem je zjednodušit a urychlit proces importu faktur do systému, snížit množství manuální práce a zvýšit přesnost získaných dat.

Hlavní funkce​

  • Změna stavu záznamů - Umožňuje hromadnou změnu stavu záznamů faktur (např. označení jako dokončené nebo přijaté).
  • Hlášení chyb při zpracování - Uživatelé mohou nahlásit problémy při automatickém zpracování faktur, což pomáhá vylepšovat algoritmy AI.
  • Automatické spouštění zpracování - Při vytvoření nebo úpravě záznamu se automaticky spustí proces zpracování faktury pomocí AI.

Jak to funguje​

Systém pracuje se speciální entitou AiParsingRecord, která reprezentuje fakturu v procesu zpracování. Při nahrání nové faktury se vytvoří záznam s počátečním stavem. Následně:

  • Pokud je záznam označen jako přijatý (STATUS_RECEIVED), systém začne s jeho zpracováním.
  • Po úspěšném zpracování je záznam označen jako dokončený (STATUS_COMPLETED).
  • V případě problémů může uživatel nahlásit chybu, což změní stav na STATUS_FAILED a odešle informace vývojářům pro vylepšení algoritmů.

Závislosti​

  • Pro správu dat využívá systém standardní ORM vrstvu EspoCRM (EntityManager)
  • Pro komunikaci s externím AI systémem používá speciální nástroj (AiParsingTool)
  • Pro extrakci dat z faktur využívá továrnu na extraktory (ExtractorFactory)

Technické informace​

Změna stavu záznamů​

Endpoint: POST /AiParsingRecord/action/changeStatus/\{newStatus\}

  • newStatus: Požadovaný stav (received nebo completed)
  • Tělo požadavku musí obsahovat pole ids s identifikátory záznamů
  • Maximální počet záznamů pro hromadnou operaci je 250

Hlášení chyb při zpracování​

Endpoint: POST /AiParsingRecord/action/reportParsingError

  • Povinný parametr entityType v URL
  • Tělo požadavku musí obsahovat pole ids a volitelně description s popisem problému
  • Automaticky kontaktuje externí API pro nahlášení chyby

Automatické spouštění zpracování​

  • Hook je aktivován před uložením entity AiParsingRecord
  • Volá službu AiParsingRecord pro spuštění procesu zpracování