Abre una cuenta gratuita

Lo primero que debes hacer es crear una Cuenta gratuita en la Consola de FacturaSend. Es decir crear un usuario y clave con el cual podrás integrar y emitir facturas desde una o más empresas

Para empezar, te sugerimos que empieces con una Empresa de Prueba, para lo cual te recomendamos tener a mano los datos contables de la misma. La mayoría de los datos se obtienen del Marangatú

Pasos para abrir una Cuenta

• Ingresar a nuestra consola
• En la parte inferior de la pantalla de Autenticación, presiona clic en el enlace de Regístrate
• Debes especificar los datos solicitados Nombre, Apellidos, Email, Nombre de usuario y la Contraseña
• Presiona clic en el boton Regístrate

Una vez que FacturaSend haya registrado tus datos, hará una redirección a la página de Empresas, desde la cual podrás crear una o más Empresas. Aqui también se listan las empresas ya creadas en formato de tarjetas (cards)

Crear una Empresa

Pasos para crear una Empresa

• En la página de Empresas, Presiona clic en el botón + (mas) o en el enlace Agregar una nueva Empresa
• En la página de Empresas digita la Razón Social o el Nombre de Fantasía de la Empresa de la cual deseas emitir las Facturas Electrónicas
• Chequea la opción del ReCaptcha de Google, si aparece en pantalla
• Presiona clic en el boton Crear
• Aguarda hasta que el proceso termine y te redirija a la página principal

El proceso de crear una nueva empresa puede demorar, aquí se aprovisionan espacios y otros recursos que FacturaSend utilizará más adelante. Cada Empresa se administra en un ambiente aislado y protegido. La seguridad es un punto importante para FacturaSend

Configurar Datos de la Empresa (Emisor)

Una vez que ya se encuentre en la página principal de FacturaSend y antes de intentar utilizar la API, debe configurar los datos fiscales del Emisor del Documento Electrónico, que en éste caso viene a ser la Empresa que ababó de crear.

Pasos para configurar datos del emisor:

• En el menú lateral izquierdo de la página principal, seleccione la opción Contribuyente Emisor del grupo Configuración. Se abrirá una página nueva con las pestañas de Datos Fiscales, Logo & Imagen, Certificado, Ambiente y API Token
• Seleccione la pestaña Datos fiscales
• Empiece rellenando los campos de RUC, Razón Social y Nombre de Fantasía
• Seguidamente especifique las Actividades económicas. Ambos, el código y la descripción deben ser especificados. Encontrará ésta opción en la opción Mi Perfil/Actividades económicas del marangatú.
• Puede especificar más actividades presionando clic sobre el boton Agregar actividad
• Luego indique el Tipo de Contribuyente (Persona física o juridica) y el Tipo de Régimen El tipo de Régimen debe ser seleccionado de acuerdo a los datos en el Marangatú
• El siguiente bloque corresponde a los campos Número de Timbrado y Fecha de Timbrado. Como la prueba será en un ambiente no conectado a la SET, en Numero de Timbrado indique un número aleatorio de 8 dígitos, ej.: 12345678 y en Fecha de Timbrado la fecha actual
• Lo siguiente son los datos de los establecimientos. Para cada establecimiento deberá especificar Número por ejemplo 001, 002, etc., la Denominación que es una descripción breve, la Dirección, el Número de Casa que puede ser '0', el Complemento 1 y Complemento 2. Debe seleccionar los campos Departamento, Distrito y Ciudad. Para concluir especifique un Número de Teléfono y Email
• Para concluir indique cómo desea emitir los comprobantes para ésta sucursal, en formato de Hoja A4 o en formato de Ticket
• Si desea agregar más establecimientos presione clic sobre el boton Agregar establecimiento
• Para guardar los datos fiscales presione clic en el botón Guardar Información Fiscal

Es importante especificar un email válido en el establecimiento especificado, ya que una copia de la Factura será enviada a éste correo en el momento de su emisión

Configurar un Logo de la Empresa

El logotipo seleccionado en éste paso servirá para personalizar el Documento Electrónico.

Pasos para agregar/cambiar el logo

• Seleccione la pestaña Logo & Imagen en la misma página donde configuró los datos de la empresa anteriormente
• Presione clic sobre el botón Seleccione un Logo para la Factura
• Una vez seleccionado la imagen desde el Equipo, se mostrará la imagen debajo del botón
• Para confirmar el logo seleccionado debe presionar clic en el botón Guardar Personalización

Especificar el Ambiente de Ejecución

Si está iniciando la integración con su software, puede saltarse éste paso.

El ambiente de ejecución es la forma como FacturaSend procesará y enviará los datos a la SET. Por lo general cuando inicia la integración no necesitará modificar éstos valores, pues seguramente querá trabajar en un ambiente de pruebas a nivel local, integrando su software hasta que ya no existan errores.

Los posibles valores para el ambiente son los siguientes:

1. Ambiente No Conectado a la SET: Debe dejar en ésta opción cuando va realizar pruebas locales, sin enviar los comprobantes a la SET. Esto generalmente será cuando inicia la integración. Para ésta opción no es obligatorio cargar un certificado digital de la Empresa.
2. Ambiente Conectado a la SET: En esta opción, ya se envían los Documentos Electrónicos a la SET, pero en ambiente de TEST. Para ésto es necesario contar con los datos del servidor de Test de la SET y un Certificado Digital válido de la Empresa.
3. Ambiente Producción de la SET: Esta opción debe ser seleccionada una vez que se hayan culminado con todas las pruebas obligatorias, y ya tenga un ambiente de Producción aprobado por la SET, pues los documentos generados en éste ambiente tienen validez fiscal y juridica

También deberá especificar en ésta misma pestaña los datos de la versión del manual técnico, que por defecto ya viene configurado, así también el Id del Código de seguridad y el Código de seguridad del Cliente

Los 2 últimos campos mencionados son proveidos por la SET cuando se habilita el ambiente de Test y Producción y son diferentes para cada ambiente.

Pasos terminar

• Presione clic en el botón Guardar Ambiente

Carga del Certificado Digital

Si está iniciando la integración con su software, puede saltarse éste paso.

El certificado digital es el documento que lo valida a usted como representante legal de la Empresa que emitirá la Factura.

Cada documento electrónico es firmado electrónicamente, utilizando el Certificado Digital de la Empresa.

Todo certificado está protegido por contraseña, por lo cual deberá proveer ésta información a FacturaSend, para que la API pueda abrir el Certificado y realizar la firma.

Pasos para cargar el Certificado

1. Presione clic sobre el botón Cargue el Certificado Digital.
2. Especifique la Contraseña del Certificado.
3. Presione clic sobre el botón Guardar Datos del Certificado

Generar una API Key

Una Api key (clave de Api) es un código generado desde la consola que necesitará para poder realizar invocaciones desde su software a travéz de llamadas API REST.

Es recomendable cambiar la Api Key si sospecha que la misma ha sido filtrada para otros usuarios, que podrían ejecutar operaciones y emitir facturas para la empresa.

Si modifica una API Key que ya estaba siendo utilizada por otro software, nececitará informar al software de la nueva API Key para poder mantener la comunicación entre los sistemas.

Pasos para generar una API Key

1. Presione clic sobre el botón Cargue el Certificado Digital.
2. Especifique la Contraseña del Certificado.
3. Presione clic sobre el botón Guardar Datos del Certificado

Requisitos de Cambios

Los cambios en tu Sistema ERP o POS son mínimos y no son propios de FacturaSend, sino más bien requisitos del propio SIFEN.

Es decir, si va implementar la Facturación Electrónica usted mismo, igual tendrá que realizar éstos cambios.

Se requieren realizar algunos cambios en:

1. Las opciones de parametrización.
2. Clientes
3. Usuarios
4. Ciudades
5. Paises
6. Monedas
7. Productos
8. Ciudades
9. Paises
10. Productos
11. Unidades de Medida

Parametrización

En la zona de parámetros u opciones del Sistema, agregar los siguientes campos:

1. URL de la API de FacturaSend (String): Ej. “https://api.facturasend.com.py/tenantId” o “http://172.10.254.15/api/tenantId”
2. API Key (String): Ej. “9FFC28EB-5376 - 4392 - B757 - 86E372FBB398”
3. Check de Comunicación Sincrona (boolean): Un check para indicar si la comunicacion se hará de forma sincrona

Cambio en Clientes

Deben realizarse las siguientes modificaciones:

Agregar campo “Nombre de Fantasía”. Un campo tipo texto abierto. Este campo es opcional para SIFEN, por el momento se puede enviar vacío.

Agregar campo “Es Proveedor del Estado”, con valores verdadero o falso

Agregar campo “Ciudad”. Un “Combobox” que esté relacionado con el código de la ciudad de la SET y que a su vez contenga relación con su distrito y departamento. Ver apartado Ciudad

Adaptar el campo “Tipo de Documento” o sincronizar si ya se posee. A la SET debe enviarse uno de éstos posibles:

1. Cédula paraguaya
2. Pasaporte
3. Cédula extranjera
4. Carnet de residencia
5. Innominado
6. Tarjeta Diplomática de exoneración fiscal
9. Otro

Agregar un campo “Numero de Casa”, Campo Numérico, se puede colocar por defecto a todos el valor “0”

Agregar un campo “Nacionalidad” o “País” que almacene la relación con la tabla de países. Ver apartado Paises

Agregar “Tipo de Operación”, Un “Combobox” con los siguientes valores y descripción

1. B2B
2. B2C
3. B2G
4. B2F

La creación de éste campo puede saltarse si se desea, ya que su valor puede ser calculados en el momento de su envío, por ejemplo:

• Si el Cliente tiene tipo de documento igual a RUC, entonces este valor puede enviarse como B2B (Business to Business)
• Si Tipo de Documento es CI, entonces se envía como B2C (Business to Consumer)
• Si es un proveedor del estado se envía B2G (Business to Goverment) y;
• Si su tipo de documento Extranjero, entonces B2F (Business to Foreign)

Cambio en Usuarios

Agregar campo “Cargo”. Un campo tipo texto abierto.

Cambio en Ciudades

La tabla Ciudades debe tener una estructura anidada con más dos tablas, distritos y departamentos

Debe estar organizado de la siguiente manera:

• Tabla 1 - Departamentos
• Tabla 1.1 - Distritos, referenciando a departamentos
• Tabla 1.1.1 - Ciudades, referenciando a distritos

De forma que el Departamento es el que engloba al Distrito, y el Distrito a la Ciudad

Los datos se pueden importar desde esta Fuente.

Cambio en Paises

Los países del sistema deben estar conforme el estándar ISO 3166. Si aún no se posee la tabla países dentro del Sistema se debe crear uno conforme éste estándar, cargando con los valores iniciales que serán enviados a FacturaSend.

Caso el sistema ya cuente con una tabla países en una estructura y codificación propia, entonces se deberá sincronizar los códigos internacionales con los países que se poseen, pues para el SIFEN se exigen los códigos internacionales de tres dígitos, ej. PRI, BRA, ARS, etc.

Para el envío a FacturaSend, es sólo necesario enviar el código del país.

Tabla de Referencia.

Cambio en Monedas

Las monedas del Sistema deben estar codificadas conforme el estándar 4217. Se aplica la misma regla de países para sincronizar los datos del Sistema con éste estándar.

Para el envío a FacturaSend, es sólo necesario enviar el código de la moneda.

Tabla de referencia.

Cambio en Productos

Cambio en Unidades de Medida

Los códigos de las unidades de medida del Sistema deben unificarse con el de la SET.

Tabla de referencia

Tabla de Referencia.

Sobre el Número de Documento

Las generación y secuencia de las numeraciones de cada Tipo de Documento Electrónico debe ser gestionada dentro del ERP, aunque las duplicación de éstos se valida en FacturaSend, antes de enviar a la SET.

Para ello debe llevar un control del punto, sucursal y número de documento, ej.: 001-001-0000001

Datos a persistir

La emisión de un documento electrónico genera un ID único e irrepetible entre los emisores que es reconocido por el SIFEN. Es muy recomendable que guarde éste número para futuras referencias, reimpresiones de documentos y ejecución de eventos, por ejemplo el de Cancelación.

Este código consta de 44 dígitos alfanuméricos y es denominado CDC

Iniciando la Integración

La integración se realiza mediante llamadas a la API de FacturaSend.

Debes tener a mano, la API KEY generada anteriormente y también la URL de la API, la cual se muestra en la misma pestaña

Para detalles específicos cómo estructurar el JSON visite la Referencia de la API de FacturaSend.

Descarga el Postman

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 validar la API Key y verificar si la API responde correctamente. Luego podrás invocar desde tu propio sistema generando el JSON

Click aqui para descargar el Postman.

Realizando un Test del Servicio

Para realizar un test del Servicio, realiza las siguientes acciones:

Pasos:

1. Abre el Postman.
2. Crea una nueva Collection y llamala FacturaSend.
3. Sobre la Collection recientemente creada, has clic derecho y selecciona la opción Add Request.
4. En el nombre, donde dice New Request cambialo por Test Servicio.
5. Donde visualiza la palabra GET, ese es el campo Method o Verbo, déjelo así como está para ésta petición.
6. En la Barra de direcciones especifica la dirección de test de la API, la cual es https://api.facturasend.com.py/<tentantId>/test
7. Teniendo en cuenta el paso anterior, cambia el valor de <tentant> por el TenantId de la Empresa que has creado en el paso inicial. El campo TenantId está visible en la parte superior del menú lateral izquierdo de la página principal de FacturaSend, arriba de la Versión.
8. Seleccione la Pestaña Headers que se encuentra debajo de la barra de direcciones.
9. En la Pestaña Headers agregue un nuevo campo KEY, VALUE. En el campo KEY escriba Authorization y en el VALUE escriba el valor fijo de "Bearer api_key_" seguido de su API Key el cual puede obtenerlo desde la Consola de FacturaSend
10. Presione clic sobre el botón Send.

Verifique las instrucciones de los Pasos, con la siguiente imagen:

Si todo sale bien deberá visualizar como resultado el texto "FacturaSend Funciona."

Creando un documento electrónico

Los siguientes pasos le muestra como invocar a la API de FacturaSend para crear un documento electrónico con datos estáticos especificados en un JSON

Pasos:

1. En la misma aplicación del Postman y sobre la misma Collection de FacturaSend ya creada anteriomente.
2. Presiona clic derecho y selecciona la opción Add Request.
3. En el nombre, donde dice New Request cambialo por CreateDE.
4. En el campo Method donde está seleccionado GET, cambialo por POST.
5. En la Barra de direcciones especifica la dirección de test de la API, la cual es https://api.facturasend.com.py/<tentantId>/create/de.
6. Teniendo en cuenta el paso anterior, cambia el valor de <tentant> por el TenantId de la Empresa que has creado en el paso inicial. El campo TenantId está visible en la parte superior del menú lateral izquierdo de la página principal de FacturaSend, arriba de la Versión.
7. Seleccione la Pestaña Headers que se encuentra debajo de la barra de direcciones.
8. En la Pestaña Headers agregue un nuevo campo KEY, VALUE. En el campo KEY escriba Authorization y en el VALUE escriba el valor fijo de "Bearer api_key_" seguido de su API Key el cual puede obtenerlo desde la Consola de FacturaSend
9. En la Pestaña Body selecciona la sub-pestaña Raw
10. Dentro del Cuadro de Texto que se abre copie y pegue el JSON disponible AQUI
11. En la misma línea de las sub-pestaña donde se encontraba la opción Raw y más hacia la parte derecha, cambie el tipo de envío actual de Text a JSON
12. 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

Ingreso a la Voluntariedad

Pasos:

1. .

Ingreso a Produccion

Pasos:

1. .