Customer fiscal profiles
The tax registration and electronic invoice receiver data of one customer in Mexico.
Fields
The API name is what the API, MCP and the CLI use.
| Name | API name | Type | Required | Description |
|---|---|---|---|---|
| ID | id | Record ID | Yes | |
| CSF issue date | date | Date | Date printed on the certificate (place and date of issue), not the upload time. | |
| Tax status certificate (CSF) | csf | PDF issued by SAT. On save, the system extracts RFC, tax regime, and fiscal address. | ||
| Legal name | razonSocial | Text | Legal name registered with SAT — business name for legal entities, full name for individuals. | |
| Entity type | persona | Constant | Taxpayer type per CSF. Optional in draft; required to issue CFDI. | |
| Default CFDI usage | usoCfdi | Text | Default UsoCFDI when this party acts as CFDI receiver. | |
| CURP | curp | Text | Unique Population Registry Code for individuals. | |
| Tax residence | residenciaFiscal | Text | Country of tax residence when the receiver is foreign (CFDI 4.0). | |
| Foreign tax ID | numRegIdTrib | Text | Tax identifier in the country of residence when the receiver is foreign. | |
| Street | calle | Text | ||
| Exterior number | numeroExterior | Text | ||
| Interior number | numeroInterior | Text | ||
| Neighborhood | colonia | Text | ||
| Locality | localidad | Text | ||
| Municipality | municipio | Text | ||
| State | estado | Text | Mexican state (c_Estado). Must match SAT records. | |
| Address country | pais | Text | Country code of the fiscal address registered with SAT. | |
| Fiscal postal code | codigoPostal | Text | Must match SAT registration. Required in CFDI 4.0 as DomicilioFiscalReceptor. | |
| Tax regime | regimenFiscal | Text | Yes | SAT tax regime (c_RegimenFiscal). Must match CSF and CFDI Issuer/Receiver nodes. |
| Capital regime | regimenCapital | Text | Capital regime from CSF (legal entities only), e.g. S.A. de C.V. | |
| Created by | createdBy | User | ||
| Created at | createdAt | Date and Time | Yes | |
| Updated by | updatedBy | User | ||
| Updated at | updatedAt | Date and Time | Yes | |
| Blocked by | blockedBy | User | ||
| Blocked at | blockedAt | Date and Time | ||
| Archived by | archivedBy | User | ||
| Archived at | archivedAt | Date and Time |
Relations
Owned records (solid line) are deleted with their owner. Grouped records (dashed line) can exist alone.
Actions
What you can do with a record. Every action also sends the webhook event fiscalmxcustomers.<action>. Reads (find, get, count) work on every table.
| Name | API name | Description | Where |
|---|---|---|---|
| Create | create | Add a new fiscal profile. | App · API · MCP · CLI |
| Edit | update | Save changes to this fiscal profile. | App · API · MCP · CLI |
| Delete | delete | Delete this fiscal profile and the data that belongs with it. This cannot be undone. | App · API · MCP · CLI |