{
  "_descripcion": "Documento Soporte de Pago de Nomina Electronica (Anexo Tecnico DIAN v1.0, TipoXML 102). Endpoint: POST /api/v1/nomina. Se envia UN documento por trabajador y por periodo.",
  "_requisito": "La empresa debe tener habilitado en DIAN el software de NOMINA (SoftwareID y PIN propios, distintos a los de facturacion) y cargarlos en el portal FacEPro: Configuracion DIAN > Software ID de NOMINA / PIN de NOMINA.",
  "_totales": "No se envian totales: FacEPro suma devengados y deducciones desde el detalle y escribe DevengadosTotal, DeduccionesTotal y ComprobanteTotal. La DIAN valida que cuadren.",
  "_opcionales": "Todos los grupos de devengados y deducciones son opcionales salvo devengados.basico, deducciones.salud y deducciones.fondo_pension. Envia solo lo que aplique al periodo.",
  "_codigos": {
    "nomina.periodo_nomina": "1 Semanal · 2 Decenal · 3 Catorcenal · 4 Quincenal · 5 Mensual · 6 Otro",
    "trabajador.tipo_contrato": "1 Termino fijo · 2 Termino indefinido · 3 Obra o labor · 4 Aprendizaje · 5 Practicas o pasantias",
    "trabajador.tipo_trabajador": "01 Dependiente · 02 Servicio domestico · 04 Madre comunitaria · 12 Aprendiz SENA lectiva · 19 Aprendiz SENA productiva · 51 Tiempo parcial (ver tabla 5.5.3 del anexo para el resto)",
    "trabajador.subtipo_trabajador": "00 No aplica · 01 Dependiente pensionado por vejez activo",
    "trabajador.tipo_documento": "11 Registro civil · 12 Tarjeta de identidad · 13 Cedula de ciudadania · 21 Tarjeta de extranjeria · 22 Cedula de extranjeria · 31 NIT · 41 Pasaporte · 42 Doc. identificacion extranjero · 47 PEP",
    "devengados.incapacidades[].tipo": "1 Comun · 2 Profesional · 3 Laboral",
    "pago.forma": "1 Contado · 2 Credito",
    "pago.metodo": "Tabla de medios de pago DIAN (10 efectivo, 42 consignacion, 47 transferencia, etc.)"
  },
  "nomina": {
    "periodo_nomina": "5",
    "tipo_moneda": "COP",
    "notas": ["Nomina mensual septiembre 2026"]
  },
  "periodo": {
    "fecha_ingreso": "2020-01-15",
    "fecha_liquidacion_inicio": "2026-09-01",
    "fecha_liquidacion_fin": "2026-09-30",
    "tiempo_laborado": "30",
    "fecha_generacion": "2026-09-30"
  },
  "trabajador": {
    "tipo_trabajador": "01",
    "subtipo_trabajador": "00",
    "alto_riesgo_pension": false,
    "tipo_documento": "13",
    "numero_documento": "1098765432",
    "primer_apellido": "GOMEZ",
    "segundo_apellido": "RESTREPO",
    "primer_nombre": "ANA",
    "otros_nombres": "MARIA",
    "lugar_trabajo_pais": "CO",
    "lugar_trabajo_departamento": "05",
    "lugar_trabajo_municipio": "05001",
    "lugar_trabajo_direccion": "CALLE 10 # 20-30",
    "salario_integral": false,
    "tipo_contrato": "2",
    "sueldo": 2500000,
    "codigo_trabajador": "EMP-001"
  },
  "pago": {
    "forma": "1",
    "metodo": "47",
    "banco": "BANCOLOMBIA",
    "tipo_cuenta": "AHORROS",
    "numero_cuenta": "12345678901"
  },
  "fechas_pago": ["2026-09-30"],
  "devengados": {
    "basico": { "dias_trabajados": 30, "sueldo_trabajado": 2500000 },
    "transporte": [{ "auxilio_transporte": 200000 }],
    "hed": [
      { "hora_inicio": "2026-09-05T18:00:00", "hora_fin": "2026-09-05T20:00:00", "cantidad": 2, "porcentaje": 25, "pago": 26041 }
    ],
    "vacaciones_comunes": [
      { "fecha_inicio": "2026-09-20", "fecha_fin": "2026-09-22", "cantidad": 3, "pago": 250000 }
    ],
    "bonificaciones": [{ "salarial": 150000, "no_salarial": 50000 }],
    "otros_conceptos": [{ "descripcion": "Bono de productividad", "no_salarial": 100000 }],
    "comisiones": [80000],
    "dotacion": 60000
  },
  "deducciones": {
    "salud": { "porcentaje": 4, "deduccion": 100000 },
    "fondo_pension": { "porcentaje": 4, "deduccion": 100000 },
    "fondo_sp": { "porcentaje": 1, "deduccion": 25000 },
    "libranzas": [{ "descripcion": "Credito de vivienda", "deduccion": 300000 }],
    "retencion_fuente": 120000,
    "otras_deducciones": [15000]
  }
}