FISCALISTO / API / REFERENCIA
Ver un depósito
Un depósito mandado a conciliación, con las facturas que se le encontraron o el pago que se registró con él.
bearerAuthAutorizaciónBearer <llave>Su llave secreta: fk_test_… en pruebas, fk_live_… en producción. Desarrolladores › Llaves.
id*stringEl id del objeto.
Correcto.
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 GET 'https://api.fiscalisto.com/v1/bank_transactions/string' \ -H 'Authorization: Bearer fk_test_…'{ "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"}Mandar depósitos POST
Los depósitos de la cuenta del emisor (de la API de su banco o de un estado de cuenta), hasta 1,000 por solicitud. Uno que ya mandó (mismo día, monto, referencia y concepto) se omite, así que puede mandar periodos que se enciman. Cada uno trae suggested_match: las facturas que parece pagar.
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.