Estructura de un CFDI en la API

Visión general

Un CFDI 4.0 válido está compuesto por varias secciones con responsabilidades claras. Aquí se muestra la estructura de arriba hacia abajo.

1. Encabezado del comprobante

Contiene los atributos globales del CFDI:

{
  "NameId": "1",
  "Currency": "MXN",
  "Folio": "100",
  "Serie": "FA",
  "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"
}

Campo	Descripción
`NameId`	Nombre que se mostrará en el PDF
`CfdiType`	Tipo de CFDI: I, E, T, N, P
`Date`	Fecha y hora de emisión (ISO 8601)
`PaymentForm`	Clave de forma de pago
`PaymentMethod`	PUE o PPD
`Currency`	Clave ISO 4217 (MXN, USD, EUR…)
`ExpeditionPlace`	CP del lugar de expedición
`OrderNumber`	Numero de Orden (opcionales)
`PaymentConditions`	Condiciones de pago (opcionales)
`Observations`	Observaciones, sólo visible en el PDF (opcionales)
`Exportation`	Exportación, elemento usando en Comercio Exterior, por default 01 (opcionales)

2. Emisor

{
  "Issuer": {
    "Rfc": "EKU9003173C9",
    "Name": "ESCUELA KEMPER URGATE",
    "FiscalRegime": "601"
  }
}

El emisor es el contribuyente que expide el comprobante. Sus datos vienen del CSD configurado en Facturama — la API los inserta automáticamente; no necesitas especificarlos si usas API Web.

Campo	Descripción
`Rfc`	Rfc del emisor
`Name`	Nombre o Razón Social en mayusculas
`FiscalRegime`	Régimen fiscal, tal como está dado de alta en el SAT

3. Receptor

{
  "Receiver": {
    "Rfc": "URE180429TM6",
    "CfdiUse": "G01",
    "Name": "UNIVERSIDAD ROBOTICA ESPAÑOLA",
    "FiscalRegime": "601",
    "TaxZipCode": "86991"
  }
}

Ademas del Rfc, Name y FiscalRegime, se añaden dos elementos extras CfdiUse y TaxZipCode todos estos elementos son obligatorios para el receptor.

Campo	Descripción
`CfdiUse`	Debe ser de acuerdo al régimen fiscal
`TaxZipCode`	Código postal del receptor

4. Conceptos (Items)

La lista de bienes o servicios facturados:

{
  "Items": [
    {
      "ProductCode": "81111500",
      "IdentificationNumber": "EDL",
      "Description": "Servicio de desarrollo de software",
      "Unit": "NO APLICA",
      "UnitCode": "E48",
      "UnitPrice": 5000.0,
      "Quantity": 2,
      "Subtotal": 10000.0,
      "TaxObject": "02",
      "Discount": 0.0,
      "Taxes": [
        {
          "Total": 1600.0,
          "Name": "IVA",
          "Base": 10000.0,
          "Rate": 0.16,
          "IsRetention": false
        }
      ],
      "Total": 11600.0
    }
  ]
}

Campo	Descripción
`ProductCode`	Clave del catálogo SAT de productos y servicios
`UnitCode`	Clave de unidad de medida del SAT
`UnitPrice`	Precio unitario sin impuestos
`Subtotal`	`UnitPrice × Quantity`
`Total`	`Subtotal + impuestos trasladados − retenciones`

5. Impuestos

Los impuestos se declaran por concepto y se suman en el total del comprobante:

Impuesto	Tipo	Tasa típica	Nombre
IVA trasladado	`IsRetention: false`	16%	IVA
IVA retenido	`IsRetention: true`	10.67%	IVA RET
ISR retenido	`IsRetention: true`	Varía	ISR
IEPS	`IsRetention: false`	Varía según producto	IEPS

6. Cadena Original y Sello Digital

Antes de enviarlo al PAC, el XML pasa por un proceso criptográfico:

Cadena Original: concatenación ordenada de los campos del CFDI en formato de texto plano (definida por el SAT en su XSLT)
Hash SHA-256: resumen criptográfico de la cadena original
Sello Digital: el hash firmado con la llave privada del CSD del emisor (RSA)

CadenaOriginal → SHA-256 → firmado con CSD → SelloDigital

Esto garantiza que nadie puede alterar el contenido del CFDI sin invalidar el sello.

7. Timbre Fiscal Digital

Una vez que el PAC valida el XML, agrega el Timbre Fiscal Digital como complemento:

<tfd:TimbreFiscalDigital
  Version="1.1"
  UUID="6128396f-c09b-4ec6-8699-43c5f7e3b230"
  FechaTimbrado="2024-01-15T10:30:05"
  NoCertificadoSAT="20001000000300022323"
  SelloCFD="..."
  SelloSAT="..."
/>

Campo	Descripción
`UUID`	Folio Fiscal — identificador único nacional del CFDI
`FechaTimbrado`	Timestamp del momento exacto del timbrado
`SelloCFD`	Sello del emisor (compacto, en Base64)
`SelloSAT`	Sello del PAC (acredita el timbrado)

El UUID es el dato más importante para el seguimiento de facturas. Guárdalo siempre junto con la factura. Con él puedes verificar el CFDI en el portal del SAT o iniciar una cancelación.

Representación impresa (PDF)

El PDF es la representación visual del XML, no el documento fiscal en sí. Debe incluir obligatoriamente el código QR con los datos del CFDI para que el receptor pueda verificarlo. Facturama genera el PDF automáticamente cuando creas un CFDI. Puedes descargarlo con:

GET /cfdi/{format}/{type}/{id}

format: Formato del archivo a obtener (pdf|html|xml). type: Tipo del CFDI. Para API Web, se utiliza issued para facturas de ingreso, egreso y complementos, mientras que se utiliza payroll para los comprobantes de nómina. id: Identificador del documento a cancelar. Lo encontrarás en el campo “Id” en la respuesta de emisión de la factura, o al consultar las facturas emitidas.

Primeros pasos

El sistema de facturación en México

API Web

API Multiemisor

CFDI 4.0

Complementos

Catálogos SAT

Herramientas

Estructura de un CFDI en la API

Visión general

1. Encabezado del comprobante

2. Emisor

3. Receptor

4. Conceptos (Items)

5. Impuestos

6. Cadena Original y Sello Digital

7. Timbre Fiscal Digital

Representación impresa (PDF)

​Visión general

​1. Encabezado del comprobante

​2. Emisor

​3. Receptor

​4. Conceptos (Items)

​5. Impuestos

​6. Cadena Original y Sello Digital

​7. Timbre Fiscal Digital

​Representación impresa (PDF)

Visión general

1. Encabezado del comprobante

2. Emisor

3. Receptor

4. Conceptos (Items)

5. Impuestos

6. Cadena Original y Sello Digital

7. Timbre Fiscal Digital

Representación impresa (PDF)