Sistema de manejo de errores producidos por el servicio de facturación electrónica de la Dirección de Impuestos y Aduanas Nacionales (DIAN) de Colombia mediante una aplicación de reprocesamiento automático

Abstract

La Dirección de Impuestos y Aduanas Nacionales (DIAN) de Colombia implementó el servicio “FACe - Factura Electrónica” que permite emitir facturas electrónicas, cuyo uso es de forma obligatoria. Sin embargo, frecuentemente dicho servicio devuelve mensajes de error.

El objetivo del presente estudio fue implementar un sistema de reprocesamiento automático que controle los errores producidos por los servicios REST de facturación electrónica de la DIAN durante el proceso de emisión de facturas electrónicas. De esta forma también se redujo la cantidad de peticiones realizadas manualmente tras el fallo inicial de las mismas.

El sistema se desarrolló haciendo uso de los servicios de AWS SQS y AWS Lambda, los cuales se encargan del reprocesamiento de las peticiones fallidas estableciendo un límite máximo de cinco intentos por petición.

Durante un periodo inicial de 4 meses, el sistema logró reducir la cantidad de peticiones fallidas en un 89% gracias al reprocesamiento. Gracias a la implementación de lambda y colas, se logró realizar esta mejora sin causar un impacto significativo en el negocio, debido a la integración entre servicios de AWS y a la optimización en cuanto a consumo que brindan dichos servicios puesto que son inicializados únicamente cuando se encola una petición y se mantienen funcionales hasta que el sistema termina de procesar las peticiones pendientes.

Dentro de las peticiones solucionadas mediante el sistema, cerca del 98% solo requirieron un único intento. De esta manera solo el 11% de peticiones fallidas tuvieron que realizarse manualmente tras su fallo inicial, logrando notablemente el objetivo del estudio.

The Directorate of National Taxes and Customs (DIAN) of Colombia implemented the “FACe - Factura Electronica” service, which allows issuing of electronic invoices and is mandatory. However, this service frequently returns error messages.

The objective of this study is to implement an automatic reprocessing system that controls the errors produced by DIAN's electronic billing REST services during the electronic invoice issuance process. This will also reduce the number of manual requests made after the initial failure.

The system was implemented using lambdas and queues, which are responsible for reprocessing failed requests, establishing a maximum limit of five attempts per request.

During an initial period of 4 months, the system managed to reduce the number of failed requests by 89% thanks to reprocessing. Due to the implementation of lambda and queues, this improvement was achieved without causing a significant impact on the business, thanks to the integration between AWS services and the optimization in terms of consumption provided by these services since they are initialized only when queuing. a request and remain functional until the system finishes processing any pending requests. Of the requests resolved through the system, around 98% only required a single attempt. In this way, only 11% of failed requests had to be made manually after their initial failure, significantly achieving the implementation objective.