FISCALISTO / API / REFERENCIA
FISCALISTO / API / REFERENCIA
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.
bearerAuthAutorizaciónBearer <llave>Su llave secreta: fk_test_… en pruebas, fk_live_… en producción. Desarrolladores › Llaves.
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/jsonissuer?stringEmisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse.
account?stringLa cuenta (CLABE o número; se guardan sus últimos 4 dígitos).
length <= 40transactions*array<>Los depósitos, hasta 1,000 por solicitud.
1 <= items <= 1000Correcto.
application/jsonLos depósitos que se agregaron.
object*stringQué tipo de objeto es («invoice», «customer»…).
livemode*booleantrue en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT.
issuer*stringEl emisor.
added*integerCuántos depósitos se agregaron.
-9007199254740991 <= value <= 9007199254740991duplicates*integerCuántos ya estaban (se omitieron).
-9007199254740991 <= value <= 9007199254740991data*array<>Los depósitos agregados.
curl -X POST 'https://api.fiscalisto.com/v1/bank_transactions' \ -H 'Authorization: Bearer fk_test_…' \ -H 'Idempotency-Key: 8f14e45f-ceea-467a-9575-6a1b0e5f3c21' \ -H 'Content-Type: application/json' \ -d '{ "account": "012180001234567891", "transactions": [ { "date": "2026-10-24", "amount": 5800, "description": "SPEI RECIBIDO INMOBILIARIA CVA", "reference": "F-1024", "payer_tax_id": "ICV060329BY0" } ]}'{ "object": "bank_import", "livemode": true, "issuer": "string", "added": -9007199254740991, "duplicates": -9007199254740991, "data": [ { "id": "string", "livemode": true, "object": "bank_transaction", "issuer": "string", "date": "string", "amount": 0, "description": "string", "reference": "string", "account": "string", "payer_tax_id": "string", "status": "open", "classification": "venta", "note": "string", "invoices": [ "string" ], "payment": "string", "suggested_match": { "invoices": [ "string" ], "amounts": { "property1": 0, "property2": 0 }, "method": "PPD", "confidence": "high", "reasons": [ "string" ] }, "created_at": "2019-08-24T14:15:22Z" } ]}