--- title: Requisitos de Cambios description: "### 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…" url: "https://facturasend.com.py/documentacion/requisitos-de-cambios/" updated: "2025-12-16" category: "2-Adapta tu Software" --- # Requisitos de Cambios ### 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. Ciudades 8. Paises 9. Productos 10. 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): **(Falso por defecto). Un check para indicar si la comunicación se hará de forma síncrona 4. Es importante tener una sección en su aplicación para poder cambiar de forma dinámica éstos parámetros, para que las pruebas puedan realizarse de manera más sencilla. ### Cambio en Clientes Deben realizarse las siguientes modificaciones, en el caso de que aún no los posea: 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 SIFEN y que a su vez contenga relación con su distrito y departamento. Ver apartado Ciudad Adaptar el campo **“Tipo de Documento”** o sincronizar/compatibilizar si ya se posee uno. A SIFEN 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](#cambio_en_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**, y es una **persona jurídica**, entonces este valor puede enviarse como **B2B**(Business to Business) - Si el Cliente tiene tipo de documento igual a **RUC**y es una **persona física**, entonces este valor puede enviarse como **B2C**(Business to Consumer) - Si Tipo de Documento es**CI**, entonces se envía como **B2C**(Business to Consumer) - Si el RUC pertenece a 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](https://docs.google.com/spreadsheets/d/1FncgfytNxOCfHioWi0NSabXPQFqA0DID/edit?usp=sharing&ouid=103475293492192380208&rtpof=true&sd=true). ### 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.](https://es.wikipedia.org/wiki/ISO_3166-1%23C%C3%B3digos_ISO_3166-1) ### 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.](https://es.wikipedia.org/wiki/ISO_4217) ### 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.](https://docs.google.com/spreadsheets/d/1JWO9zFRWWrbgxBtC5wVb3X0C9_lo-X6jRpQYoiLw3mc/edit?usp=sharing) ### 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. Este código se llama **"Código de Control"** o **CDC**y está compuesto de**44**dígitos alfanumerícos. 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. También es importante que guarde en su sistema, junto con el CDC, el estado del Documento. Este estado será **0-Generado** cuando usted crea el documento, pero luego puede cambiar a **2-Aprobado** o**4-Rechazado.** A continuación los demás estados disponibles: - -1 = Borrador - 0 = Generado DE - 1 = Enviado en un Lote - 2 = Aprobado - 3 = Aprobado con observacion - 4 = Rechazado - 98 = Inexistente - 99 = Cancelado. ### Iniciando la Integración La integración se realiza mediante llamadas a la API de FacturaSend. Debes tener a mano, la API Key generada desde la consola de FacturaSend 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.