Consideraciones Importantes

Algunas cosas que debes tener en cuenta para usar nuestra API

AnteriorCuotas y límites SiguienteManual Operativo de la Plataforma

Última actualización hace 11 días

¿Te fue útil?

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. 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 y reemplazarlo en el código de ejemplo donde se encuentra {{x-api-key}}
Las consultas GET son independientes del modo en que estés usando la API (Habilitación, pruebas o producción).
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
Tenga en cuenta que si va 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 .
Si encuentras inconsistencias en esta documentación o códigos de error desconocidos por favor infórmanos .
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 factura 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 el documento 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.

AnteriorCuotas y límites SiguienteManual Operativo de la Plataforma

Última actualización hace 11 días

¿Te fue útil?

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 y reemplazarlo en el código de ejemplo donde se encuentra {{x-api-key}}
Las consultas GET son independientes del modo en que estés usando la API (Habilitación, pruebas o producción).
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
Tenga en cuenta que si va 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 .
Si encuentras inconsistencias en esta documentación o códigos de error desconocidos por favor infórmanos .
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 factura 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 el documento 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.