Přeskočit na hlavní obsah

API Endpointy pro zpracování faktur

Tato část dokumentace detailně popisuje dostupné API endpointy pro práci s automatickým zpracováním faktur.

Změna stavu záznamů​

Endpoint umožňuje hromadnou změnu stavu záznamů faktur. Podporované stavy jsou:

  • received - Faktura byla přijata k zpracování
  • completed - Faktura byla úspěšně zpracována

Omezení​

  • Maximálně 250 záznamů v jedné operaci
  • Pro stav completed musí mít záznam již vyplněné pole parsedData

Hlášení chyb​

Endpoint pro nahlášení problému při zpracování faktury. Umožňuje:

  • Odeslat informace o chybě do externího systému AI
  • Automaticky označit záznamy jako neúspěšné (STATUS_FAILED)

Speciální chování​

  • Funguje i pro související entity (extractory a providery)
  • Automaticky generuje popis chyby pokud není zadán

Technické informace​

ChangeStatus API​

  • Třída: ChangeStatus
  • Metoda: process(Request $request): Response
  • Validace:
  • Kontrola existence parametru newStatus
  • Kontrola existence a formátu pole ids
  • Ověření maximálního počtu záznamů
  • Pro stav completed ověření existence parsedData

ReportParsingError API​

  • Třída: ReportParsingError
  • Metoda: process(Request $request): Response
  • Závislosti:
  • AiParsingTool pro komunikaci s externím API
  • EntityManager pro práci s daty
  • Speciální logika:
  • Podpora hlášení chyb pro související entity
  • Automatické sestavení podmínek pro dotaz do databáze