Tax receipts (CFDI)
A stamped Mexican electronic invoice for sales, credit notes, payroll, payments, or transfers.
- API name:
fiscalmxcfdis - Domain: FiscalMX
- Modules: Finances, Human resources
Fields
The API name is what the API, MCP and the CLI use.
| Name | API name | Type | Required | Description |
|---|---|---|---|---|
| ID | id | Record ID | Yes | |
| UUID | uuid | Text | ||
| Customer | customerId | Reference | ||
| Record | tableUid | Constant | Business table this row points to. | |
| Record ID | recordId | Text | ||
| Global period start | dateGlobalStart | Date | Calendar date for this value. | |
| Global period end | dateGlobalEnd | Date | Calendar date for this value. | |
| Periodicity | periodicity | Constant | Fixed option from the allowed set for this field. | |
| Source | source | Constant | Yes | Fixed option from the allowed set for this field. |
| Direction | direction | Constant | Yes | Fixed option from the allowed set for this field. |
| Version | version | Text | Whole number without fractional part. | |
| Series | serie | Text | ||
| Folio | folio | Text | ||
| Issue date | fecha | Date and Time | ||
| Digital seal | sello | Text | ||
| Certificate number | noCertificado | Text | ||
| Certificate | certificado | Text | ||
| Payment form | formaPago | Text | ||
| Payment conditions | condicionesDePago | Text | ||
| Currency | moneda | Text | ||
| Exchange rate | tipoCambio | Text | ||
| CFDI type | tipoDeComprobante | Constant | Yes | Fixed option from the allowed set for this field. |
| Purpose | purpose | Constant | Yes | Fixed option from the allowed set for this field. |
| Export | exportacion | Text | ||
| Payment method | metodoPago | Text | ||
| Place of issue | lugarExpedicion | Text | ||
| Confirmation | confirmacion | Text | ||
| Issuer tax ID | emisorRfc | Text | ||
| Issuer name | emisorNombre | Text | ||
| Issuer tax regime | emisorRegimenFiscal | Text | ||
| Issuer facility | emisorFacAtrAdquirente | Text | ||
| Receiver tax ID | receptorRfc | Text | ||
| Receiver name | receptorNombre | Text | ||
| Receiver tax address | receptorDomicilioFiscal | Text | ||
| Receiver tax regime | receptorRegimenFiscal | Text | ||
| CFDI use | receptorUsoCfdi | Text | ||
| Receiver tax residence | receptorResidenciaFiscal | Text | ||
| Foreign tax ID | receptorNumRegIdTrib | Text | ||
| Global periodicity | informacionGlobalPeriodicidad | Text | ||
| Global months | informacionGlobalMeses | Text | ||
| Global year | informacionGlobalAno | Text | ||
| PAC environment | environment | Constant | Environment the CFDI was stamped in. Sandbox CFDIs have no fiscal validity. | |
| Stamp version | timbreVersion | Text | ||
| Stamp date | timbreFechaTimbrado | Date and Time | ||
| PAC tax ID | timbreRfcProvCertif | Text | ||
| Stamp legend | timbreLeyenda | Text | ||
| CFDI seal | timbreSelloCfd | Text | ||
| SAT certificate number | timbreNoCertificadoSat | Text | ||
| SAT seal | timbreSelloSat | Text | ||
| XML | xml | |||
| Cancellation acuse | cancellationAcuse | |||
| Cancellation status | statusCancellation | Constant | Yes | Fixed option from the allowed set for this field. |
| SAT status | statusSat | Constant | Yes | Fixed option from the allowed set for this field. |
| Recognition mode | recognitionMode | Text | ||
| Host table | recognitionHostTableUid | Text | ||
| Payment receipt overdue | isRepOverdue | Boolean | Yes | When enabled, the named condition applies to this record. |
| Stamping overdue | isStampOverdue | Boolean | Yes | When enabled, the named condition applies to this record. |
| Replacement UUID | cancellationReplacementUuid | Text | ||
| Discount | descuento | Currency | Amount in the document or line currency. | |
| Withheld tax | totalImpuestosRetenidos | Currency | Monetary amount in the applicable currency for this record. | |
| Transferred tax | totalImpuestosTrasladados | Currency | Amount in the document or line currency. | |
| Issue payment complement by | datePagoDue | Date | Calendar date without time of date. | |
| Replaces CFDI | fiscalmxcfdiIdReplaces | Reference | ||
| Subtotal | subtotal | Currency | Sum of line amounts before tax and withholding on this document. | |
| Total | total | Currency | Document total after discounts, tax, and withholding in document currency. | |
| Status | status | Constant | Yes | Lifecycle or processing state from the allowed values for this record. |
| Cancellation motive | cancelRequestReason | Constant | Fixed option from the allowed set for this field. | |
| Recognition at | recognitionAt | Date and Time | ||
| Recognition by | recognitionBy | Reference | ||
| Created by | createdBy | User | ||
| Created at | createdAt | Date and Time | Yes | |
| Updated by | updatedBy | User | ||
| Updated at | updatedAt | Date and Time | Yes | |
| Stamped by | stampedBy | User | ||
| Stamped at | stampedAt | Date and Time | ||
| Canceled by | canceledBy | User | ||
| Canceled at | canceledAt | Date and Time | ||
| SAT canceled by | canceledSatBy | User | ||
| Canceled with SAT | canceledSatAt | Date and Time | ||
| Requested by | cancellationRequestedBy | User | ||
| Cancellation requested | cancellationRequestedAt | Date and Time | ||
| 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.
| Field | Points to | Kind |
|---|---|---|
Customer customerId | Customers | reference |
Replaces CFDI fiscalmxcfdiIdReplaces | Tax receipts (CFDI) | reference |
Actions
What you can do with a record. Every action also sends the webhook event fiscalmxcfdis.<action>. Reads (find, get, count) work on every table.
| Name | API name | Description | Where |
|---|---|---|---|
| Edit | update | Save changes to this cfdi. | App · WebMCP · API · MCP · CLI |
| Cancel | cancel | Reverse the posted effect of this cfdi. | App · WebMCP · API · MCP · CLI |
| Revoke external links | revoke | Revoke active external share links for this cfdi. | App · API · MCP · CLI |
| Close global period | closeGlobalPeriod | Close the global CFDI period. | App · API · MCP · CLI |
| Recognize | recognize | Link or draft a commercial host from an imported CFDI. Does not post. | App · API · MCP · CLI |
| Request cancellation | requestCancellation | Request cancellation of this stamped CFDI. | App · API · MCP · CLI |
| Reseal | reseal | Refresh CFDI Fecha and rebuild XML before stamping. | App · API · MCP · CLI |
| Share externally | share | Publish and send an external link to this document. | App · API · MCP · CLI |
| Stamp | stamp | Enqueue this CFDI for PAC stamping. | App · API · CLI |
| Substitute | substitute | Create a CFDI that replaces this one (relation 04) so you can cancel it with reason 01. | App · API · CLI |
| Block | block | Stop edits and deletion of this cfdi. It stays visible and can still appear on existing documents. Unblock to edit again. | App · WebMCP · API · MCP · CLI |
| Unblock | unblock | Allow edits and deletion of this cfdi again. | App · WebMCP · API · MCP · CLI |
| Archive | archive | Retire this cfdi from daily use. It leaves active lists and pickers, and most actions stop. Unarchive to restore it. | App · WebMCP · API · MCP · CLI |
| Restore | unarchive | Return this cfdi to active lists and actions. | App · WebMCP · API · MCP · CLI |
States
How a record moves from state to state. Archive and block can happen in any state.
| Action | API name |
|---|---|
| Cancel | cancel |
| Request cancellation | requestCancellation |