CFDI types
| Type | Code | Description |
|---|---|---|
| Income | I | Invoice for the sale of goods or services |
| Expense | E | Credit note, return, or discount |
| Transfer | T | Movement of merchandise (no charge) |
| Payroll | N | Payroll receipt for employees |
| Payment | P | Payment complement for deferred collections |
Endpoint
POST /3/cfdis
Income CFDI structure
"NameId": "",
"Currency": "",
"Folio": "",
"Serie": "",
"CfdiType": "",
"PaymentForm": "",
"PaymentMethod": "",
"OrderNumber": "",
"ExpeditionPlace": "",
"Date": "",
"PaymentConditions": "",
"Observations": "",
"Exportation": "",
"Receiver":
{
"Rfc": "",
"CfdiUse": "",
"Name": "",
"FiscalRegime": "",
"TaxZipCode": ""
}
"Items": [
{
"ProductCode": "",
"IdentificationNumber": "",
"Description": "",
"Unit": "",
"UnitCode": "",
"UnitPrice": 0.0,
"Quantity": 0.0,
"Subtotal": 0.0,
"TaxObject": "",
"Taxes": [
{
"Total": 16,
"Name": "IVA",
"Base": 0.0,
"Rate": 0.16,
"IsRetention": false
}
],
"Total": 0.0
}
]
{
"NameId": "1",
"Currency": "MXN",
"Folio": "100",
"Serie": "FAC",
"CfdiType": "I",
"PaymentForm": "03",
"PaymentMethod": "PUE",
"OrderNumber": "TEST-001",
"ExpeditionPlace": "78000",
"Date": "2026-05-15T22:17:44",
"PaymentConditions": "CREDITO A SIETE DIAS",
"Observations": "Elemento Observaciones solo visible en PDF",
"Exportation": "01",
"Receiver": {
"Rfc": "URE180429TM6",
"CfdiUse": "CP01",
"Name": "UNIVERSIDAD ROBOTICA ESPAÑOLA",
"FiscalRegime": "601",
"TaxZipCode": "86991"
},
"Items": [
{
"ProductCode": "10101504",
"IdentificationNumber": "EDL",
"Description": "Estudios de laboratorio",
"Unit": "NO APLICA",
"UnitCode": "MTS",
"UnitPrice": 50,
"Quantity": 2.0,
"Subtotal": 100,
"TaxObject": "02",
"Taxes": [
{
"Total": 16,
"Name": "IVA",
"Base": 100,
"Rate": 0.16,
"IsRetention": false
}
],
"Total": 116
}
]
}
Folio and Date. To
avoid duplicate receipts, generate both values only once when the operation
starts and reuse them unchanged on every retry.
string
required
Unique identifier of the operation, generated by your system.
string
required
Start date and time of the operation, in
YYYY-MM-DDTHH:mm:ss format.Do not regenerate
Folio or Date on retries, and do not use the current
system date/time to recalculate Date. Any change to these values makes
Facturama treat the retry as a new operation.{
"Folio": 100,
"Date": "2026-05-15T22:17:44"
}
Successful response
{
"Id": "DznlumtVtkA3ya4JXAeGWw2",
"CfdiType": "ingreso",
"Type": "I - ingreso",
"Serie": "FAC",
"Folio": "100",
"Date": "2026-06-11T16:05:51",
"CertNumber": "30001000000500003416",
"PaymentTerms": "03 - Transferencia electrónica de fondos",
"PaymentConditions": "CREDITO A SIETE DIAS",
"PaymentMethod": "PUE - Pago en una sola exhibición",
"PaymentAccountNumber": "",
"PaymentBankName": "",
"ExpeditionPlace": "78000",
"ExchangeRate": 0.0,
"Currency": "MXN - Peso Mexicano",
"Subtotal": 100.0,
"Discount": 0.0,
"Total": 116.0,
"Observations": "Elemento Observaciones solo visible en PDF",
"OrderNumber": "TEST-001",
"Issuer": {
"FiscalRegime": "601 - General de Ley Personas Morales",
"Rfc": "EKU9003173C9",
"TaxName": "ESCUELA KEMPER URGATE",
"Email": "correo@prueba.com",
"Phone": "9999999999",
"TaxAddress": {
"Street": "Calle de prueba",
"ExteriorNumber": "123",
"InteriorNumber": "",
"Neighborhood": "Prueba",
"ZipCode": "42501",
"Municipality": "Pruebas",
"State": "ESTADO DE MEXICO",
"Country": "México"
}
},
"Receiver": {
"Rfc": "URE180429TM6",
"Name": "UNIVERSIDAD ROBOTICA ESPAÑOLA",
"Email": ""
},
"Items": [
{
"ProductCode": "10101504",
"IdentificationNumber": "EDL",
"UnitCode": "MTS",
"Discount": 0.0,
"CuentaPredial": "",
"Quantity": 2.0,
"Unit": "MTS - NO APLICA",
"Description": "Estudios de laboratorio",
"UnitValue": 50.0,
"Total": 100.0
}
],
"Taxes": [
{
"Total": 16.0,
"Name": "IVA",
"Rate": 0.16,
"Type": "transferred"
}
],
"Complement": {
"TaxStamp": {
"Uuid": "5e09160f-a206-44d7-b389-4f243585e76a",
"Date": "2026-06-11T16:05:52",
"SatCertNumber": "30001000000500003456",
"RfcProvCertif": "SPR190613I52"
}
},
"Status": "active",
"OriginalString": "||4.0|FAC|100|2026-06-11T16:05:51|03|30001000000500003416|.......|"
}
Examples of some catalogs used
Payment forms (PaymentForm)
| Code | Description |
|---|---|
01 | Cash |
02 | Nominative check |
03 | Electronic transfer |
04 | Credit card |
28 | Debit card |
99 | To be defined (use with PPD) |
Payment methods (PaymentMethod)
| Code | Description | When to use |
|---|---|---|
PUE | Single payment | Immediate or cash collection |
PPD | Installment or deferred payment | Credit or future payments — requires a payment complement |
If you use
PPD, you must issue a Payment Complement each time the client
makes a payment. Use PaymentForm: "99" on the original invoice.Related CFDIs
A node used to display information about related tax receipts:{
"Relations": {
"Type": "01",
"Cfdis": [
{
"Uuid": "45ab1a98-1709-446a-8759-e45a8d76b557"
}
]
}
}
Usage example
{
"NameId": "2",
"Currency": "MXN",
"Folio": "100",
"Serie": "NDC",
"CfdiType": "E",
"PaymentForm": "03",
"PaymentMethod": "PUE",
"OrderNumber": "TEST-001",
"ExpeditionPlace": "78000",
"Date": "2024-06-25T12:00:00",
"PaymentConditions": "Nota de credito",
"Observations": "Elemento Observaciones solo visible en PDF",
"Exportation": "01",
"Receiver": {
"Rfc": "URE180429TM6",
"CfdiUse": "CP01",
"Name": "UNIVERSIDAD ROBOTICA ESPAÑOLA",
"FiscalRegime": "601",
"TaxZipCode": "86991"
},
"Relations": {
"Type": "01",
"Cfdis": [
{
"Uuid": "45ab1a98-1709-446a-8759-e45a8d76b557"
}
]
},
"Items": [
{
"Quantity": 1,
"ProductCode": "86121500",
"UnitCode": "E48",
"Unit": "Unidad de servicio",
"Description": "Pago inicial del 50% por el desarrollo del sitio web personal.",
"IdentificationNumber": "980000",
"UnitPrice": 500.00,
"Subtotal": 500.00,
"TaxObject": "02",
"Taxes": [
{
"Name": "IVA",
"Rate": 0.16,
"Total": 80,
"Base": 500,
"IsRetention": false,
"IsFederalTax": false
}
],
"Total": 580.00
}
]
}
| Code | Description |
|---|---|
01 | Credit note for the related documents |
02 | Debit note for the related documents |
03 | Return of merchandise on previous invoices or transfers |
04 | Replacement of the previous CFDIs |
05 | Transfers of merchandise previously invoiced |
06 | Invoice generated from the previous transfers |
07 | CFDI for the application of an advance payment |