Copyright Teleinte SAS 2021
Para mayor información en operaciones@teleinte.com

EndPoint


Método: POST

EndPoint:

Pruebas
https://servicios-pruebas.afacturar.com/api/radian/lector_cufe

Producción
https://servicios.afacturar.com/api/radian/lector_cufe

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

Descripción

Número de identificación del OFE - Obligado a facturar electronicamente.

Tipo de dato

Númerico.

Especificaciones

Debe estar registrado en servicios.afacturar.com

Obligatorio

Si

lista_cufe

Descripción

Identificador de la factura - CUFE

Tipo de dato

Parametrizado

Especificaciones

CUFEs seprados por coma. La cantidad máxima de CUFEs para consultar son de 1 a 20, estos aproximadamente demoran en ser procesados 60 segundos.

Obligatorio

Si



Estructura JSON de respuesta


Salida Exitosa



{
	"codigo_error": 0,
	"descripcion_error": "OK",
	"tiempo_ejecucion": 0.7741971015930176,
	"resultado": [
		{
			"cufe": "20a212814c88c688e773bc6d3b0abf8bab5630da09593da1a93efe40ea47ed69142df95f2e8f3a916c07683db98e6d62",
			"codigo_error": "13",
			"descripcion_error": "La factura No.E5582261174 ya se encuentra procesada"
		},
		{
			"cufe": "a4b78fb499043758ad14a8ee96e74a47543236398577fd79f9b5a21dcaf1d4efeda7bb0c2f94868388c363bbf6334f9d",
			"codigo_error": "23",
			"descripcion_error": "El CUFE no esta asociado al NIT del receptor"
		},
		{
			"cufe": "d96c80873db5939819bff2f9f82963a0640cd6f4bfc3123ec5e4a7f1efd6e8d3eb6787968e98eac1a0805550a5b69b27",
			"codigo_error": "23",
			"descripcion_error": "El CUFE no esta asociado al NIT del receptor"
		}
	]
}							  
							 
Salida con errores de datos

{
    "codigo_error": 30,
    "descripcion_error": "Maximo de CUFEs permitidos para procesar 20"
}							
							

Codigo de respuesta


Codigo Descripción
5 El token no esta asociado al documento del obligado XXXXXXX, o no se encuentra en servicios
10 Errores de parametros de entrada
11 Maximo de CUFEs permitidos para procesar 50
13 La factura No.XXX ya se encuentra procesada
15 El Nit ZZZZZZZZZZ no esta registrado en Afacturar.com o se encuentra inactivo
23 El CUFE no esta asociado al NIT del receptor
21 El archivo no es un Invoice
25 Retornado por la DIAN

Consumo del API


CURL

								curl -X POST \
  https://servicios.afacturar.com/api/radian/lector_cufe \
  -H 'accept: application/json' \
  -H 'authorization: Bearer token_cliente' \
  -H 'cache-control: no-cache' \
  -H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
  -H 'postman-token: bfe14f11-95ec-c258-3c8e-516314ace9e1' \
  -F 'lista_cufe=20a212814c88c688e773bc6d3b0abf8bab5630da09593da1a93efe40ea47ed69142df95f2e8f3a916c07683db98e6d62
,a4b78fb499043758ad14a8ee96e74a47543236398577fd79f9b5a21dcaf1d4efeda7bb0c2f94868388c363bbf6334f9d
,d96c80873db5939819bff2f9f82963a0640cd6f4bfc3123ec5e4a7f1efd6e8d3eb6787968e98eac1a0805550a5b69b27
,e53800d33831740979bf6714f97c55db2463df05dc61a100f43bff16608ef6d040a57a7a83393ac39d1e9be6b2f9e339
,76a2f562c0745b53fb346309cd3296eda1c11a08fc1cce1537ffadabcca18e9dc5b6456d0ea2b1c6021447f4b3a8f3d8
,4c52590c145293ec831c3f449b57c13ed90d8a4325f614a53e72ddc85ca5049a3ca4d1fcf007b13314f402078f722cad
' \
  -F documento_obligado=830020470
								

C#

								C#
var client = new RestClient("https://servicios.afacturar.com/api/radian/lector_cufe");
var request = new RestRequest(Method.POST);
request.AddHeader("postman-token", "ac0f7501-d0af-35d9-1130-3b4fbc8d22e5");
request.AddHeader("cache-control", "no-cache");
request.AddHeader("authorization", "Bearer token_cliente");
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=\"lista_cufe\"\r\n\r\n20a212814c88c688e773bc6d3b0abf8bab5630da09593da1a93efe40ea47ed69142df95f2e8f3a916c07683db98e6d62\n,a4b78fb499043758ad14a8ee96e74a47543236398577fd79f9b5a21dcaf1d4efeda7bb0c2f94868388c363bbf6334f9d\n,d96c80873db5939819bff2f9f82963a0640cd6f4bfc3123ec5e4a7f1efd6e8d3eb6787968e98eac1a0805550a5b69b27\n,e53800d33831740979bf6714f97c55db2463df05dc61a100f43bff16608ef6d040a57a7a83393ac39d1e9be6b2f9e339\n,76a2f562c0745b53fb346309cd3296eda1c11a08fc1cce1537ffadabcca18e9dc5b6456d0ea2b1c6021447f4b3a8f3d8\n,4c52590c145293ec831c3f449b57c13ed90d8a4325f614a53e72ddc85ca5049a3ca4d1fcf007b13314f402078f722cad\n,e53800d33831740979bf6714f97c55db2463df05dc61a100f43bff16608ef6d040a57a7a83393ac39d1e9be6b2f9e339\n,297e3966bf105b4affe304675df69ee85b7247dfe58453ec3a6b5d45202122bc6afbf3966ed44d72cadbe120e07b3d5e\n,297e3966bf105b4affe304675df69ee85b7247dfe58453ec3a6b5d45202122bc6afbf3966ed44d72cadbe120e07b3d5e\n,40ebfde3f7c601ca48beb9ca2a569eb0db0c0c219012c5c1d133fa98de57d6cce8ce4b443e600cddc65d0a869a69eb74\n,e53800d33831740979bf6714f97c55db2463df05dc61a100f43bff16608ef6d040a57a7a83393ac39d1e9be6b2f9e339\n,e53800d33831740979bf6714f97c55db2463df05dc61a100f43bff16608ef6d040a57a7a83393ac39d1e9be6b2f9e339\n,658e2a1cbb38e08788cc9ce67375a17a1ada59a65c104f5470292bdc3ce0b2a79a15bfab209bfb89267b8b393f65b4c2\n,bab32e421154666ce9ee5335c0a38bc399a374bb3fb04a610e7811c344a80791081db6b073e361cd0532e84acf1eded4\n,bab32e421154666ce9ee5335c0a38bc399a374bb3fb04a610e7811c344a80791081db6b073e361cd0532e84acf1eded4\n,de6b6894717d4cbf5b4aaa6445a0efec04ee844bfd3a014fea580cf0e4ba8f0f65ceebbf57181819674efd57383b6b71\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 Implementación del evento en FEV 12 de Diciembre de 2022