Ver una lectura de factura
El escaneo, con los duplicados recalculados (o el gasto, si ya se creó).
Autorización
apiKey expenses.scanLa llave del negocio, creada en el panel: Integraciones → API pública. vk_live_… es una llave real; vk_test_…, una llave de modo prueba (verificaciones simuladas, nada toca el libro real). Ver la guía «Modo de prueba».
Va en: header
Permiso: expenses.scan
Parámetros de la ruta
Parámetros de consulta
Sobre qué negocio actúa la petición. Obligatorio solo si la llave entra a varios negocios; con uno solo, se deduce.
Cuerpo de la respuesta
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/expense-scans/cmuhb7c8d0061x8w1f2g3h4jk"{ "object": "expenseScan", "id": "cmuhb7c8d0061x8w1f2g3h4jk", "outcome": "EXTRACTED", "message": null, "documentKind": "INVOICE", "confidence": "HIGH", "draft": { "amount": 357000, "subtotal": 300000, "tax": 57000, "paidTo": "Harina La Espiga S.A.S.", "vendorTaxId": "900123456-7", "invoiceNumber": "FE-20931", "occurredAt": "2026-10-10T05:00:00.000Z", "categoryId": "cmt7xbfrm0003q3w121ldx6wz", "categoryName": "Proveedores y mercancía", "paymentMethod": "TRANSFER", "accountLabel": null, "notes": "20 bultos de harina" }, "duplicates": [], "file": { "attachmentId": "cmuhb7c9e0062x8w1m4n5b6vc", "fileName": "factura-fe-20931.pdf", "contentType": "application/pdf", "size": 84210 }, "expenseId": null, "expense": null, "expiresAt": "2026-10-18T21:20:00.000Z", "createdAt": "2026-10-12T21:20:00.000Z"}Leer una factura con IA POST
«Registrar gasto con IA» del panel, por API: mandas la foto o el PDF de la factura y devuelve el **borrador** del gasto (proveedor, NIT, número de factura, fecha, total, subtotal, IVA, categoría sugerida) y los gastos parecidos que ya existen. **No crea nada** salvo con `create: true`. La factura queda guardada en nuestro almacenamiento privado; al crear el gasto se adjunta a él. Límite: 20 lecturas por minuto y 300 al día por negocio. No funciona con llaves de prueba.
Crear el gasto de una lectura POST
Crea el gasto con lo leído, más tus correcciones en `expense`, con la factura adjunta. **Un escaneo crea un gasto**: repetirlo devuelve el mismo (`200`).