Complemento de Nómina 1.2

¿Cuándo emitir un CFDI de nómina?

Emite un CFDI de nómina por cada pago que hagas a un trabajador por concepto de sueldos, salarios o ingresos asimilados. El comprobante usa CfdiType: "N" y lleva el complemento de nómina 1.2 dentro del nodo Complemento.Payroll.

Periodo de pago → Cálculo de percepciones y deducciones → CFDI de nómina timbrado

El complemento de nómina vigente es la versión 1.2 (revisión C). Aplica tanto para trabajadores subordinados (régimen 02 Sueldos) como para asimilados a salarios (regímenes 05 a 11).

Diferencias con una factura de ingreso

Elemento	Factura de ingreso	CFDI de nómina
`CfdiType`	`I`	`N`
`Items`	Requerido	No se envía
`PaymentMethod`	Requerido	Requerido
`PaymentForm`	Requerido	No se registra
`Receiver.CfdiUse`	`G01`, `G03`, etc.	`CN01`
Complemento	Opcional	`Payroll` requerido
Tipo de consulta	`issued`	`payroll`

El nodo Items no se envía en un CFDI de nómina. Facturama construye el concepto a partir de los totales del complemento. Enviar conceptos provoca un error de validación.

Endpoint

POST /3/cfdis

Consulta las referencias API

Estructura del CFDI de nómina

  "NameId": "16",
  "Folio": "",
  "Serie": "",
  "CfdiType": "N",
  "PaymentMethod": "PUE",
  "ExpeditionPlace": "",
  "Date": "",

  "Receiver":
  {
    "Rfc": "",
    "CfdiUse": "CN01",
    "Name": "",
    "FiscalRegime": "605",
    "TaxZipCode": ""
  }

  "Complemento":
  {
    "Payroll": {
      "Type": "",
      "PaymentDate": "",
      "InitialPaymentDate": "",
      "FinalPaymentDate": "",
      "DaysPaid": 0.0,
      "Issuer": {},
      "Employee": {},
      "Perceptions": {},
      "Deductions": {},
      "OtherPayments": [],
      "Incapacities": []
    }
  }

  "Issuer":
  {
    "EmployerRegistration": "",
    "FromEmployerRfc": "",
    "Curp": "",
    "EntitySNCF" : 
    {
      "OriginSource" : "",
      "AmountOriginSource" : ""
    }
  }

  "Employee":
  {
    "Curp": "",
    "SocialSecurityNumber": "",
    "StartDateLaborRelations": "",
    "ContractType": "",
    "Unionized": false,
    "TypeOfJourney": "",
    "RegimeType": "",
    "EmployeeNumber": "",
    "Department": "",
    "Position": "",
    "PositionRisk": "",
    "FrequencyPayment": "",
    "Bank": "",
    "BankAccount": "",
    "BaseSalary": 0.0,
    "DailySalary": 0.0,
    "FederalEntityKey": ""
  }

  "Perceptions":
  {
    "Details": [
      {
        "PerceptionType": "",
        "Code": "",
        "Description": "",
        "TaxedAmount": 0.0,
        "ExemptAmount": 0.0
      }
    ]
  }

  "Deductions":
  {
    "Details": [
      {
        "DeduccionType": "",
        "Code": "",
        "Description": "",
        "Amount": 0.0
      }
    ]
  }

  "OtherPayments": [
    {
      "OtherPaymentType": "",
      "Code": "",
      "Description": "",
      "Amount": 0.0
    }
  ]

  "Incapacities": [
    {
      "Days": 0,
      "Type": "",
      "Amount": 0.0
    }
  ]

Ejemplo completo

Recibo quincenal de un trabajador subordinado con sueldo y vales de despensa:

{
  "NameId": "16",
  "Folio": "1",
  "Serie": "NOM",
  "CfdiType": "N",
  "ExpeditionPlace": "78000",
  "PaymentMethod": "PUE",
  "Date": "2026-08-15T12:00:00",
  "Receiver": {
    "Rfc": "CACX7605101P8",
    "CfdiUse": "CN01",
    "Name": "XOCHILT CASAS CHAVEZ",
    "FiscalRegime": "605",
    "TaxZipCode": "36257"
  },
  "Complemento": {
    "Payroll": {
      "Type": "O",
      "PaymentDate": "2026-08-15",
      "InitialPaymentDate": "2026-08-01",
      "FinalPaymentDate": "2026-08-15",
      "DaysPaid": 15,
      "Issuer": {
        "EmployerRegistration": "B5510768108"
      },
      "Employee": {
        "Curp": "CACX760510MDFSHX09",
        "SocialSecurityNumber": "12345678903",
        "StartDateLaborRelations": "2021-03-01",
        "ContractType": "01",
        "Unionized": false,
        "TypeOfJourney": "01",
        "RegimeType": "02",
        "EmployeeNumber": "00042",
        "Department": "Administración",
        "Position": "Analista de sistemas",
        "PositionRisk": "1",
        "FrequencyPayment": "04",
        "Bank": "002",
        "BankAccount": "1234567890123456",
        "BaseSalary": 500.00,
        "DailySalary": 512.50,
        "FederalEntityKey": "SLP"
      },
      "Perceptions": {
        "Details": [
          {
            "PerceptionType": "001",
            "Code": "P001",
            "Description": "Sueldo",
            "TaxedAmount": 7500.00,
            "ExemptAmount": 0.00
          },
          {
            "PerceptionType": "029",
            "Code": "P029",
            "Description": "Vales de despensa",
            "TaxedAmount": 0.00,
            "ExemptAmount": 500.00
          }
        ]
      },
      "Deductions": {
        "Details": [
          {
            "DeduccionType": "001",
            "Code": "D001",
            "Description": "Seguridad social",
            "Amount": 216.35
          },
          {
            "DeduccionType": "002",
            "Code": "D002",
            "Description": "ISR retenido",
            "Amount": 1052.28
          }
        ]
      }
    }
  }
}

Consideraciones del nodo general en un CFDI de nómina:

CfdiType debe ser "N".
No incluyas Items.
No incluyas PaymentForm: conforme al Anexo 20, este atributo no se registra cuando el tipo de comprobante es N.
Currency debe ser "MXN".
En el nodo Receiver, el atributo CfdiUse debe ser "CN01".
En el nodo Receiver, el atributo FiscalRegime normalmente es 605 (Sueldos y Salarios e Ingresos Asimilados a Salarios).

Elementos del complemento de nómina

Nodo Payroll

string

requerido

Tipo de nómina. Usa O para nómina ordinaria y E para nómina extraordinaria.

string

requerido

Fecha efectiva de erogación del pago, en formato YYYY-MM-DD.

string

requerido

Fecha inicial del periodo de pago.

string

requerido

Fecha final del periodo de pago. Debe ser igual o posterior a InitialPaymentDate.

number

requerido

Número de días o fracción que cubre el pago. Acepta hasta tres decimales.

object

Datos del patrón. Ver Nodo Issuer.

object

requerido

Datos del trabajador. Ver Nodo Employee.

object

Percepciones del periodo. Ver Nodo Perceptions.

object

Deducciones aplicadas al trabajador. Ver Nodo Deductions.

array

Pagos que no se consideran ingreso por sueldos, como el subsidio para el empleo o los viáticos entregados.

array

Incapacidades que aplican en el periodo.

Nodo Issuer

string

Registro patronal ante el IMSS. Requerido cuando el trabajador está sujeto al régimen obligatorio de seguridad social.

string

RFC del patrón origen. Se registra en casos de subcontratación laboral o cuando pagas por cuenta de otro patrón.

string

CURP del patrón cuando es persona física. Debe tener 18 caracteres.

object

Nodo para entidades y dependencias que aplican el Sistema Nacional de Coordinación Fiscal. Contiene OriginSource (IP, IM o IF) y AmountOriginSource.

Nodo Employee

string

requerido

CURP del trabajador. Exactamente 18 caracteres.

string

requerido

Clave del tipo de contrato conforme al catálogo c_TipoContrato.

string

requerido

Clave del régimen de contratación conforme al catálogo c_TipoRegimen.

string

requerido

Número interno del trabajador. Hasta 15 caracteres, sin el carácter |.

string

requerido

Periodicidad de pago conforme al catálogo c_PeriodicidadPago.

string

requerido

Clave de la entidad federativa donde el trabajador prestó sus servicios, conforme al catálogo c_Estado.

Número de seguridad social del trabajador. Requerido cuando el régimen es 02 Sueldos.

string

Fecha de inicio de la relación laboral, en formato YYYY-MM-DD.

boolean

Indica si el trabajador está sindicalizado.

string

Tipo de jornada conforme al catálogo c_TipoJornada.

string

Departamento o área del trabajador. Hasta 100 caracteres.

string

Puesto asignado al trabajador. Hasta 100 caracteres.

string

Clase de riesgo de puesto conforme al catálogo c_RiesgoPuesto.

string

Clave del banco donde depositas la nómina, conforme al catálogo de bancos.

string

Número de cuenta o CLABE. Entre 10 y 18 dígitos.

number

Salario base de cotización.

number

Salario diario integrado.

array

Nodo para subcontratación laboral. Cada elemento contiene RfcContractor y PercentageTime (entre 0.001 y 100).

Nodo Perceptions

array

Lista de percepciones del periodo.

string

Clave del tipo de percepción conforme al catálogo c_TipoPercepcion.

string

Clave de control interno de la percepción. Entre 3 y 15 caracteres.

string

Concepto de la percepción. Hasta 100 caracteres.

number

requerido

Importe gravado de la percepción.

number

requerido

Importe exento de la percepción.

array

Detalle de horas extra. Cada elemento contiene Days, HoursType, ExtraHours y PaidAmount.

object

Nodo para ingresos en acciones o títulos valor. Contiene MarketValue y PriceWhenGranting.

object

Nodo para jubilaciones, pensiones o haberes de retiro. Contiene TotalASinglePayment, TotalParciality, DailyAmount, AccumulatedIncome y NonAccumulatedIncome.

object

Nodo para pagos por separación. Contiene TotalPaid, YearsOfService, LastMonthlySalaryOrd, AccumulatedIncome y NonAccumulatedIncome.

Nodo Deductions

string

requerido

Clave del tipo de deducción conforme al catálogo c_TipoDeduccion.

string

requerido

Clave de control interno de la deducción. Entre 3 y 15 caracteres.

string

requerido

Concepto de la deducción. Hasta 100 caracteres.

number

requerido

Importe de la deducción. El valor mínimo es 0.01.

Nodo OtherPayments

string

requerido

Clave del tipo de otro pago conforme al catálogo c_TipoOtroPago.

string

requerido

Clave de control interno del pago. Entre 3 y 15 caracteres.

string

requerido

Concepto del pago. Hasta 100 caracteres.

number

requerido

Importe del pago.

object

Nodo requerido cuando OtherPaymentType es 002. Contiene Amount con el subsidio causado.

object

Nodo requerido cuando OtherPaymentType es 004. Contiene PositiveBalance, Year y RemainingPositiveBalance.

Nodo Incapacities

integer

requerido

Días de incapacidad en el periodo.

string

requerido

Clave del tipo de incapacidad conforme al catálogo c_TipoIncapacidad.

number

Importe del descuento por la incapacidad.

Casos especiales

Horas extra

Registra las horas extra como una percepción de tipo 019 con el detalle de días, tipo de horas e importe pagado:

{
  "PerceptionType": "019",
  "Code": "P019",
  "Description": "Horas extra",
  "TaxedAmount": 250.00,
  "ExemptAmount": 750.00,
  "ExtraHours": [
    {
      "Days": 2,
      "HoursType": "02",
      "ExtraHours": 6,
      "PaidAmount": 1000.00
    }
  ]
}

HoursType usa 01 para horas dobles, 02 para triples y 03 para simples.

Incapacidades

Cuando el trabajador tiene días de incapacidad, agrega el nodo Incapacities y la deducción 006 correspondiente:

{
  "Incapacities": [
    {
      "Days": 3,
      "Type": "02",
      "Amount": 900.00
    }
  ],
  "Deductions": {
    "Details": [
      {
        "DeduccionType": "006",
        "Code": "D006",
        "Description": "Descuento por incapacidad",
        "Amount": 900.00
      }
    ]
  }
}

Subsidio para el empleo

El subsidio se registra en OtherPayments con la clave 002 y el nodo EmploymentSubsidy:

{
  "OtherPayments": [
    {
      "OtherPaymentType": "002",
      "Code": "OP002",
      "Description": "Subsidio para el empleo",
      "Amount": 120.00,
      "EmploymentSubsidy": {
        "Amount": 120.00
      }
    }
  ]
}

El importe en Amount es el subsidio efectivamente entregado al trabajador, mientras que EmploymentSubsidy.Amount es el subsidio causado conforme a la disposición vigente. Calcula ambos valores con tu sistema de nómina; la API no los deriva por ti.

Saldo a favor por compensación anual

Usa la clave 004 en OtherPayments junto con el nodo Compensation:

{
  "OtherPaymentType": "004",
  "Code": "OP004",
  "Description": "Aplicación de saldo a favor por compensación anual",
  "Amount": 350.00,
  "Compensation": {
    "PositiveBalance": 1200.00,
    "Year": 2025,
    "RemainingPositiveBalance": 850.00
  }
}

Pagos por separación

Un finiquito o liquidación es nómina extraordinaria (Type: "E"). Agrega la percepción 025 y el nodo Indemnification:

{
  "Type": "E",
  "Perceptions": {
    "Details": [
      {
        "PerceptionType": "025",
        "Code": "P025",
        "Description": "Indemnización",
        "TaxedAmount": 18000.00,
        "ExemptAmount": 6000.00
      }
    ],
    "Indemnification": {
      "TotalPaid": 24000.00,
      "YearsOfService": 5,
      "LastMonthlySalaryOrd": 15000.00,
      "AccumulatedIncome": 18000.00,
      "NonAccumulatedIncome": 6000.00
    }
  }
}

Jubilaciones y pensiones

Para jubilaciones, pensiones o haberes de retiro, usa la percepción 039 (pago único) o 044 (parcialidades) junto con el nodo Retirement:

{
  "Perceptions": {
    "Details": [
      {
        "PerceptionType": "039",
        "Code": "P039",
        "Description": "Jubilación en una sola exhibición",
        "TaxedAmount": 30000.00,
        "ExemptAmount": 10000.00
      }
    ],
    "Retirement": {
      "TotalASinglePayment": 40000.00,
      "AccumulatedIncome": 30000.00,
      "NonAccumulatedIncome": 10000.00
    }
  }
}

Subcontratación laboral

Cuando el trabajador presta servicios a través de subcontratación, registra los contratantes en Employee.Outsourcing:

{
  "Outsourcing": [
    {
      "RfcContractor": "EKU9003173C9",
      "PercentageTime": 60.00
    },
    {
      "RfcContractor": "URE180429TM6",
      "PercentageTime": 40.00
    }
  ]
}

La suma de PercentageTime de todos los contratantes debe ser 100.

Catálogos de nómina

Estos catálogos los define el SAT y pueden cambiar. Verifica los valores vigentes en el catálogo oficial catCFDI publicado por el SAT antes de liberar a Producción.

Tipo de nómina (Type)

Clave	Descripción
`O`	Ordinaria. Pago periódico conforme a la relación laboral
`E`	Extraordinaria. Finiquito, liquidación, PTU, aguinaldo por separado

Tipo de contrato (ContractType)

GET /catalogs/ContractTypes

Clave	Descripción
`01`	Contrato de trabajo por tiempo indeterminado
`02`	Contrato de trabajo para obra determinada
`03`	Contrato de trabajo por tiempo determinado
`04`	Contrato de trabajo por temporada
`05`	Contrato de trabajo sujeto a prueba
`06`	Contrato de trabajo con capacitación inicial
`07`	Modalidad de contratación por pago de hora laborada
`08`	Modalidad de trabajo por comisión laboral
`09`	Modalidades de contratación donde no existe relación de trabajo
`10`	Jubilación, pensión, retiro
`99`	Otro contrato

Tipo de régimen (RegimeType)

GET /catalogs/regimentypes

Clave	Descripción
`02`	Sueldos
`03`	Jubilados
`04`	Pensionados
`05`	Asimilados miembros de sociedades cooperativas de producción
`06`	Asimilados integrantes de sociedades y asociaciones civiles
`07`	Asimilados miembros de consejos directivos y de vigilancia
`08`	Asimilados comisionistas
`09`	Asimilados honorarios
`10`	Asimilados acciones
`11`	Asimilados otros
`12`	Jubilados o pensionados
`13`	Indemnización o separación
`99`	Otro régimen

Periodicidad de pago (FrequencyPayment)

GET /catalogs/paymentfrequencies

Clave	Descripción
`01`	Diario
`02`	Semanal
`03`	Catorcenal
`04`	Quincenal
`05`	Mensual
`06`	Bimestral
`07`	Unidad de obra
`08`	Comisión
`09`	Precio alzado
`10`	Decenal
`99`	Otra periodicidad

Tipo de jornada (TypeOfJourney)

GET /catalogs/typesofjourney

Clave	Descripción
`01`	Diurna
`02`	Nocturna
`03`	Mixta
`04`	Por hora
`05`	Reducida
`06`	Continuada
`07`	Partida
`08`	Por turnos
`99`	Otra jornada

Riesgo de puesto (PositionRisk)

GET /catalogs/positionrisks

Clave	Descripción
`1`	Clase I
`2`	Clase II
`3`	Clase III
`4`	Clase IV
`5`	Clase V
`99`	No aplica

Tipos de percepción más usados (PerceptionType)

GET /catalogs/perceptions

Clave	Descripción
`001`	Sueldos, salarios, rayas y jornales
`002`	Gratificación anual (aguinaldo)
`003`	Participación de los trabajadores en las utilidades
`005`	Fondo de ahorro
`014`	Subsidios por incapacidad
`019`	Horas extra
`020`	Prima dominical
`021`	Prima vacacional
`022`	Prima por antigüedad
`025`	Indemnizaciones
`028`	Comisiones
`029`	Vales de despensa
`038`	Otros ingresos por salarios
`039`	Jubilaciones, pensiones o haberes de retiro
`046`	Ingresos asimilados a salarios
`050`	Viáticos

El catálogo c_TipoPercepcion completo incluye más de 40 claves.

Tipos de deducción más usados (DeduccionType)

GET /catalogs/deductions

Clave	Descripción
`001`	Seguridad social
`002`	ISR
`004`	Otros
`005`	Aportaciones a fondo de vivienda
`006`	Descuento por incapacidad
`007`	Pensión alimenticia
`010`	Pago por crédito de vivienda
`011`	Pago de abonos INFONACOT
`019`	Cuotas sindicales
`020`	Ausencia (ausentismo)
`022`	Impuestos locales

El catálogo c_TipoDeduccion completo incluye más de 100 claves.

Tipos de otros pagos (OtherPaymentType)

GET /catalogs/otherpayments

Clave	Descripción
`001`	Reintegro de ISR pagado en exceso (siempre que no haya sido enterado al SAT)
`002`	Subsidio para el empleo (efectivamente entregado al trabajador)
`003`	Viáticos (entregados al trabajador)
`004`	Aplicación de saldo a favor por compensación anual
`005`	Reintegro de ISR retenido en exceso de ejercicio anterior (siempre que no haya sido enterado al SAT)
`999`	Pagos distintos a los listados y que no deben considerarse como ingreso por sueldos, salarios o ingresos asimilados

El catálogo c_TipoOtroPago completo incluye 10 claves.

Tipo de incapacidad (Incapacities.Type)

GET /catalogs/incapacities

Clave	Descripción
`01`	Riesgo de trabajo
`02`	Enfermedad en general
`03`	Maternidad

Consultar el catálogo de bancos

GET /catalogs/Banks

[
  { "Name": "BANAMEX", "Value": "002" },
  { "Name": "BBVA BANCOMER", "Value": "012" },
  { "Name": "SANTANDER", "Value": "014" },
  { "Name": "HSBC", "Value": "021" },
  { "Name": "BANORTE", "Value": "072" },
  { "Name": "STP", "Value": "646" }
]

El catálogo c_Banco completo incluye más de 100 claves.

Consultar y descargar el recibo

Los CFDI de nómina usan el tipo payroll en lugar de issued:

GET /cfdi?type=payroll
GET /api/Cfdi/pdf/payroll/{id}
GET /api/Cfdi/xml/payroll/{id}

Si consultas con type=issued no verás los recibos de nómina. Revisa Consultar CFDI y Descargar documentos.

Errores comunes

Error	Causa	Solución
`400`	Enviaste el nodo `Items` en un CFDI con `CfdiType: "N"`	Elimina `Items`. Los importes salen del complemento
`400`	`Curp` con formato inválido o distinta de 18 caracteres	Verifica la CURP del trabajador contra el formato oficial
`400`	`SocialSecurityNumber` ausente con `RegimeType: "02"`	Registra el número de seguridad social del trabajador
`400`	`FinalPaymentDate` anterior a `InitialPaymentDate`	Corrige las fechas del periodo
`400`	Suma de `PercentageTime` en `Outsourcing` distinta de `100`	Ajusta los porcentajes de los contratantes
`400`	`Amount` de una deducción menor a `0.01`	Omite la deducción en lugar de enviarla en cero
`401`	Credenciales incorrectas o de otro ambiente	Usa las credenciales del ambiente correspondiente
`422`	El total de deducciones excede el total de percepciones	Revisa el cálculo de nómina antes de timbrar
`500`	Error no controlado del servicio	Contacta a soporte con el `Folio` y la fecha del intento

Siguientes pasos

Cancelar CFDI

Cancela un recibo de nómina timbrado por error.

Descargar documentos

Obtén el PDF y el XML del recibo para entregarlo al trabajador.

Catálogos SAT

Consulta las claves vigentes directamente desde la API.

Tipos de comprobantes

Entiende cuándo aplica cada tipo de CFDI.

Primeros pasos

El sistema de facturación en México

API Web

API Multiemisor

CFDI 4.0

Complementos

Catálogos SAT

Herramientas

Complemento de Nómina 1.2

¿Cuándo emitir un CFDI de nómina?

Diferencias con una factura de ingreso

Endpoint

Estructura del CFDI de nómina

Ejemplo completo

Elementos del complemento de nómina

Nodo Payroll

Nodo Issuer

Nodo Employee

Nodo Perceptions

Nodo Deductions

Nodo OtherPayments

Nodo Incapacities

Casos especiales

Horas extra

Incapacidades

Subsidio para el empleo

Saldo a favor por compensación anual

Pagos por separación

Jubilaciones y pensiones

Subcontratación laboral

Catálogos de nómina

Consultar el catálogo de bancos

Consultar y descargar el recibo

Errores comunes

Siguientes pasos

Cancelar CFDI

Descargar documentos

Catálogos SAT

Tipos de comprobantes

​¿Cuándo emitir un CFDI de nómina?

​Diferencias con una factura de ingreso

​Endpoint

​Estructura del CFDI de nómina

​Ejemplo completo

​Elementos del complemento de nómina

​Nodo Payroll

​Nodo Issuer

​Nodo Employee

​Nodo Perceptions

​Nodo Deductions

​Nodo OtherPayments

​Nodo Incapacities

​Casos especiales

​Horas extra

​Incapacidades

​Subsidio para el empleo

​Saldo a favor por compensación anual

​Pagos por separación

​Jubilaciones y pensiones

​Subcontratación laboral

​Catálogos de nómina

​Consultar el catálogo de bancos

​Consultar y descargar el recibo

​Errores comunes

​Siguientes pasos

Cancelar CFDI

Descargar documentos

Catálogos SAT

Tipos de comprobantes

¿Cuándo emitir un CFDI de nómina?

Diferencias con una factura de ingreso

Endpoint

Estructura del CFDI de nómina

Ejemplo completo

Elementos del complemento de nómina

Nodo Payroll

Nodo Issuer

Nodo Employee

Nodo Perceptions

Nodo Deductions

Nodo OtherPayments

Nodo Incapacities

Casos especiales

Horas extra

Incapacidades

Subsidio para el empleo

Saldo a favor por compensación anual

Pagos por separación

Jubilaciones y pensiones

Subcontratación laboral

Catálogos de nómina

Consultar el catálogo de bancos

Consultar y descargar el recibo

Errores comunes

Siguientes pasos