Perfiles fiscales de empresa
El registro fiscal, el domicilio fiscal y el lugar de expedición predeterminado de una empresa que emite facturas electrónicas en México.
- Nombre API:
fiscalmxcompanies - Dominio: FiscalMX
- Módulos: Finanzas, Administración
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. | |
| Registro fiscal | taxregistrationId | Referencia | ||
| 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. | |
| CURP | curp | Texto | Clave Única de Registro de Población para personas físicas. | |
| 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. | |
| Mes de declaración anual | month | Número Entero | Número entero sin parte fraccionaria. | |
| Ambiente del PAC | pacEnvironment | Constante | Sin ambiente no se timbra. Solo un administrador lo cambia desde la app. | |
| Inicio de periodo | dateStart | Fecha | Fecha de calendario sin hora. | |
| Fin de periodo | dateEnd | Fecha | Fecha de calendario sin hora. | |
| 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í | |
| Facturación habilitada por | enabledFiscalBy | Usuario | ||
| Facturación habilitada el | enabledFiscalAt | Fecha y Hora | ||
| 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.
| Campo | Apunta a | Tipo |
|---|---|---|
Registro fiscal taxregistrationId | Registros fiscales | referencia |
Acciones
Lo que puedes hacer con un registro. Cada acción también envía el evento de webhook fiscalmxcompanies.<acción>. Las lecturas (find, get, count) funcionan en toda tabla.
| Nombre | Nombre API | Descripción | Dónde |
|---|---|---|---|
| Crear | create | Crea un perfil. | App · WebMCP · API · MCP · CLI |
| Editar | update | Guarda los cambios del perfil. | App · API · CLI |
| Habilitar facturación | enableFiscal | Habilitar fiscal-mx para esta empresa. | App · API · MCP · CLI |
| Exportar DIOT | exportDiot | Compilar hechos DIOT por proveedor para un periodo. No envía al SAT. | App · API · MCP · CLI |
| Usar PAC de producción | setPacProduction | Timbrar con el PAC de producción. Los CFDI tienen validez fiscal. | App · API · CLI |
| Usar PAC de pruebas | setPacSandbox | Timbrar con el PAC de pruebas. Los CFDI no tienen validez fiscal. | App · API · CLI |
| Eliminar | delete | Elimina el perfil y los datos que le pertenecen. No se puede deshacer. | App · WebMCP · API · MCP · CLI |
Estados
Cómo pasa un registro de un estado a otro. Archivar y bloquear pueden ocurrir en cualquier estado.
| Acción | Nombre API |
|---|---|
| Habilitar facturación | enableFiscal |