Perfiles fiscales de cliente
El registro fiscal y los datos de receptor de factura electrónica de un cliente en México.
Campos
El nombre API es el que usan la API, MCP y la CLI.
| Nombre | Nombre API | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
| ID | id | ID de registro | Sí | |
| Fecha de emisión de la CSF | date | Fecha | Fecha impresa en la constancia (Lugar y Fecha de Emisión), no la fecha de carga. | |
| Constancia de situación fiscal (CSF) | csf | PDF emitido por el SAT. Al guardar, el sistema extrae RFC, régimen y domicilio fiscal. | ||
| Nombre o denominación social | razonSocial | Texto | Nombre legal registrado ante el SAT — denominación social para personas morales, nombre completo para personas físicas. | |
| Tipo de entidad | persona | Constante | Tipo de contribuyente según la CSF. Opcional en borrador; obligatorio para emitir CFDI. | |
| Uso de CFDI predeterminado | usoCfdi | Texto | UsoCFDI predeterminado cuando esta parte actúa como receptor del CFDI. | |
| CURP | curp | Texto | Clave Única de Registro de Población para personas físicas. | |
| Residencia fiscal | residenciaFiscal | Texto | País de residencia fiscal cuando el receptor es extranjero (CFDI 4.0). | |
| Núm. registro ID tributario | numRegIdTrib | Texto | Identificador fiscal en el país de residencia cuando el receptor es extranjero. | |
| Calle | calle | Texto | ||
| Número exterior | numeroExterior | Texto | ||
| Número interior | numeroInterior | Texto | ||
| Colonia | colonia | Texto | ||
| Localidad | localidad | Texto | ||
| Municipio o alcaldía | municipio | Texto | ||
| Entidad federativa | estado | Texto | Estado mexicano (c_Estado). Debe coincidir con los registros del SAT. | |
| País del domicilio | pais | Texto | Código de país del domicilio fiscal registrado ante el SAT. | |
| Código postal fiscal | codigoPostal | Texto | Debe coincidir con el registrado ante el SAT. Obligatorio en CFDI 4.0 como DomicilioFiscalReceptor. | |
| Régimen fiscal | regimenFiscal | Texto | Sí | Régimen fiscal SAT (c_RegimenFiscal). Debe coincidir con la CSF y el nodo Emisor/Receptor del CFDI. |
| Régimen capital | regimenCapital | Texto | Régimen de capital de la CSF (solo personas morales), p. ej. S.A. de C.V. | |
| Creado por | createdBy | Usuario | ||
| Creado el | createdAt | Fecha y Hora | Sí | |
| Actualizado por | updatedBy | Usuario | ||
| Actualizado el | updatedAt | Fecha y Hora | Sí | |
| Bloqueado por | blockedBy | Usuario | ||
| Bloqueado el | blockedAt | Fecha y Hora | ||
| Archivado por | archivedBy | Usuario | ||
| Archivado el | archivedAt | Fecha y Hora |
Relaciones
Los registros poseídos (línea sólida) se eliminan con su dueño. Los registros agrupados (línea punteada) pueden existir solos.
Acciones
Lo que puedes hacer con un registro. Cada acción también envía el evento de webhook fiscalmxcustomers.<acción>. Las lecturas (find, get, count) funcionan en toda tabla.
| Nombre | Nombre API | Descripción | Dónde |
|---|---|---|---|
| Crear | create | Crea un perfil. | App · API · MCP · CLI |
| Editar | update | Guarda los cambios del perfil. | App · API · MCP · CLI |
| Eliminar | delete | Elimina el perfil y los datos que le pertenecen. No se puede deshacer. | App · API · MCP · CLI |