Clientes
FISCALISTO / API / REFERENCIA
FISCALISTO / API / REFERENCIA
Una liga (url) que usted le manda a su cliente: la abre en fiscalisto.com y da su RFC, nombre, régimen, código postal y uso, escritos o leídos de su constancia, revisados antes de aceptarlos. Al mandarlos llega customer_data_request.completed. Un cliente nuevo queda en el catálogo del emisor; si ya existía con otros datos, los nuevos vienen en submission para que usted los aplique.
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?stringEl emisor (iss_…) que va a facturarle. Por omisión, su único emisor.
reference?stringSu id para este cliente o pedido, como «Pedido 1042». El cliente la ve arriba del formulario y viene de vuelta en el evento.
length <= 100description?stringUna línea que el cliente ve arriba del formulario: para qué son sus datos.
length <= 300expires_in_days?integerDías que la liga sirve, de 1 a 60. Por omisión 60.
1 <= value <= 60Correcto.
application/jsonUna liga para que un cliente dé sus datos fiscales.
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 que le va a facturar.
status*stringopen (la liga espera), completed (el cliente mandó sus datos), expired (venció) o canceled.
"open""completed""expired""canceled"url*|La liga para su cliente, en fiscalisto.com. null cuando ya no está abierta.
reference*|Su id para este cliente o pedido.
description*|Lo que el cliente ve arriba del formulario.
expires_at*|Cuándo deja de servir la liga.
created_at*|Cuándo se creó.
submission*|Lo que mandó el cliente (el último envío: puede corregirlo en las 24 horas siguientes). null mientras no conteste.
curl -X POST 'https://api.fiscalisto.com/v1/customer_data_requests' \ -H 'Authorization: Bearer fk_test_…' \ -H 'Idempotency-Key: 8f14e45f-ceea-467a-9575-6a1b0e5f3c21' \ -H 'Content-Type: application/json' \ -d '{ "reference": "cliente-8812", "description": "Para facturar su suscripción de octubre."}'{ "id": "cdr_0q1Vmmw52sbD4cHPqLfBvX0AkFg3hX2Ys", "object": "customer_data_request", "livemode": false, "issuer": "iss_0q1Vmmw52sbD", "status": "completed", "url": null, "reference": "cliente-8812", "description": "Para facturar su suscripción de octubre.", "expires_at": "2026-12-23T10:15:00-06:00", "created_at": "2026-10-24T10:15:00-06:00", "submission": { "tax_id": "ICV060329BY0", "legal_name": "INMOBILIARIA CVA", "tax_system": "601", "zip": "33826", "use": "G03", "email": "facturas@inmobiliariacva.mx", "source": "constancia", "customer": "cus_0q1Vmmw52sbD1", "applied": true, "submitted_at": "2026-10-24T11:02:41-06:00" }}