Nota Ajuste de Reemplazo (Nómina)#
Las notas de ajuste de reemplazo de nómina electrónica permiten reemplazar o modificar una nómina individual que contenga uno o varios errores en su creación.
A continuación se describe los métodos y estructuras para la creación de una Nota de Ajuste Tipo Eliminación de una Nómina Electrónica.
Creación de una Nota de Ajuste de Reemplazo (NAR).#
Para hacer el consumo de la API se deben tener en cuenta en que entorno se va a trabajar, SOVOS Saphety cuenta con dos ambientes especificados en el apartado de Entornos.
Consumo del método de creación.#
El Verbo Http (acción) que se utiliza para la creación de este documento es:
POST
El método que se utiliza para la creación de este documento es:
/v2/{virtualOperator}/payroll/replacementPayrollAsync
Parameters
Para esta petición se requiere como parámetro el alias de su operador virtual.
Parametro virtualOperator
Recuerde reemplazar en el método el parámetro {virtualOperator} con el alias de su operador virtual en minúsculas, por defecto el alias es “saphety”.
Body#
Estructura del mensaje JSON de una Nota de Ajuste de Eliminación (Nómina)#
A continuación encontrara la estructura Base definida por Saphety para la creación de una Nota de Ajuste de Eliminación para Nómina Electrónica.
JSON (DTO)
{
"TipoNota": "1",
"Reemplazar": {
"ReemplazandoPredecesor": {
"NumeroPred": "ABC1222",
"CUNEPred": "cd62475de5abcd4d79adea9a9d823c30f82afbad59f4611d597b35518a62c2c63f63b7e1ac565b6e12427d6e15dbd7f3",
"FechaGenPred": "2021-07-07"
},
"Novedad": {
"CuneNov": "42573cff1435ac3d5391714ce0a894355c2ac44baa88867e39b61f3b3636164d5e2306791814d2bbf55234b5f7614ba4",
"Value": "true"
},
"Periodo": {
"FechaIngreso": "2021-07-01",
"FechaLiquidacionInicio": "2021-07-01",
"FechaLiquidacionFin": "2021-07-07",
"TiempoLaborado": "7",
"FechaGen": "2021-07-07"
},
"NumeroSecuenciaXML": {
"CodigoTrabajador": "1",
"Prefijo": "NAR", // Prefijo generado por la plataforma de nomina
"Consecutivo": "1222" // Consecutivo generado por la plataforma de nomina
},
"LugarGeneracionXML": {
"Pais": "CO",
"DepartamentoEstado": "11",
"MunicipioCiudad": "11001",
"Idioma": "es"
},
"InformacionGeneral": {
"FechaHoraGen": "2021-07-20T00:00:00",
"PeriodoNomina": "1",
"TipoMoneda": "COP",
"TRM": "10"
},
"Notas": [
"Nota de prueba"
],
"Empleador": {
"NIT": "{{nit}}" // nit de la empresa emisora o empleador
},
"Trabajador": {
"TipoTrabajador": "01",
"SubTipoTrabajador": "00",
"AltoRiesgoPension": "true",
"TipoDocumento": "13",
"NumeroDocumento": "123456789",
"PrimerApellido": "Primer Apellido",
"SegundoApellido": "Segundo Apellido",
"PrimerNombre": "Primere Nombre",
"OtrosNombres": "Otros Nombres",
"LugarTrabajoPais": "CO",
"LugarTrabajoDepartamentoEstado": "11",
"LugarTrabajoMunicipioCiudad": "11001",
"LugarTrabajoDireccion": "Direccion",
"SalarioIntegral": "true",
"TipoContrato": "1",
"Sueldo": "1",
"CodigoTrabajador": "1",
"CorreoElectronico": "correo@correo.com" // si no se quiere enviar la notificacion eliminar este campo
},
"Pago": {
"Forma": "1",
"Metodo": "11"
},
"FechasPagos": [
{
"FechaPago": "2021-02-22"
}
],
"Devengados": {
"Basico": {
"DiasTrabajados": "7",
"SueldoTrabajado": "2800000.00"
},
"Transporte": [
{
"AuxilioTransporte": "20000.00",
"ViaticoManutAlojS": "50000.00",
"ViaticoManutAlojNS": "10000.00"
},
{
"AuxilioTransporte": "10000.00",
"ViaticoManutAlojS": "30000.00",
"ViaticoManutAlojNS": "15000.00"
}
],
"HEDs": [
{
"Cantidad": "3",
"Porcentaje": "100",
"Pago": "300000.00"
}
],
"HENs": [
{
"Cantidad": "1",
"Porcentaje": "100",
"Pago": "10000.00"
}
],
"HRNs": [
{
"Cantidad": "1",
"Porcentaje": "100",
"Pago": "500.00"
}
],
"HEDDFs": [
{
"Cantidad": "1",
"Porcentaje": "100",
"Pago": "5500.00"
}
],
"HRDDFs": [
{
"Cantidad": "1",
"Porcentaje": "100",
"Pago": "8500.00"
}
],
"HENDFs": [
{
"Cantidad": "1",
"Porcentaje": "100",
"Pago": "5700.00"
}
],
"HRNDFs": [
{
"Cantidad": "1",
"Porcentaje": "100",
"Pago": "7800.00"
}
],
"Vacaciones": {
"VacacionesComunes": [
{
"Cantidad": "1",
"Pago": "450000.00"
}
],
"VacacionesCompensadas": [
{
"Cantidad": "1",
"Pago": "102000.00"
}
]
},
"Primas": {
"Cantidad": "1",
"Pago": "100000.00",
"PagoNS": "50000.00"
},
"Cesantias": {
"Pago": "1500000.00",
"Porcentaje": "100",
"PagoIntereses": "20000.00"
},
"Incapacidades": [
{
"Cantidad": "1",
"Tipo": "1",
"Pago": "15000.00"
},
{
"Cantidad": "1",
"Tipo": "2",
"Pago": "30000.00"
}
],
"Licencias": {
"LicenciaMP": [
{
"Cantidad": "1",
"Pago": "450000.00"
}
],
"LicenciaR": [
{
"Cantidad": "1",
"Pago": "38000.00"
}
],
"LicenciaNR": [
{
"Cantidad": "1"
}
]
},
"Bonificaciones": [
{
"BonificacionS": "10000.00",
"BonificacionNS": "3500.00"
}
],
"Auxilios": [
{
"AuxilioS": "800.00",
"AuxilioNS": "700.00"
}
],
"OtrosConceptos": [
{
"DescripcionConcepto": "Descripcion Concepto",
"ConceptoS": "350.00",
"ConceptoNS": "950.00"
}
],
"Compensaciones": [
{
"CompensacionO": "9600.00",
"CompensacionE": "7850.00"
}
],
"BonoEPCTVs": [
{
"PagoS": "8000.00",
"PagoNS": "650.00",
"PagoAlimentacionS": "750.00",
"PagoAlimentacionNS": "450.00"
}
],
"Comisiones": [
{
"Comision": "96000.00"
}
],
"PagosTerceros": [
{
"PagoTercero": "45000.00"
}
],
"Anticipos": [
{
"Anticipo": "15000.00"
}
],
"Dotacion": "5000.00",
"ApoyoSost": "20000.00",
"Teletrabajo": "95000.00",
"BonifRetiro": "75000.00",
"Indemnizacion": "80000.00",
"Reintegro": "15000.00"
},
"Deducciones": {
"Salud": {
"Porcentaje": "1.00",
"Deduccion": "35000.00"
},
"FondoPension": {
"Porcentaje": "1.00",
"Deduccion": "510000.00"
},
"FondoSP": {
"Porcentaje": "1.00",
"Deduccion": "24900.00",
"PorcentajeSub": "1.00",
"DeduccionSub": "96300.00"
},
"Sindicatos": [
{
"Porcentaje": "1.00",
"Deduccion": "127500.00"
}
],
"Sanciones": [
{
"SancionPublic": "7000.00",
"SancionPriv": "9000.00"
}
],
"Libranzas": [
{
"Descripcion": "Banco",
"Deduccion": "780000.00"
}
],
"PagosTerceros": [
{
"PagoTercero": "10000.00"
}
],
"Anticipos": [
{
"Anticipo": "85000.00"
}
],
"OtrasDeducciones": [
{
"OtraDeduccion": "96300.00"
}
],
"PensionVoluntaria": "500000.00",
"RetencionFuente": "500.00",
"AFC": "2800.00",
"Cooperativa": "350.00",
"EmbargoFiscal": "450320.00",
"PlanComplementarios": "510.00",
"Educacion": "35820.00",
"Reintegro": "9850.00",
"Deuda": "23450.00"
},
"DevengadosTotal": "4999850.00",
"DeduccionesTotal": "2793300.00",
"ComprobanteTotal": "2206550.00"
},
"CorrelationDocumentId": "POSTMAN-{{$timestamp}}" // Codigo unico generado por la plataforma de nomina.
}
Respuesta#
{
"IsValid": true,
"Warnings": [],
"Errors": [],
"ResultData": "7290c7be-815f-43eb-a6ea-387350653275",
"ResultCode": 200
}
{
"IsValid": false,
"Warnings": [],
"Errors": [
{
"Field": null,
"Code": "DeserializationError",
"Description": "Invalid character after parsing property name. Expected ':' but got: E. Path 'TipoNota', line 4, position 3.",
"ExplanationValues": []
}
],
"ResultData": null,
"ResultCode": 400
}
Referencia: Swagger#
Si quieres más información dirígete a Swagger que es el modelo del API de SOVOS Saphety, para el ambiente de QA https://api-factura-electronica-co-qa.saphety.com/swagger/index.html y para el ambiente de producción https://api-factura-electronica-co.saphety.com/swagger/index.html