Escàner de compres: API pública i MCP

24 de setembre de 2026 — l'escàner de compres se suma a l'API pública i al servidor MCP, juntament amb l'app ja existent: puja factures de proveïdors i rebuts, revisa les dades extretes, resol duplicats i converteix un escaneig revisat en un esborrany de compra. Consulta la guia de l'escàner.

Tretze operacions noves

Què afegeix cada operació

• Filtres nous del llistat — GET /v1/purchase_scans filtra per source, supplier_id, document_kind, file_kind, supplier_link_state, has_issues i sender; source i supplier_id admeten una llista de valors separada per comes. Els elements del llistat inclouen aquests mateixos tres camps de classificació més issue_count, el nombre d'incidències pendents de revisar — no el recompte brut d'incidències per camp. document_kind és un de invoice, simplified_qualified, ticket, delivery_note, other o undetermined.
• Camps de compra per línia i catalog_selection a la revisió — un pedaç de línia a PUT /v1/purchase_scans/{id}/review pot fixar els cinc camps específics de compra tan aviat com estiguin disponibles a l'escaneig (supplier_sku, unit_code, price_unit_code, package_quantity, measured_base_quantity) i catalog_selection, que vincula una línia extreta a un producte, variant o presentació resolts; ometre'l en conserva la selecció actual i un producte d'una altra empresa és 422.
• scope i facets a les estadístiques — GET /v1/purchase_scans/stats admet scope=inbox (per defecte) o scope=history, i afegeix facets.by_document_kind, facets.by_file_kind i facets.by_supplier_link_state al costat dels seus comptadors d'estat ja existents.
• Diversos resultats a la bústia — GET /v1/purchase_scan_emails filtra per diversos valors de result alhora i cada entrada publica també sender_authentication i, quan aplica, reason.
• 413 a la vora — un lot o arxiu que supera els límits de pujada (20 arxius, 20 MiB per arxiu, 100 MiB per lot) es rebutja abans d'arribar a l'aplicació, amb un cos JSON 413 payload_too_large, no un error d'aplicació.

Dues operacions existents també canvien

• POST /v1/purchase_invoices i PUT /v1/purchase_invoices/{id} ara accepten fins a 10.000 caràcters a notes — abans 1.000 — igualant el límit que ja fa servir la revisió de l'escaneig.
• Totes dues també rebutgen un external_id que comenci pel prefix reservat purchase-scan: amb 422 parameter_invalid_value: aquest prefix està reservat a les factures que el propi escàner crea en convertir.

Consulta els codis d'error de Purchase Scans per als 23 codis, i el catàleg de tools MCP per a les onze tools noves — deu de l'escàner més list_purchase_invoice_expense_categories.