Správa: AI Parsing

Modul AI Parsing vyžaduje pro svou funkčnost připojení k externí službě Apertia.ai a správnou konfiguraci e-mailových zdrojů.

Instalace a prvotní nastavení

1. Nainstalujte rozšíření přes Administrace -> Rozšíření.
2. Přejděte do Administrace -> Integrace -> AiParsing.
3. Vyplňte přihlašovací údaje:
   • Endpoint: URL adresa API služby (např. https://api.apertia.ai/v1).
   • Token: Váš API klíč.
4. Uložte a ověřte spojení (pokud je k dispozici tlačítko testu, jinak se ověří při prvním pokusu).

Konfigurace chování

Globální nastavení naleznete v Administrace -> Nastavení (sekce AI Parsing).

Automatizace e-mailů

Pro automatické vytěžování faktur z e-mailů je nutné definovat sledované schránky.

• Parsable Emails: Seznam e-mailových adres (vašich firemních), na které chodí faktury. Pokud e-mail přijde na jednu z těchto adres (pole To), systém zkontroluje přílohy.
• Parsable Entities: Které typy dokladů se mají vytvářet (typicky SupplierInvoice - Přijatá faktura).

Logika párování

• Entity Matching Mode:
  • Create if not found: Pokud systém nenajde dodavatele podle IČO/názvu, vytvoří nový záznam Účtu.
  • Await existing: Pokud dodavatel neexistuje, proces se zastaví a čeká na ruční zásah.
• Auto Completion:
  • Pokud je zapnuto, systém se pokusí vytvořit cílový doklad ihned po analýze.
  • Pokud je vypnuto (doporučeno pro kontrolu), záznam zůstane ve stavu Parsed a uživatel musí data potvrdit.

Monitoring a řešení problémů

Protokoly (Logy)

Všechny akce modulu jsou logovány do standardního logu EspoCRM (data/logs/espoch-*.log). Hledejte klíčové slovo [AiParsingRecord].

Běžné chyby

1. Záznam zůstal ve stavu Sent:
   • Zkontrolujte, zda je server CRM dostupný z internetu (pro příjem webhooku).
   • Ověřte konfiguraci siteUrl v CRM – webhook URL se generuje na základě této adresy.
2. Chyba "No attachments found":
   • E-mail neobsahoval přílohu nebo byl formát přílohy ignorován (podporovány jsou obvykle PDF, JPG, PNG).
3. Chyba autentizace:
   • Ověřte platnost tokenu v Integracích.