Factuarea APIDevelopers
Contrato

Escaneos de compra: historial acotado, OCR aplazado y faceta de proveedores

El detalle del escaneo devuelve ahora los 50 intentos y eventos de auditoría más recientes con sus totales, los escaneos que esperan la cuota diaria de OCR lo indican y las estadísticas añaden una faceta por proveedor.

24 de septiembre de 2026 — tres novedades en la API del escáner de compras. Solo la primera cambia algo que ya recibes. Consulta la guía del escáner.

  • El detalle del escaneo devuelve los 50 attempts y eventos de audit más recientes — del más nuevo al más antiguo, en GET /v1/purchase_scans/{id} y en todas las operaciones que devuelven el escaneo completo (retry, review, duplicate_resolution, convert, archive, restore), además de la tool MCP get_purchase_scan. Antes, las dos listas crecían con cada reintento y cada edición. Dos enteros nuevos, attempts_total y audit_total, indican cuántos hay en total: un escaneo con 60 intentos devuelve 50 entradas y attempts_total: 60. Lee los totales en lugar de contar las listas. Las entradas no cambian.
  • Los escaneos que esperan la cuota diaria de OCR lo indican — deferred_until (ISO 8601) y deferred_reason (ocr_daily_quota_reached) aparecen en los elementos del listado y en el detalle. Mientras deferred_until tenga valor, el escaneo se reintenta solo cuando se reinicia la cuota de la empresa: no hace falta llamar a retry. En cualquier otro caso, los dos son null.
  • Nueva facets.by_supplier en las estadísticas — GET /v1/purchase_scans/stats enumera los proveedores con al menos un escaneo vinculado dentro del scope pedido, cada uno con su id, name y count, ordenados por count descendente y después por nombre, con un máximo de 100 entradas.

Endpoints actualizados3

EndpointDescripción
GET/v1/purchase_scansListar escaneos de compras
GET/v1/purchase_scans/{purchase_scan}Consultar un escaneo de compra
GET/v1/purchase_scans/statsConsultar indicadores del escáner de compras