Mexican SAT CFDI v4.X

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

Scenarios

bill/invoice

standard

Filters:

Types: standard

Output:

Extensions: mx-cfdi-doc-type:I

credit-note

Filters:

Types: credit-note

Output:

Extensions: mx-cfdi-doc-type:E, mx-cfdi-rel-type:01

standard, credit-note

Filters:

Types: standard, credit-note
Filter: (custom)

Output:

Extensions: mx-cfdi-payment-method:PUE

standard, credit-note

Filters:

Types: standard, credit-note
Filter: (custom)

Output:

Extensions: mx-cfdi-payment-method:PPD

Extensions

Document Type

mx-cfdi-doc-type

Code	Name
`I`	Invoice
`E`	Credit Note

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}

Validation Rules

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

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 between 0 and 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 between 0 and 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 between 0 and 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 between 0 and 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 between 0 and 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[*].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

bill/invoice

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

Validation Rules

​Scenarios

​bill/invoice

​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

​Validation Rules

Scenarios

bill/invoice

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

Validation Rules