Clientes
FISCALISTO / API / REFERENCIA
FISCALISTO / API / REFERENCIA
Cambia solo los campos que manda. Las facturas ya timbradas no cambian.
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/jsontax_id?stringRFC (Rfc), 12 caracteres una persona moral y 13 una física.
^[A-ZÑ&]{3,4}\d{6}[A-Z0-9]{3}$legal_name?stringNombre o razón social tal como está en la constancia de situación fiscal, sin el régimen de capital (sin «S.A. de C.V.»).
1 <= length <= 300tax_system?stringRégimen fiscal (RegimenFiscal), clave de c_RegimenFiscal: 601, 612, 626…
^6\d\d$zip?stringCódigo postal del domicilio fiscal, 5 dígitos, como en la constancia de situación fiscal. El de un emisor es el lugar de expedición (LugarExpedicion) de sus comprobantes.
^\d{5}$email?|Correo del cliente (varios separados por comas), a donde van sus facturas con send_email.
use?stringUso del CFDI (UsoCFDI), clave de c_UsoCFDI. Por omisión G03, o S01 con régimen 616.
^[A-Z]{1,2}\d{2}$foreign?|Si es extranjero: su país de residencia (ResidenciaFiscal, c_Pais) y su número de registro tributario (NumRegIdTrib), con el RFC genérico XEXX010101000.
ieps_taxpayer?booleantrue si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio.
Correcto.
application/jsonUn cliente del catálogo de un emisor.
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 (iss_…).
tax_id*stringRFC (Rfc), 12 caracteres una persona moral y 13 una física.
legal_name*stringNombre o razón social tal como está en la constancia de situación fiscal, sin el régimen de capital (sin «S.A. de C.V.»).
tax_system*stringRégimen fiscal (RegimenFiscal), clave de c_RegimenFiscal: 601, 612, 626…
zip*stringCódigo postal del domicilio fiscal, 5 dígitos, como en la constancia de situación fiscal. El de un emisor es el lugar de expedición (LugarExpedicion) de sus comprobantes.
email*|Correo del cliente (varios separados por comas), a donde van sus facturas.
use*|Uso del CFDI (UsoCFDI), clave de c_UsoCFDI. Por omisión G03, o S01 con régimen 616.
foreign*|Si es extranjero: su país de residencia (ResidenciaFiscal, c_Pais) y su número de registro tributario (NumRegIdTrib), con el RFC genérico XEXX010101000.
ieps_taxpayer*booleantrue si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio.
created_at*stringCuándo se creó, ISO 8601 con la hora de la Ciudad de México (-06:00).
date-timeupdated_at*|Cuándo cambió por última vez, ISO 8601 (-06:00).
curl -X POST 'https://api.fiscalisto.com/v1/customers/string' \ -H 'Authorization: Bearer fk_test_…' \ -H 'Idempotency-Key: 8f14e45f-ceea-467a-9575-6a1b0e5f3c21' \ -H 'Content-Type: application/json' \ -d '{ "email": "facturas@cva.example"}'{ "id": "cus_OufpKqnrvx9p1", "object": "customer", "livemode": false, "issuer": "iss_OufpKqnrvx9p", "tax_id": "ICV060329BY0", "legal_name": "INMOBILIARIA CVA", "tax_system": "601", "zip": "33826", "email": "pagos@cva.example", "use": "G03", "foreign": null, "ieps_taxpayer": false, "created_at": "2026-10-20T09:02:11-06:00", "updated_at": "2026-10-24T10:15:42-06:00"}