Ver una solicitud de datos

Ir al contenido

GET

/v1/customer_data_requests/{id}

Una solicitud de datos: su liga y, si el cliente ya contestó, sus datos fiscales y el cliente que se guardó.

Autorización

bearerAuth

headerAutorizaciónBearer <llave>

Su llave secreta: fk_test_… en pruebas, fk_live_… en producción. Desarrolladores › Llaves.

Parámetros de la ruta

id*string

El id del objeto.

Cuerpo de la respuesta

Correcto.

application/json

response

Una liga para que un cliente dé sus datos fiscales.

id*string

Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_).

livemode*boolean

true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT.

object*string

Qué tipo de objeto es («invoice», «customer»…).

issuer*string

El emisor que le va a facturar.

status*string

open (la liga espera), completed (el cliente mandó sus datos), expired (venció) o canceled.

Uno de"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 GET 'https://api.fiscalisto.com/v1/customer_data_requests/string' \  -H 'Authorization: Bearer fk_test_…'

{  "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"  }}

Ver una solicitud de datos

AutorizaciónCopiar enlace a esta sección

Parámetros de la rutaCopiar enlace a esta sección

Cuerpo de la respuestaCopiar enlace a esta sección

Autorización

Parámetros de la ruta

Cuerpo de la respuesta