Copyright Teleinte SAS 2021
Para mayor información en operaciones@teleinte.com
Observación: Información sujeta a cambios

EndPoint


Método: POST

EndPoint:

Producción
https://servicios-pruebas.afacturar.com/api/nomina/eliminar

Habilitación
https://servicios-habilitacion.afacturar.com/api/nomina/eliminar

Producción
https://servicios.afacturar.com/api/nomina/eliminar

Seguridad SSL: Afacturar cuenta en sus endpoint con certificados de seguridad (DigiCert SHA2 Extended Validation Server CA), su aplicación debe ser capaz de negociar y validar dicho certificado.

Parámetros de entrada


HEADERS


Accept: application/json

Authorization: Bearer Token asignado a cada cliente


BODY


documento_obligado: Número de identificación del cliente

data: JSON

testSetId: Número entregado en la DIAN para la Habilitación. Este parametro es soló para habilitación


Estructura de JSON de entrada


Nomina


nomina Objeto Requerido

Información de la nomina

Especificación:

encabezado Objeto Requerido

Encabezado

Especificación:

fecha_liquidacion_inicio Date Requerido

Fecha de inicio de Liquidación de Nómina 

Especificación: AAAA-MM-DD

fecha_liquidacion_fin Date Requerido

Fecha fin de Liquidación de Nómina 

Especificación: AAAA-MM-DD

fecha_generacion Date Requerido

Fecha de emisión del documento de nómina

Especificación: AAAA-MM-DD

hora_generacion Time Requerido

Hora de emisión del documento de nómina

Especificación: HH24:MM:SS

prefijo String Requerido

Prefijo del documento, depende de las sucursales que posea el Empleador, esté es elegido por el emisor del documento

Especificación:

numero_documento String Requerido

Consecutivo manejado por el Empleador, esté es elegido por el emisor del documento 

Especificación: Mínimo 1 caracter

nota Array Requerido

Observaciones del documento

Especificación: String

periodo_nomina Parametrizado Requerido

Codigo de Periodo de Nómina

Especificación:

1= Semanal

2= Decenal

3= Catorcenal

4= Quincenal

5= Mensual 

6= Otro 

tiempo_laborado String Requerido

Cantidad de Tiempo que lleva laborando el Trabajador en la empresa, para indicar el tiempo laborado, se debe tener en cuenta la siguiente nomenclatura


Calculo Tiempo Laborado Significado
1 Año360 Dias
1 Mes30 Dias

Ejemplo: 5 Años + 3 Meses + 18 Dias => (5*360)+(3*30)+18 => 1908.00

Especificación: Cantidad de dias

pais Parametrizado Requerido

Código dentificador del país. Código alfa-2 asignado al pais

Especificación: Estandar ISO 3166-1. Inf adicional Ver

departamento Parametrizado Requerido

Codigo del departamento, son las subdivisiones administrativas del país (CO). Fue publicada en 1998 y actualizada por última vez en el sexto boletín de la primera edición en 2004.
Si no corresponde a Colombia debe ir el nombre de la ciudad o estado

Especificación: ISO 3166-2:CO. Inf adicional Ver

ciudad Parametrizado Requerido

Código del municipio ó ciudad ó subdivisión de tercer nivel.

Especificación: Inf adicional Ver

idioma Parametrizado Requerido

Código del idioma donde se genera el documento

Especificación: es- Español castellano. Inf adicional Ver

moneda Parametrizado Requerido

Divisa aplicable a toda la factura

Especificación: COP- Colombia, USD - dolares. Inf adicional Ver

fecha_retiro Date No_requerido

Fecha de retiro del trabajador o aprendiz

Especificación: AAAA-MM-DD

cambio_de_moneda Objeto No_requerido

Cambio de moneda

Especificación:

fecha_cambio Date Requerido

Fecha del cambio de la moneda.

Especificación: Formato AAAA-MM-DD y es requerido si la moneda de origen es diferente de COP

codigo Parametrizado Requerido

La moneda de referencia para el tipo de cambio; La moneda a partir de la cual se realiza el cambio.

Especificación: COP- Colombia, USD - dolares. Inf adicional Ver. Es requerido si la moneda de origen es diferente de COP

valor_base_trm String-patron Requerido

Tasa de cambio del día de emisión o expedición del documento.

Especificación: Formato #####.##, separador con punto, dos decimales. Es requerido si la moneda de origen es diferente de COP

informacion_trabajador Objeto Requerido

informacion_trabajador

Especificación:

tipo_identificacion Parametrizado Requerido

Tipo de documento de identificación de la empresa o persona

Especificación:

11= Registro civil

12= Tarjeta de identidad

13= Cedula ciudadania

21= Tarjeta de extranjería

22= Cedula de extranjería

31= NIT

41= Pasaporte

42= Documento de identificación extranjero

50= NIT de otro país

91=NUIP

identificacion String Requerido

Número completo de la identificación de la empresa o persona

Especificación: Alfanumérico

correo_electronico Requerido

Lista de direcciones de correo electronico, separadas por punto y coma ';'. Para el envio de las notificaciones al adquiriente se va tomar la primera dirección de correo.

Especificación: xxxx@xx.xx;yyyy@yy.yy

numero_movil String No_requerido

Número de móvil para el envio de notificaciones

Especificación: 3111111111

nombre Array Requerido

Nombre del trabajador

Especificación:

primer_nombre String Requerido

Primer nombre

Especificación: Mínimo 3 caracteres

otros_nombres String No_requerido

Otros nombre

Especificación:

primer_apellido String Requerido

Primer apellido

Especificación: Mínimo 3 caracteres

segundo_apellido String Requerido

Segundo apellido

Especificación: Mínimo 3 caracteres

pais Parametrizado Requerido

Código dentificador del país. Código alfa-2 asignado al pais

Especificación: Estandar ISO 3166-1. Inf adicional Ver

nombre_pais String No_requerido

Nombre del país.

Especificación: Estandar ISO 3166-1. Inf adicional Ver

departamento Parametrizado Requerido

Codigo del departamento, son las subdivisiones administrativas del país (CO). Fue publicada en 1998 y actualizada por última vez en el sexto boletín de la primera edición en 2004.
Si no corresponde a Colombia debe ir el nombre de la ciudad o estado

Especificación: ISO 3166-2:CO. Inf adicional Ver

nombre_departamento String No_requerido

Nombre del departamento

Especificación: ISO 3166-2:CO. Inf adicional Ver

ciudad Parametrizado Requerido

Código del municipio ó ciudad ó subdivisión de tercer nivel.

Especificación: Inf adicional Ver

nombre_ciudad String No_requerido

Nombre del municipio ó ciudad ó subdivisión de tercer nivel.

Especificación: Inf adicional Ver

direccion String Requerido

Elemento de texto libre, que el emisor puede elegir utilizar para poner toda la información de la dirección

Especificación: Mínimo 10 caracteres

informacion_nomina Objeto No_requerido

Información de nomina

Especificación:

numero_documento Strig Requerido

Numero de la nomina a la cual se va a realizar cambios.

Especificación: Prefijo+numero_documento

cune String Requerido

CUNE de la nomina a la cual se va a realizar cambios.

Especificación: CUNE

fecha_documento Date Requerido

Fecha del documento a la cual se va a realizar cambios.

Especificación: Formato AAAA-MM-DD

generalidades Objeto Requerido

Información de quien envia la información

Especificación:

tipo_ambiente_dian Parametrizado Requerido

Ambiente de la DIAN al que se destina el documento enviado.

Especificación:

1= Producción

2= Pruebas

version Numerico Requerido

Identificación consecutiva de la especificación

Especificación:

identificador_transmision String Mínimo 5 caracteres

Código único para identificar el paquete transmitido

Especificación:

integrador Objeto Requerido

Información de quien envia la información

Especificación:

nombre Parametrizado Requerido

Nombre de quien realiza la integración

Especificación: S o N

tipo Parametrizado Requerido

Codigo del medio usado para realizar la integración

Especificación:

MOVIL

WEB

DLL

EXCEL

ERP-XXXXXXXXX

webhook String No_requerido

URL para notificar cuando ha ocurrido un evento. Esta se utiliza cuando los codigos de error del retorno del API son 28,20.

Especificación: URL con portocolo de seguridad - HTTPS

notificacion Objeto Requerido

Información de configuración de envio de notificaciones. Los campos de notificación son obligatorios en caso que sea de forma automatica.

Especificación:

es_automatico Parametrizado Requerido

Indicar si la notificación es enviada de forma automatica

Especificación: S o N

para Requerido

Especificación: xxx@xx.xxx

con_copia No_requerido

Especificación: xxx@xx.xxx

complemento_asunto String No_requerido

Especificación:

Estructura json

							{
	"nomina": [
		{
			"encabezado": {
				"fecha_liquidacion_inicio": "",
				"fecha_liquidacion_fin": "",
				"fecha_generacion": "",
				"hora_generacion": "",
				"prefijo": "",
				"numero_documento": "",
				"nota": [
					""
				],
				"periodo_nomina": "",
				"tiempo_laborado": "",
				"pais": "",
				"departamento": "",
				"ciudad": "",
				"idioma": "",
				"moneda": ""
			},
			"cambio_de_moneda": {
				"fecha_cambio": "",
				"codigo": "",
				"valor_base_trm": ""
			},
			"informacion_trabajador": {
				"tipo_identificacion": "",
				"identificacion": "",
				"correo_electronico": "",
				"numero_movil": "",
				"nombre": {
					"primer_nombre": "",
					"otros_nombres": "",
					"primer_apellido": "",
					"segundo_apellido": ""
				},
				"pais": "",
				"nombre_pais": "",
				"departamento": "",
				"nombre_departamento": "",
				"ciudad": "",
				"nombre_ciudad": "",
				"direccion": ""
			},
			"informacion_nomina": {
				"numero_documento": "",
				"cune": "",
				"fecha_documento": ""
			}
		}
	],
	"generalidades": {
		"tipo_ambiente_dian": 0,
		"identificador_transmision": "",
		"integrador": {
			"nombre": "",
			"tipo": "",
			"webhook": ""
		},
		"notificacion": {
			"es_automatico": "",
			"para": "",
			"con_copia": "",
			"complemento_asunto": ""
		}
	}
}							

Estructura JSON de respuesta


Salida Exitosa



{
	"codigo_error": 0,
	"descripcion_error": "OK",
	"tiempo_ejecucion": 2.8475100994110109,
	"transaccion": "5e5e5e5e5e55e",
	"resultado": {
		"cune": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
		"numero_nomina": "S00001",
		"url_representacion_qr_svg": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/QR_111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.svg",
		"qr_url_imagen_base_64": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/QR64_111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.txt",
		"url_representacion_xml": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/fv083002047005520S00001.xml",
		"url_application_response": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/ar083002047005520S00001.xml",
		"url_attached_document_url": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/ad083002047005520S00001.xml",
		"url_representacion_grafica": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/ad083002047005520S00001.pdf"
	},
	"entorno": "Este documento se envia al entorno: DOCUMENTO_NO_VALIDO",
	"ErrorMessage_DIAN": ""
}
							  
							 

Salida con errores de semantica



{
    "codigo_error": 400,
    "descripcion_error": "Hay un problema con la informacion entregada",
    "tiempo_ejecucion": 0.01330113410949707,
    "transaccion": "5e74ce82707f6",
    "resultado": [
        {
            "propiedad": "nomina[0].encabezado.periodo_nomina",
            "descripcion": "Does not have a value in the enumeration [1,2,3,4,5]"
        },
        {
            "propiedad": "nomina[0].encabezado.periodo_nomina",
            "descripcion": "Does not have a value in the enumeration [1,2,3,4,5]"
        },
        {
            "propiedad": "nomina[0].encabezado",
            "descripcion": "The property hora_generacio is not defined and the definition does not allow additional properties"
        }
    ],
    "entorno": "Este documento se envia al entorno: DOCUMENTO_NO_VALIDO",
    "ErrorMessage_DIAN": ""
}
						
					  

Salida con errores de datos



{
    "codigo_error": 400,
    "descripcion_error": "Hay problema(s) con la información entregada",
    "resultado": [
        [
            {
                "propiedad": "nomina->valor_nomina-> valor_total_pago ",
                "descripcion": "El valor total del pado es diferente al (valor base + valor devengos) - valor deducciones  "
            }
        ]
    ]
}									
						
						

Salida con errores HTTP



{
	"codigo_error": 500,
	"descripcion_error": "Unauthenticated."
}
						

Salida con error de datos en la DIAN



{
    "codigo_error": 15,
    "descripcion_error": "La validación en la DIAN devuelve error(es)",
    "tiempo_ejecucion": 1.9776690006256104,
    "transaccion": "5e74d144dd565",
    "resultado": {
		"cufe": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
		"numero_nomina": "SETP990001504",
        "url_representacion_qr_svg": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/QR_111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.svg",
        "qr_url_imagen_base_64": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/QR64_111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.txt",
        "url_representacion_xml": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/fv083002047005520SETP990001502.xml",
    },
    "entorno": "Este documento se envia al entorno: DOCUMENTO_NO_VALIDO",
    "ErrorMessage_DIAN": ""
}
						

Codigo de respuesta


Cuando usted hace un llamado a la API, puede recibir los siguientes mensajes de error en la respuesta. Puede que haya algo mal con su solicitud o puede que algo esté mal de nuestra parte. Los errores responden con un código de error y JSON que contiene un mensaje, una descripción y un código API más preciso.

Códigos de ERROR


Tabla de Errores
Código Estado Descripción Acción sugerida
28 Timeout La operación duro más de 60 seg
15 Error retornado por la DIAN La información enviada no cumple con el estandar del XML o los valores no estan bien calculados
400 Solicitud incorrecta Hay un problema con su solicitud Compruebe que su solicitud sigue la documentación de la API y utiliza la sintaxis correcta.
401 No autorizado No tiene la autorización necesaria para realizar la solicitud. Asegúrese de estar utilizando una clave API válida con los permisos necesarios para su solicitud.
403 Prohibido El servidor entendió la solicitud, pero se negó a cumplirla. Vea si su plan en Afacturar.com incluye el recurso que está solicitando y su clave API tiene las autorizaciones necesarias.
404 No encontrado El servidor no pudo encontrar el recurso solicitado. Cambie su URL de solicitud para que coincida con un punto final API válido.
405 Método no permitido El recurso no tiene el método especificado. (por ejemplo, PUT en las transmisiones) Cambie el método para seguir la documentación del recurso.
409 Conflicto Un conflicto surgió de su solicitud. (por ejemplo, el OFE no esta asociado al código de autorización) Modificar la carga útil para eliminar el conflicto..
415 Tipo de medio no admitido La solicitud no está en un formato compatible. Verifique que su encabezado Content-Type sea compatible y que su solicitud cumpla con la documentación.
422 Entidad no procesable La solicitud fue sintácticamente correcta pero falló debido a errores semánticos. Asegúrese de que su solicitud incluya todos los campos obligatorios y que sus datos sean válidos.
429 Exceder el límite de envío Se excede el numero de transacciones permitido (120 por minuto). Verifique que se encuentra dentro de los límites acordados con Afacturar.
500 Error de servidor interno Algo salió mal de nuestro lado. Pruebe la solicitud nuevamente más tarde. Si el error no se resuelve, póngase en contacto con el soporte técnico soporte@afacturar.com.
503 Servicio no disponible Estamos experimentando niveles de tráfico más altos de lo normal. Prueba la solicitud nuevamente, ya estamos enterado del problema para aumentar la capacidad.

Nomina ejemplos


Ejemplo 1.

							{
	"nomina": [
		{
			"encabezado": {
				"fecha_liquidacion_inicio": "2021-01-01",
				"fecha_liquidacion_fin": "2021-01-31",
				"fecha_documento": "2021-02-10",
				"hora_documento": "10:00:00",
				"fecha_generacion": "2021-02-10",
				"hora_generacion": "10:00:00",
				"prefijo": "NE",
				"numero_documento": "314",
				"nota": [
					"Nota 1",
					"Nota 2",
					"Nota 3"
				],
				"periodo_nomina": 5,
				"tiempo_laborado": "5000.00",
				"pais": "CO",
				"departamento": "11",
				"ciudad": "11001",
				"idioma": "es",
				"moneda": "COP"
			},
			"informacion_trabajador": {
				"tipo_identificacion": 13,
				"identificacion": "33000000",
				"correo_electronico": "jperez@teleinte.com",
				"numero_movil": "777777",
				"nombre": {
					"primer_nombre": "Andres",
					"otros_nombres": "german",
					"primer_apellido": "ibarra",
					"segundo_apellido": "bravo"
				},
				"pais": "CO",
				"nombre_pais": "Colombia",
				"departamento": "11",
				"nombre_departamento": "Bogota",
				"ciudad": "11001",
				"nombre_ciudad": "bogoota",
				"direccion": "Carrera 10 96-29"
			},
			"informacion_nomina": {
				"numero_documento": "NE305",
				"cune": "bf04e28745e9c208104157dbee7277e4c84f299ba5fe662833f0b4c9a207c063000413bfe315a1ac88fe9679c2828450",
				"fecha_documento": "2021-06-16"
			}
		}
	],
	"generalidades": {
		"tipo_ambiente_dian": 2,
		"identificador_transmision": "2021-02-18",
		"integrador": {
			"nombre": "",
			"tipo": "",
			"webhook": ""
		}
	}
}							

Ejemplo 2.

							{
	"nomina": [
		{
			"encabezado": {
				"fecha_liquidacion_inicio": "2021-01-01",
				"fecha_liquidacion_fin": "2021-01-31",
				"fecha_documento": "2021-02-10",
				"hora_documento": "10:00:00",
				"fecha_generacion": "2021-02-10",
				"hora_generacion": "10:00:00",
				"prefijo": "NE",
				"numero_documento": "314",
				"nota": [
					"Nota 1",
					"Nota 2",
					"Nota 3"
				],
				"periodo_nomina": 5,
				"tiempo_laborado": "5000.00",
				"pais": "CO",
				"departamento": "11",
				"ciudad": "11001",
				"idioma": "es",
				"moneda": "COP"
			},
			"cambio_de_moneda": {
				"fecha_cambio": "2021-03-01",
				"codigo": "MX",
				"valor_base_trm": "2500.00"
			},
			"informacion_trabajador": {
				"tipo_identificacion": 13,
				"identificacion": "33000000",
				"correo_electronico": "jperez@teleinte.com",
				"numero_movil": "777777",
				"nombre": {
					"primer_nombre": "Andres",
					"otros_nombres": "german",
					"primer_apellido": "ibarra",
					"segundo_apellido": "bravo"
				},
				"pais": "CO",
				"nombre_pais": "Colombia",
				"departamento": "11",
				"nombre_departamento": "Bogota",
				"ciudad": "11001",
				"nombre_ciudad": "bogoota",
				"direccion": "Carrera 10 96-29"
			},
			"informacion_nomina": {
				"numero_documento": "NE305",
				"cune": "bf04e28745e9c208104157dbee7277e4c84f299ba5fe662833f0b4c9a207c063000413bfe315a1ac88fe9679c2828450",
				"fecha_documento": "2021-06-16"
			}
		}
	],
	"generalidades": {
		"tipo_ambiente_dian": 2,
		"identificador_transmision": "2021-02-18",
		"integrador": {
			"nombre": "",
			"tipo": "",
			"webhook": ""
		}
	}
}							

Consumo del API


CURL

								curl -X POST \
  https://servicios-pruebas.afacturar.com/api/vp_des/nomina \
  -H 'accept: application/json' \
  -H 'authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6ImY3M2I5YTA0NjQwMThhNDQ5ZDkxYzQ3YmJjMDZhOGEzOTkxZDY0MWRmODlhYWQ5NTczYzQwZWQ3YzJhMjIxZTE2MTYwM2M2ODA2MDBmZjNjIn0.eyJhdWQiOiIxMyIsImp0aSI6ImY3M2I5YTA0NjQwMThhNDQ5ZDkxYzQ3YmJjMDZhOGEzOTkxZDY0MWRmODlhYWQ5NTczYzQwZWQ3YzJhMjIxZTE2MTYwM2M2ODA2MDBmZjNjIiwiaWF0IjoxNTg4MjY5ODY0LCJuYmYiOjE1ODgyNjk4NjQsImV4cCI6MTYxOTgwNTg2NCwic3ViIjoiMTA3NyIsInNjb3BlcyI6W119.dzEvpEWCbZMGIeuTixpUdnvCqE_p_bQEI-3qP-7o6vXV2JzeSrk9Avo-HCjxQD58CUsWdyusa87bEoRthuq2RmdoLRAu7cBKmH_UmJa4iNNZIjZFgGPNzHHNsqf8PUnfGrlC0bvOIpfCoEruP6_AkuHTZ2ToeW8KC1iOg793VrNzJ63co5etpe5cYGkObp9qhGVu00zoGwlzpzyUems9xMj8rJ3g6kOv89p4FlNd9k5-Gn3hceR4oG_PpMnfg0lMMQH55CClXT7Nqj98VrJbE7zLLOOgZbTYYhtXvl9I826OY-5y50UH8b9UQ3npSmXU2y6CPMMrhB32K5XdYjnkLRkO3pYWzkmyRYL6vksOyRSTQX6_2tXDHA0Z0mSlEReo-h2vNv8ptk5unK1BrKIck4YOUwQfv39THhObarIAKvxYleggDs37oyxuGM7kW4lHfkEJGafXINMXHHpqz4Gf3x03oLz3rR4A0iGGK5I-18KzeBt3nAJrwsqmflurlZYPWkmz_IQTuu69FcbrB1X9XQ7Kd6ZPQSrrONAg6MXE_hyjdl_qfzdqp20hBCE1PcNmAsVdk9aMmIglW1lgDaELm71uSX3oIyhW0fGGjKRNAlaxwVYk22i0z4YP_QBjjV4icCTQzOOjVXE0HcKxuqGThjDy315-BM9hETEgfQvUSJE' \
  -H 'cache-control: no-cache' \
  -H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
  -H 'postman-token: 66ddadf8-cf0e-6598-4ae5-e35395aac6ac' \
  -F 'data={
	"nomina": [
		{
			"encabezado": {
				"fecha_liquidacion_inicio": "2021-01-01",
				"fecha_liquidacion_fin": "2021-01-31",
				"fecha_generacion": "2021-02-10",
				"hora_generacion": "10:00:00",
				"prefijo": "",
				"consecutivo": "1",
				"nota": [
					"Nota 1",
					"Nota 2",
					"Nota 3"
				],
				"periodo_nomina": 5,
				"tiempo_laborado": "5000.00",
				"pais": "CO",
				"departamento": "11",
				"ciudad": "110001",
				"idioma": "es",
				"moneda": "COP"
			},
			"informacion_trabajador": {
				"tipo_identificacion": 13,
				"identificacion": "33333333",
				"correo_electronico": "jperez@teleinte.com",
				"numero_movil": "",
				"nombre": {
					"primer_nombre": "Juan",
					"otros_nombres": "Marcos",
					"primer_apellido": "Perez",
					"segundo_apellido": "Perez"
				},
				"pais": "CO",
				"nombre_pais": "Colombia",
				"departamento": "11",
				"nombre_departamento": "Bogota",
				"ciudad": "11001",
				"nombre_ciudad": "Bogota",
				"direccion": "Carrera 10 96-29"
			},
			"contrato": {
				"codigo_trabajador": "2020",
				"tipo_trabajador": "01",
				"subtipo_trabajador": "00",
				"riesgo_pensional": true,
				"tipo_contrato": 5,
				"fecha_ingreso": "2005-05-03",
				"salario_integral": "N",
				"sueldo": "4000000.00"
			},
			"pago": {
				"fecha": [
					"2021-02-01"
				],
				"forma": 1,
				"metodo": 45,
				"cuenta_bancaria": {
					"nombre_banco": "",
					"tipo": "",
					"numero": ""
				}
			},
			"devengados": {
				"basico": {
					"dias_trabajados": 30,
					"sueldo": "4000000.00"
				},
				"teletrabajo": [
					{
						"pago": "100000.00"
					}
				]
			},
			"deducciones": {
				"salud": {
					"porcentaje": "4.00",
					"deduccion": "160000.00"
				},
				"fondo_pension": {
					"porcentaje": "4.00",
					"deduccion": "160000.00"
				},
				"fondo_seguridad_pensional": {
					"porcentaje": "0.50",
					"deduccion": "20000.00"
				},
				"fondo_subsistencia": {
					"porcentaje": "0.50",
					"deduccion": "20000.00"
				},
				"libranzas": [
					{
						"descripcion": "Compensar credito de libre inversión",
						"deduccion": "387000.00"
					}
				]
			},
			"valor_nomina": {
				"valor_base": "40000000.00",
				"valor_total_devengos": "4100000.00",
				"valor_total_deducciones": "747000.00",
				"valor_total_pago": "3353000.00"
			}
		}
	],
	"generalidades": {
		"tipo_ambiente_dian": 2,
		"identificador_transmision": "2021-02-18",
		"integrador": {
			"nombre": "",
			"tipo": "",
			"webhook": ""
		}
	}
}' \
  -F documento_obligado=830020470								

C#

								var client = new RestClient("https://servicios-pruebas.afacturar.com/api/vp_des/nomina");
var request = new RestRequest(Method.POST);
request.AddHeader("postman-token", "53f655e3-8f92-62ae-ab14-dc3f89d5bf08");
request.AddHeader("cache-control", "no-cache");
request.AddHeader("authorization", "Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6ImY3M2I5YTA0NjQwMThhNDQ5ZDkxYzQ3YmJjMDZhOGEzOTkxZDY0MWRmODlhYWQ5NTczYzQwZWQ3YzJhMjIxZTE2MTYwM2M2ODA2MDBmZjNjIn0.eyJhdWQiOiIxMyIsImp0aSI6ImY3M2I5YTA0NjQwMThhNDQ5ZDkxYzQ3YmJjMDZhOGEzOTkxZDY0MWRmODlhYWQ5NTczYzQwZWQ3YzJhMjIxZTE2MTYwM2M2ODA2MDBmZjNjIiwiaWF0IjoxNTg4MjY5ODY0LCJuYmYiOjE1ODgyNjk4NjQsImV4cCI6MTYxOTgwNTg2NCwic3ViIjoiMTA3NyIsInNjb3BlcyI6W119.dzEvpEWCbZMGIeuTixpUdnvCqE_p_bQEI-3qP-7o6vXV2JzeSrk9Avo-HCjxQD58CUsWdyusa87bEoRthuq2RmdoLRAu7cBKmH_UmJa4iNNZIjZFgGPNzHHNsqf8PUnfGrlC0bvOIpfCoEruP6_AkuHTZ2ToeW8KC1iOg793VrNzJ63co5etpe5cYGkObp9qhGVu00zoGwlzpzyUems9xMj8rJ3g6kOv89p4FlNd9k5-Gn3hceR4oG_PpMnfg0lMMQH55CClXT7Nqj98VrJbE7zLLOOgZbTYYhtXvl9I826OY-5y50UH8b9UQ3npSmXU2y6CPMMrhB32K5XdYjnkLRkO3pYWzkmyRYL6vksOyRSTQX6_2tXDHA0Z0mSlEReo-h2vNv8ptk5unK1BrKIck4YOUwQfv39THhObarIAKvxYleggDs37oyxuGM7kW4lHfkEJGafXINMXHHpqz4Gf3x03oLz3rR4A0iGGK5I-18KzeBt3nAJrwsqmflurlZYPWkmz_IQTuu69FcbrB1X9XQ7Kd6ZPQSrrONAg6MXE_hyjdl_qfzdqp20hBCE1PcNmAsVdk9aMmIglW1lgDaELm71uSX3oIyhW0fGGjKRNAlaxwVYk22i0z4YP_QBjjV4icCTQzOOjVXE0HcKxuqGThjDy315-BM9hETEgfQvUSJE");
request.AddHeader("accept", "application/json");
request.AddHeader("content-type", "multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW");
request.AddParameter("multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW", "------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"data\"\r\n\r\n{\n\t\"nomina\": [\n\t\t{\n\t\t\t\"encabezado\": {\n\t\t\t\t\"fecha_liquidacion_inicio\": \"2021-01-01\",\n\t\t\t\t\"fecha_liquidacion_fin\": \"2021-01-31\",\n\t\t\t\t\"fecha_generacion\": \"2021-02-10\",\n\t\t\t\t\"hora_generacion\": \"10:00:00\",\n\t\t\t\t\"prefijo\": \"\",\n\t\t\t\t\"consecutivo\": \"1\",\n\t\t\t\t\"nota\": [\n\t\t\t\t\t\"Nota 1\",\n\t\t\t\t\t\"Nota 2\",\n\t\t\t\t\t\"Nota 3\"\n\t\t\t\t],\n\t\t\t\t\"periodo_nomina\": 5,\n\t\t\t\t\"tiempo_laborado\": \"5000.00\",\n\t\t\t\t\"pais\": \"CO\",\n\t\t\t\t\"departamento\": \"11\",\n\t\t\t\t\"ciudad\": \"110001\",\n\t\t\t\t\"idioma\": \"es\",\n\t\t\t\t\"moneda\": \"COP\"\n\t\t\t},\n\t\t\t\"informacion_trabajador\": {\n\t\t\t\t\"tipo_identificacion\": 13,\n\t\t\t\t\"identificacion\": \"33700230\",\n\t\t\t\t\"correo_electronico\": \"jperez@teleinte.com\",\n\t\t\t\t\"numero_movil\": \"\",\n\t\t\t\t\"nombre\": {\n\t\t\t\t\t\"primer_nombre\": \"JUan\",\n\t\t\t\t\t\"otros_nombres\": \"Marcos\",\n\t\t\t\t\t\"primer_apellido\": \"Perez\",\n\t\t\t\t\t\"segundo_apellido\": \"Perez\"\n\t\t\t\t},\n\t\t\t\t\"pais\": \"CO\",\n\t\t\t\t\"nombre_pais\": \"Colombia\",\n\t\t\t\t\"departamento\": \"11\",\n\t\t\t\t\"nombre_departamento\": \"Bogota\",\n\t\t\t\t\"ciudad\": \"11001\",\n\t\t\t\t\"nombre_ciudad\": \"Bogota\",\n\t\t\t\t\"direccion\": \"Carrera 10 96-29\"\n\t\t\t},\n\t\t\t\"contrato\": {\n\t\t\t\t\"codigo_trabajador\": \"2020\",\n\t\t\t\t\"tipo_trabajador\": \"01\",\n\t\t\t\t\"subtipo_trabajador\": \"00\",\n\t\t\t\t\"riesgo_pensional\": true,\n\t\t\t\t\"tipo_contrato\": 5,\n\t\t\t\t\"fecha_ingreso\": \"2005-05-03\",\n\t\t\t\t\"salario_integral\": \"N\",\n\t\t\t\t\"sueldo\": \"4000000.00\"\n\t\t\t},\n\t\t\t\"pago\": {\n\t\t\t\t\"fecha\": [\n\t\t\t\t\t\"2021-02-01\"\n\t\t\t\t],\n\t\t\t\t\"forma\": 1,\n\t\t\t\t\"metodo\": 45,\n\t\t\t\t\"cuenta_bancaria\": {\n\t\t\t\t\t\"nombre_banco\": \"\",\n\t\t\t\t\t\"tipo\": \"\",\n\t\t\t\t\t\"numero\": \"\"\n\t\t\t\t}\n\t\t\t},\n\t\t\t\"devengados\": {\n\t\t\t\t\"basico\": {\n\t\t\t\t\t\"dias_trabajados\": 30,\n\t\t\t\t\t\"sueldo\": \"4000000.00\"\n\t\t\t\t},\n\t\t\t\t\"teletrabajo\": [\n\t\t\t\t\t{\n\t\t\t\t\t\t\"pago\": \"100000.00\"\n\t\t\t\t\t}\n\t\t\t\t]\n\t\t\t},\n\t\t\t\"deducciones\": {\n\t\t\t\t\"salud\": {\n\t\t\t\t\t\"porcentaje\": \"4.00\",\n\t\t\t\t\t\"deduccion\": \"160000.00\"\n\t\t\t\t},\n\t\t\t\t\"fondo_pension\": {\n\t\t\t\t\t\"porcentaje\": \"4.00\",\n\t\t\t\t\t\"deduccion\": \"160000.00\"\n\t\t\t\t},\n\t\t\t\t\"fondo_seguridad_pensional\": {\n\t\t\t\t\t\"porcentaje\": \"0.50\",\n\t\t\t\t\t\"deduccion\": \"20000.00\"\n\t\t\t\t},\n\t\t\t\t\"fondo_subsistencia\": {\n\t\t\t\t\t\"porcentaje\": \"0.50\",\n\t\t\t\t\t\"deduccion\": \"20000.00\"\n\t\t\t\t},\n\t\t\t\t\"libranzas\": [\n\t\t\t\t\t{\n\t\t\t\t\t\t\"descripcion\": \"Compensar credito de libre inversión\",\n\t\t\t\t\t\t\"deduccion\": \"387000.00\"\n\t\t\t\t\t}\n\t\t\t\t]\n\t\t\t},\n\t\t\t\"valor_nomina\": {\n\t\t\t\t\"valor_base\": \"40000000.00\",\n\t\t\t\t\"valor_total_devengos\": \"4100000.00\",\n\t\t\t\t\"valor_total_deducciones\": \"747000.00\",\n\t\t\t\t\"valor_total_pago\": \"3353000.00\"\n\t\t\t}\n\t\t}\n\t],\n\t\"generalidades\": {\n\t\t\"tipo_ambiente_dian\": 2,\n\t\t\"identificador_transmision\": \"2021-02-18\",\n\t\t\"integrador\": {\n\t\t\t\"nombre\": \"\",\n\t\t\t\"tipo\": \"\",\n\t\t\t\"webhook\": \"\"\n\t\t}\n\t}\n}\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"documento_obligado\"\r\n\r\n830020470\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW--", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);								

Historico de cambios


Versión Cambios Fecha de liberación
1 Creación del api 2021-04-23