Clarisa ofrece una API que le permite a su sistema integrarse y descargar el PDF en base 64 de documentos electrónicos.
La acción disponible de la API para descarga de un Documento equivalente maquina registradora con sistema POS, Nota de ajuste crédito POS, Nota de ajuste debito POS traerá el DATA en base al NIT, tipo y número de 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 PDF 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 | 1 | Corresponde al Tipo de documento electrónico que se desea consultar. |
| numeroDocumento | EPOS1 | Corresponde a el Número del documento electrónico, que se desea consultar. |
https://pru.clarisacloud.com:8443/api/equivalente/rest/v1/de/pos/pdf/?nit=12345&tipoDocumento=1&numeroDocumento=EPOS1
Petición:
| Tipo de Documento | Codigo |
|---|---|
| Documento Equivalente POS | 1 |
| Nota Ajuste Crédito POS | 2 |
| Nota Ajuste Débito POS | 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