Sign in Sign out ☰La API de PLColab está diseñada para facilitar la integración de sistemas de facturación electrónica con las normativas establecidas por la Dirección de Impuestos y Aduanas Nacionales de Colombia (DIAN). Con el objetivo de garantizar la estabilidad, disponibilidad y correcto funcionamiento de nuestras APIs, hemos implementado una política de control y bloqueo automático para clientes que presenten tasas elevadas de fallos en sus solicitudes, con el fin de prevenir abusos como picos de tráfico, scraping o intentos de DDoS leves.
La DIAN es la entidad encargada de recaudar impuestos y aduanas en Colombia, y la facturación electrónica es obligatoria para todas las empresas que operan en el país. Esta API permite a los desarrolladores integrar sus sistemas con los requerimientos técnicos de la DIAN para garantizar el cumplimiento normativo.
Para mantener la calidad del servicio y prevenir abusos, se han establecido los siguientes niveles de control:
1. Notificación y Tasa de Fallos Moderada (21% - 40%)
Si la tasa de errores supera el 20% e iguala o no excede el 40%, durante 3 días consecutivos, se notificará automáticamente al cliente afectado.
Si dicha condición se mantiene durante esos 3 días, se procederá a un bloqueo automático de 7 días calendario.
Esta medida busca incentivar la corrección proactiva de integraciones defectuosas.
2. Tasa de Fallos Alta (41% - 70%)
Si la tasa de errores excede el 40% y es inferior o igual al 70%, se aplicará un bloqueo automático inmediato de 7 días calendario sin periodo de gracia.
El cliente será notificado al momento del bloqueo con detalles del comportamiento detectado.
3. Tasa de Fallos Crítica (mayor al 70%)
Si la tasa de errores supera el 70%, se procederá a un bloqueo automático inmediato sin fecha de desbloqueo automática.
El cliente deberá contactar al equipo de atención al cliente o soporte técnico para realizar un diagnóstico conjunto y definir una posible reactivación del acceso.
4. Notificación en Todos los Casos
En cada uno de los escenarios anteriores, se enviará una notificación automática vía correo electrónico u otro medio definido con los siguientes datos:
Fecha y hora de detección
Tasa de error detectada
Periodo evaluado
Acción tomada (advertencia o bloqueo)
Pasos sugeridos para solución
Al momento de implementar tu integración, específicamente para el caso de emisión, te recomendamos enviar hasta 100 solicitudes por minuto a la API. Esto significa que si tu aplicación supera ese límite, algunas peticiones podrían ser rechazadas, recibiendo una respuesta de error con Status Code 429 Too Many Requests.
Te recomendamos diseñar tu integración considerando este tope para asegurar un funcionamiento estable y sin interrupciones.
Powered by Azure API Management © Microsoft 2025