Factuarea APIDevelopers
Contracte

Escanejos de compra: historial acotat, OCR ajornat i faceta de proveïdors

El detall de l’escaneig retorna ara els 50 intents i esdeveniments d’auditoria més recents amb els seus totals, els escanejos que esperen la quota diària d’OCR ho indiquen i les estadístiques afegeixen una faceta per proveïdor.

24 de setembre de 2026 — tres novetats a l’API de l’escàner de compres. Només la primera canvia alguna cosa que ja reps. Consulta la guia de l’escàner.

  • El detall de l’escaneig retorna els 50 attempts i esdeveniments d’audit més recents — del més nou al més antic, a GET /v1/purchase_scans/{id} i a totes les operacions que retornen l’escaneig complet (retry, review, duplicate_resolution, convert, archive, restore), a més de la tool MCP get_purchase_scan. Abans, les dues llistes creixien amb cada reintent i cada edició. Dos enters nous, attempts_total i audit_total, indiquen quants n’hi ha en total: un escaneig amb 60 intents retorna 50 entrades i attempts_total: 60. Llegeix els totals en lloc de comptar les llistes. Les entrades no canvien.
  • Els escanejos que esperen la quota diària d’OCR ho indiquen — deferred_until (ISO 8601) i deferred_reason (ocr_daily_quota_reached) apareixen als elements del llistat i al detall. Mentre deferred_until tingui valor, l’escaneig es reintenta sol quan es reinicia la quota de l’empresa: no cal cridar retry. En qualsevol altre cas, tots dos són null.
  • Nova facets.by_supplier a les estadístiques — GET /v1/purchase_scans/stats enumera els proveïdors amb almenys un escaneig vinculat dins de l’scope demanat, cadascun amb el seu id, name i count, ordenats per count descendent i després per nom, amb un màxim de 100 entrades.

Endpoints actualitzats3

EndpointDescripció
GET/v1/purchase_scansLlistar escaneigs de compres
GET/v1/purchase_scans/{purchase_scan}Consultar un escaneig de compra
GET/v1/purchase_scans/statsConsultar indicadors de l’escàner de compres