Estructura Nómina Electrónica
Ejemplo de la estructura JSON de una nómina electrónica. Reemplaza los datos de software, devengados, deducciones e información general por los de tu empresa; si aún no has probado la API, empieza por Instalación y Pruebas.
{
"documento": {
"software": {
"ambiente": 2,
"identificacion": "iDENTIFICACION",
"pin": "345345",
"ruta_certificado": "Certificado.p12",
"clave_certificado": "CLAVE"
},
"fechas_pagos": [
{
"fecha_pago": "2023-11-12"
}
],
"devengados_total": 2546936.0,
"comprobante_total": 2410464.0,
"deducciones_total": 136472.0,
"informacion_general": {
"hora_gen": "10:28:12-05:00",
"fecha_gen": "2023-10-31",
"periodo_nomina": 4,
"ambiente": 2,
"version": "",
"tipo_xml": "102"
},
"proveedor_software": {
"razon_social": "EMPRESA",
"primer_apellido": "",
"segundo_apellido": "",
"primer_nombre": "",
"otros_nombres": "",
"nit": "345345",
"dv": 1,
"software_id": "",
"software_sc": "",
"codigo_qr": ""
},
"lugar_generacion_xml": {
"municipio_ciudad": "05364",
"departamento_estado": "05"
},
"numero_secuencia_xml": {
"numero": "N138",
"prefijo": "N",
"consecutivo": "138"
},
"pago": {
"banco": "BANCOLOMBIA",
"forma": "1",
"metodo": "47",
"tipo_cuenta": "Cuenta de Ahorros",
"numero_cuenta": "3463546456"
},
"notas": "",
"periodo": {
"fecha_gen": "2023-11-12",
"fecha_ingreso": "2021-10-19",
"tiempo_laborado": "732",
"fecha_liquidacion_fin": "2023-10-31",
"fecha_liquidacion_inicio": "2023-10-01"
},
"redondeo": "0.00",
"empleador": {
"nit": "34564356",
"dv": 1,
"razon_social": "EMPRESA",
"departamento": "05",
"ciudad": "05034",
"direccion": "calle 123"
},
"trabajador": {
"sueldo": "1560000.00",
"otros_nombres": "JUANA",
"primer_nombre": "LEIDY",
"tipo_contrato": "2",
"tipo_documento": "13",
"primer_apellido": "Martinez",
"segundo_apellido": "Perez",
"tipo_trabajador": "01",
"numero_documento": "123456",
"salario_integral": false,
"alto_riesgo_pension": false,
"sub_tipo_trabajador": "00",
"lugar_trabajo_direccion": "Calle 234 # 2345",
"lugar_trabajo_municipio_ciudad": "05034",
"lugar_trabajo_departamento_estado": "05"
},
"devengados": {
"heds": [
{
"hora_inicio": "2023-01-01T00:00:00",
"hora_fin": "2023-01-01T00:00:00",
"cantidad": 0,
"porcentaje": 0.0,
"pago": 0.0
}
],
"hens": [
{
"hora_inicio": "2023-01-01T00:00:00",
"hora_fin": "2023-01-01T00:00:00",
"cantidad": 0,
"porcentaje": 0.0,
"pago": 0.0
}
],
"hrns": [
{
"hora_inicio": "2023-01-01T00:00:00",
"hora_fin": "2023-01-01T00:00:00",
"cantidad": 0,
"porcentaje": 0.0,
"pago": 0.0
}
],
"basico": {
"dias_trabajados": 13,
"sueldo_trabajado": 677344.00
},
"heddfs": [
{
"hora_inicio": "2023-01-01T00:00:00",
"hora_fin": "2023-01-01T00:00:00",
"cantidad": 0,
"porcentaje": 0.0,
"pago": 0.0
}
],
"hendfs": [
{
"hora_inicio": "2023-01-01T00:00:00",
"hora_fin": "2023-01-01T00:00:00",
"cantidad": 0,
"porcentaje": 0.0,
"pago": 0.0
}
],
"hrddfs": [
{
"hora_inicio": "2023-01-01T00:00:00",
"hora_fin": "2023-01-01T00:00:00",
"cantidad": 0,
"porcentaje": 0.0,
"pago": 0.0
}
],
"hrndfs": [
{
"hora_inicio": "2023-01-01T00:00:00",
"hora_fin": "2023-01-01T00:00:00",
"cantidad": 0,
"porcentaje": 0.0,
"pago": 0.0
}
],
"primas": {
"cantidad": 0,
"pago": 0.0,
"pago_ns": 0.0
},
"censantias": {
"pago": 0.0,
"porcentaje": 0.0,
"pago_intereses": 0.0
},
"incapacidades": [
{
"fecha_inicio": "12:12",
"fecha_fin": "12:12",
"cantidad": 0,
"tipo": "12:12",
"pago": 0.0
}
],
"licencias": {
"licencias_mp": [
{
"fecha_inicio": "12:12",
"fecha_fin": "12:12",
"cantidad": 0,
"pago": 0.0
}
],
"licencias_r": [
{
"fecha_inicio": "12:12",
"fecha_fin": "12:12",
"cantidad": 0,
"pago": 0.0
}
],
"licencias_nr": [
{
"fecha_inicio": "12:12",
"fecha_fin": "12:12",
"cantidad": 0
}
]
},
"transporte": {
"auxilio_transporte": 61050.00,
"viatico_manut_aloj_s": 0.00,
"viatico_manut_aloj_ns": 0.00
},
"vacaciones": {
"vacaciones_comunes": [
{
"fecha_inicio": "2023-01-01T00:00:00",
"fecha_fin": "2023-01-01T00:00:00",
"cantidad": 0,
"pago": 0.0
}
],
"vacaciones_compensadas": [
{
"cantidad": 0,
"pago": 0.0
}
]
},
"bonificaciones": [
{
"bonificacion_s": 0.0,
"bonificacion_ns": 0.0
}
],
"auxilios": [
{
"auxilio_s": 0.0,
"auxilio_ns": 0.0
}
],
"huelgas_legales": [
{
"fecha_inicio": "123",
"fecha_fin": "",
"cantidad": 0
}
],
"otros_conceptos": [
{
"descripcion": "",
"concepto_s": 0.0,
"conceptop_ns": 0.0
}
],
"compensaciones": [
{
"compensacion_o": 0.0,
"compensacion_e": 0.0
}
],
"bonoepctvs": [
{
"pago_s": 0.0,
"pago_ns": 0.0,
"pago_alimentacion_s": 0,
"pago_alimentacion_ns": 0.0
}
],
"comisiones": [
{
"comision": 0.0
}
],
"pagos_terceros": [
{
"pago_tercero": 0.0
}
],
"anticipos": [
{
"anticipo": 0.0
}
],
"dotacion": 0.0,
"apoyo_sost": 0.0,
"teletrabajo": 0.0,
"bonif_retiro": 0.0,
"indemnizacion": 0.0,
"reintegro": 0.0
},
"deducciones": {
"salud": {
"deduccion": 68236.0,
"porcentaje": 4.0
},
"fondo_pension": {
"deduccion": 68236.0,
"porcentaje": 4.0
},
"fondo_sp": {
"deduccion": 0.0,
"porcentaje": 0.0,
"deduccion_sub": 0.0,
"porcentaje_sub": 0.0
},
"sindicatos": [
{
"porcentaje": 0.0,
"deduccion": 0.0
}
],
"sanciones": [
{
"sancion_public": 0.0,
"sancion_priv": 0.0
}
],
"libranzas": [
{
"descripcion": "",
"deduccion": 0.0
}
],
"pagos_terceros": [
{
"pago_tercero": 0.0
}
],
"anticipos": [
{
"anticipo": 0.0
}
],
"otras_deducciones": [
{
"otra_deduccion": 0.0
}
],
"pensionvoluntaria": 0.0,
"retencionfuente": 0.0,
"afc": 0.0,
"cooperativa": 0.0,
"embargo_fiscal": 0.0,
"plan_complementarios": 0.0,
"educacion": 0.0,
"reintegro": 0.0,
"deuda": 0.0
}
}
}