Guía de Integración (Header NE)#
Header#
Especificación y definición de datos del Header de la Nómina Electrónica.
1. Logo (NE)
Logo viene del sistema (Pre configurado en la plataforma SaphetyDoc.)
Se debe visualizar en la parte superior izquierda
NA
Tamaño en pixeles Horizontal: 200px Vertical: 80 px
2. Tipo de Documento (NE)
{
"NumeroSecuenciaXML": {
"Prefijo": "ABC",
"Consecutivo": "1"
}
}
<NumeroSecuenciaXML
CodigoTrabajador="1"
Prefijo="ABC" <!-- ( 2 ) -->
Consecutivo="1" <!-- ( 2 ) -->
Numero="ABC1"/>
El Prefijo del documento, depende de las sucursales que posea el Empleado.
El Consecutivo Debe corresponder a un consecutivo manejado por el Empleador. Se recomienda un consecutivo no mayor a 15 caracteres, tener en cuenta que la validación final la realiza la DIAN.
15 CARACTERES
3. Razón Social (NE)
Razón Social “FE DEMO” viene de sistema (Pre configurado en la plataforma SaphetyDoc).
<Empleador
RazonSocial="FE DEMO"
OtrosNombres="OtrosNombres"
NIT="80844005"
DV="1"
Pais="CO"
DepartamentoEstado="11"
MunicipioCiudad="11001"
Direccion="Crr 56 # 89-10 Oficina 208 Edficio Torre1"/>
NA
36 CARACTERES
4. Datos Empleador (NE)
{
"Empleador": {
"NIT": "80844005"
}
}
<Empleador RazonSocial="FE DEMO"
OtrosNombres="OtrosNombres"
NIT="80844005"
DV="1"
Pais="CO"
DepartamentoEstado="11"
MunicipioCiudad="11001"
Direccion="Crr 56 # 89-10 Oficina 208 Edficio Torre1"/>
Se debe colocar el NIT sin guiones ni DV de la empresa dueña del Software que genera el Documento, debe estar registrado en la DIAN.
36 CARACTERES
5. Dígito de Verificación (NE)
El dígito de verificación “1” viene de sistema (Pre configurado en la plataforma SaphetyDoc).
<Empleador RazonSocial="FE DEMO"
OtrosNombres="OtrosNombres"
NIT="80844005"
DV="1"
Pais="CO"
DepartamentoEstado="11"
MunicipioCiudad="11001"
Direccion="Crr 56 # 89-10 Oficina 208 Edficio Torre1"/>
NA
NA
6 - 7 - 8. Datos Trabajador (NE)
{
"Trabajador": {
"TipoDocumento": "13", //( 6 )
"NumeroDocumento": "123456789", //( 7 )
"CodigoTrabajador": "1", //( 8 )
}
}
<Trabajador
TipoDocumento="13" <!-- ( 6 ) -->
NumeroDocumento="123456789" <!-- ( 7 ) -->
CodigoTrabajador="1"/><!-- ( 8 ) -->
El TipoDocumento de identificación que actualmente tiene el trabajador, aprendiz, o pasante.
Los tipos de documentos están disponibles en el método WEB API de Saphety: TiposDeDocumento
El NumeroDocumento es el Número de identificación que actualmente tiene el trabajador o aprendiz.
El CodigoTrabajador es el código del trabajador a manejo interno del Empleador (Campo opcional).
36 CARACTERES
9 - 13. Forma de Pago (NE)
{
"Pago": {
"Forma": "1", //( 9 )
"Metodo": "11",//( 14 )
}
}
<Pago
Forma="1" <!-- ( 9 ) -->
Metodo="11"/><!-- ( 14 ) -->
La Forma de pago del documento.
Las Formas de pago están disponibles en el método WEB API de Saphety: Formas
Métodos de Pago del Documento.
Los Métodos de pago están disponibles en el método WEB API de Saphety: Métodos
36 CARACTERES
11. Periodo de Pago (NE)
{
"Periodo": {
"FechaIngreso": "2021-07-01",
"FechaLiquidacionInicio": "2021-07-01",//(11)
"FechaLiquidacionFin": "2021-07-07",//(11)
"TiempoLaborado": "7",
"FechaGen": "2021-07-07"
}
}
<Periodo FechaIngreso="2021-07-01"
FechaLiquidacionInicio="2021-07-01" <!-- (11) -->
FechaLiquidacionFin="2021-07-07" <!-- (11) -->
TiempoLaborado="7"
FechaGen="2021-07-07"/>
La FechaIngreso corresponde a la Fecha de Ingreso del trabajador a la empresa, en formato AAAA-MM‐DD
La FechaLiquidacionInicio corresponde a la Fecha de inicio de Liquidación de Nómina.
La FechaLiquidacionFin corresponde a la Fecha fin de Liquidación de Nómina.
El TiempoLaborado corresponde al número de días trabajados.
La FechaGen Debe ir la fecha de emisión del documento. Considerando zona horaria de Colombia (‐ 5), en formato AAAA‐MM‐DD
NA
10 - 12 - 13. Datos Trabajador (NE)
{
"Trabajador": {
"TipoTrabajador": "47",//( 13 )
"SubTipoTrabajador": "00",
"AltoRiesgoPension": "true",
"TipoDocumento": "13",
"NumeroDocumento": "123456789",
"PrimerApellido": "Primer Apellido",//( 12 )
"SegundoApellido": "Segundo Apellido",//( 12 )
"PrimerNombre": "Primer Nombre",//( 12 )
"OtrosNombres": "Otros Nombres",//( 12 )
"LugarTrabajoPais": "CO",
"LugarTrabajoDepartamentoEstado": "11",
"LugarTrabajoMunicipioCiudad": "11001",
"LugarTrabajoDireccion": "Direccion",
"SalarioIntegral": "true",//( 10 )
"Sueldo": "1500000",
"TipoContrato": "1",
"CorreoElectronico": "correo@correo.com",
}
}
<Trabajador
TipoTrabajador="47" <!-- ( 13 ) -->
SubTipoTrabajador="00"
AltoRiesgoPension="true"
TipoDocumento="13"
NumeroDocumento="123456789"
PrimerApellido="Primer Apellido"<!-- ( 12 ) -->
SegundoApellido="Segundo Apellido"<!-- ( 12 ) -->
PrimerNombre="Primer Nombre"<!-- ( 12 ) -->
OtrosNombres="Otros Nombres"<!-- ( 12 ) -->
LugarTrabajoPais="CO"
LugarTrabajoDepartamentoEstado="11"
LugarTrabajoMunicipioCiudad="11001"
LugarTrabajoDireccion="Direccion"
SalarioIntegral="true" <!-- ( 10 ) -->
TipoContrato="1"
Sueldo="2800000.00"
CodigoTrabajador="1"
Sueldo="1500000.00"/>
El TipoTrabajador corresponde al Código del tipo de trabajador del Ministerio de salud. Aportes a Seguridad Social de Activos.
Los TipoTrabajador están disponibles en el método WEB API de Saphety: TipoTrabajador
El PrimerNombre corresponde al Primer Nombre del trabajador o aprendiz.
El PrimerApellido corresponde al Primer Apellido del trabajador o aprendiz.
El SegundoApellido corresponde al Segundo Apellido del trabajador o aprendiz.
El campo CorreoElectronico se utiliza para realizar la notificación y es opcional.
El campo Sueldo, Corresponde al valor que el empleador paga de forma periódica al trabajador como contraprestación por el trabajo realizado, este puede ser fijo o variable de acuerdo con la unidad de tiempo en que las partes hayan acordado el pago, teniendo como base el día o la hora trabajada.
36 CARACTERES
15 - 16. Información General (NE)
{
"InformacionGeneral": {
"FechaHoraGen": "2021-07-08T00:00:00", //( 16 )
"PeriodoNomina": "1",
"TipoMoneda": "COP",//( 15 )
}
}
<InformacionGeneral
Version="V1.0: Documento Soporte de Pago de Nómina Electrónica"
Ambiente="2"
TipoXML="102" CUNE="c722a4091317e4bd9baf894224c515a61783380f3588e6f9233f5844f45e182265e82a52586e135707930c1e5a5f2e5
EncripCUNE="CUNE-SHA384"
FechaGen="2021-07-08"<!-- ( 16 ) -->
HoraGen="00:00:00-05:00"<!-- ( 16 ) -->
PeriodoNomina="1"
TipoMoneda="COP"<!-- ( 15 ) -->
TRM="10.00"/>
El campo FechaHoraGen son: Fecha de emisión más la Hora de emisión en formato aaaa-mm-ddThh:mm:ss
El campo PeriodoNomina corresponde al código de periodo de Nómina.
Los PeriodoNomina están disponibles en el método WEB API de Saphety: PeriodoNómina
El TipoMoneda corresponde al Tipo de Moneda utilizada en el documento.
25 CARACTERES
Otro. Identificador Único Documento (NE)
{
"CorrelationDocumentId": "POSTMAN-1625754123"
}
NA
El campo CorrelationDocumentId corresponde al identificador único del Emisor.
NA
Otro. Fecha de Pagos (NE)
{
"FechasPagos": [
{
"FechaPago": "2021-06-29"
}
]
}
<FechasPagos>
<FechaPago>2021-06-29</FechaPago>
</FechasPagos>
El campo FechaPago corresponde a la fecha de pago de la Nómina Electrónica.
NA
Otro. Lugar de Generación del Documento (NE)
{
"LugarGeneracionXML": {
"Pais": "CO",
"DepartamentoEstado": "11",
"MunicipioCiudad": "11001",
"Idioma": "es"
}
}
<LugarGeneracionXML
Pais="CO"
DepartamentoEstado="11"
MunicipioCiudad="11001"
Idioma="es"/>
El campo País corresponde al Código del país donde se genera el documento. Los códigos de los países están disponibles en el método WEB API de Saphety: CountryCode
El campo DepartamentoEstado corresponde al Código del departamento donde se genera el documento. Los códigos de los departamentos están disponibles en el método WEB API de Saphety: DepartamentoEstado
El campo MunicipioCiudad corresponde al Código del municipio o ciudad donde se genera el documento. Los códigos de los municipios están disponibles en el método WEB API de Saphety: MunicipioCiudad
El campo Idioma corresponde al Código del país donde se genera el documento. Los códigos de idiomas están disponibles en el método WEB API de Saphety: Idioma
NA