Escáner de compras: API pública y MCP

24 de septiembre de 2026 — el escáner de compras se suma a la API pública y al servidor MCP, junto a la app ya existente: sube facturas de proveedores y recibos, revisa los datos extraídos, resuelve duplicados y convierte un escaneo revisado en un borrador de compra. Consulta la guía del escáner.

Trece operaciones nuevas

Qué añade cada operación

• Filtros nuevos del listado — GET /v1/purchase_scans filtra por source, supplier_id, document_kind, file_kind, supplier_link_state, has_issues y sender; source y supplier_id admiten una lista de valores separada por comas. Los elementos del listado incluyen esos mismos tres campos de clasificación más issue_count, el número de incidencias pendientes de revisar — no el recuento bruto de incidencias por campo. document_kind es uno de invoice, simplified_qualified, ticket, delivery_note, other o undetermined.
• Campos de compra por línea y catalog_selection en la revisión — un parche de línea en PUT /v1/purchase_scans/{id}/review puede fijar los cinco campos específicos de compra en cuanto estén disponibles en el escaneo (supplier_sku, unit_code, price_unit_code, package_quantity, measured_base_quantity) y catalog_selection, que vincula una línea extraída a un producto, variante o presentación resuelto; omitirlo conserva la selección actual y un producto de otra empresa es 422.
• scope y facets en las estadísticas — GET /v1/purchase_scans/stats admite scope=inbox (por defecto) o scope=history, y añade facets.by_document_kind, facets.by_file_kind y facets.by_supplier_link_state junto a sus contadores de estado ya existentes.
• Varios resultados en el buzón — GET /v1/purchase_scan_emails filtra por varios valores de result a la vez y cada entrada publica también sender_authentication y, cuando aplica, reason.
• 413 en el borde — un lote o archivo que supera los límites de subida (20 archivos, 20 MiB por archivo, 100 MiB por lote) se rechaza antes de llegar a la aplicación, con un cuerpo JSON 413 payload_too_large, no un error de aplicación.

Dos operaciones existentes también cambian

• POST /v1/purchase_invoices y PUT /v1/purchase_invoices/{id} ahora aceptan hasta 10.000 caracteres en notes — antes 1.000 — igualando el límite que ya usa la revisión del escaneo.
• Ambas también rechazan un external_id que empiece por el prefijo reservado purchase-scan: con 422 parameter_invalid_value: ese prefijo está reservado a las facturas que el propio escáner crea al convertir.

Consulta los códigos de error de Purchase Scans para los 23 códigos, y el catálogo de tools MCP para las once tools nuevas — diez del escáner más list_purchase_invoice_expense_categories.