Consideraciones Importantes
Para que el uso de nuestra API sea óptimo debes tener en cuenta lo siguiente:#
- El tamaño máximo del archivo XML resultante debe ser menor a 500KB. Si tu archivo supera este tamaño deberás dividir el mismo en varias facturas.- El endpoint para todos los métodos es https://isv.aliaddo.net/api/v1/public/documents.- Deberás generar una API KEY de autenticación en nuestro Portal ISV y reemplazarlo en el código de ejemplo donde se encuentran los corchetes {{x-api-key}}, debes eliminar estos corchetes ya que son una referencia visual para saber que se trata de contenido dinámico.- Los documentos no pueden tener una fecha anterior al día en el que son emitidos, en caso de ser así, serán rechazados.- Ten en cuenta que los archivos PDF y XML generados en nuestra plataforma son de carácter temporal y se realiza eliminación de los mismos periódicamente.- El consecutivo debe encontrarse dentro del rango de la resolución.- Los campos que tienen un valor vacío "" o el valor cero 0 son campos con valores opcionales.- Los campos con valores numéricos obligatorios y opcionales deben cómo mínimo tener un cero 0 ya que estos campos no pueden estar vacíos.- Verifica tener las librerías o dependencias adecuadas.- Las fechas tienen el formato AAAA-MM-DD- Las fechas también pueden contener horas con el formato AAAA-MM-DDTHH:MM:SS±hhmm- Ten en cuenta que si vas a realizar descuentos o cargos sobre la factura en general no se pueden realizar sobre el detalle o sobre cada producto o servicio facturado.- Los campos que requieren de un código pueden ser consultados aquí.- Si encuentras inconsistencias en esta documentación o códigos de error desconocidos por favor infórmanos aquí.- Es posible que al enviar una factura sea devuelto un error 500 con el mensaje Service Unavailable en el atributo dianStateReason y el código error en el atributo dianDeliveryStatus, esto indica que el servicio de la DIAN está temporalmente no disponible. Deberás reintentar el envío de la factura con en intervalos de 60 segundos, si continúa deberás esperar al menos 30 minutos para el restablecimiento del servicio por parte de la DIAN.Se mostrará de esta manera:
"dianStateReason": ["One or more errors occurred. Service Unavailable"]
"dianDeliveryStatus": "error"O puede que se muestre así:
"dianStateReason": ["One or more errors occurred. Internal Server Error"]
"dianDeliveryStatus": "error"- Sólo en caso de que "dianDeliveryStatus": "new" ó "dianDeliveryStatus": "error" se podrá volver a enviar el documento con el método POST para actualizar.- Nuestro software realiza una serie de validaciones previas al procesamiento que realiza la DIAN, si una de estas validaciones es alcanzada se devolverá un estado 200, sin embargo, el cuerpo del objeto JSON tendrá la explicación de los errores para que puedas hacer las respectivas correcciones.Modificado en 2026-07-08 15:40:26
