Mexican SAT CFDI v4.X

Key: mx-cfdi-v4 Module: github.com/invopop/gobl.mx.cfdi

Scenarios

Scenarios attach notes and extensions to a document when its filters match. Read more about scenarios.

bill/invoice

Tags	Type	Output
-	`standard`	`{ “ext”: { “mx-cfdi-doc-type”: “I” } }`
-	`credit-note`	`{ “ext”: { “mx-cfdi-doc-type”: “E”, “mx-cfdi-rel-type”: “01” } }`
custom	`standard` `credit-note`	`{ “ext”: { “mx-cfdi-payment-method”: “PUE” } }`
custom	`standard` `credit-note`	`{ “ext”: { “mx-cfdi-payment-method”: “PPD” } }`

Extensions

Document Type

mx-cfdi-doc-type

Code	Name
`I`	Invoice
`E`	Credit Note
`P`	Payment

Relation Type

mx-cfdi-rel-type

Code	Name
`01`	Credit note for related documents
`02`	Debit note for related documents
`03`	Return of goods for related documents
`04`	Substitution of the previous CFDI document
`05`	Transfer of goods for related documents
`06`	Invoice generated by previous transfers
`07`	CFDI for advance payment

Place of Issue

Post code of where the invoice was issued. In CFDI, this translates to the ‘LugarExpedicion’.

mx-cfdi-issue-place

Pattern: ^[0-9]{5}$

Tax Type

Code defined in the CFDI catalogue “c_Impuesto” for the type of tax. Used in the ‘Impuesto’ field.

mx-cfdi-tax-type

Code	Name
`001`	Income Tax
`002`	Value Added Tax
`003`	Special Tax on Production and Services

Product or Service Code

Code defined in the CFDI catalogue used to identify a product or service. Mapped to the ‘ClaveProdServ’ CFDI field.

mx-cfdi-prod-serv

Fiscal Regime Code

Fiscal regime associated with suppliers and customers.

mx-cfdi-fiscal-regime

Code	Name
`601`	General de Ley Personas Morales
`603`	Personas Morales con Fines no Lucrativos
`605`	Sueldos y Salarios e Ingresos Asimilados a Salarios
`606`	Arrendamiento
`607`	Régimen de Enajenación o Adquisición de Bienes
`608`	Demás ingresos
`610`	Residentes en el Extranjero sin Establecimiento Permanente en México
`611`	Ingresos por Dividendos (socios y accionistas)
`612`	Personas Físicas con Actividades Empresariales y Profesionales
`614`	Ingresos por intereses
`615`	Régimen de los ingresos por obtención de premios
`616`	Sin obligaciones fiscales
`620`	Sociedades Cooperativas de Producción que optan por diferir sus ingresos
`621`	Incorporación Fiscal
`622`	Actividades Agrícolas, Ganaderas, Silvícolas y Pesqueras
`623`	Opcional para Grupos de Sociedades
`624`	Coordinados
`625`	Régimen de las Actividades Empresariales con ingresos a través de Plataformas Tecnológicas
`626`	Régimen Simplificado de Confianza

CFDI Use Code

Chosen by the customer to indicate the purpose of an invoice.

mx-cfdi-use

Code	Name
`G01`	Acquisition of goods
`G02`	Returns, discounts or rebates
`G03`	General expenses
`I01`	Construction
`I02`	Office furniture and equipment as investment
`I03`	Transport equipment
`I04`	Computer equipment and accessories
`I05`	Dies, punches, molds, matrices and other tooling
`I06`	Telephone communications
`I07`	Satellite communications
`I08`	Other machinery and equipment
`D01`	Medical and dental fees and hospital expenses
`D02`	Medical expenses for disability or incapacity
`D03`	Funeral expenses
`D04`	Donations
`D05`	Interest actually paid on mortgage loans (housing)
`D06`	Voluntary contributions to the SAR
`D07`	Medical insurance premiums
`D08`	Mandatory school transportation expenses
`D09`	Deposits in savings accounts, pension plans premiums
`D10`	Payments for educational services (school fees)
`S01`	Without tax effects
`CP01`	Payments
`CN01`	Payroll

Payment Method

Code defined in the CFDI catalogue “c_MetodoPago” for the payment method. Used in the ‘MetodoPago’ field.

mx-cfdi-payment-method

Code	Name
`PUE`	Payment in a single exhibition
`PPD`	Payment in deferred installments

Payment Means

Code defined in the CFDI catalogue “c_FormaPago” for the payment method. Used in the ‘FormaPago’ field.

mx-cfdi-payment-means

Code	Name
`01`	Cash
`02`	Check
`03`	Electronic Funds Transfer
`04`	Credit Card
`05`	Electronic Wallet
`06`	Online or Electronic Payment
`08`	Grocery Voucher
`12`	Payment in Kind
`13`	Payment by subrogation
`14`	Payment by consignment
`15`	Debt relief
`17`	Netting
`23`	Novation
`24`	Merger
`25`	Debt remission
`26`	Expiration of payment obligation
`27`	To the creditor’s satisfaction
`28`	Debit card
`29`	Services card
`30`	Advance payment
`31`	Payment via intermediary
`99`	Undefined

CFDI Global Period

Period for when the sales were generated.

mx-cfdi-global-period

Code	Name
`01`	Daily
`02`	Weekly
`03`	Biweekly
`04`	Monthly
`05`	Bimonthly

CFDI Global Month

Specific month or month range for the global invoice.

mx-cfdi-global-month

Code	Name
`01`	January
`02`	February
`03`	March
`04`	April
`05`	May
`06`	June
`07`	July
`08`	August
`09`	September
`10`	October
`11`	November
`12`	December
`13`	January-February
`14`	March-April
`15`	May-June
`16`	July-August
`17`	September-October
`18`	November-December

CFDI Global Year

mx-cfdi-global-year

Pattern: \d{4}

Cancellation Reason

Reason for cancelling a CFDI at the SAT. Reason 01 requires the UUID of the CFDI that substitutes it.

mx-cfdi-cancel-reason

Code	Name
`01`	Issued with errors, with relation
`02`	Issued with errors, without relation
`03`	The operation was not carried out
`04`	Nominative operation included in a global invoice

Validation Rules

Validation rules check each struct against a set of assertions and report any failures with a unique code and message. Read more about validation.

bill.Invoice

Field	Test	Validation Code / Message
Invoice	Can convert to [MXN]	`GOBL-MX-CFDI-BILL-INVOICE-27` Invoice must be in MXN or provide exchange rate for conversion
`tax.ext`	Ext require [mx-cfdi-doc-type, mx-cfdi-issue-place, mx-cfdi-payment-method]	`GOBL-MX-CFDI-BILL-INVOICE-01` Tax requires ‘mx-cfdi-doc-type’, ‘mx-cfdi-issue-place’, and ‘mx-cfdi-payment-method’ extensions
`tax.ext`	Has global tag Ext require [mx-cfdi-global-period, mx-cfdi-global-month, mx-cfdi-global-year]	`GOBL-MX-CFDI-BILL-INVOICE-02` Global invoices require ‘mx-cfdi-global-period’, ‘mx-cfdi-global-month’, and ‘mx-cfdi-global-year’ extensions
`customer`	Has global tag Empty	`GOBL-MX-CFDI-BILL-INVOICE-03` Cannot be set with global tag
`payment`	Has global tag Present	`GOBL-MX-CFDI-BILL-INVOICE-04` Payment is required for global invoices
`payment.advances`	Has global tag Present	`GOBL-MX-CFDI-BILL-INVOICE-05` Advances must be set with global tag
`lines[*].item.ref`	Has global tag Present	`GOBL-MX-CFDI-BILL-INVOICE-06` Must be set with global tag
`tax.ext`	No global tag Ext require all or none of [mx-cfdi-global-period, mx-cfdi-global-month, mx-cfdi-global-year]	`GOBL-MX-CFDI-BILL-INVOICE-07` ’mx-cfdi-global-period’, ‘mx-cfdi-global-month’, and ‘mx-cfdi-global-year’ extensions must all be present or all absent
`customer.tax_id`	No global tag Present	`GOBL-MX-CFDI-BILL-INVOICE-08` Customer tax ID is required
`customer.tax_id.code`	No global tag Present	`GOBL-MX-CFDI-BILL-INVOICE-09` Customer tax ID code is required
`customer.ext`	Customer is Mexican Ext require [mx-cfdi-fiscal-regime, mx-cfdi-use]	`GOBL-MX-CFDI-BILL-INVOICE-10` Mexican customer requires ‘mx-cfdi-fiscal-regime’ and ‘mx-cfdi-use’ extensions
`customer.addresses`	Customer is Mexican Present	`GOBL-MX-CFDI-BILL-INVOICE-11` Mexican customer must have at least one address
`customer.addresses[*].code`	Customer is Mexican Present	`GOBL-MX-CFDI-BILL-INVOICE-12` Customer address postal code is required
`customer.addresses[*].code`	Customer is Mexican Matches ^[0-9]$	`GOBL-MX-CFDI-BILL-INVOICE-13` Customer address postal code format is invalid
`lines[*].item.ext`	No global tag Ext require [mx-cfdi-prod-serv]	`GOBL-MX-CFDI-BILL-INVOICE-14` Item requires ‘mx-cfdi-prod-serv’ extension
`lines[*].item.ext`	No global tag Valid prod-serv	`GOBL-MX-CFDI-BILL-INVOICE-15` Product/service code must have 8 digits
`tax.ext`	Has preceding Ext require [mx-cfdi-rel-type]	`GOBL-MX-CFDI-BILL-INVOICE-16` Tax requires ‘mx-cfdi-rel-type’ extension when preceding documents are present
`preceding[*].stamps`	Stamps have sat-uuid	`GOBL-MX-CFDI-BILL-INVOICE-17` Preceding row is missing ‘sat-uuid’ stamp
`supplier.tax_id`	Present	`GOBL-MX-CFDI-BILL-INVOICE-18` Supplier tax ID is required
`supplier.tax_id.code`	Present	`GOBL-MX-CFDI-BILL-INVOICE-19` Supplier tax ID code is required
`supplier.ext`	Ext require [mx-cfdi-fiscal-regime]	`GOBL-MX-CFDI-BILL-INVOICE-20` Supplier requires ‘mx-cfdi-fiscal-regime’ extension
`lines[*].quantity`	Min 0	`GOBL-MX-CFDI-BILL-INVOICE-21` Line quantity must be greater than 0
`lines[*].item.price`	Present	`GOBL-MX-CFDI-BILL-INVOICE-22` Line item price is required
`lines[*].item.price`	Min 0	`GOBL-MX-CFDI-BILL-INVOICE-23` Line item price must be greater than 0
`lines[*].total`	Min 0	`GOBL-MX-CFDI-BILL-INVOICE-24` Line total must not be negative
`discounts`	Empty	`GOBL-MX-CFDI-BILL-INVOICE-25` Document level discounts are not supported, use line discounts instead
`charges`	Empty	`GOBL-MX-CFDI-BILL-INVOICE-26` Document level charges are not supported

bill.Payment

Field	Test	Validation Code / Message
Payment	Payment type in [receipt]	`GOBL-MX-CFDI-BILL-PAYMENT-01` Only payment receipts are supported
Payment	Can convert to MXN	`GOBL-MX-CFDI-BILL-PAYMENT-02` Payment must be in MXN or provide exchange rate for conversion
Payment	Line document currencies match	`GOBL-MX-CFDI-BILL-PAYMENT-28` Line document currency must match the payment currency
`ext`	Ext require [mx-cfdi-doc-type, mx-cfdi-issue-place]	`GOBL-MX-CFDI-BILL-PAYMENT-03` Payment requires ‘mx-cfdi-doc-type’ and ‘mx-cfdi-issue-place’ extensions
`ext`	Ext ‘mx-cfdi-doc-type’ in [P]	`GOBL-MX-CFDI-BILL-PAYMENT-04` Payment document type must be ‘P’
`supplier.tax_id`	Present	`GOBL-MX-CFDI-BILL-PAYMENT-05` Supplier tax ID is required
`supplier.tax_id.code`	Present	`GOBL-MX-CFDI-BILL-PAYMENT-06` Supplier tax ID code is required
`supplier.ext`	Ext require [mx-cfdi-fiscal-regime]	`GOBL-MX-CFDI-BILL-PAYMENT-07` Supplier requires ‘mx-cfdi-fiscal-regime’ extension
`customer`	Present	`GOBL-MX-CFDI-BILL-PAYMENT-08` Customer is required
`customer.tax_id`	Present	`GOBL-MX-CFDI-BILL-PAYMENT-09` Customer tax ID is required
`customer.tax_id.code`	Present	`GOBL-MX-CFDI-BILL-PAYMENT-10` Customer tax ID code is required
`customer.ext`	Ext require [mx-cfdi-use] Ext ‘mx-cfdi-use’ in [CP01]	`GOBL-MX-CFDI-BILL-PAYMENT-11` Customer’s ‘mx-cfdi-use’ must be ‘CP01’ for payments
`customer.ext`	Customer is Mexican Ext require [mx-cfdi-fiscal-regime]	`GOBL-MX-CFDI-BILL-PAYMENT-12` Mexican customer requires ‘mx-cfdi-fiscal-regime’ extension
`customer.addresses`	Customer is Mexican Present	`GOBL-MX-CFDI-BILL-PAYMENT-13` Mexican customer must have at least one address
`customer.addresses[*].code`	Customer is Mexican Present	`GOBL-MX-CFDI-BILL-PAYMENT-14` Customer address postal code is required
`customer.addresses[*].code`	Customer is Mexican Matches ^[0-9]$	`GOBL-MX-CFDI-BILL-PAYMENT-15` Customer address postal code format is invalid
`payee`	Empty	`GOBL-MX-CFDI-BILL-PAYMENT-16` Payee cannot be represented in a CFDI payment
`methods`	Length between 1 and 1	`GOBL-MX-CFDI-BILL-PAYMENT-17` Exactly one payment method is required
`methods[*].ext`	Ext require [mx-cfdi-payment-means]	`GOBL-MX-CFDI-BILL-PAYMENT-18` Payment method requires ‘mx-cfdi-payment-means’ extension
`methods[*].ext`	Ext ‘mx-cfdi-payment-means’ not in [99]	`GOBL-MX-CFDI-BILL-PAYMENT-19` Payment means ‘99’ (to define) is not allowed
`lines[*].refund`	Empty	`GOBL-MX-CFDI-BILL-PAYMENT-20` Refund lines are not supported
`lines[*].installment`	Present	`GOBL-MX-CFDI-BILL-PAYMENT-21` Installment number is required
`lines[*].payable`	Present	`GOBL-MX-CFDI-BILL-PAYMENT-22` Payable amount is required
`lines[*].due`	Present	`GOBL-MX-CFDI-BILL-PAYMENT-23` Due amount is required
`lines[*].document`	Present	`GOBL-MX-CFDI-BILL-PAYMENT-24` Line document is required
`lines[*].document.stamps`	Stamps have sat-uuid	`GOBL-MX-CFDI-BILL-PAYMENT-25` Line document requires the ‘sat-uuid’ stamp
`lines[*].tax`	No rate surcharges	`GOBL-MX-CFDI-BILL-PAYMENT-26` Tax rate surcharges are not supported
`lines[*].tax`	Retained rates with percent	`GOBL-MX-CFDI-BILL-PAYMENT-27` Retained tax rates must have a percent
`preceding[*].ext`	Ext require [mx-cfdi-rel-type] Ext ‘mx-cfdi-rel-type’ in [04]	`GOBL-MX-CFDI-BILL-PAYMENT-29` Preceding row’s ‘mx-cfdi-rel-type’ must be ‘04’
`preceding[*].stamps`	Stamps have sat-uuid	`GOBL-MX-CFDI-BILL-PAYMENT-30` Preceding row is missing ‘sat-uuid’ stamp

bill.Status

Field	Test	Validation Code / Message
`lines[*].ext`	Ext ‘mx-cfdi-cancel-reason’ in [01, 02, 03, 04]	`GOBL-MX-CFDI-BILL-STATUS-01` Line ‘mx-cfdi-cancel-reason’ extension is not valid

pay.Instructions

Field	Test	Validation Code / Message
`ext`	Ext require [mx-cfdi-payment-means]	`GOBL-MX-CFDI-PAY-INSTRUCTIONS-01` Payment instructions require ‘mx-cfdi-payment-means’ extension

pay.Record

Field	Test	Validation Code / Message
`ext`	Ext require [mx-cfdi-payment-means]	`GOBL-MX-CFDI-PAY-RECORD-01` Payment advance requires ‘mx-cfdi-payment-means’ extension

pay.Terms

Field	Test	Validation Code / Message
`notes`	Length at most 1000	`GOBL-MX-CFDI-PAY-TERMS-01` Notes length must be no more than 1000

addon.FoodVouchers

Field	Test	Validation Code / Message
`employer_registration`	Length at most 20	`GOBL-MX-CFDI-FOODVOUCHERS-01` Employer registration must be no more than 20 characters
`account_number`	Present	`GOBL-MX-CFDI-FOODVOUCHERS-02` Account number is required
`account_number`	Length at most 20	`GOBL-MX-CFDI-FOODVOUCHERS-03` Account number must be no more than 20 characters
`total`	Present	`GOBL-MX-CFDI-FOODVOUCHERS-04` Total is required
`lines`	Present	`GOBL-MX-CFDI-FOODVOUCHERS-05` Lines are required
`lines[*].e_wallet_id`	Present	`GOBL-MX-CFDI-FOODVOUCHERS-06` Line e-wallet ID is required
`lines[*].e_wallet_id`	Length at most 20	`GOBL-MX-CFDI-FOODVOUCHERS-07` Line e-wallet ID must be no more than 20 characters
`lines[*].issue_date_time`	Not zero	`GOBL-MX-CFDI-FOODVOUCHERS-08` Line issue date and time is required
`lines[*].employee`	Present	`GOBL-MX-CFDI-FOODVOUCHERS-09` Line employee is required
`lines[*].employee.tax_code`	Present	`GOBL-MX-CFDI-FOODVOUCHERS-10` Employee tax code (RFC) is required
`lines[*].employee.tax_code`	Valid RFC	`GOBL-MX-CFDI-FOODVOUCHERS-11` Employee tax code (RFC) must be valid
`lines[*].employee.curp`	Present	`GOBL-MX-CFDI-FOODVOUCHERS-12` Employee CURP is required
`lines[*].employee.curp`	Matches ^[A-Z][AEIOUX][A-Z][0-9][0-1][0-9][0-3][0-9][MH][A-Z][BCDFGHJKLMNÑPQRSTVWXYZ][0-9A-Z][0-9]$	`GOBL-MX-CFDI-FOODVOUCHERS-13` Employee CURP format must be valid
`lines[*].employee.name`	Present	`GOBL-MX-CFDI-FOODVOUCHERS-14` Employee name is required
`lines[*].employee.name`	Length at most 100	`GOBL-MX-CFDI-FOODVOUCHERS-15` Employee name must be no more than 100 characters
`lines[*].employee.social_security`	Matches ^[0-9]$	`GOBL-MX-CFDI-FOODVOUCHERS-16` Employee social security number format is invalid
`lines[*].amount`	Present	`GOBL-MX-CFDI-FOODVOUCHERS-17` Line amount is required

addon.FuelAccountBalance

Field	Test	Validation Code / Message
`account_number`	Present	`GOBL-MX-CFDI-FUELACCOUNTBALANCE-01` Account number is required
`account_number`	Length between 1 and 50	`GOBL-MX-CFDI-FUELACCOUNTBALANCE-02` Account number must be between 1 and 50 characters
`subtotal`	Present	`GOBL-MX-CFDI-FUELACCOUNTBALANCE-03` Subtotal is required
`total`	Present	`GOBL-MX-CFDI-FUELACCOUNTBALANCE-04` Total is required
`lines`	Present	`GOBL-MX-CFDI-FUELACCOUNTBALANCE-05` Lines are required
`lines[*]`	Valid line total	`GOBL-MX-CFDI-FUELACCOUNTBALANCE-20` Line total must be quantity x unit_price
`lines[*].e_wallet_id`	Present	`GOBL-MX-CFDI-FUELACCOUNTBALANCE-06` Line e-wallet ID is required
`lines[*].purchase_date_time`	Not zero	`GOBL-MX-CFDI-FUELACCOUNTBALANCE-07` Line purchase date and time is required
`lines[*].vendor_tax_code`	Present	`GOBL-MX-CFDI-FUELACCOUNTBALANCE-08` Line vendor tax code is required
`lines[*].vendor_tax_code`	Valid RFC	`GOBL-MX-CFDI-FUELACCOUNTBALANCE-09` Line vendor tax identity code is invalid
`lines[*].service_station_code`	Present	`GOBL-MX-CFDI-FUELACCOUNTBALANCE-10` Line service station code is required
`lines[*].service_station_code`	Length between 1 and 20	`GOBL-MX-CFDI-FUELACCOUNTBALANCE-11` Line service station code must be between 1 and 20 characters
`lines[*].quantity`	Min 0	`GOBL-MX-CFDI-FUELACCOUNTBALANCE-12` Line quantity must be greater than 0
`lines[*].item`	Present	`GOBL-MX-CFDI-FUELACCOUNTBALANCE-13` Line item is required
`lines[*].item.type`	Present	`GOBL-MX-CFDI-FUELACCOUNTBALANCE-14` Line item type is required
`lines[*].item.name`	Present	`GOBL-MX-CFDI-FUELACCOUNTBALANCE-15` Line item name is required
`lines[*].item.name`	Length between 1 and 300	`GOBL-MX-CFDI-FUELACCOUNTBALANCE-16` Line item name must be between 1 and 300 characters
`lines[*].item.price`	Min 0	`GOBL-MX-CFDI-FUELACCOUNTBALANCE-17` Line item price must be greater than 0
`lines[*].item.unit`	One of [mg, cg, g, kg, t, mm, cm, dm, m, lm, km, in, ft, lft, mm2, cm2, dm2, m2, ac, ha, mm3, cm3, dm3, m3, ml, cl, dl, l, kl, w, kw, kwh, kj, kcal, rate, yr, mon, wk, day, s, h, min, piece, item, pair, dozen, assortment, service, job, activity, trip, group, outfit, kit, basebox, pk, one, bag, box, bin, can, tub, case, tray, portion, set, roll, carton, cylinder, barrel, jerrican, carboy, demijohn, bottle, canister, pkg, pkt, bunch, bdl, blk, pallet, reel, sack, sheet, envelope, lot, unit]	`GOBL-MX-CFDI-FUELACCOUNTBALANCE-27` Line item unit must be valid
`lines[*].purchase_code`	Present	`GOBL-MX-CFDI-FUELACCOUNTBALANCE-18` Line purchase code is required
`lines[*].purchase_code`	Length between 1 and 50	`GOBL-MX-CFDI-FUELACCOUNTBALANCE-19` Line purchase code must be between 1 and 50 characters
`lines[*].taxes`	Present	`GOBL-MX-CFDI-FUELACCOUNTBALANCE-21` Line taxes are required
`lines[].taxes[].cat`	Present	`GOBL-MX-CFDI-FUELACCOUNTBALANCE-22` Line tax category is required
`lines[].taxes[].cat`	One of [VAT, IEPS]	`GOBL-MX-CFDI-FUELACCOUNTBALANCE-23` Line tax category must be a valid value
`lines[].taxes[].rate`	No percent Present	`GOBL-MX-CFDI-FUELACCOUNTBALANCE-24` Line tax rate is required when percent is not set
`lines[].taxes[].rate`	Min 0	`GOBL-MX-CFDI-FUELACCOUNTBALANCE-25` Line tax rate must be greater than 0
`lines[].taxes[].amount`	Min 0	`GOBL-MX-CFDI-FUELACCOUNTBALANCE-26` Line tax amount must be greater than 0

Overview

Use Cases

Quick Start

Tax Regimes

Addons

Catalogues

Schemas (Draft 0)

Mexican SAT CFDI v4.X

Scenarios

Extensions

Document Type

Relation Type

Place of Issue

Tax Type

Product or Service Code

Fiscal Regime Code

CFDI Use Code

Payment Method

Payment Means

CFDI Global Period

CFDI Global Month

CFDI Global Year

Cancellation Reason

Validation Rules

​Scenarios

​Extensions

​Document Type

​Relation Type

​Place of Issue

​Tax Type

​Product or Service Code

​Fiscal Regime Code

​CFDI Use Code

​Payment Method

​Payment Means

​CFDI Global Period

​CFDI Global Month

​CFDI Global Year

​Cancellation Reason

​Validation Rules

Scenarios

Extensions

Document Type

Relation Type

Place of Issue

Tax Type

Product or Service Code

Fiscal Regime Code

CFDI Use Code

Payment Method

Payment Means

CFDI Global Period

CFDI Global Month

CFDI Global Year

Cancellation Reason

Validation Rules