Clarisa ofrece una API que le permite a su sistema integrarse y consultar si el documento electrónico se encuentra registrado en el portal de la DIAN
La acción disponible de la API para consulta de una Factura Electrónica, Nota Crédito, Nota Debito traerá el UUID en base al tipo y número documento comercial consultado
Importante !
Para la consulta masiva de documentos electrónicos , es decir mas de un documento, se debe enviar cada petición con intervalo de 5 segundos como mínimo para evitar el cruce de peticiones.
Consulta Documento Electrónico
CABECERAS:
| CABECERA | VALOR |
| Content-Type | application/json |
| Authorization | token de usuario |
METODO: "GET"
Parametros de URL (QueryParam):
| LLAVE | VALOR | DESCRIPCIÓN |
| nit | 12345 | Corresponde al Nit de la empresa donde se realizó el documento |
| tipoDocumento | 01 | Corresponde al Tipo de documento electrónico que se desea consultar. |
| numeroDocumento | SETP990000001 | Corresponde a el Número del documento electrónico, que se desea consultar. |
https://pru.clarisacloud.com:8443/api/factura/rest/v1/factura/validacion/?nit=12345&numeroDocumento=SETP990000001&tipoDocumento=01
Petición:
| Tipo de Documento | Codigo |
|---|---|
| Factura Electrónica | 01 |
| Nota Crédito | 02 |
| Nota Débito | 03 |
Respuesta:
| Nombre | Tipo dato | Descripción |
|---|---|---|
| data | Alfanumérico | Contiene el uuid, estado del documento y fecha validación |
| lastAction | Alfanumérico | Nombre de la acción bajo la cual se respondió esta respuesta |
| success | Booleano | Determina si la operación fué exitosa o no |
| textResponse | Alfanumérico | Texto de la respuesta |
| titleResponse | Alfanumérico | Título de la respuesta |
Respuesta TOKEN
Tiene una vigencia de 12 horas, por favor
recuerde utilizar el token asignado en el login, para poder acceder a la API de documento electrónico.
Correcto
En caso de que la petición se ejecute sin errores se devolverá la siguiente respuesta:
CÓDIGO HTTP: 200
Incorrecto
Si la solicitud no es correcta, recibirá la siguiente respuesta:
CÓDIGO HTTP: 400