FISCALISTO / API / REFERENCIA
Explicar un depósito sin factura
Un depósito que ninguna factura explica: venta (aún sin facturar), prestamo, traspaso o devolucion. El SAT puede presumir ingreso un depósito sin explicar (CFF art. 59 fr. III).
bearerAuthAutorizaciónBearer <llave>Su llave secreta: fk_test_… en pruebas, fk_live_… en producción. Desarrolladores › Llaves.
id*stringEl id del objeto.
Idempotency-Key?stringOpcional (los SDK la mandan solos). Si la respuesta se pierde, repita la solicitud con el mismo valor durante 24 horas: contesta lo mismo, con idempotent-replayed: true, y no lo hace dos veces (ni crea, ni manda correos, ni cobra).
1 <= length <= 255application/json- body
classification*stringventa (una venta que aún no se factura), prestamo, traspaso (entre cuentas propias) o devolucion.
"venta""prestamo""traspaso""devolucion"note?stringUna nota para su equipo (de dónde vino, por qué).
length <= 500Correcto.
application/json- response
Un depósito de la cuenta del emisor, y las facturas que pagó.
id*stringIdentificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_).
livemode*booleantrue en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT.
object*stringQué tipo de objeto es («invoice», «customer»…).
issuer*stringEl emisor.
date*stringEl día del depósito (AAAA-MM-DD).
amount*numberLo depositado, en pesos.
description*stringEl concepto del banco.
reference*|La referencia o clave de rastreo, o null.
account*|Los últimos 4 dígitos de la cuenta, o null.
payer_tax_id*|El RFC de quien depositó, si se sabe.
status*stringopen (sin conciliar), matched (pagó facturas) o classified (no es de una factura).
"open""matched""classified"classification*|classified: venta (aún sin facturar), prestamo, traspaso o devolucion; si no, null.
note*|Una nota al clasificarlo, o null.
invoices*array<string>Las facturas (inv_…) que pagó, si está conciliado.
payment*|El complemento de pago (inv_…) timbrado con él, o null.
suggested_match*|Si está abierto, las facturas que parece pagar (por monto, RFC, folio en el concepto y fecha): invoices, lo que toca a cada una (amounts), method, confidence (high o medium) y por qué (reasons). null si ninguna encaja.
created_at*|Cuándo se mandó.
curl -X POST 'https://api.fiscalisto.com/v1/bank_transactions/string/classify' \ -H 'Authorization: Bearer fk_test_…' \ -H 'Idempotency-Key: 8f14e45f-ceea-467a-9575-6a1b0e5f3c21' \ -H 'Content-Type: application/json' \ -d '{ "classification": "traspaso", "note": "De la cuenta de ahorro"}'{ "id": "btx_OufpKqnrvx9p9Rt4sLm2XyT5uBcW8sKdLx", "object": "bank_transaction", "livemode": false, "issuer": "iss_OufpKqnrvx9p", "date": "2026-10-24", "amount": 5800, "description": "SPEI RECIBIDO INMOBILIARIA CVA · ICV060329BY0", "reference": "F-1024", "account": "4821", "payer_tax_id": "ICV060329BY0", "status": "open", "classification": null, "note": null, "invoices": [], "payment": null, "suggested_match": { "invoices": [ "inv_OufpKqnrvx9p6hW1yQbT3mZr8sKdLx0VeN" ], "amounts": { "inv_OufpKqnrvx9p6hW1yQbT3mZr8sKdLx0VeN": 5800 }, "method": "PUE", "confidence": "high", "reasons": [ "Mismo monto", "RFC del cliente en el concepto" ] }, "created_at": "2026-10-25T09:00:00-06:00"}Conciliar un depósito POST
El depósito pagó estas facturas (de un mismo cliente), o sin invoices, las de suggested_match. Sus facturas PUE por cobrar quedan pagadas (invoice.paid). No timbra: para pagar una PPD con este depósito, POST /v1/payments con bank_transaction.
Deshacer la conciliación POST
Vuelve a open, y sus facturas vuelven a deber. Si se pagó con un complemento vigente, cancélelo antes.