--- title: "Facturadores" description: "Facturadores" type: "docs" category: "doc" tags: [] authors: [Anonymous] date: "2023-08-01" last_update: "2026-10-08" time_minutes: 1 draft: false unlisted: false url: "https://www.billmysales.com/docs/billers" --- # Facturadores Los facturadores son las aplicaciones del usuario hacia dónde BillMySales envía las órdenes o pedidos que se requieren facturar, en base a diferentes reglas. --- ## LibreDTE LibreDTE # LibreDTE Documentación asociada al facturador [LibreDTE](https://www.billmysales.com/apps/billers/libredte) como facturador. --- ### Configuración inicial Configuración LibreDTE # Configuración LibreDTE En esta sección se explicarán los pasos para configurar la pasarela de facturación de BillMySales utilizando **LibreDTE como facturador**. ## Requisitos 1. Tener cuenta con el Servicio Plus activo en LibreDTE. 2. Tener cuenta en BillMySales con cualquier plan, incluyendo el gratuito. 3. [Crear una pasarela de facturación](https://www.billmysales.com/academy/capacitacion-inicial/pasarelas-de-facturacion/crear-pasarela-de-facturacion) en BillMySales utilizando LibreDTE como facturador y el origen de datos de su elección. > [!NOTE] Nota > > La configuración que se explicará es una configuración por defecto que solo garantiza la conexión entre ambos sistemas. Sin embargo, debe validar la configuración y, si necesita algo específico, configúrelo según sus requerimientos. ## Configuración básica de LibreDTE Para comenzar, debes ingresar a la configuración de la [pasarela de facturación](https://app.billmysales.com/billing_gateways) creada en BillMySales y dirigirte a la tercera pestaña llamada **Facturador** y realizar lo siguiente: ![Pestaña facturador con LibreDTE](https://www.billmysales.com/img/content/docs/billers/libredte/pestana_facturador_con_libredte.png) **1. Datos de conexión** Para poder realizar la conexión entre BillMySales y LibreDTE, debes completar la siguiente información: - **URL**: es la dirección del servidor de libredte viene por defecto como ***https://libredte.cl***. - **Hash**: corresponde al hash del usuario principal de LibreDTE. El Hash del usuario lo obtienes siguiendo los siguientes pasos: 1. Ingresa a [LibreDTE](https://libredte.cl/usuarios/ingresar) con tu cuenta de usuario (debe ser el usuario principal). 2. Una vez dentro, dirígete a la esquina superior derecha de la pantalla y haz clic donde dice *LibreDTE* o en el logo de tu empresa en caso de que lo tengas cargado e ingresa a la opción **Mi perfil**: ![Menú LibreDTE](https://www.billmysales.com/img/content/docs/billers/libredte/menu_libredte.png) 3. Una vez estés dentro del perfil del usuario, copia el **API Hash**: ![Perfil de usuario LibreDTE](https://www.billmysales.com/img/content/docs/billers/libredte/perfil_de_usuario_libredte.png) 4. Finalmente, pégalo en la configuración de la pasarela de BillMySales: ![Datos de conexión](https://www.billmysales.com/img/content/docs/billers/libredte/datos_de_conexion.png) **2. Opciones del DTE que se generará**: - El **RUT del emisor** debe ser el del contribuyente registrado en LibreDTE con el Servicio Plus activo. - En la **configuración de precios** deberás indicar cómo envía los precios de los ítems tu origen de datos. Mencionar que todos los ítems en el origen de datos deben tener la misma configuración. Las opciones disponibles son las siguientes: - Precios configurados para ítems afectos y exentos, el origen de datos envía montos brutos. - Precios configurados para ítems afectos y exentos, el origen de datos envía montos netos. - Usar siempre precios afectos, el origen de datos envía montos brutos. - Usar siempre precios afectos, el origen de datos envía montos netos. - Todos los precios son exentos (monto sin impuestos). ![Opciones del DTE que se generará](https://www.billmysales.com/img/content/docs/billers/libredte/opciones_del_dte_que_se_generara.png) > [!WARNING] Importante > > Si realizarás pruebas deberás dejar el campo **¿Tipo de emisión?** con la opción ***Generar cotización (documento temporal)***. De esta manera, todas las órdenes que lleguen desde tu origen de datos se generarán como [documentos temporales](https://libredte.cl/dte/dte_tmps/listar) en LibreDTE y no serán enviados al SII. Para finalizar, dirígete al final de la página en BillMySales y guarda la configuración haciendo clic en el botón **Guardar cambios**. ![Botón para guardar los cambios](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_07.png) --- ## BHExpress BHExpress # BHExpress Documentación asociada al facturador [BHExpress](https://www.billmysales.com/apps/billers/bhexpress) como facturador. --- ### Configuración inicial Configuración BHExpress # Configuración BHExpress En esta sección se explicarán los pasos para configurar la pasarela de facturación de BillMySales utilizando **BHExpress como facturador**. ## Requisitos 1. Tener cuenta en BHExpress con cualquier plan activo. 2. Tener cuenta en BillMySales con cualquier plan, incluyendo el gratuito. 3. [Crear una pasarela de facturación](https://www.billmysales.com/academy/capacitacion-inicial/pasarelas-de-facturacion/crear-pasarela-de-facturacion) en BillMySales utilizando BHExpress como facturador y el origen de datos de su elección. > [!NOTE] Nota > > La configuración que se explicará es una configuración por defecto que solo garantiza la conexión entre ambos sistemas. Sin embargo, debe validar la configuración y, si necesita algo específico, configúrelo según sus requerimientos. ## Configuración básica de BHExpress Para comenzar, debes ingresar a la configuración de la [pasarela de facturación](https://app.billmysales.com/billing_gateways) creada en BillMySales y dirigirte a la tercera pestaña llamada **Facturador** y realizar los siguientes pasos: ![Pestaña facturador con BHExpress](https://www.billmysales.com/img/content/docs/billers/bhexpress/pestana_facturador_con_bhexpress.png) **1. Token de la API de BHExpress** Para obtener el **Token API** solicitado en BillMySales debes realizar lo siguiente: ![Campo del token API en BillMySales](https://www.billmysales.com/img/content/docs/billers/bhexpress/campo-del-token-api-en-billmysales.png) 1. Ingresa a tu cuenta de BHExpress y dirígete a tu [perfil del usuario](https://app.bhexpress.cl/usuarios/perfil#token) e ingresa a la última pestaña llamada **Token API**: ![Token del usuario en BHExpress](https://www.billmysales.com/img/content/docs/billers/bhexpress/token-del-usuario-en-bhexpress.png) 2. Copia el token entregado por BHExpress y pégalo en el campo **Token API** de la configuración de la pasarela en BillMySales: ![Token de BHExpress configurado en BillMySales](https://www.billmysales.com/img/content/docs/billers/bhexpress/token-de-bhexpress-configurado-en-billmysales.png) **2. Opciones de la Boleta de honorarios** En esta sección deberás configurar los siguientes campos: - **RUT emisor**: Debes indicar el RUT de quien emitirá las boletas de honorarios y de quién se encuentre registrado en BHExpress con un plan activo. - **Tipo de precio**: define si el monto de los ítems son brutos o líquidos. - **¿Quién retiene?**: indica si la retención la realiza el emisor o receptor de la boleta de honorarios. - **Tasa de retención**: configura la tasa de retención [definida por el SII](https://www.sii.cl/destacados/boletas_honorarios/aumento_gradual.html) para el periodo actual. ![Configuración de las opciones de las BHEs](https://www.billmysales.com/img/content/docs/billers/bhexpress/configuracion-de-las-opciones-de-las-bhes.png) Una vez realizada la configuración debes ir al final de la página y guardar la configuración haciendo clic en el botón **Guardar cambios**. ![Botón de guardar cambios](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_07.png) --- ## SII: BHE SII: BHE # SII: BHE Documentación asociada al facturador [SII: BHE](https://www.billmysales.com/apps/billers/siibhe) como facturador. --- ### Configuración inicial Configuración SII: BHE # Configuración SII: BHE En esta sección se explicarán los pasos para configurar la pasarela de facturación de BillMySales utilizando **SII: BHE como facturador**. ## Requisitos 1. Tener inicio de actividades de segunda categoría en el SII. 2. Tener cuenta en BillMySales con cualquier plan, incluyendo el gratuito. 3. [Crear una pasarela de facturación](https://www.billmysales.com/academy/capacitacion-inicial/pasarelas-de-facturacion/crear-pasarela-de-facturacion) en BillMySales utilizando BHExpress como facturador y el origen de datos de su elección. > [!NOTE] Nota > > La configuración que se explicará es una configuración por defecto que solo garantiza la conexión entre ambos sistemas. Sin embargo, debe validar la configuración y, si necesita algo específico, configúrelo según sus requerimientos. ## Configuración básica de SII para boletas de honorarios Para comenzar con la configuración debes dirigirte a las [pasarelas de facturación](https://app.billmysales.com/billing_gateways) en BillMySales e ingresar a editar la pasarela creada previamente. Para comenzar, debes ingresar a la configuración de la [pasarela de facturación](https://app.billmysales.com/billing_gateways) creada en BillMySales y dirigirte a la tercera pestaña llamada **Facturador** y realizar lo siguiente: ![Pestaña facturador con SII: BHE](https://www.billmysales.com/img/content/docs/billers/siibhe/pestana_facturador_con_sii_bhe.png) **1. Datos de conexión al SII** Conecta tu SII con BillMySales ingresando la siguiente información: - **RUT Emisor**: debes indicar el RUT del contribuyente de segunda categoría que realizará la emisión de las boletas de honorarios. - **Clave SII**: debes indicar la clave tributaria del emisor de las boletas de honorarios. ![Datos de conexión al SII](https://www.billmysales.com/img/content/docs/billers/siibhe/datos-de-conexion-al-sii.png) **2. Opciones de la Boleta de honorarios** En esta sección deberás configurar los siguientes campos: - **¿Quién retiene?**: indica si la retención la realiza el emisor o receptor de la boleta de honorarios o si no tienes retención. Recuerda que si tus ventas son a personas naturales, la retención siempre la debes hacer tu. - **Tasa de retención adicional**: configura la tasa de retención [definida por el SII](https://www.sii.cl/destacados/boletas_honorarios/aumento_gradual.html) para el periodo actual. ![Opciones de las BHE](https://www.billmysales.com/img/content/docs/billers/siibhe/opciones-de-las-bhe.png) Una vez finalices la configuración, debes dirigirte al final de la página de BillMySales y guardar la configuración haciendo clic en el botón **Guardar cambios**. ![Botón para guardar los cambios](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_07.png) --- ## Webhook Webhook # Webhook Documentación asociada al facturador [Webhook](https://www.billmysales.com/apps/billers/webhook) como facturador. --- ### Configuración inicial Configuración Webhook # Configuración Webhook En esta sección se explicarán los pasos para configurar la pasarela de facturación de BillMySales utilizando **Webhook como facturador**. ## Requisitos 1. Tener cuenta en BillMySales con cualquier plan, incluyendo el gratuito. 2. [Crear una pasarela de facturación](https://www.billmysales.com/academy/capacitacion-inicial/pasarelas-de-facturacion/crear-pasarela-de-facturacion) en BillMySales utilizando Webhook como facturador y el origen de datos de su elección. > [!NOTE] Nota > > La configuración que se explicará es una configuración por defecto que solo garantiza la conexión entre ambos sistemas. Sin embargo, debe validar la configuración y, si necesita algo específico, configúrelo según sus requerimientos. ## Configuración de la pasarela Realizando esta configuración, la integración permitirá emitir boletas y/o facturas electrónicas. Para comenzar, debes ingresar a la configuración de la [pasarela de facturación](https://app.billmysales.com/billing_gateways) creada en BillMySales. Una vez dentro, deberás dirigirte a la segunda pestaña llamada **Origen de datos** y realizar lo siguiente: ![Pestaña origen de datos con webhook](https://www.billmysales.com/img/content/docs/billers/webhook/pestana_origen_de_datos_con_webhook.png) **1. Datos de conexión**. Para poder realizar la conexión, BillMySales solicita el siguiente dato: - **URL**: debes indicar la URL a la cual se notificará cuando se deba crear el documento tributario en tu sistema. Adicionalmente, BillMySales entrega la **Clave secreta**, la cual debe ser configurada en tu sistema para que sea posible validar que la notificación enviada a la URL sea auténtica. ![Datos de conexión](https://www.billmysales.com/img/content/docs/billers/webhook/datos_de_conexion.png) Una vez finalices la configuración, debes dirigirte al final de la página de BillMySales y guardar la configuración haciendo clic en el botón **Guardar cambios**. ![Botón para guardar los cambios](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_07.png) --- ## Odoo Odoo # Odoo Documentación asociada al facturador [Odoo](https://www.billmysales.com/apps/billers/odoo) como facturador. --- ### Configuración inicial Configuración Odoo como facturador # Configuración Odoo como facturador En esta sección se explicarán los pasos para configurar la pasarela de facturación de BillMySales utilizando **Odoo como facturador**. ## Requisitos 1. Tener cuenta en Odoo. 2. Tener cuenta en BillMySales con cualquier plan, incluyendo el gratuito. 3. [Crear una pasarela de facturación](https://www.billmysales.com/academy/capacitacion-inicial/pasarelas-de-facturacion/crear-pasarela-de-facturacion) en BillMySales utilizando LibreDTE como facturador y el origen de datos de su elección. > [!NOTE] Nota > > La configuración que se explicará es una configuración por defecto que solo garantiza la conexión entre ambos sistemas. Sin embargo, debe validar la configuración y, si necesita algo específico, configúrelo según sus requerimientos. > [!INFO] INFO > > Esta integración solo ha sido probada hasta la versión 17 de Odoo. ## Configuración básica de Odoo Para comenzar, debes ingresar a la configuración de la [pasarela de facturación](https://app.billmysales.com/billing_gateways) creada en BillMySales y dirigirte a la tercera pestaña llamada **Facturador** y realizar lo siguiente: ![Pestaña facturador con Odoo](https://www.billmysales.com/img/content/docs/billers/odoo/pestana_facturador_con_odoo.png) **1. URL del sitio en Odoo** Ingresa la URL personalizada de acceso a tu cuenta de Odoo, por ejemplo: ![Campo URL del sistema Odoo](https://www.billmysales.com/img/content/docs/billers/odoo/campo-url-del-sistema-odoo.png) **2. Base de datos** Para obtener el nombre de la base de datos de Odoo primero debes activar el modo desarrollador en Odoo siguiendo los siguientes pasos: 1. Dirígete al módulo de **Ajustes** en Odoo. 2. Luego, en los ajustes generales, al final de la página, encontrarás la sección **Herramientas de desarrollador** donde deberás hacer clic en **Activar modo de desarrollador**. ![Activar modo desarrollador en Odoo](https://www.billmysales.com/img/content/docs/billers/odoo/activar-modo-desarrollador.png) 3. Finalmente, en la esquina superior derecha de la pantalla, justo debajo de tu nombre, podrás encontrar el nombre de la base de datos. ![Nombre de la base de datos](https://www.billmysales.com/img/content/docs/billers/odoo/nombre-de-la-base-de-datos.png) 4. Una vez tengas el nombre de la base de datos, deberás configurarlo en el campo **Base de datos** de la pasarela de facturación en BillMySales, por ejemplo: ![Base de datos configurada en BillMySales](https://www.billmysales.com/img/content/docs/billers/odoo/base-de-datos-configurada-en-billmysales.png) **3. Correo electrónico de tu usuario de Odoo** Indica el correo del usuario de Odoo. El usuario debe tener acceso al siguiente módulo de Odoo: - **Facturación**: permiso de mostrar funcionalidades de contabilidad (solo para lectura). ![Correo del usuario de Odoo configurado en BillMySales](https://www.billmysales.com/img/content/docs/billers/odoo/correo-del-usuario-de-odoo-configurado-en-billmysales.png) **4. Clave de API** Para obtener la clave de API en Odoo debes seguir los siguientes pasos: 1. En tu cuenta de Odoo, hacer clic en tu usuario que se encuentra en la esquina superior derecha de la pantalla e ingresar a la opción **Mis preferencias**. ![Sección de Mis preferencias en Odoo](https://www.billmysales.com/img/content/docs/billers/odoo/seccion-de-mis-preferencias-en-odoo.png) 2. Luego, ir a la pestaña **Seguridad** y hacer clic en la opción **Agregar clave API**. ![Configuración de seguridad en Odoo](https://www.billmysales.com/img/content/docs/billers/odoo/configuracion-de-seguridad-en-odoo.png) 3. Deberás ingresar la contraseña de tu usuario. ![Ingresar clave de usuario en Odoo](https://www.billmysales.com/img/content/docs/billers/odoo/ingresar-clave-de-usuario-en-odoo.png) 4. Finalmente, deberás indicar el nombre para identificar la clave API y la duración de validez y hacer clic en **Generar clave**. ![Crear clave API en Odoo](https://www.billmysales.com/img/content/docs/billers/odoo/crear-clave-api-en-odoo.png) Una vez realizado el último paso, Odoo te entregará la clave creada ![Clave API creada en Odoo](https://www.billmysales.com/img/content/docs/billers/odoo/clave-api-creada-en-odoo.png) 5. Una vez realices los 4 pasos indicados, deberás copiar la clave entregada por Odoo y dirigirte a la configuración de la pasarela en BillMySales y pegarla en el campo llamado **Clave API**. ![Clave API configurada en BillMySales](https://www.billmysales.com/img/content/docs/billers/odoo/clave-api-configurada-en-billmysales.png) **5. Versión Odoo** Finalmente, configura cuál es la versión de Odoo que estás utilizando. Actualmente las versiones disponibles en BillMySales son: - **Versión 16.0**. - **Versión 16.4**. - **Versión 17.0**. Si no sabes la versión de Odoo que utilizas, la puedes encontrar ingresando a la aplicación de **Ajustes** en Odoo y luego en la sección de **Opciones generales**. Una vez finalices la configuración, debes dirigirte al final de la página de BillMySales y guardar la configuración haciendo clic en el botón **Guardar cambios**. ![Botón para guardar los cambios](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_07.png) --- ## Sibi Sibi # Sibi Documentación asociada al facturador [Sibi](https://www.billmysales.com/apps/billers/sibi) como facturador. --- ### Configuración inicial Configuración Sibi # Configuración Sibi En esta sección se explicarán los pasos para configurar la pasarela de facturación de BillMySales utilizando **Sibi como facturador**. ## Requisitos 1. Tener cuenta en Sibi con plan activo. 2. Tener cuenta en BillMySales con cualquier plan, incluyendo el gratuito. 3. [Crear una pasarela de facturación](https://www.billmysales.com/academy/capacitacion-inicial/pasarelas-de-facturacion/crear-pasarela-de-facturacion) en BillMySales utilizando Sibi como facturador y el origen de datos de su elección. > [!NOTE] Nota > > La configuración que se explicará es una configuración por defecto que solo garantiza la conexión entre ambos sistemas. Sin embargo, debe validar la configuración y, si necesita algo específico, configúrelo según sus requerimientos. ## Configuración de la pasarela Realizando esta configuración, la integración permitirá emitir tus documentos de manera automática. Para comenzar, debes ingresar a la configuración de la [pasarela de facturación](https://app.billmysales.com/billing_gateways) creada en BillMySales y dirigirte a la tercera pestaña llamada **Facturador** y realizar lo siguiente: ![Pestaña facturador con Sibi](https://www.billmysales.com/img/content/docs/billers/sibi/pestana_facturador_con_sibi.png) **1. Datos de conexión** Para realizar la conexión con tu cuenta de Sibi, BillMySales solicita el siguiente campo: - **Token**: corresponde al token de autenticación en Sibi. Este token es entregado por Sibi al momento de registrar tu cuenta en su sistema. Si no cuentas con este dato, deberás solicitarlo al soporte de dicha plataforma. Una vez obtengas el token, deberás pegarlo en la configuración de BillMySales ![Datos de conexión de Sibi configurados en BillMySales](https://www.billmysales.com/img/content/docs/billers/sibi/datos-de-conexion-de-sibi-configurados-en-billmysales.png) **2. Opciones del documento que se generará** En esta sección deberás configurar los siguientes campos: - **RUC**: ingresa el número de registro único del contribuyente. - **¿Tipo de emisión?**: define si deseas generar tus documentos en formato real o proforma. - **Configuración de precio**: debes indicar cómo envía los precios de los ítems tu origen de datos. Mencionar que todos los ítems en el origen de datos deben tener la misma configuración. ![Opciones del documento que se generará](https://www.billmysales.com/img/content/docs/billers/sibi/opciones_del_documento_que_se_generara.png) Una vez finalices la configuración, debes dirigirte al final de la página de BillMySales y guardar la configuración haciendo clic en el botón **Guardar cambios**. ![Botón para guardar los cambios](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_07.png) --- ## Contabilium Bsale # Bsale Documentación asociada al facturador [Contabilium](https://www.billmysales.com/apps/billers/contabilium) como facturador. --- ### Configuración inicial Configuración Contabilium # Configuración Contabilium En esta sección se explicarán los pasos para configurar la pasarela de facturación de BillMySales utilizando **Contabilium como facturador**. ## Requisitos 1. Tener cuenta en Contabilium con el Plan Full activo. 2. Tener cuenta en BillMySales con cualquier plan, incluyendo el gratuito. 3. [Crear una pasarela de facturación](https://www.billmysales.com/academy/capacitacion-inicial/pasarelas-de-facturacion/crear-pasarela-de-facturacion) en BillMySales utilizando Contabilium como facturador y el origen de datos de su elección. > [!NOTE] Nota > > La configuración que se explicará es una configuración por defecto que solo garantiza la conexión entre ambos sistemas. Sin embargo, debe validar la configuración y, si necesita algo específico, configúrelo según sus requerimientos. ## Configuración de la pasarela Realizando esta configuración, la integración permitirá emitir boletas y/o facturas electrónicas. Para comenzar, debes ingresar a la configuración de la [pasarela de facturación](https://app.billmysales.com/billing_gateways) creada en BillMySales y dirigirte a la tercera pestaña llamada **Facturador** y realizar lo siguiente: ![Pestaña facturador con Contabilium](https://www.billmysales.com/img/content/docs/billers/contabilium/pestana_facturador_con_contabilium.png) **1. Datos de conexión** Para poder realizar la conexión, BillMySales solicita el **Correo electrónico**, la **API Key** y el **Código de integración** de las credenciales de la API de Contabilium. ![Datos de conexión Contabilium](https://www.billmysales.com/img/content/docs/billers/contabilium/datos_de_conexion_contabilium.png) Para poder obtenerlas debes ingresar a tu cuenta de Contabilium y seguir los siguientes pasos: 1. En el menú que se encuentra en el costado izquierdo de la pantalla dirígete a la opción de **Ventas** y haz clic en **Integraciones (Ventas online)** ![Menú de ventas en contabilium](https://www.billmysales.com/img/content/docs/billers/contabilium/menu-de-ventas-en-contabilium.png) 2. Una vez estés dentro de la página de integraciones debes ir a la pestaña llamada **Ecommerce** y hacer clic en el botón **ADHERIRLO** ![Pagina de integraciones de contabilium](https://www.billmysales.com/img/content/docs/billers/contabilium/pagina-de-integraciones-de-contabilium.png) 3. Al hacer clic en el botón anterior, se abrirá una pestaña donde solicitará **URL Callback** y el **Nombre de la cuenta**: ![Crear aplicación en contabilium](https://www.billmysales.com/img/content/docs/billers/contabilium/crear-aplicacion-en-contabilium.png) 4. La URL la obtienes desde la pasarela de facturación en BillMySales, en la pestaña llamada **Webhook** ![URL del webhook en BillMySales](https://www.billmysales.com/img/content/docs/billers/contabilium/url-del-webhook-en-billmysales.png) 5. Copia la **URL del webhook** entregada por BillMySales y pégala en la configuración de Contabilium, además, completa el nombre como *BillMySales*: ![Datos para crear la app en contabilium completados](https://www.billmysales.com/img/content/docs/billers/contabilium/datos-para-crear-la-app-en-contabilium-completados.png) 6. Una vez completes los datos solicitados, haz clic en **Activar** y obtendrás los datos de conexión requeridos por BillMySales: ![Aplicación creada en contabilium](https://www.billmysales.com/img/content/docs/billers/contabilium/aplicacion-creada-en-contabilium.png) 7. Con esta información, vuelve a la configuración de la pasarela en BillMySales e ingresa a la pestaña **Facturación** donde deberás completar los campos de la siguiente manera: - **Correo electrónico**: correo del usuario de Contabilium. - **API Key**: corresponde a la API Key obtenida en Contabilium con el paso anterior. - **Código de integración**: corresponde al **ID integración** obtenida en Contabilium con el paso anterior. ![Datos de conexión completados en BillMySales](https://www.billmysales.com/img/content/docs/billers/contabilium/datos-de-conexion-completados-en-billmysales.png) 8. Una vez completados los datos, debes dirigirte al final de la página y hacer clic en el botón **Guardar cambios** ![Botón de guardar cambios](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_07.png) Finalmente, vuelve a la sección de **Datos de conexión** y haz clic en el botón **Conectar BillMySales con Contabilium** ![Conectar BillMySales con Contabilium](https://www.billmysales.com/img/content/docs/billers/contabilium/conectar_billmysales_con_contabilium.png) **2. Configuración de la región** Define el país de la cuenta. Actualmente solo se encuentra disponible Chile. ![Configuración de la región](https://www.billmysales.com/img/content/docs/billers/contabilium/configuracion_de_la_region.png) **3. Opciones del DTE que se generará** En esta sección deberás configurar los siguientes campos: - **Configuración de precio**: debes indicar cómo envía los precios de los ítems tu origen de datos. Mencionar que todos los ítems en el origen de datos deben tener la misma configuración. - **Tipo de emisión**: define si solo se debe notificar la orden o si debe ser notificada y generada. ![Opciones del DTE que se generará](https://www.billmysales.com/img/content/docs/billers/contabilium/opciones_del_dte_que_se_generara.png) Una vez realizada la configuración debes ir al final de la página y guardar la configuración haciendo clic en el botón **Guardar cambios**. ![Botón de guardar cambios](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_07.png) --- ## Alegra Alegra # Alegra Documentación asociada al facturador [Alegra](https://www.billmysales.com/apps/billers/alegra) como facturador. --- ### Configuración inicial Configuración Alegra # Configuración Alegra En esta sección se explicarán los pasos para configurar la pasarela de facturación de BillMySales utilizando **Alegra como facturador**. ## Requisitos 1. Tener cuenta en Alegra con un plan activo. 2. Tener cuenta en BillMySales con cualquier plan, incluyendo el gratuito. 3. [Crear una pasarela de facturación](https://www.billmysales.com/academy/capacitacion-inicial/pasarelas-de-facturacion/crear-pasarela-de-facturacion) en BillMySales utilizando Alegra como facturador y el origen de datos de su elección. > [!NOTE] Nota > > La configuración que se explicará es una configuración por defecto que solo garantiza la conexión entre ambos sistemas. Sin embargo, debe validar la configuración y, si necesita algo específico, configúrelo según sus requerimientos. ## Configuración de la pasarela Realizando esta configuración, la integración permitirá emitir boletas y/o facturas electrónicas. Para comenzar, debes ingresar a la configuración de la [pasarela de facturación](https://app.billmysales.com/billing_gateways) creada en BillMySales y dirigirte a la tercera pestaña llamada **Facturador** y realizar lo siguiente: ![Pestaña facturador con Alegra](https://www.billmysales.com/img/content/docs/billers/alegra/pestana_facturador_con_alegra.png) **1. Datos de conexión** Para poder realizar la conexión, BillMySales solicita el **Usuario** y el **Token** de las credenciales de la API de Alegra. Para poder obtener las credenciales debes ingresar a tu cuenta de Alegra y seguir los siguientes pasos: 1. Dirígete a la opción de **Configuración** que se encuentra en el menú del costado izquierdo de la página: ![Sección configuración en Alegra](https://www.billmysales.com/img/content/docs/billers/alegra/seccion-configuracion-en-alegra.png) 2. Dentro de las configuraciones haz clic en el recuadro llamado **Integraciones** ![Sección de integraciones en la configuración de alegra](https://www.billmysales.com/img/content/docs/billers/alegra/seccion-de-integraciones-en-la-configuracion-de-alegra.png) 3. Al ingresar, debes ir a la última pestaña **Integración Manual (API)** donde encontrarás los 2 datos requeridos por BillMySales para realizar la conexión: ![Datos de conexión en alegra](https://www.billmysales.com/img/content/docs/billers/alegra/datos-de-conexion-en-alegra.png) 4. Copia la información de Alegra y pégala en la configuración de la pasarela en BillMySales de la siguiente manera: ![Datos de conexión configurados en BillMySales](https://www.billmysales.com/img/content/docs/billers/alegra/datos-de-conexion-configurados-en-billmysales.png) **2. Opciones del documento que se generará** En esta sección deberás configurar los siguiente campo: - **Tipo de documento**: define el estado con el cual se creará la factura, este estado puede ser *Borrador* o *Abierta*. - **Configuración de precio**: debes indicar cómo envía los precios de los items tu origen de datos. Mencionar que todos los items en el origen de datos deben tener la misma configuración. - **Prefijo de numeración** *(opcional)*: prefijo de la numeración de Alegra con la que se emitirán los documentos, por ejemplo `BOL`. Si se deja vacío, o si en Alegra no existe una numeración activa con ese prefijo, se usará la numeración preferida de la cuenta. ![Opciones del documento en BillMySales](https://www.billmysales.com/img/content/docs/billers/alegra/opciones-del-documento-en-billmysales.png) **3. Configuración de región** Ingresa si el país de facturación es Colombia o Perú. ![Configuración de la región](https://www.billmysales.com/img/content/docs/billers/alegra/configuracion-de-la-region.png) Una vez realizada la configuración debes ir al final de la página y guardar la configuración haciendo clic en el botón **Guardar cambios**. ![Botón de guardar cambios](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_07.png) --- ## Nubox Nubox # Nubox Documentación asociada al facturador [Nubox](https://www.billmysales.com/apps/billers/nubox) como facturador. --- ### Configuración inicial Configuración Nubox # Configuración Nubox En esta sección se explicarán los pasos para configurar la pasarela de facturación de BillMySales utilizando **Nubox como facturador**. ## Requisitos 1. Tener cuenta en Nubox con el plan activo. 2. Tener cuenta en BillMySales con cualquier plan, incluyendo el gratuito. 3. [Crear una pasarela de facturación](https://www.billmysales.com/academy/capacitacion-inicial/pasarelas-de-facturacion/crear-pasarela-de-facturacion) en BillMySales utilizando Nubox como facturador y el origen de datos de su elección. > [!NOTE] Nota > > La configuración que se explicará es una configuración por defecto que solo garantiza la conexión entre ambos sistemas. Sin embargo, debe validar la configuración y, si necesita algo específico, configúrelo según sus requerimientos. ## Configuración de la pasarela Realizando esta configuración, la integración permitirá emitir boletas y/o facturas electrónicas. Para comenzar, debes ingresar a la configuración de la [pasarela de facturación](https://app.billmysales.com/billing_gateways) creada en BillMySales y dirigirte a la tercera pestaña llamada **Facturador** y realizar lo siguiente: ![Pestaña facturador con Nubox](https://www.billmysales.com/img/content/docs/billers/nubox/pestana_facturador_con_nubox.png) **1. Datos de conexión** Para poder realizar la conexión, BillMySales solicita los siguientes datos: - **RUT emisor**: debes indicar el RUT del contribuyente que emitirá los documentos. - **RUT funcionario autorizado**: corresponde al RUT del usuario al que quedarán asociadas las emisiones. - **Usuario**: debes indicar el usuario de la API de Nubox. - **Código de sucursal**: debes indicar la sucursal creada en Nubox. Si no tienes sucursales creadas, deja el campo con un **1**. - **Contraseña**: debes indicar la contraseña para autenticar la API de Nubox. ![Datos de conexión](https://www.billmysales.com/img/content/docs/billers/nubox/datos_de_conexion.png) Para poder obtener el **Usuario** y la **Contraseña**, debes ingresar a tu cuenta de Nubox y seguir los siguientes pasos: 1. Haz clic en el engranaje que se encuentra en la esquina superior derecha de la página e ingresa a la opción **Integraciones & API** ![Menú de configuración en Nubox](https://www.billmysales.com/img/content/docs/billers/nubox/menu-de-configuracion-en-nubox.png) 2. Luego, en la sección de **API** haz clic en el botón **Iniciar** ![Sección de API en la configuración de Nubox](https://www.billmysales.com/img/content/docs/billers/nubox/seccion-de-api-en-la-configuracion-de-nubox.png) 3. Se abrirá una ventana donde deberás seleccionar la segunda opción llamada **Directamente con Nubox (por mi cuenta, sin empresa asociada)** y luego hacer clic en el botón **Crear credenciales** ![Creación de credenciales en Nubox](https://www.billmysales.com/img/content/docs/billers/nubox/creacion-de-credenciales-en-nubox.png) 4. Una vez el proceso haya sido completado, se mostrará el siguiente mensaje: ![Credenciales creadas en Nubox](https://www.billmysales.com/img/content/docs/billers/nubox/credenciales-creadas-en-nubox.png) 5. Luego de realizar este paso, se mostrará en la pantalla las credenciales creadas. Debes copiar estas credenciales y pegarlas en la configuración de la pasarela en BillMySales. ![Credenciales de Nubox configuradas en BillMySales](https://www.billmysales.com/img/content/docs/billers/nubox/credenciales-de-nubox-configuradas-en-billmysales.png) **2. Opciones del DTE que se generará** En esta sección deberás configurar los siguientes campos: - **¿Cómo generar la númeración del folio?**: actualmente solo permite la foliación automática. - **Tipo de documento por defecto**: define qué tipo de documento quieres que se emita (boleta o factura). - **Plataforma**: indica el nombre de la plataforma que se asignará en la referencia de la orden en el documento (por defecto se asigna el nombre del origen de datos que estés integrando). - **Tipo de emisión**: define si deseas que se emitan documentos borradores/temporales o documentos reales. - **Vendedor**: indica el nombre del vendedor que se asignará en el documento (por defecto se asigna el nombre del origen de datos que estés integrando). - **Configuración de precio**: debes indicar cómo envía los precios de los items tu origen de datos. Mencionar que todos los items en el origen de datos deben tener la misma configuración. ![Opciones del DTE que se generará](https://www.billmysales.com/img/content/docs/billers/nubox/opciones_del_dte_que_se_generara.png) Para finalizar, dirígete al final de la página en BillMySales y guarda la configuración haciendo clic en el botón **Guardar cambios**. ![Botón para guardar los cambios](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_07.png) --- ## Facto Facto # Facto Documentación asociadas al ecommerce [Facto](https://www.billmysales.com/apps/billers/facto) como facturador. --- ### Configuración inicial Configuración de Facto # Configuración de Facto En esta sección se explican los pasos para configurar la pasarela de facturación de Facto. ## Requisitos 1. Tener cuenta en Facto. 2. Tener cuenta en BillMySales con cualquier plan, incluyendo gratuito. - Si requiere usar sondeo [necesitará un plan que lo permita](https://www.billmysales.com). 3. Crear pasarela usando el facturador Facto y el origen de datos de su elección. ## Configuración básica de pasarela de facturación **1. Obtener los "Datos de conexión" desde Facto:** Para obtener los **"Datos de conexión"** debes dirigirte a la opción **"API"** en el menú de tu cuenta de Facto: ![Menú de Administración - Opción API](https://www.billmysales.com/img/content/docs/billers/facto/bms_facto_01.png) **2. Generar la llave de la API:** Luego se debe generar la llave de la API en la siguiente opción: ![Crear Llave API](https://www.billmysales.com/img/content/docs/billers/facto/bms_facto_02.png) *Servicios API > Llaves de accesos API > Crear Llave API* **3. Seleccionar tipo de software y permisos:** Aquí deberás seleccionar **"Software Propio"** y los permisos de documentos que emitirán desde BillMySales. Esto dependerá de cada caso. **4. Copiar credenciales generadas:** Los datos de conexión serán **"Login"** y **"Contraseña"** para **"Usuario"** y **"Contraseña"** respectivamente. ![Agregar acceso API - Software Propio](https://www.billmysales.com/img/content/docs/billers/facto/bms_facto_03.png) > [!NOTE] Nota importante > >Copiar y Guardar contraseña antes de presionar el botón 'Agregar' **5. Permisos para productos AFECTOS:** Si lo que venden es **afecto**, se deben seleccionar los siguientes documentos: - Emitir documento factura electrónica. - Emitir documento boleta electrónica. ![Permisos para productos afectos](https://www.billmysales.com/img/content/docs/billers/facto/bms_facto_04.png) **6. Permisos para productos EXENTOS:** Si lo que venden es **exento**, se deben seleccionar los siguientes documentos: - Emitir documento factura exenta electrónica. - Emitir documento boleta exenta electrónica. ![Permisos para productos exentos](https://www.billmysales.com/img/content/docs/billers/facto/bms_facto_05.png) > [!NOTE] Importante > >No es posible ver la contraseña ni editar los permisos después de crear la llave de la API, por lo que se debe procurar seleccionar los documentos que se ocupará o se deberá borrar y volver a crear. **7. Configurar en BillMySales:** Luego en tu cuenta de **BillMySales** te debes dirigir a la pasarela de facturación de Facto e ingresar a la pestaña **"Facturador"**. ![Pestañas: General, Origen de datos, Facturador, Webhook](https://www.billmysales.com/img/content/docs/billers/facto/bms_facto_06.png) **8. Añadir credenciales en BillMySales:** Se debe añadir el **"Usuario"** y **"Contraseña"** obtenidos previamente desde Facto en BillMySales en los campos correspondientes: ![Datos de conexión en BillMySales](https://www.billmysales.com/img/content/docs/billers/facto/bms_facto_07.png) **Datos de conexión** - Usuario* - Contraseña* **9. Opción de datos de prueba:** Es posible utilizar **datos de prueba** mientras se realiza la integración, para esto debes presionar el mensaje que se encuentra de la parte inferior del campo "Usuario". Esto añadirá credenciales de prueba que deben ser cambiadas una vez que se comiencen a realizar documentos reales. **10. Guardar cambios:** Para guardar la conexión de tu cuenta en la sección del Facturador, debes bajar hasta el final de la página y seleccionar **"Guardar cambios"**. ![Botón Guardar cambios](https://www.billmysales.com/img/content/docs/billers/facto/bms_facto_08.png) **11. Verificación en Facto:** En Facto quedará de la siguiente manera: ![Verificación en Facto - Software Propio con Info técnica general](https://www.billmysales.com/img/content/docs/billers/facto/bms_facto_09.png) --- ## Bsale Bsale # Bsale Documentación asociada al facturador [Bsale](https://www.billmysales.com/apps/billers/basle) como facturador. --- ### Configuración inicial Configuración Bsale # Configuración Bsale En esta sección se explicarán los pasos para configurar la pasarela de facturación de BillMySales utilizando **Bsale**. ## Requisitos 1. Tener cuenta activa en Bsale. 2. Tener cuenta en BillMySales con cualquier plan, incuyendo el gratuito. 3. [Crear una pasarela de facturación](https://www.billmysales.com/academy/capacitacion-inicial/pasarelas-de-facturacion/crear-pasarela-de-facturacion) en BillMySales utilizando BHExpress como facutrador y el origen de datos de su elección. > [!NOTE] Nota > > La configuración que se explicará es una configuración por defecto que solo garantiza la conexión entre ambos sistemas. Sin embargo, debe validar la configuración y, si necesita algo específico, configúrelo según sus requerimientos. ## Configuración básica de Bsale Para comenzar, debes ingresar a la configuración de la [pasarela de facturación](https://app.billmysales.com/billing_gateways) creada en BillMySales y dirigirte a la tercera pestaña llamada **Facturador** y realizar lo siguiente: ![Pestaña facturador con Bsale](https://www.billmysales.com/img/content/docs/billers/bsale/pestana_facturador_con_bsale.png) **1. Configurar API Token** Para obtener el API Token debes realizar lo siguiente: 1. Envía un correo al mail ***ayuda@bsale.app*** solicitando el token. En este correo debes indicar el usuario registrado en Bsale al cual deseas asociar el token de acceso. Una vez envíes el correo, te enviarán la siguiente información ![Correo con token de bsale](https://www.billmysales.com/img/content/docs/billers/bsale/correo_con_token_de_bsale.png) 2. En el correo debes ingresar al enlace para crear el token en productivo para empresas activas. Al ingresar, te solicitará crear un usuario para ingresar a **Bsale {devs}** ![Crear usuario en bsale devs](https://www.billmysales.com/img/content/docs/billers/bsale/crear-usuario-en-bsale-devs.png) 3. Una vez creado podrás ingresar a https://account.bsale.dev/account/ y encontrarás el token creado. 4. Ahora deberás copiar el token haciendo clic en el botón de la columna **Access token** ![Copiar token de bsale](https://www.billmysales.com/img/content/docs/billers/bsale/copiar-token-de-bsale.png) 5. Finalmente, debes ir a la pasarela en BillMySales y pegar el token en el campo **API Token** que se encuentra en los datos de conexión. ![API Token configurado en BillMySales](https://www.billmysales.com/img/content/docs/billers/bsale/api-token-configurado-en-billmysales.png) **2. Opciones del DTE** En esta sección deberás configurar los siguientes campos: - **Configuración de precio**: debes indicar cómo envía los precios de los ítems tu origen de datos. Mencionar que todos los ítems en el origen de datos deben tener la misma configuración. - **Enviar documento desde Bsale**: define si deseas o no enviar el PDF de la orden al cliente desde Bsale. ![Configuración de las opciones del DTE](https://www.billmysales.com/img/content/docs/billers/bsale/configuracion-de-las-opciones-del-dte.png) **3. Configuración de región** Ingresa si el país de facturación es Chile o Perú. ![Configuración de la región](https://www.billmysales.com/img/content/docs/billers/bsale/configuracion-de-la-region.png) Una vez realizada la configuración debes ir al final de la página y guardar la configuración haciendo clic en el botón **Guardar cambios**. --- ## NubeFact NubeFact # NubeFact Documentación asociadas al ecommerce [NubeFact](https://www.billmysales.com/apps/billers/nubefact) como facturador. --- ### Configuración inicial Configuración NubeFact # Configuración NubeFact En esta sección se explicarán los pasos para configurar la pasarela de facturación de BillMySales utilizando **NubeFact como facturador**. ## Requisitos 1. Tener cuenta activa con NubeFact. 2. Tener cuenta en BillMySales con cualquier plan, incluyendo el gratuito. 3. [Crear una pasarela de facturación](https://www.billmysales.com/academy/capacitacion-inicial/pasarelas-de-facturacion/crear-pasarela-de-facturacion) en BillMySales utilizando LibreDTE como facturador y el origen de datos de su elección. > [!NOTE] Nota > > La configuración que se explicará es una configuración por defecto que solo garantiza la conexión entre ambos sistemas. Sin embargo, debe validar la configuración y, si necesita algo específico, configúrelo según sus requerimientos. ## Configuración básica de NubeFact Para comenzar, debes ingresar a la configuración de la [pasarela de facturación](https://app.billmysales.com/billing_gateways) creada en BillMySales y dirigirte a la tercera pestaña llamada **Facturador** y realizar lo siguiente: ![Pestaña facturador con NubeFact](https://www.billmysales.com/img/content/docs/billers/nubefact/pestana_facturador_con_nubefact.png) **1. Configura datos de conexión** Los datos de conexión solicitados por BillMySales son los siguientes: - **URL**: corresponde a la dirección del servidor de NubeFact. - **Token**: corresponde al token de conexión a la API de NubeFact. ![Datos de conexión sin configurar](https://www.billmysales.com/img/content/docs/billers/nubefact/datos_de_conexion_sin_configurar.png) Para obtener la URL y Token requeridos por BillMySales debes realizar los siguientes pasos: 1. Ingresa a tu cuenta de NubeFact y dirigirte al menú de configuración que se encuentra en la esquina superior derecha de la pantalla, e ingresar a la opción llamada **API (Integración)** ![Menú de configuración NubeFact](https://www.billmysales.com/img/content/docs/billers/nubefact/menu-de-configuracion-nubefact.png) 2. Luego de ingresar a la sección de la API, deberás generar un Nuevo Token del cual podrás obtener la URL y el token: ![Datos de conexión en NubeFact](https://www.billmysales.com/img/content/docs/billers/nubefact/datos-de-conexion-en-nubefact.png) 3. Finalmente, copia los datos entregados por NubeFact y pegarlos en BillMySales de la siguiente manera: - **RUTA**: corresponde al campo URL en BillMySales. - **TOKEN**: corresponde al campo Token en BillMySales. ![Datos de conexión en BillMySales](https://www.billmysales.com/img/content/docs/billers/nubefact/datos_de_conexion_sin_configurar.png) **2. Opciones del DTE** En esta sección deberás configurar el siguiente campo: - **Configuración de precio**: debes indicar cómo envía los precios de los ítems tu origen de datos. Mencionar que todos los ítems en el origen de datos deben tener la misma configuración. Para finalizar, dirígete al final de la página en BillMySales y guarda la configuración haciendo clic en el botón **Guardar cambios**. ![Botón para guardar los cambios](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_07.png) --- Última actualización el 08/10/2026