Crear CFDI

Tipos de CFDI

Tipo	Clave	Descripción
Ingreso	`I`	Factura por venta de bienes o servicios
Egreso	`E`	Nota de crédito, devolución o descuento
Traslado	`T`	Movimiento de mercancías (sin cobro)
Nómina	`N`	Recibo de nómina para empleados
Pago	`P`	Complemento de pago para cobros diferidos

Endpoint

POST /3/cfdis

Estructura del CFDI de Ingreso

  "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
    }
  ]

Consulta las referencias API Ejemplo completo de un CFDI de ingreso:

{
  "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
    }
  ]
}

Idempotencia y reintentos Facturama identifica una operación por la combinación de Folio y Date. Para evitar comprobantes duplicados, ambos valores deben generarse una sola vez al iniciar la operación y reutilizarse sin cambios en cada reintento.

string

requerido

Identificador único de la operación, generado por tu sistema.

string

requerido

Fecha y hora de inicio de la operación, en formato YYYY-MM-DDTHH:mm:ss.

No regeneres Folio ni Date en los reintentos, y no uses la fecha/hora actual del sistema para recalcular Date. Cualquier cambio en estos valores hará que Facturama trate el reintento como una operación nueva.

Por ejemplo, una operación con:

{
  "Folio": 100,
  "Date": "2026-05-15T22:17:44"
}

Conserva estos mismos valores en cada reintento, sin importar cuánto tiempo haya pasado desde la solicitud original.

Respuesta exitosa

{
  "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|.......|"
}

Ejemplos de algunos catálogos utilizados

Formas de pago (PaymentForm)

Clave	Descripción
`01`	Efectivo
`02`	Cheque nominativo
`03`	Transferencia electrónica
`04`	Tarjeta de crédito
`28`	Tarjeta de débito
`99`	Por definir (usar con PPD)

Métodos de pago (PaymentMethod)

Clave	Descripción	Cuándo usar
`PUE`	Pago en una sola exhibición	Cobro inmediato o al contado
`PPD`	Pago en parcialidades o diferido	Crédito o pagos futuros — requiere complemento de pago

Si usas PPD, debes emitir un Complemento de Pago cada vez que el cliente realice un pago. Usa PaymentForm: "99" en la factura original.

Nodo relación

Nodo usado para expresar la información de los comprobantes fiscales relacionados:

{
  "Relations": {
    "Type": "01",
    "Cfdis": [
      {
        "Uuid": "45ab1a98-1709-446a-8759-e45a8d76b557"
      }
    ]
  }
}

Ejemplo de uso.

{
    "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
        }
    ]
}

Tipos de relación más comunes:

Clave	Descripción
`01`	Nota de crédito de los documentos relacionados
`02`	Nota de débito de los documentos relacionados
`03`	Devolución de mercancía sobre facturas o traslados previos
`04`	Sustitución de los CFDI previos
`05`	Traslados de mercancias facturados previamente
`06`	Factura generada por los traslados previos
`07`	CFDI por aplicación de anticipo

Primeros pasos

El sistema de facturación en México

API Web

API Multiemisor

CFDI 4.0

Complementos

Catálogos SAT

Herramientas

Tipos de CFDI

Endpoint

Estructura del CFDI de Ingreso

Respuesta exitosa

Ejemplos de algunos catálogos utilizados

Formas de pago (PaymentForm)

Métodos de pago (PaymentMethod)

Nodo relación

​Tipos de CFDI

​Endpoint

​Estructura del CFDI de Ingreso

​Respuesta exitosa

​Ejemplos de algunos catálogos utilizados

​Formas de pago (PaymentForm)

​Métodos de pago (PaymentMethod)

​Nodo relación

Tipos de CFDI

Endpoint

Estructura del CFDI de Ingreso

Respuesta exitosa

Ejemplos de algunos catálogos utilizados

Formas de pago (PaymentForm)

Métodos de pago (PaymentMethod)

Nodo relación