Consideraciones importantes

Algunas cosas que debes tener en cuenta para usar nuestra API

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.

• El historial de archivos cargados a la API se retendrá por 90 días, luego se irán eliminando a medida que cumplan este lapso de tiempo.

• Hay tres modos de envío de documentos, Habilitación se refiere a los documentos que requiere la DIAN por primera vez para habilitar a la empresa. Pruebas se refiere a los documentos que pueden ser enviados de manera segura para verificar que los datos se encuentren bien, no se envían a la DIAN. Producción se refiere a todos los documentos reales que serán enviados a la DIAN para su procesamiento.

• Necesitas una API KEY de autenticación para interactuar con nuestra api, este dato lo deberás indicar en el campo {{x-api-key}}

• Las nóminas deben ser enviadas dentro de los primeros 5 días del mes posterior

• 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.

• Las fechas tienen el formato AAAA-MM-DD

• Las fechas con horas y minutos tienen el formato AAAA-MM-DDTHH:MM:SS

• 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 Unavaliable 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 re intentar el envío de la nómina con el método que usaste primeramente en intervalos de 20 segundos. Se mostrará de esta manera: "dianStateReason": ["One or more errors ocurred. Service Unavaliable"] "dianDeliveryStatus": "error" O puede que se muestre así "dianStateReason": ["One or more errors ocurred. Internal Server Error"] "dianDeliveryStatus": "error"

• Sólo en caso de que "dianDeliveryStatus": "new" ó "dianDeliveryStatus": "error" se podrá volver a enviar la nómina con el método POST para crear.

• Nuestro software realiza una serie de validaciones previas al procesamiento que realiza la DIAN, si una de estas validaciones es alcanzada se devolverá un error 500 con un cuerpo donde se explican los errores para que se hagan las respectivas correcciones.