Clarisa ofrece una API que le permite a su sistema integrarse y descargar el XML en base 64 de documentos electrónicos.
La acción disponible de la API para descarga de una Factura Electrónica, Nota Crédito, Nota Debito traerá el DATA en base al NIT, tipo y número documento comercial consultado
Importante !
Para la descarga 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.
Descarga XML en Base 64
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/documento/xml/?nit=12345&tipoDocumento=1&numeroDocumento=SETP990000001
Petición:
| Tipo de Documento | Codigo |
|---|---|
| Factura Electrónica | 1 |
| Nota Crédito | 2 |
| Nota Débito | 3 |
Respuesta:
| Nombre | Tipo dato | Descripción |
|---|---|---|
| data | Alfanumérico | Contiene el archivo en base 64 |
| lastAction | Alfanumérico | Nombre de la acción bajo la cual responde la petición |
| 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