Puedes probar la API de FacturaSend haciendo llamadas a través de un software como POSTMAN y enviando un JSON estático en el cuerpo de la petición.
Esto te ayudará a comprender el funcionamiento básico de datos JSON, validar la API Key y verificar cómo los datos se guardan en la plataforma. Al comprender el funcionamiento de la invocación, luego podrás invocar al servicio desde tu propio sistema generando el JSON de forma dinámica.
Descarga del POSTMAN #
Puedes descargar el POSTMAN desde la siguiente ubicación:
Clic aquí para descargar el POSTMAN.
ATENCIÓN: No actualice la versión del POSTMAN, utilice la versión que descargó, la cual es la última versión comunitaria gratuita disponible y con todas las funcionalidades activadas.
Descarga la colección de POSTMAN #
Hemos preparado una colección de servicios con las invocaciones de la API de FacturaSend para usarlas con POSTMAN, sólo debe descargarlas y luego importarlas al POSTMAN.
Clic aquí para descargar la Colección de servicios de FacturaSend en POSTMAN
La colección está en el formato JSON de POSTMAN
Importar la colección de POSTMAN #
Siga los siguientes pasos para importar la colección al POSTMAN
Una vez hecha la descarga de la colección en el paso anterior, se debe dirigir a su POSTMAN:
Dirigirse a Import en la parte Superior Izquierda
Ingresando al Import deberá cargar el archivo, seleccionando “files”
Seleccione el archivo JSON descargado
Una vez importada la colección, le aparece en su POSTMAN de la siguiente manera, dónde podrá visualizar todas los JSON
Variables en la colección de POSTMAN #
En este apartado se mostrará las variables de la colección de POSTMAN, de dónde sacar esos datos y cómo cargarlos.
Primeramente identificaremos las variables
Nos dirigiremos a la colección del POSTMAN y luego a Edit
Una vez dentro se podrá visualizar el siguiente apartado dónde se encuentran las variables
Una vez identificada cada variable, procederemos identificar de dónde sacar los datos para cada variable
Para este caso utilizaremos el endpoint Creación un Documento Electrónico
Dentro del endpoint identificaremos cada una de esas variables, que son las siguientes
1- URL
2- TENENAT_ID
3- API_KEY
Veremos de dónde sacar los datos para cargar en esas variables
Nos debemos dirigir a FacturaSend
Una vez dentro del FacturaSend, primeramente identificaremos el dato de la variable URL:
1- URL
Para ello nos dirigimos a la parte inferior del menú del lateral izquierdo, en la parte inferior se encuentra el apartado Contribuyente Emisor
Una vez dentro nos dirigimos a API Key
Una vez allí, en la parte inferior de la página se encuentra la URL, debemos copiar dicha dirección de Url fija de la API
Ejemplo:
https://api.facturasend.com.py/tipstest
La información que necesitamos para la URL, es solamente la primera parte de dicha URL
Ejemplo:
URL: https://api.facturasend.com.py
2- TENENAT_ID
Siguiendo con la identificación de las variables, seguimos con la segunda variable:
El TENENAT_ID se puede identificar de la siguiente manera
En el mismo apartado de dónde identificamos el dato para la URL, se encuentra el dato para la variable del TENENAT_ID
Sería la segunda parte de la URL que copiamos anteriormente de Url fija de la API
Ejemplo:
https://api.facturasend.com.py/tipstest
Dónde el TENENAT_ID es:
tipstest
3- API_KEY
Seguimos con la identificación del dato para la variable API_KEY
Siempre hablando del mismo apartado API key
Debemos Generar la API_KEY, para ello debemos darle click en Generar API Key y posteriormente darle click a Guardar API Key
Al generar la API_KEY, debemos copiarla para luego colocarla en la variable
De esa forma contamos con los tres datos necesarios para cargarlo en las variables dentro del POSTMAN
Procederemos a cargarlos
Nos dirigimos nuevamente a la colección, luego a Edit
Una vez dentro de la colección nos dirigimos a “Variables”, ahí encontraremos las variables
Procedemos a cargarlas con los datos que recolectamos anteriormente y guardar dándole click a Save
De esta forma las variables ya estarían cargas y se puede proceder
Creando un Documento Electrónico #
Los siguientes pasos le muestran como invocar a la API de FacturaSend para crear un documento electrónico con datos estáticos especificados en un JSON
Pasos:
- En la misma aplicación del Postman y sobre la misma Collection de FacturaSend ya importada anteriormente.
- Identificar que operación necesita realizar, cómo ejemplo podemos utilizar el endpoint para Creación un Documento Electrónico.
- Dentro del endpoint que es un método POST podemos visualizar el JSON en el apartado Body.
- Dicho JSON podrá ser modificado en base a sus necesidades
- Presione clic sobre el botón Send.
- Verifique las instrucciones de los Pasos, con la siguiente imagen:
Si todo sale bien deberá deberá obtener una lista deList, con la información sobre la aprobación o rechazo del documento.
Para comprender cada detalle de los parámetros que se le puede enviar a la API así como los posibles valores de retorno, consulte aqui la Referencia de la API
