--- title: "Orígenes de datos" description: "Orígenes de datos" type: "docs" category: "doc" tags: [] authors: [Anonymous] date: "2023-08-01" last_update: "2026-08-25" time_minutes: 1 draft: false unlisted: false url: "https://www.billmysales.com/docs/datasources" --- # Orígenes de datos Los orígenes de datos son las aplicaciones del usuario desde dónde BillMySales lee las órdenes o pedidos que se requieren facturar, en base a diferentes reglas. --- ## Agenda Pro Agenda Pro # Agenda Pro --- ### Configuración inicial Configuración de AgendaPro # Configuración de AgendaPro En esta sección se explicarán los pasos para realizar la configuración de la pasarela de facturación de **AgendaPro** como origen de datos. > [!INFO] Recuperación de órdenes > > Esta integración recupera las órdenes mediante **webhook**. ## Requisitos 1. Tener cuenta en AgendaPro con plan Pro 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 usando el origen de datos AgendaPro y el facturador 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 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 Agendapro](https://www.billmysales.com/img/content/docs/datasources/agendapro/pestana_origen_de_datos_con_agendapro.png) **1. Datos de conexión API** 1. Para poder realizar la conexión, BillMySales solicita el **Usuario** y **Contraseña** de las credenciales de la API de AgendaPro. Para poder obtener las credenciales debes ingresar a tu cuenta de AgendaPro y seguir los siguientes pasos: 2. Ingresa a las sección de **Configuraciones** que encuentras en la esquina superior derecha de la página haciendo clic en el engranaje: ![Ingresar a la configuración de Agendapro](https://www.billmysales.com/img/content/docs/datasources/agendapro/ingresar-a-la-configuracion-de-agendapro.png) 3. Luego de ingresar a la configuración haz clic en en la opción **Integraciones/API Pública** que se encuentra en el menú del costado izquierdo de la pantalla: ![Acceder a la sección de API en AgendaPro](https://www.billmysales.com/img/content/docs/datasources/agendapro/acceder-a-la-seccion-de-api-en-agendapro.png) 4. Finalmente, ingresa a la última sección llamada **API** donde encontrarás las credenciales de la API: ![Sección API de AgendaPro](https://www.billmysales.com/img/content/docs/datasources/agendapro/seccion-api-de-agendapro.png) 5. Copia ambos datos y pégalos en la configuración de la pasarela de facturación en BillMySales de la siguiente manera: ![Datos de conexión configurados en BillMySales](https://www.billmysales.com/img/content/docs/datasources/agendapro/datos-de-conexion-configurados-en-billmysales.png) 6. 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) --- ## Dolibarr Dolibarr # Dolibarr --- ### Configuración inicial Configuración de Dolibarr # Configuración de Dolibarr En esta sección se explican los pasos para configurar la pasarela de facturación de Dolibarr. > [!INFO] Recuperación de órdenes > > Esta integración recupera las órdenes mediante **webhook**. ## Requisitos 1. Tener cuenta en Dolibarr con cualquier plan de pago. 2. Tener cuenta en BillMySales con cualquier plan, incluyendo gratuito. - Si requiere usar sondeo [necesitará un plan que lo permita](https://www.billmysales.com/#pricing). 3. Crear pasarela usando el origen Dolibarr y el facturador de su elección. --- ## Configuración para emitir facturas electrónicas **1. Acceder al listado de terceros** Debes entrar en el administrador de Dolibarr e ingresar a "Terceros". En "Listado" es donde encontrarás a los clientes agregados a la cuenta de Dolibarr: ![Menú Terceros - Listado](https://www.billmysales.com/img/content/docs/datasources/dolibarr/manual/bms_doli_01.png) **2. Seleccionar cliente** Debes seleccionar el cliente al que deseas emitir facturas: ![Seleccionar cliente](https://www.billmysales.com/img/content/docs/datasources/dolibarr/manual/bms_doli_02.png) **3. Modificar cliente** Dentro del cliente seleccionar "Modificar": ![Botón Modificar](https://www.billmysales.com/img/content/docs/datasources/dolibarr/manual/bms_doli_03.png) **4. Configurar Sujeto a IVA** Luego en el campo "Sujeto a IVA" se debe seleccionar la opción "Sí": ![Sujeto a IVA - Sí](https://www.billmysales.com/img/content/docs/datasources/dolibarr/manual/bms_doli_04.png) **5. Ir a Notas** Una vez completado lo anterior, en la misma página debes ir a "Notas", que está en la parte superior derecha: ![Pestaña Notas](https://www.billmysales.com/img/content/docs/datasources/dolibarr/manual/bms_doli_05.png) **6. Editar Nota pública** A continuación dirígete a "Nota (pública)" y haz clic en el lápiz: ![Editar Nota pública](https://www.billmysales.com/img/content/docs/datasources/dolibarr/manual/bms_doli_06.png) **7. Añadir Giro del cliente** Dentro de este campo añades lo que hará referencia a la Actividad económica del tercero (su Giro), tal como se muestra en el siguiente ejemplo y seleccionas "Modificar": ![Añadir Giro](https://www.billmysales.com/img/content/docs/datasources/dolibarr/manual/bms_doli_07.png) **8. Finalizar configuración** Finalizando los pasos anteriores, el cliente quedará configurado para que se le emitan facturas. --- ## Configuración para emitir boletas electrónicas **1. Acceder al listado de terceros** Debes entrar en el administrador de Dolibarr e ingresar a "Terceros". En "Listado" es donde encontrarás a los clientes agregados a la cuenta de Dolibarr: ![Menu Terceros - Listado](https://www.billmysales.com/img/content/docs/datasources/dolibarr/manual/bms_doli_08.png) **2. Seleccionar cliente** Debes seleccionar el cliente al que deseas emitir facturas: ![Seleccionar cliente](https://www.billmysales.com/img/content/docs/datasources/dolibarr/manual/bms_doli_09.png) **3. Modificar cliente** Dentro del cliente seleccionar "Modificar": ![Boton Modificar](https://www.billmysales.com/img/content/docs/datasources/dolibarr/manual/bms_doli_10.png) **4. Configurar Sujeto a IVA** Luego en el campo "Sujeto a IVA" se debe seleccionar la opción "No": ![Sujeto a IVA - No](https://www.billmysales.com/img/content/docs/datasources/dolibarr/manual/bms_doli_11.png) Finalizando los pasos anteriores el cliente quedará configurado para que se le emitan boletas. --- ### Configuración de tipo de precio # ¿Cómo identificar si el ítem es afecto o exento? ## ¿Cómo identificar si el ítem es afecto o exento? Para identificar si la orden es afecta o exenta se debe revisar el índice **lines** los índices **total_tva** y **tva_tx**. **Caso afecto** El índice **total_tva** debe tener un valor distinto de cero además, el índice **tva_tx** debe tener el valor del impuesto: ![Ejemplo caso afecto](https://www.billmysales.com/img/content/docs/datasources/dolibarr/manual/bms_doli_13.png) ![Ejemplo caso exento](https://www.billmysales.com/img/content/docs/datasources/dolibarr/manual/bms_doli_14.png) **Caso exento** El índice **total_tva** debe tener un valor igual a cero además, el índice **tva_tx** debe tener un valor igual a cero: ![Ejemplo caso exento](https://www.billmysales.com/img/content/docs/datasources/dolibarr/manual/bms_doli_15.png) ![Ejemplo caso exento](https://www.billmysales.com/img/content/docs/datasources/dolibarr/manual/bms_doli_16.png) --- ## Configuración de tipo de precio En Dolibarr sus precios se deben configurar con precios netos, esto es debido a que este E-commerce trabaja sus precios solamente con valores netos, es decir se pueden utilizar las siguientes opciones en BillMySales: - Precios configurados para items afectos y exentos, el origen de datos envía montos netos. - Usar siempre precios afectos, el origen de datos envía montos netos. Esto se modifica en la configuración de la pasarela en la pestaña "Facturador": ![Configuración de precios](https://www.billmysales.com/img/content/docs/datasources/dolibarr/manual/bms_doli_12.png) --- ### Cómo revisar los logs del módulo en Dolibarr ## ¿Cómo revisar el registro (logs) del módulo en Dolibarr? ### ¿Cómo revisar el registro (logs) del módulo en Dolibarr? **1. Acceder a Configuración de módulos** Debes entrar en el administrador de Dolibarr y dirigirte a "Configuración de módulos": ![Configuración de módulos](https://www.billmysales.com/img/content/docs/datasources/dolibarr/manual/bms_doli_17.png) **2. Buscar módulo de registros** Se debe buscar el módulo en la sección de "Sistema", donde será encontrado con el nombre de "REGISTROS DE DEPURACIÓN" y hacer clic en el engranaje para entrar a su configuración: ![Módulo Registros de Depuración](https://www.billmysales.com/img/content/docs/datasources/dolibarr/manual/bms_doli_18.png) **3. Descargar archivo de log** Dentro de la configuración debes descargar el archivo de log de Dolibarr: ![Descargar log](https://www.billmysales.com/img/content/docs/datasources/dolibarr/manual/bms_doli_19.png) **4. Abrir archivo con editor de texto** A continuación, ya descargado el log, debes abrir el archivo con tu editor de texto preferido: ![Abrir archivo log](https://www.billmysales.com/img/content/docs/datasources/dolibarr/manual/bms_doli_20.png) **5. Buscar registro del módulo** Al abrir el archivo, puedes encontrar el registro del módulo con el rango de la fecha y la hora o buscando con el ID de la factura. Este será mostrado por el registro en "BillMySales Response BillPayed #ID de la factura". En la siguiente imagen se verá reflejado un ejemplo del log: ![Ejemplo de registro en el log](https://www.billmysales.com/img/content/docs/datasources/dolibarr/manual/bms_doli_21.png) --- ## Easy Digital Downloads Easy Digital Downloads # Easy Digital Downloads --- ### Configuración inicial Configuración de EasyDigitalDownloads # Configuración de EasyDigitalDownloads En esta sección se explicarán los pasos para realizar la configuración de la pasarela de facturación de **EasyDigitalDownloads** como origen de datos. > [!INFO] Recuperación de órdenes > > Esta integración recupera las órdenes mediante **webhook**. ## Requisitos 1. Tener cuenta en Wordpress. 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 usando el origen de datos Seller Center y el facturador de su elección. > [!NOTE] Nota > > La configuración que se explicará es una configuración por defecto que sólo 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 seguir los siguientes pasos: ### 1. En BillMySales En tu cuenta de BillMySales debes seguir los siguientes pasos: 1. Ingresa a la configuración de la [pasarela de facturación](https://app.billmysales.com/billing_gateways) creada en BillMySales. 2. Una vez estés dentro, deberás dirigirte a la segunda pestaña llamada **Origen de datos**: ![Pestaña origen de datos con EasyDigitalDownloads](https://www.billmysales.com/img/content/docs/datasources/easydigitaldownloads/easydigitaldownloads.png) 3. Y guarda la configuración al final de la página 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) ### 2.En Wordpress (EasyDigitalDownloads) Luego de guardar la configuración en BillMySales, debes ingresar a tu cuenta de Wordpress y realizar los siguientes pasos: 1. Dirígete a la sección de **Plugins** que se encuentra en el menú del costado izquierdo de la pantalla e ingresa a la opción **Agregar Plugin** ![Opción de agregar plugin en wordpress](https://www.billmysales.com/img/content/docs/datasources/easydigitaldownloads/agregar-plugin-wordpress.png) 2. En el buscador de la página, busca el Plugin e instálalo haciendo clic en el botón **Instalar ahora** ![Instalar Plugin](https://www.billmysales.com/img/content/docs/datasources/easydigitaldownloads/instalar-plugin.png) 3. Luego de instalarlo deberás activarlo haciendo clic en el botón **Activar** ![Activar Plugin](https://www.billmysales.com/img/content/docs/datasources/easydigitaldownloads/activar-plugin.png) 4. Una vez se encuentre activo se deberá configurar el Plugin, para esto debes dirigirte a la sección de **Opciones** que se encuentra en el menú del costado izquierdo de la pantalla e ingresar en la opción **WP Webhooks** ![Opción de WP Webhooks](https://www.billmysales.com/img/content/docs/datasources/easydigitaldownloads/wp-webhooks.png) 5. Ingresa en la pestaña **Send Data** ![Pestaña Send Data](https://www.billmysales.com/img/content/docs/datasources/easydigitaldownloads/send-data.png) 6. Dentro de esta pestaña debes dirigirte al final de la página y en la sección **Easy Digital Downloads** y hacer clic en **Payments status changed** ![Payments status changed](https://www.billmysales.com/img/content/docs/datasources/easydigitaldownloads/payments-status-changed.png) 7. En esta página deberás hacer clic en **Add Webhook URL** ![Botón Add Webhook URL](https://www.billmysales.com/img/content/docs/datasources/easydigitaldownloads/add-webhook-url.png) 8. Al hacer esto, se abrirá una ventana donde se solicitarán los siguientes datos: - Webhook Name: El nombre debe ser **BillMySales** - Webhook URL: este campo debe ser completado con **URL del Webhook que obtienes desde BillMySales** ingresando a la configuración de la [pasarela de facturación](https://app.billmysales.com/billing_gateways), en la pestaña **Webhook** ![Pestaña Webhook en BillMySales](https://www.billmysales.com/img/content/docs/datasources/easydigitaldownloads/pestana-webhook-en-billmysales.png) Debes copiar la URL de BillMySales y pegarla en la configuración de Easy Digital Downloads y hacer clic en **Add for edd_payments** ![Creación del Webhook](https://www.billmysales.com/img/content/docs/datasources/easydigitaldownloads/creacion-del-webhook.png) 9. Luego, deberás hacer clic en el símbolo de los 3 puntos del webhook recién creado e ingresar a la opción **Settings** ![Configuración del Webhook](https://www.billmysales.com/img/content/docs/datasources/easydigitaldownloads/configuracion-del-webhook.png) 10. Finalmente, deberás definir en el campo **Trigger om selected payment status changes** el estado con el cual deseas que las órdenes sean procesadas ![Configuración del estado de las órdenes](https://www.billmysales.com/img/content/docs/datasources/easydigitaldownloads/configuracion-del-estado-de-las-ordenes.png) Realizando estos pasos la conexión entre Easy Digital Downloads y BillMySales se encontraría funcional. --- ## Genérico Genérico # Genérico --- ### Configuración inicial Configuración del Origen de datos Genérico # Configuración del Origen de datos Genérico En esta sección se explicarán los pasos para realizar la configuración de la pasarela de facturación de un **Origen de datos Genérico**. > [!INFO] Recuperación de órdenes > > Esta integración recupera las órdenes mediante **webhook**. ## 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 usando el origen de datos Genérico y el facturador de su elección. ## 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 Origen de datos generico](https://www.billmysales.com/img/content/docs/datasources/generico/pestana_origen_de_datos_con_origen_de_datos_generico.png) **1. Datos de autenticación** Esta sección deberás configurar para que BillMySales pueda recibir la información para la generación de las órdenes desde tu origen de datos. Los datos que se solicitan son: - **Cabecera HMAC-SHA256**: corresponde al nombre de la cabecera donde viene la firma HMAC-SHA256 de los datos que se recibirán desde tu origen de datos. - **Clave HMAC-SHA256**: corresponde a la clave secreta utilizada para validar la firma que autentica los datos que vienen del origen de datos. ![Datos de autenticación](https://www.billmysales.com/img/content/docs/datasources/generico/datos_de_autenticacion.png) **2. Datos de notificación** En esta sección deberás configurar para que BillMySales pueda notificar al origen de datos una vez se genere la orden. Los datos que se solicitan son: - **URL de notificación***: corresponde a la URL donde se deberá notificar cuando se generen las órdenes. - **Clave HMAC-SHA256**: corresponde a la clave secreta utilizada para firmar la notificación. ![Datos de notificación](https://www.billmysales.com/img/content/docs/datasources/generico/datos_de_notificacion.png) **3. Define los selectores** Adicionalmente, deberás configurar desde qué campos se obtendrán los datos para la generación del documento. Esta configuración se divide en varias secciones: - Campos de la orden. - Total de la orden. - Datos del proveedor. - Datos del cliente. - Dirección de facturación. - Dirección de envío. - Detalles. - Envíos. - Descuentos. - Pagos. 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) --- ## Jumpseller Jumpseller # Jumpseller --- ### Configuración inicial Configuración de Jumpseller # Configuración de Jumpseller En esta sección se explican los pasos para configurar la pasarela de facturación de Jumpseller. > [!INFO] Recuperación de órdenes > > Esta integración recupera las órdenes mediante **webhook** y **sondeo**. ## Requisitos 1. Tener cuenta en Jumpseller con cualquier plan de pago. 2. Tener cuenta en BillMySales con cualquier plan, incluyendo gratuito. - Si requieres usar sondeo [necesitarás un plan que lo permita](https://www.billmysales.com/#pricing). 3. Crear pasarela usando el origen Jumpseller y el facturador de su elección. --- ## Configurar el Sondeo Realizando esta configuración la integración permitirá recuperar las órdenes generadas en Jumpseller y **se generarán boletas no nominativas por defecto**. **NOTA:** Es importante haber iniciado sesión en la tienda de Jumpseller. **1. Guardar configuración inicial** Antes de conectar BillMySales con Jumpseller guarda la configuración en el botón "Guardar cambios". Luego podrás realizar la conexión. **2. Conectar con Jumpseller** Ingresar configuración de la pasarela de Jumpseller en la pestaña "Origen de datos" presionar en el Botón "Conectar BillMySales con Jumpseller": ![Conectar BillMySales con Jumpseller](https://www.billmysales.com/img/content/docs/datasources/jumpseller/manual/bms_jump_01.png) **3. Autorizar la aplicación** Esto nos redirigirá a otra página en donde debemos presionar en "Autorizar": ![Autorizar aplicación](https://www.billmysales.com/img/content/docs/datasources/jumpseller/manual/bms_jump_02.png) **4. Verificar conexión** Con esto, ya tendremos conectado BillMySales con nuestra tienda de Jumpseller: ![Conexión establecida](https://www.billmysales.com/img/content/docs/datasources/jumpseller/manual/bms_jump_03.png) **5. Activar la pasarela** Finalmente en la pestaña "General" en "Estado de la pasarela" seleccionamos "Activada" y presionamos "Guardar cambios". Con esto la pasarela estará activada. --- ## Configurar el Webhook Para conectar el Webhook en primera instancia se debió haber completado el paso "Configurar el Sondeo". **1. Crear conexión Webhook** Para configurar el webhook solo se debe presionar "Crear conexión Webhook de Jumpseller": ![Crear conexión Webhook](https://www.billmysales.com/img/content/docs/datasources/jumpseller/manual/bms_jump_04.png) --- ### Configuración de tipos de documentos Configuración de tipos de documentos # Configuración de tipos de documentos En esta sección se explican los pasos para configurar los tipos de documentos, ya sean boletas nominativas o facturas electrónicas. ## Configuración para boletas nominativas Para poder emitir boletas nominativas, es decir, con el RUT del cliente debes seguir los siguientes pasos en Jumpseller: **1. Acceder a Checkout en Jumpseller** Entrar en el administrador la tienda en Jumpseller, pero ahora debes ir a la configuración y luego a "Checkout": ![Menú Checkout](https://www.billmysales.com/img/content/docs/datasources/jumpseller/manual/bms_jump_05.png) **2. Configurar Campos del Sistema** Dentro de Checkout ir a la sección "Campos del Sistema", donde los campos de identificación fiscal se marcan como obligatorios, tal como se muestra en la imagen: ![Campos del Sistema](https://www.billmysales.com/img/content/docs/datasources/jumpseller/manual/bms_jump_06.png) Con esta configuración ya se deberían poder emitir boletas nominativas. --- ## Configuración para facturas o boletas nominativas Para poder emitir facturas o boletas nominativas, es decir, con el RUT del cliente debes seguir los siguientes pasos en Jumpseller: **1. Acceder a Checkout** Ingresar en el administrador de la tienda en Jumpseller e ingresar a "Checkout": ![Configuración Checkout](https://www.billmysales.com/img/content/docs/datasources/jumpseller/manual/bms_jump_07.png) **2. Agregar Campos Personalizados** Dentro de "Checkout" debes bajar a "Campos Personalizados" y seleccionar "Agregar Campo": ![Campos Personalizados](https://www.billmysales.com/img/content/docs/datasources/jumpseller/manual/bms_jump_08.png) **3. Crear campo "Documento"** El primer campo será "Documento", el cual será configurado de la siguiente forma para permitir la elección del tipo de documento que el cliente desea: - **Etiqueta:** Documento. - **Área:** "Otro". - **Tipo:** Lista de selección. **4. Agregar opciones del documento** En opciones se debe añadir: - Boleta. - Factura. **Nota:** Los nombres "Documento", "Boleta" y "Factura" deben ser exactamente escritos de esta forma. Ya que si están de otra forma, por ejemplo, todo en mayúsculas o minúsculas, no funcionará. **5. Guardar campo Documento** Luego debes seleccionar "Guardar". **6. Crear campo "Giro"** El segundo campo será "Giro", el cual debe ser configurado de la siguiente forma: - **Etiqueta:** Giro. - **Área:** Otro. - **Tipo:** Campo de entrada. **7. Guardar campo Giro** Luego debes seleccionar "Guardar". **8. Campo Giro opcional** Si deseas que el campo giro sea opcional lo debes dejar de la siguiente forma: ![Campo Giro opcional](https://www.billmysales.com/img/content/docs/datasources/jumpseller/manual/bms_jump_09.png) **9. Verificar campos creados** Una vez creados estos campos se verán de la siguiente manera: ![Campos creados](https://www.billmysales.com/img/content/docs/datasources/jumpseller/manual/bms_jump_10.png) **10. Vista en el checkout** Y en el checkout de tu tienda se verá de la siguiente manera: ![Vista en checkout](https://www.billmysales.com/img/content/docs/datasources/jumpseller/manual/bms_jump_11.png) --- ## Configuración en BillMySales **1. Acceder a Origen de datos** A continuación, te debes dirigir a la configuración de la pasarela e ingresar a la pestaña "Origen de datos": ![Pestaña Origen de datos](https://www.billmysales.com/img/content/docs/datasources/jumpseller/manual/bms_jump_12.png) **2. Editar Campos del documento** Al final de la página te encontrarás con el recuadro de "Campos del documento" y lo debes editar: ![Campos del documento](https://www.billmysales.com/img/content/docs/datasources/jumpseller/manual/bms_jump_13.png) **3. Añadir campo Documento** Dentro de este campo se debe añadir el "Documento" tal como se muestra en la siguiente imagen: ![Añadir Documento](https://www.billmysales.com/img/content/docs/datasources/jumpseller/manual/bms_jump_14.png) **4. Editar Campos del cliente** En la misma página te encontrarás con el recuadro "Campos del cliente" y lo debes editar: ![Campos del cliente](https://www.billmysales.com/img/content/docs/datasources/jumpseller/manual/bms_jump_15.png) **5. Añadir campo Giro** Dentro de este campo se debe añadir el "Giro" tal como se muestra en la siguiente imagen: ![Añadir Giro](https://www.billmysales.com/img/content/docs/datasources/jumpseller/manual/bms_jump_16.png) **6. Guardar configuración** Finalmente debes guardar la configuración en "Guardar cambios". Con esta configuración ya podrás emitir boletas nominativas y facturas electrónicas a tus clientes a través de tu tienda. --- ### Configuración de tipo de precio # ¿Cómo identificar si un ítem es afecto o exento? ## ¿Cómo identificar si un ítem es afecto o exento? Para identificar si la orden es afecta o exenta se debe ingresar en el [listado de órdenes](https://www.billmysales.com/apps/datasources/jumpseller) e ingresar a la orden que desea revisar, luego en el historial ir al campo "Datos recibidos" donde podrá ver el JSON de la orden con los datos que envía Jumpseller para generar el documento. #### **Caso afecto** El índice **tax** debe tener un valor distinto de cero además, en el índice **taxes debe venir la información** relacionada con el impuesto. #### **Caso exento** El índice **tax** debe tener un valor cero además, el índice **taxes debe estar vacío**. #### **Orden afecta con valores netos** Para identificar si la orden afecta es neta se debe revisar el índice **products**. Dentro de **products** en el índice **taxes** se encuentra el campo **tax_on_product_price** en donde si su valor es **False** indica que el IVA no se encuentra agregado al precio del ítem. #### **Orden afecta con valores brutos** Para identificar si la orden afecta es bruto se debe revisar el índice **products**. Dentro de **products** en el índice **taxes** se encuentra el campo **tax_on_product_price** en donde si su valor es **True** indica que el IVA se encuentra agregado al precio del ítem. --- ## Configuración con precios NETOS La configuración para definir en BillMySales si quieres que tus precios sean "Precios configurados para ítems afectos y exentos, el origen de datos envía los montos neto", es la siguiente: ![Configuración impuestos - Netos](https://www.billmysales.com/img/content/docs/datasources/jumpseller/manual/bms_jump_18.png) Esto quiere decir que en los precios que le asignes a tus productos no incluirán el impuesto, sino que será sumado al producto en el momento de la compra. **Ejemplo:** Precio asignado en producto: ![Precio neto en producto](https://www.billmysales.com/img/content/docs/datasources/jumpseller/manual/bms_jump_19.png) Precio compra del producto: ![Precio con impuesto agregado](https://www.billmysales.com/img/content/docs/datasources/jumpseller/manual/bms_jump_20.png) Se incluirá en caso de Chile, el impuesto de un 19%, esto dependerá de tu país o región. ## Configuración con precios BRUTOS La configuración para definir en BillMySales si quieres que tus precios sean "Precios configurados para ítems afectos y exentos, el origen de datos envía montos brutos", es la siguiente: ![Configuración impuestos - Brutos](https://www.billmysales.com/img/content/docs/datasources/jumpseller/manual/bms_jump_21.png) Esto quiere decir que en los precios que le asignes a tus productos incluirán el impuesto, es decir, el impuesto ya se encuentra sumado al producto en el momento de la compra. **Ejemplo:** Precio asignado en producto: ![Precio bruto en producto](https://www.billmysales.com/img/content/docs/datasources/jumpseller/manual/bms_jump_22.png) Precio compra del producto: ![Precio bruto final](https://www.billmysales.com/img/content/docs/datasources/jumpseller/manual/bms_jump_23.png) El impuesto está incluido en el precio. **Importante:** Si nuestros precios están definidos como "Precios configurados para ítems afectos y exentos, el origen de datos envía montos brutos", también se debe asignar el envío bruto: ![El envío incluye impuestos](https://www.billmysales.com/img/content/docs/datasources/jumpseller/manual/bms_jump_24.png) --- ## Configuración de tipo de precio En esta sección se explican los pasos para configurar el tipo de precio en BillMySales. En Jumpseller sus precios se pueden configurar con precios brutos y netos, dependiendo de la configuración del impuesto de tu cuenta, es decir, puede utilizar las siguientes opciones en BillMySales: ![Opciones de configuración de precios](https://www.billmysales.com/img/content/docs/datasources/jumpseller/manual/bms_jump_17.png) --- ## Mercado Libre Mercado Libre # Mercado Libre --- ### Configuración inicial Configuración de Mercado Libre # Configuración de Mercado Libre En esta sección se explicarán los pasos para realizar la configuración de la pasarela de facturación de **Mercado Libre** como origen de datos. > [!INFO] Recuperación de órdenes > > Esta integración recupera las órdenes mediante **webhook** y **sondeo**. ## Requisitos 1. Tener cuenta en Mercado Libre. 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 usando el origen de datos Mercado Libre y el facturador de su elección. > [!NOTE] Nota > > La configuración que se explicará es una configuración por defecto que sólo 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 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 Mercado Libre](https://www.billmysales.com/img/content/docs/datasources/mercadolibre/pestana_origen_de_datos_con_mercado_libre.png) 1. En la sección **Datos de conexión** debes hacer clic en el botón azúl **Conectar BillMySales con Mercado Libre** ![Sección datos de conexión](https://www.billmysales.com/img/apps/datasources/mercadolibre/seccion-datos-de-conexion.png) 2. Una vez hagas clic serás redirigido a Mercado Libre donde te solicitará autorizar la integración de la aplicación ![Autorización de aplicación en mercado libre](https://www.billmysales.com/img/apps/datasources/mercadolibre/autorizacion-de-aplicacion-en-mercado-libre.png) 3. Si estás de acuerdo con los permisos que se otorgarán a la aplicación de BillMySales debes hacer clic en el botón **Autorizar** que se encuentra al final de la pagina 4. Al autorizar la integración se mostrará un mensaje confirmado que la conexión fue autorizada: ![Mensaje de autorización aplicación en mercado libre](https://www.billmysales.com/img/apps/datasources/mercadolibre/mensaje-de-autorizacion-aplicacion-en-mercado-libre.png) 5. Finalmente serás redirigido a la cuenta de BillMySales donde se mostrarán los datos de la conexión ![Datos de conexión Mercado Libre y BillMySales](https://www.billmysales.com/img/apps/datasources/mercadolibre/datos-de-conexion-mercado-libre-y-billmysales.png) **Importante**: el token es actualizado automáticamente por el sistema. Realizando esto, la conexión entre Mercado Libre y BillMySales se encontraría lista. --- ## Multivende Multivende # Multivende --- ### Configuración inicial Configuración de Multivende # Configuración de Multivende En esta sección se explican los pasos para configurar la pasarela de facturación de Multivende. > [!INFO] Recuperación de órdenes > > Esta integración recupera las órdenes mediante **webhook** y **sondeo**. ## Requisitos 1. Tener cuenta en Multivende con cualquier plan de pago. 2. Tener cuenta en BillMySales con cualquier plan, incluyendo gratuito. - Si requiere usar sondeo [necesitará un plan que lo permita](https://www.billmysales.com/#pricing). 3. Crear pasarela usando el origen Multivende y el facturador de su elección. --- ## Configuración básica de pasarela de facturación Realizando esta configuración la integración permitirá recibir notificaciones del pago de tus pedidos y se generarán boletas y facturas electrónicas. Para realizar la conexión de Multivende con BillMySales debes ingresar a la cuenta de administrador de: - **Multivende:** https://app.multivende.com/developers/login - **BillMySales:** https://billmysales.com/signin **1. Dirigirse a Origen de datos** Una vez en BillMySales debes dirigirte a la pasarela de facturación de Multivende y seleccionamos "Origen de datos": ![Pestañas de configuración](https://www.billmysales.com/img/content/docs/datasources/multivende/manual/bms_multi_01.png) **2. Guardar los cambios** Para poder realizar la activación de la aplicación debes ir al final de la página y hacer clic en "Guardar los cambios": ![Guardar cambios](https://www.billmysales.com/img/content/docs/datasources/multivende/manual/bms_multi_02.png) **3. Conectar BillMySales con Multivende** Completado el paso anterior, debes ir al campo "Datos de conexión" y hacer clic en "Conectar BillMySales con Multivende": ![Datos de conexión](https://www.billmysales.com/img/content/docs/datasources/multivende/manual/bms_multi_03.png) **4. Aceptar la aplicación en Multivende** Esto te va a dirigir a tu cuenta de administrador de la tienda en Multivende y deberás aceptar la aplicación para que pueda enviar la información proporcionada: ![Autorizar acceso en Multivende](https://www.billmysales.com/img/content/docs/datasources/multivende/manual/bms_multi_04.png) **5. Guardar en Multivende** Luego seleccionar "Guardar": ![Guardar en Multivende](https://www.billmysales.com/img/content/docs/datasources/multivende/manual/bms_multi_05.png) **6. Verificar datos de conexión** Una vez realizado lo anterior serás redirigido desde Multivende a BillMySales y en la pestaña "Origen de datos" se visualizarán los datos de conexión de la empresa con la aplicación: ![Datos de conexión completados](https://www.billmysales.com/img/content/docs/datasources/multivende/manual/bms_multi_06.png) **7. Activar la pasarela** Como paso final debes dirigirte a la pestaña "General" para activar la pasarela: ![Activar pasarela](https://www.billmysales.com/img/content/docs/datasources/multivende/manual/bms_multi_07.png) **8. Guardar cambios finales** Y guardar los datos en el botón "Guardar cambios": ![Guardar cambios finales](https://www.billmysales.com/img/content/docs/datasources/multivende/manual/bms_multi_08.png) Al terminar quedará activa y completamente funcional la aplicación. --- ### Configuración de tipo de precio Configuración de tipo de precio # Configuración de tipo de precio En Multivende sus precios se deben configurar como "Usar siempre precios afectos, el origen de datos envía montos brutos", esto es debido a que por el momento es la configuración integrada. Esta opción la debes configurar en la pestaña "Facturador" campo "Configuración de precios en el origen de datos" de la pasarela de facturación: ![Configuración de precios](https://www.billmysales.com/img/content/docs/datasources/multivende/manual/bms_multi_09.png) --- ### Configuración para enviar el PDF de un DTE a Multivende ## Configuración para enviar el PDF del documento a Multivende ### Configuración para enviar el PDF del documento a Multivende Para enviar el PDF del documento emitido es necesario crear un emisor en Multivende. **1. Acceder a Documentos Tributarios Electrónicos** Para crear el emisor de documentos debes ingresar a "Configuración" y a "Documentos Tributarios Electrónicos" en Multivende: ![Configuración DTE](https://www.billmysales.com/img/content/docs/datasources/multivende/manual/bms_multi_10.png) **2. Configurar emisores** Posterior a esto en "Emisores de documentos" debes seleccionar "Configurar": ![Configurar emisores](https://www.billmysales.com/img/content/docs/datasources/multivende/manual/bms_multi_11.png) **3. Crear nuevo emisor** Luego ingresar a la opción de "Crear": ![Crear emisor](https://www.billmysales.com/img/content/docs/datasources/multivende/manual/bms_multi_12.png) **4. Completar formulario** En esta página debes completar el siguiente formulario con los datos de tu empresa. El campo del código se debe completar con **01111**, finalmente se presiona el botón **Guardar**: ![Formulario de emisor](https://www.billmysales.com/img/content/docs/datasources/multivende/manual/bms_multi_13.png) --- ### Configurar emisor de documentos en BillMySales **1. Obtener identificador del emisor** Para configurar el emisor en BillMySales se debe obtener el identificador del emisor de DTEs. Para esto debes seleccionar el emisor creado en Multivende desde el listado "Emisores de Documentos": ![Seleccionar emisor](https://www.billmysales.com/img/content/docs/datasources/multivende/manual/bms_multi_14.png) **2. Localizar URL del emisor** Luego, en la parte superior del navegador encontrarás la URL del sitio, esto lo verás como en la siguiente imagen: ![URL completa](https://www.billmysales.com/img/content/docs/datasources/multivende/manual/bms_multi_15.png) **3. Copiar código del emisor** Localizada la URL la debes copiar el código del "Emisor de Documentos" este se encuentra en la siguiente sección de la URL: ![Código del emisor](https://www.billmysales.com/img/content/docs/datasources/multivende/manual/bms_multi_16.png) **4. Acceder a Origen de datos en BillMySales** Este código debe ser pegado en la pestaña "Origen de datos" configuración de la pasarela en BillMySales: ![Pestaña Origen de datos](https://www.billmysales.com/img/content/docs/datasources/multivende/manual/bms_multi_17.png) **5. Pegar código en Emisores de DTEs** Luego en el campo "Emisores de DTEs" se debe pegar el código previamente copiado: ![Campo Emisor de DTEs](https://www.billmysales.com/img/content/docs/datasources/multivende/manual/bms_multi_18.png) **6. Guardar cambios** Finalmente, este cambio debe ser guardado presionando el botón "Guardar cambios": ![Guardar cambios](https://www.billmysales.com/img/content/docs/datasources/multivende/manual/bms_multi_19.png) --- ## Odoo Odoo # Odoo --- ### Configuración inicial Configuración de Odoo como origen de de datos # Configuración de Odoo como origen de de datos En esta sección se explicarán los pasos para realizar la configuración de la pasarela de facturación de Odoo como origen de datos. > [!INFO] Recuperación de órdenes > > Esta integración recupera las órdenes mediante **sondeo**. ## Requisitos 1. Tener cuenta en Odoo con la versión Enterprise o Comunidad. 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 usando el origen Odoo y el facturador de su elección. > [!NOTE] Nota > > La configuración que se explicará es una configuración por defecto que sólo 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 de la pasarela Realizando esta configuración, la integración permitirá emitir boletas 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 configurar los datos de conexión: ![Pestaña origen de datos con Odoo](https://www.billmysales.com/img/content/docs/datasources/odoo/pestana_origen_de_datos_con_odoo.png) **1. URL del sistema 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/datasources/odoo/odoo_01.png) **2. Base de datos** Para obtener en 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/datasources/odoo/odoo_02.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/datasources/odoo/odoo_03.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/datasources/odoo/odoo_04.png) **3. Correo electrónico de tu usuario en Odoo** Indica el correo del usuario de Odoo. El usuario debe tener acceso a los siguientes módulos de Odoo: - **Ventas**: permiso de mostrar documentos. - **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/datasources/odoo/odoo_05.png) **4. Clave 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/datasources/odoo/odoo_06.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/datasources/odoo/odoo_07.png) 3. Deberás ingresar la contraseña de tu usuario. ![Ingresar clave de usuario en Odoo](https://www.billmysales.com/img/content/docs/datasources/odoo/odoo_08.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/datasources/odoo/odoo_09.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/datasources/odoo/odoo_10.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/datasources/odoo/odoo_11.png) **5. Origen de las órdenes** Define la aplicación desde la cual se obtendrán las órdenes provenientes de Odoo. Existen 2 aplicaciones disponibles: 1. **Ventas**: por pedido de venta o presupuesto confirmado. 2. **Contabilidad**: por factura validada. ![¿Qué aplicación usará para capturar las órdenes?](https://www.billmysales.com/img/content/docs/datasources/odoo/odoo_12.png) **6. 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 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) Realizando estos 6 pasos de la configuración inicial, la conexión entre Odoo y BillMySales quedará lista. --- ## Planyo Planyo # Planyo --- ### Configuración inicial Configuración de Planyo # Configuración de Planyo En esta sección se explicarán los pasos para realizar la configuración de la pasarela de facturación de **Planyo** como origen de datos. > [!INFO] Recuperación de órdenes > > Esta integración recupera las órdenes mediante **webhook**. ## Requisitos 1. Tener cuenta en Planyo. 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 usando el origen de datos Planyo y el facturador de su elección. > [!NOTE] Nota > > La configuración que se explicará es una configuración por defecto que sólo 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, primero debes ingresar 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 dirigirte al final de la pagina para guardar la configuración haciendo clic en el botón **Guardar cambios**: ![Pestaña origen de datos con Planyo](https://www.billmysales.com/img/content/docs/datasources/planyo/pestana_origen_de_datos_con_planyo.png) ![Botón para guardar los cambios](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_07.png) Luego de guardar la configuración en BillMySales, debes ingresar a tu cuenta de Planyo donde deberás crear el Webhook siguiendo los siguientes pasos: 1. Dirigete al menú que se encuentra en el costado izquierdo de la cuenta e ingresa a la sección **Propiedades del sitio**, luego haz clic en la opción **Configuraciones de notificación (Correo electrónico/SMS)**: ![Configuraciones del sitio en Planyo](https://www.billmysales.com/img/content/docs/datasources/planyo/configuraciones-del-sitio-en-planyo.png) 2. Una vez estés dentro de la configuración de las notificaciones ve al final de la pagina y en la sección **Otra** e ingresa a **Notificación de seguimiento**: ![Configuraciones de las notificaciones](https://www.billmysales.com/img/content/docs/datasources/planyo/configuraciones-de-las-notificaciones.png) 3. Dentro de esta pagina deberás configurar el campo **Pago recibido** ![Configuración de la URL en Planyo](https://www.billmysales.com/img/content/docs/datasources/planyo/configuracion-de-la-url-en-planyo.png) Este campo lo debes completar con la **URL del Webhook que obtienes desde BillMySales** ingresando a la configuración de la [pasarela de facturación](https://app.billmysales.com/billing_gateways), en la pestaña **Webhook** ![Pestaña Webhook en BillMySales](https://www.billmysales.com/img/content/docs/datasources/planyo/pestana-webhook-en-billmysales.png) 4. Copia la URL completa entregada por BillMySales y pegala en el campo **Pago recibido** de la configuración de Planyo y adicionalmente añade el siguiente texto al final del webhook para que los datos sean enviados de manera correcta a BillMySales: `?ppp_payload=json` La URL deberá quedar de la siguiente manera en Planyo: ![Webhook configurado en Planyo](https://www.billmysales.com/img/content/docs/datasources/planyo/webhook-configrado-en-planyo.png) Para finalizar la configuración, dirigiete al final de la pagina y haz clic en el botón **Actualizar** ![Botón de actualizar en Planyo](https://www.billmysales.com/img/content/docs/datasources/planyo/boton_de_actualizar_en_planyo.png) --- ## PrestaShop PrestaShop # PrestaShop --- ### Configuración inicial Configuración de PrestaShop # Configuración de PrestaShop En esta sección se explican los pasos para configurar la pasarela de facturación de PrestaShop. > [!INFO] Recuperación de órdenes > > Esta integración recupera las órdenes mediante **webhook**. ## Requisitos 1. Tener cuenta en PrestaShop con cualquier plan de pago. 2. Tener cuenta en BillMySales con cualquier plan, incluyendo gratuito. - Si requiere usar sondeo [necesitará un plan que lo permita](https://www.billmysales.com/#pricing). 3. Crear pasarela usando el origen PrestaShop y el facturador de su elección. --- ## Configuración básica de pasarela de facturación > [!NOTE] Importante > >Esta integración momentáneamente solo permite generar boletas. En caso de que se necesite generar una factura, el usuario puede definir campos obligatorios con los datos que una factura requiera. **1. Acceder al Gestor de módulo** Para realizar la conexión de Prestashop con BillMySales debes ingresar a la cuenta de administrador en tu tienda y dirigirte a "Gestor de módulo": ![Gestor de módulo en Prestashop](https://www.billmysales.com/img/content/docs/datasources/prestashop/manual/bms_presta_01.png) **2. Subir un módulo** Dentro de Gestor de módulo encontrarás un campo llamado "Subir un módulo": ![Subir un módulo](https://www.billmysales.com/img/content/docs/datasources/prestashop/manual/bms_presta_02.png) **3. Descargar el módulo** Debes descargar el módulo desde el siguiente enlace proporcionado por BillMySales. **4. Subir el módulo descargado** Una vez descargado, deberás subir el módulo descargado. **5. Buscar el módulo en Administración** Una vez subas el módulo hay que realizar la configuración del módulo para esto se debe buscar el módulo en la sección de "Administración", donde será encontrado con el nombre de "BillMySales": ![Módulo BillMySales en Administración](https://www.billmysales.com/img/content/docs/datasources/prestashop/manual/bms_presta_03.png) **6. Configurar el módulo** Para poder configurar el módulo se debe configurar: ![Opciones de configuración del módulo](https://www.billmysales.com/img/content/docs/datasources/prestashop/manual/bms_presta_04.png) **6.1 Webhook de notificaciones** La URL se obtiene en la pestaña "Webhook" de la pasarela de facturación en BillMySales. **6.2 Token del webhook** El token se obtiene en la pestaña "Origen de datos" campo "Clave secreta" de la pasarela de facturación en BillMySales. Puedes crear uno personalizado, sin embargo tiene que ser el mismo de BillMySales. **7. Activar el módulo** Al terminar quedará activo y completamente funcional el módulo. --- ### Configuración de tipo de precio Configuración de tipo de precio # Configuración de tipo de precio El tipo de precio lo debes configurar en la configuración de la pasarela en BillMySales en la pestaña "Facturador" campo "Configuración de precios en el origen de datos" de la pasarela de facturación. ![Configuración de precios](https://www.billmysales.com/img/content/docs/datasources/prestashop/manual/bms_presta_05.png) --- ## Reveniu Reveniu # Reveniu --- ### Configuración inicial Configuración de Reveniu # Configuración de Reveniu En esta sección se explicarán los pasos para realizar la configuración de la pasarela de facturación de **Reveniu** como origen de datos. > [!INFO] Recuperación de órdenes > > Esta integración recupera las órdenes mediante **webhook**. ## Requisitos 1. Tener cuenta en Reveniu. 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 usando el origen de datos Reveniu y el facturador de su elección. > [!NOTE] Nota > > La configuración que se explicará es una configuración por defecto que sólo 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 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 Reveniu](https://www.billmysales.com/img/content/docs/datasources/reveniu/pestana_origen_de_datos_con_reveniu.png) **1. Configura la API Key** ![Datos de conexión de Reveniu en BIllMySales](https://www.billmysales.com/img/content/docs/datasources/reveniu/datos_de_conexion_de_reveniu_en_billmysales.png) Para configurar la API Key de Reveniu en BillMySales debes: 1. Ingresar a tu cuenta de Reveniu en la sección de **Configuración** y hacer clic en la opción de **API**: ![Sección de configuración en Reveniu](https://www.billmysales.com/img/apps/datasources/reveniu/seccion-de-configuracion-en-reveniu.png) 2. Una vez estés dentro de la configuración de la API encontrarás la opción para crear la API Key. Para crearla debes hacer clic en el botón **Generar nueva API Key** ![Crear API Key reveniu](https://www.billmysales.com/img/apps/datasources/reveniu/crear-api-key-reveniu.png) 3. Te solicitará confirmar la creación de la nueva API Key: ![Confirmar creación de nueva API Key](https://www.billmysales.com/img/apps/datasources/reveniu/confirmar-creacion-de-nueva-api-key.png) 4. Una vez creada, se mostrará de la siguiente manera: ![API Key creada](https://www.billmysales.com/img/apps/datasources/reveniu/api-key-creada.png) 5. Debes hacer clic en el botón **Copiar secret key** y dirigirte a la pasarela de facturación en BillMySales y pegarla en el campo **API Key** de los datos de conexión: ![API Key configurada en BillMySales](https://www.billmysales.com/img/apps/datasources/reveniu/api-key-configurada-en-billmysales.png) **2. Opciones de la orden** Define la zona horaria en BillMySales con la que se mostrarán las órdenes, por ejemplo: ![Configurar zona horaria](https://www.billmysales.com/img/apps/datasources/reveniu/configurar-zona-horaria.png) Finalmente, dirígete al final de la página 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) --- ## Seller Center Seller Center # Seller Center --- ### Configuración inicial Configuración de Seller Center # Configuración de Seller Center En esta sección se explicarán los pasos para realizar la configuración de la pasarela de facturación de **Seller Center** como origen de datos. > [!INFO] Recuperación de órdenes > > Esta integración recupera las órdenes mediante **webhook** y **sondeo**. ## Requisitos 1. Tener cuenta en Seller Center. 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 usando el origen de datos Seller Center y el facturador de su elección. > [!NOTE] Nota > > La configuración que se explicará es una configuración por defecto que sólo 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 Seller Center](https://www.billmysales.com/img/content/docs/datasources/sellercenter/pestana_origen_de_datos_con_seller_center.png) **1. Datos de conexión** Para poder realizar la conexión, BillMySales solicita la **URL API**, el **Usuario** y **Clave** de las credenciales de la API de Seller Center. Para poder obtener las credenciales debes ingresar a tu cuenta de Seller Center y seguir los siguientes pasos: 1. Haz clic en la sección **Mi cuenta** que se encuentra en la esquina superior derecha de la pantalla e ingresa a la opción **Integraciones**: ![Sección de Integraciones en seller center](https://www.billmysales.com/img/content/docs/datasources/sellercenter/seccion-de-integraciones-en-seller-center.png) 2. Dentro de esta página encontrarás una sección llamada **API Explorer** donde encontrarás los 3 datos requeridos por BillMySales para realizar la conexión. ![Datos de conexión en seller center](https://www.billmysales.com/img/content/docs/datasources/sellercenter/datos-de-conexion-en-seller-center.png) 3. Copia la información de Seller Center y pégala en BillMySales de la siguiente manera: - **API URL**: corresponde al campo ***URL API*** de BillMySales. - **User ID**: corresponde al campo ***Usuario*** de BillMySales. - **API Key**: corresponde al campo ***Clave*** de BillMySales. **2. Configuración de la región** Define el país de la tienda. Por el momento solo está disponible Chile. Una vez completada la configuración, dirígete al final de la página en BillMySales y guarda la configuración haciendo clic en el botón **Guardar cambios**. --- ## Shopify Shopify # Shopify --- ### Configuración inicial Configuración de Shopify # Configuración de Shopify En esta sección se explican los pasos para configurar la pasarela de facturación de Shopify. > [!INFO] Recuperación de órdenes > > Esta integración recupera las órdenes mediante **webhook** y **sondeo**. ## Requisistos 1. Tener cuenta en Shopify con cualquier plan de pago. 2. Tener cuenta en BillMySales con cualquier plan, incluyendo gratuito. A. Si requiere usar sondeo necesitará un plan que lo permita. (https://www.billmysales.com/#pricing) 3. Crear pasarela usando el origen Shopify y el facturador de su elección. ## Configuración básica de pasarela de facturación Realizando esta configuración la integración permitirá recibir notificaciones del pago de tus pedidos y se generarán boletas no nominativas por defecto. 1. Para realizar la conexión de Shopify con BillMySales debes ingresar a la cuenta de administrador en tu tienda y dirigirte a "Configuración" que se encuentra en el costado izquierdo de la página: ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_01.png) 2. Dentro de **Configuración** debes ingresar a **Notificaciones** ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_02.png) 3. Debes ingresar en **“Webhooks”** hacer clic en **"Crear webhook"**: ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_03.png) 4. En esta ventana se deben completar los campos con los siguientes datos: a. Evento: "Orden de pago" o "Pago de pedido". b. URL: La URL se obtiene en la pestaña "Webhook" de la pasarela de facturación en BillMySales. c. Formato: Json. d. Versión de la API de Webhooks: Se selecciona la última versión que tenga disponible Shopify. Una vez completados estos datos debes hacer clic en "Guardar" como se muestra en la siguiente imagen: ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_04.png) 5. Una vez creado el Webhook, en esa misma página se indica una clave secreta propia de la tienda. ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_05.png) 6. Esta clave secreta debe ser añadida en BillMySales en la configuración de la pasarela en la pestaña **"Origen de datos"** campo **"Clave secreta"**: ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_06.png) 7. Finalmente se debe guardar la configuración al final de la página en **"Guardar cambios"**: ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_07.png) --- ### Configuración del sondeo Configuración del Sondeo # Configuración del Sondeo El sondeo permite obtener las órdenes desde Shopify, esto con el objetivo de facturar aquellas órdenes que no han sido recibidas por BillMySales. ## ¿Cómo configurar el sondeo? Para poder configurar el sondeo de órdenes debes: 1. Ingresar a la tienda como de Shopify e ir a Ajustes. ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_34.png) 2. Lo anterior abrirá la página de ajuste de Shopify, aquí debes seleccionar: **Aplicaciones y canales de Ventas** ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_35.png) 3. Luego presionar en Desarrollar aplicaciones. ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_36.png) 4. Permitimos el desarrollo de aplicaciones en Permitir el desarrollo de aplicaciones personalizadas. ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_37.png) 5. Con esto podremos crear la Aplicación en Crear aplicación. ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_38.png) 6. Completamos los campos Nombre de la aplicación y Desarrollador de aplicaciones. ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_39.png) Posterior a esto presionamos en Crear aplicación. 7. Ingresamos a Configurar los ámbitos de la API de administración. ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_40.png) 8. Seleccionamos los siguientes accesos a la aplicación y luego presionamos en Guardar. ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_41.png) 9. Nos dirigimos a Credenciales API y luego presionamos en Instalar aplicación. ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_42.png) 10. Al instalar la aplicación podremos obtener el Token de acceso, presionamos Revelar token una vez. Este Token solo se puede ver una sola vez, debe almacenarlo para poder utilizarlo en BillMySales. ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_43.png) 11. Ahora guardamos el Token en BillMySales en el campo API Token. ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_44.png) 12. Ahora debemos configurar el Código de la tienda. El cual se obtiene desde la URL de la página de administración de Shopify. ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_45.png) 13. Identificado el código, lo almacenamos en BillMySales en el campo Código de la tienda. ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_46.png) 14. Finalmente, nos dirigimos al final de la página de configuración de BillMySales y presionamos en Guardar cambios. --- ### Configuración de tipos de documentos # Configuración para emitir boletas y facturas ## Configuración para emitir boletas y facturas **Esta configuración es opcional.** Para poder emitir estos tipos de documentos actualmente existen 2 opciones: ## Configurar campos de Shopify En esta opción se utilizarán los campos **"Company"** y **"Address line 2"**, los cuales se modificarán y harán referencia al RUT y al Giro, para esto, se debe: 1. Ingresar en el administrador de la tienda en Shopify y luego ir a **"Configuración"** que se encuentra el costado izquierdo de la página: ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_08.png) 2. Dentro de Settings ingresar a **"Pantalla de pago"**: ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_09.png) 3. En la sección de Checkout ir a "Información del cliente", y configurar los campos "Nombre de la empresa" y "Línea 2 de dirección" seleccionados de la siguiente manera: - Company name: (RUT) ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_10.png) Nota: Si deseas que el cliente siempre tenga que añadir el RUT, este campo se puede seleccionar cómo requerido. - Address line 2: (Giro) ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_11.png) Nota: Si deseas que el cliente siempre tenga que añadir el Giro, este campo se puede seleccionar como requerido, esto sólo si tus clientes recibirán facturas en su mayoría. 4. Luego se debe guardar en la opción de "Guardar" que se encuentra en la parte superior de la página. 5. En la misma página debes ir al final donde te encontrarás con la sección "Idioma de la pantalla de pago" y debes ingresar la opción "Gestionar idioma de pantalla de pago". ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_12.png) 6. Dentro de de esta página te encontrarás con la siguiente sección de “Checkout contact” 7. En la cual debes editar los siguientes campos de la siguiente manera: a. Company label: RUT </br> b. Optional company label: RUT</br> c. Address2 label: Giro (sólo para factura)</br> d. Optional address2 label: Giro (sólo para factura)</br> ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_13.png) Estos campos pueden ser personalizables, mientras se haga referencia a la función que cumple cada uno. 8. Luego se debe guardar en la opción de "Guardar" que se encuentra en la parte superior de la página. 9. Ahora debes ir a la pasarela de facturación de Shopify en BillMySales e ingresar a la pestaña **Origen de datos** ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_14.png) 10. Luego ir a "Campos del cliente" y los siguientes campos se debe modificar como se muestra en la siguiente imagen: ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_15.png) ◦ Identificador fiscal: billing_address.company ◦ Actividad económica: billing_address.address2 11. Finalmente guardar la configuración al final de la página en "Guardar cambios". > [!NOTE] Nota > >Si deseas que al cliente se le emita una factura debes ir a la pestaña "Facturador" y en los "Comportamientos personalizables" y activar la opción "Generar factura si los datos del receptor tienen: RUT, razón social, giro, dirección y comuna.": ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_16.png) > [!NOTE] Importante > > Este campo sólo se debe seleccionar si deseas que tu cliente al añadir esos datos en la compra se le emita una factura. En el caso de no activarlo, se va a emitir una boleta, aunque se encuentren los campos añadidos. ## Configurar modificando la plantilla de la tienda > [!NOTE] Importante > >Hay casos en los que puede que esta opción no funcione si utilizan plantillas o aplicaciones externas ya que algunas de estas sobrescriben los datos enviados desde Shopify. Con esta opción deberán añadir un código a la configuración de tu tienda para que el cliente pueda elegir factura o boleta electrónica. Para esto debes: 1. En tu tienda de Shopify ingresar a "Tienda online" y luego a "Temas". ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_17.png) 2. Dentro de temas dirigirte al icono de los tres puntos y seleccionar "Editar código". ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_18.png) 3. En Edit code, debes buscar una carpeta llamada "Secciones" y seleccionarla para visualizar los campos. ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_19.png) 4. Dentro de la carpeta ya seleccionada debes buscar un campo llamado "main-cart-item.liquid". ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_20.png) 5. Luego ingresar al campo indicado donde debes descargar y pegar uno de los códigos que se encuentra en el siguiente enlace. [Descarga los códigos aquí.](https://drive.google.com/drive/folders/1YUnmFDh9uoWE7Uc829koWGqLbzb_IBZa) 6. El código llamado "shopifybillmysalesradiobox.txt" permite que la opción de "Boleta o Factura" el cliente la pueda seleccionar con un botón. 7. Este código debe ser añadido como las instrucciones lo indican abajo de "form action", tal como se indica en la siguiente imagen: ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_21.png) 8. Una vez terminado ya se podrían emitir boletas nominativas o facturas de las ventas que se realicen en la tienda. --- ### Configuración de tipo de precio ¿Cómo configuro el tipo de precio en BillMySales? # ¿Cómo configuro el tipo de precio en BillMySales? En Shopify sus precios se pueden configurar con precios brutos y netos, dependiendo de la configuración del impuesto de tu cuenta, es decir, puede utilizar las siguientes opciones en BillMySales: Esta opción la debes configurar en la pestaña "Facturador" campo "Configuración de precios en el origen de datos" de la pasarela de facturación. ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_22.png) La configuración para definir en BillMySales si quieres que tus precios sean "Precios configurados para items afectos y exentos, el origen de datos envía los montos neto", es la siguiente: ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_23.png) Esto quiere decir que en los precios que le asignes a tus productos no incluirán el impuesto, si no que será sumado al producto en el momento de la compra, por ejemplo: * Precio asignado en producto: ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_24.png) * Precio compra del producto: ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_25.png) Se incluirá en caso de Chile, el impuesto de un 19%, esto dependerá de tu país o región. La configuración para definir en BillMySales si quieres que tus precios sean "Precios configurados para items afectos y exentos, el origen de datos envía montos brutos", es la siguiente: ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_26.png) Esto quiere decir que en los precios que le asignes a tus productos incluirán el impuesto, es decir, el impuesto ya se encuentra sumado al producto en el momento de la compra, por ejemplo: Precio asignado en producto: Precio compra del producto: ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_27.png) Donde nos indica que el impuesto correspondiente ya está incluido en el precio. --- ### Identificar si el item es afecto o exento ¿Cómo identificar si el ítem es afecto o exento? # ¿Cómo identificar si el ítem es afecto o exento? Para identificar si la orden es afecta o exenta se debe ingresar en el listado de órdenes e ingresar a la orden que desea revisar, luego en el historial ir al campo “Datos recibidos” donde podrá ver el JSON de la orden con los datos que envía Jumpseller para generar el documento. #### **Caso afecto** El índice taxable debe tener un valor True además, en el índice tax_lines debe venir la información relacionada con el impuesto. ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_29.png) #### **Caso exento** El índice taxable debe tener un valor False además, el índice tax_lines debe estar vacío. ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_30.png) ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_31.png) #### **Orden afecta con valores netos** Para identificar si la orden afecta es neta se debe revisar el índice taxes_included. Si el valor de este campo es False indica que los valores son netos. ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_32.png) #### **Orden afecta con valores brutos** Para identificar si la orden afecta es neta se debe revisar el índice taxes_included. Si el valor de este campo es True indica que los valores son brutos. ![Manual Shopify](https://www.billmysales.com/img/content/docs/datasources/shopify/manual/bms_shopify_33.png) --- ## WooCommerce WooCommerce # WooCommerce --- ### Configuración inicial Configuración de WooCommerce # Configuración de WooCommerce En esta sección se explican los pasos para configurar la pasarela de facturación de WooCommerce. > [!INFO] Recuperación de órdenes > > Esta integración recupera las órdenes mediante **webhook**. ## Requisitos 1. Tener cuenta en WooCommerce con cualquier plan de pago. 2. Tener cuenta en BillMySales con cualquier plan, incluyendo gratuito. - Si requiere usar sondeo [necesitará un plan que lo permita](https://www.billmysales.com/#pricing). 3. Crear pasarela usando el origen WooCommerce y el facturador de su elección. --- ## Configuración básica de pasarela de facturación Realizando esta configuración la integración permitirá recibir notificaciones del pago de tus pedidos y se generarán boletas no nominativas por defecto. **1. Acceder a Ajustes de WooCommerce** Para realizar la conexión de Woocommerce con BillMySales debes ingresar a la cuenta de administrador en tu tienda de Woocommerce y dirigirte a ajustes: ![Menú de ajustes en WooCommerce](https://www.billmysales.com/img/content/docs/datasources/woocommerce/manual/bms_woo_01.png) **2. Acceder a la sección Avanzado** Dentro de ajustes encontrarás un campo llamado "Avanzado", el cual permite añadir y personalizar un Webhook para nuestra tienda: ![Sección Avanzado](https://www.billmysales.com/img/content/docs/datasources/woocommerce/manual/bms_woo_02.png) **3. Dirigirse a Webhooks** Debes dirigirte a la opción "Webhooks": ![Opción Webhooks](https://www.billmysales.com/img/content/docs/datasources/woocommerce/manual/bms_woo_03.png) **4. Añadir Webhook** Y seleccionar la opción "Añadir Webhook": ![Añadir Webhook](https://www.billmysales.com/img/content/docs/datasources/woocommerce/manual/bms_woo_04.png) **5. Configurar el Webhook** Dentro del campo procedemos a crear el Webhook el cual se hará completando los campos de la siguiente manera: - **Nombre:** BillMySales - **Estado:** Activo - **Tema:** "Procesado" (recomendado) o "Pedido actualizado" - **URL de entrega:** Este campo lo obtienes en la configuración de la pasarela en BillMySales en la pestaña "Webhook": ![URL del webhook en BillMySales](https://www.billmysales.com/img/content/docs/datasources/woocommerce/manual/bms_woo_05.png) - **Secreto:** Este campo lo obtienes en la configuración de la pasarela en BillMySales en la pestaña "Origen de datos": ![Clave secreta en origen de datos](https://www.billmysales.com/img/content/docs/datasources/woocommerce/manual/bms_woo_06.png) **6. Activar la pasarela en BillMySales** Para poder guardar el Webhook en Woocommerce primero se debe activar la pasarela de facturación en BillMySales en la pestaña "General": ![Pestañas de configuración](https://www.billmysales.com/img/content/docs/datasources/woocommerce/manual/bms_woo_07.png) ![Activar pasarela](https://www.billmysales.com/img/content/docs/datasources/woocommerce/manual/bms_woo_08.png) **7. Guardar el Webhook** Una vez realizado esto se puede guardar el webhook creado en la tienda y quedará completamente funcional: ![Guardar webhook](https://www.billmysales.com/img/content/docs/datasources/woocommerce/manual/bms_woo_09.png) --- ### Configuración de tipos de documentos Configuración para facturas y boletas # Configuración para facturas y boletas **Importante:** Hay casos en los que puede que esta opción no funcione si utilizan plantillas o aplicaciones externas ya que algunas de estas sobrescriben los datos enviados desde WooCommerce. Para emitir estos dos tipos de documentos, se deben agregar ciertos campos al checkout de la tienda electrónica. **1. Acceder a Plugins** En tu cuenta de administrador de WooCommerce, debes ingresar a "Plugins", en esta opción nos dirigimos a "Agregar nuevo": ![Agregar nuevo plugin](https://www.billmysales.com/img/content/docs/datasources/woocommerce/manual/bms_woo_10.png) **2. Buscar Code Snippets** Dentro de esta opción debes buscar lo siguiente "Code Snippets": ![Buscar Code Snippets](https://www.billmysales.com/img/content/docs/datasources/woocommerce/manual/bms_woo_11.png) **3. Instalar y activar Code Snippets** Luego debes instalar y activar la siguiente aplicación: ![Instalar y activar Code Snippets](https://www.billmysales.com/img/content/docs/datasources/woocommerce/manual/bms_woo_12.png) **PD:** En caso que al estar instalando el plugins "Code Snippets" arroja "Instalación fallida" es altamente probable que se deba a que el usuario no cuente con los permisos correspondiente, debe asignar el permiso correspondiente y volver a instalar. ![Instalación fallida](https://www.billmysales.com/img/content/docs/datasources/woocommerce/manual/bms_woo_13.png) **4. Ir a Plugins instalados** Una vez ya instalado y activo, te debes dirigir a la opción de "Plugins instalados": ![Plugins instalados](https://www.billmysales.com/img/content/docs/datasources/woocommerce/manual/bms_woo_14.png) **5. Acceder a Snippets** En esta opción se debe buscar la aplicación recientemente instalada como "Code Snippets", en la cual debes ingresar a "Snippets": ![Acceder a Snippets](https://www.billmysales.com/img/content/docs/datasources/woocommerce/manual/bms_woo_15.png) **6. Añadir nuevo Snippet** Dentro de Snippets seleccionar la opción "Add New": ![Add New Snippet](https://www.billmysales.com/img/content/docs/datasources/woocommerce/manual/bms_woo_16.png) **7. Ingresar el código** Al ingresar a esta opción se debe ingresar el código se descarga del [siguiente enlace](https://www.billmysales.com/apps/datasources/woocommerce) y debería quedar la la siguiente manera: ![Código del snippet](https://www.billmysales.com/img/content/docs/datasources/woocommerce/manual/bms_woo_17.png) **8. Guardar y activar** Finalmente guardar y activar el código al final de esta página. Ya realizados los pasos quedaría habilitada la tienda para que se puedan emitir boletas nominativas (con RUT) y facturas electrónicas. --- ### Configuración de tipo de precio # ¿Cómo identificar si el ítem es afecto o exento? ## ¿Cómo identificar si el ítem es afecto o exento? Para identificar si la orden es afecta o exenta se debe ingresar en el [listado de órdenes](https://www.billmysales.com/apps/datasources/woocommerce) e ingresar a la orden que desea revisar, luego en el historial ir al campo "Datos recibidos" donde podrá ver el JSON de la orden con los datos que envía WooCommerce para generar el documento. **Caso afecto** El índice tax debe tener un valor distinto de cero además, en el índice taxes debe venir la información relacionada con el impuesto, por ejemplo: ![Ejemplo caso afecto](https://www.billmysales.com/img/content/docs/datasources/woocommerce/manual/bms_woo_20.png) **Caso exento** El índice tax debe tener un valor cero además, el índice taxes debe estar vacío, por ejemplo: ![Ejemplo caso exento](https://www.billmysales.com/img/content/docs/datasources/woocommerce/manual/bms_woo_21.png) --- ## Configuración de tipo de precio En WooCommerce sus precios se deben configurar con precios netos, esto es debido a que este e-commerce trabaja sus precios solamente con valores netos, es decir se pueden utilizar las siguientes opciones en BillMySales: - 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 netos. Esto se modifica en la configuración de la pasarela en la pestaña "Facturador": ![Configuración de precios](https://www.billmysales.com/img/content/docs/datasources/woocommerce/manual/bms_woo_18.png) **Importante:** Esta configuración es válida cuando en tu cuenta de WooCommerce tienes una configuración de impuestos. Por ejemplo: ![Opciones de impuestos en WooCommerce](https://www.billmysales.com/img/content/docs/datasources/woocommerce/manual/bms_woo_19.png) --- ### ¿Cómo actualizar estados de ordenes masivamente? ¿Cómo actualizar estados de ordenes masivamente? # ¿Cómo actualizar estados de ordenes masivamente? El actualizar el estado de órdenes en WooCommerce permite facturar órdenes que no fueron facturadas por algún problema. Para poder hacer esto debe: 1. Ingresar al listado de órdenes y marcar las órdenes que desea facturar. 2. Posterior a esto en la sección "Acciones en lote" puede elegir el estado de las órdenes: ![Imagen](https://www.billmysales.com/img/content/docs/datasources/woocommerce/como-actualizar-estados-de-ordenes-masivamente/como-actualizar-estados-de-ordenes-masivamente-1.png) > [!NOTE] Importante > >Los siguientes son estados de ejemplo, pero podrían variar en cada caso. ![Imagen](https://www.billmysales.com/img/content/docs/datasources/woocommerce/como-actualizar-estados-de-ordenes-masivamente/como-actualizar-estados-de-ordenes-masivamente-2.png) 3. Debe seleccionar un estado previo al que genera el documento y aplicar los cambios. 4. Finalmente debe volver a realizar la acción anterior pero con el estado final del pedido para que las órdenes se facturen. --- ## ZohoBooks ZohoBooks # ZohoBooks --- ### Configuración inicial Configuración de Zoho Books # Configuración de Zoho Books En esta sección se explican los pasos para configurar la pasarela de facturación de Zoho Books. > [!INFO] Recuperación de órdenes > > Esta integración recupera las órdenes mediante **webhook**. ## Requisitos 1. Tener cuenta en Zoho Books con cualquier plan de pago. 2. Tener cuenta en BillMySales con cualquier plan, incluyendo gratuito. - Si requiere usar sondeo [necesitará un plan que lo permita](https://www.billmysales.com/#pricing). 3. [Crear una pasarela de facturación](https://www.billmysales.com/academy/capacitacion-inicial/pasarelas-de-facturacion/crear-pasarela-de-facturacion) en BillMySales usando el origen de datos Zoho Books y el facturador de su elección. > [!NOTE] Nota > > La configuración que se explicará es una configuración por defecto que sólo 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 pasarela de facturación Realizando esta configuración, la integración permitirá emitir boletas y/o facturas electrónicas. Para realizar la conexión de Zoho Books con BillMySales debes ingresar a la cuenta de administrador en tu tienda y dirigirte a la configuración de la cuenta haciendo clic en el engranaje que encontrarás en la esquina superior derecha: ![Botón de engranaje](https://www.billmysales.com/img/content/docs/datasources/zohobooks/configuracion-inicial/boton-de-engranaje.png) Dentro de la configuración deberás realizar los siguientes pasos: ## Crear Webhook Para crear y configurar el Webhook, debes: 1. Ingresar a la opción **Acciones del flujo de trabajo** que se encuentra en el recuadro **Automation**: ![Opcion de acciones del flujo de trabajo](https://www.billmysales.com/img/content/docs/datasources/zohobooks/configuracion-inicial/opcion-de-acciones-del-flujo-de-trabajo.png) 2. Dentro de esta página, ingresa a la opción **Webhooks** ![Opcion de webhooks](https://www.billmysales.com/img/content/docs/datasources/zohobooks/configuracion-inicial/opcion-de-webhooks.png) 3. Haz clic en el botón **Nuevo Webhook** que se encuentra en la esquina superior derecha de la pantalla: ![Boton crear webhook](https://www.billmysales.com/img/content/docs/datasources/zohobooks/configuracion-inicial/boton-crear-webhook.png) 4. Para crear el Webhook deberás completar los campos de la siguiente manera: - **Nombre**: BillMySales. - **Módulo**: Factura. - **URL Y PARÁMETROS**: la URL la debes obtener desde la pasarela de facturación en BillMySales, en la pestaña **Webhook** ![Pestaña Webhook en BillMySales](https://www.billmysales.com/img/content/docs/datasources/zohobooks/configuracion-inicial/pestania-webhook-en-billmysales.png) - **ENCABEZADOS**: - Clave: `X-ZOHOBOOKS-BMS` - Value: `a9b5d17ecd610018b2cad0fa0dc5b6e9` ![Configuracion del Webhook](https://www.billmysales.com/img/content/docs/datasources/zohobooks/configuracion-inicial/configuracion-del-webhook.png) 5. Finalmente, dirígete al final de la página y haz clic en el botón **Guardar** ![Boton de guardar webhook](https://www.billmysales.com/img/content/docs/datasources/zohobooks/configuracion-inicial/boton-de-guardar-webhook.png) ## Crear regla del flujo Para crear la regla de flujo debes realizar los siguientes pasos: 1. Ingresa a la opción **Reglas del flujo de trabajo** que encontrarás en la sección **Automation** ![Opcion de Reglas de flujo de trabajo](https://www.billmysales.com/img/content/docs/datasources/zohobooks/configuracion-inicial/opcion-de-reglas-de-flujo-de-trabajo.png) 2. Dentro de esta página haz clic en el botón **Nueva regla del flujo de trabajo** ![Boton Crear nueva regla del flujo de trabajo](https://www.billmysales.com/img/content/docs/datasources/zohobooks/configuracion-inicial/boton-crear-nueva-regla-del-flujo-de-trabajo.png) 3. Completa la siguiente información para crear la regla: - **Nombre de la regla de flujo de trabajo**: BillMySales Flujo. - **Módulo**: Factura. - **¿Desea ejecutar el flujo de trabajo para?**: Tipos de Factura determinado. - **Tipo de factura**: Factura. ![Nueva regla del flujo de trabajo](https://www.billmysales.com/img/content/docs/datasources/zohobooks/configuracion-inicial/nueva-regla-del-flujo-de-trabajo.png) 4. Haz clic en **Siguiente**. 5. Completa la condición de ejecución de la regla de la siguiente manera: - **Tipo de flujo de trabajo**: Basado en eventos. - **Tipo de acción**: Creado o editado. - **Ejecutar el flujo de trabajo cuando**: Se actualizan todos los campos seleccionados. Estado. - **Ejectar cuando el registro sea**: Editado cada vez. ![Condición de ejecución de regla de flujo de trabajo](https://www.billmysales.com/img/content/docs/datasources/zohobooks/configuracion-inicial/condicion-de-ejecucion-de-regla-de-flujo-de-trabajo.png) 6. Haz clic en **Siguiente**. 7. Haz clic en el botón **Criterios nuevos**: ![Botón de Criterios nuevos](https://www.billmysales.com/img/content/docs/datasources/zohobooks/configuracion-inicial/boton-de-criterios-nuevos.png) 8. En esta sección deberás completar los 3 campos de la siguiente manera: - Estado. - es. - Aprobado. ![Criterio creado](https://www.billmysales.com/img/content/docs/datasources/zohobooks/configuracion-inicial/criterio-creado.png) 9. Luego, haz clic en el botón **Acciones inmediatas** ![Botón de Acciones inmediatas](https://www.billmysales.com/img/content/docs/datasources/zohobooks/configuracion-inicial/boton-de-acciones-inmediatas.png) 10. En esta sección deberás completar los campos de la siguiente manera: - **Tipo de acción**: Webhooks. - **Nombre**: selecciona el webhook de BillMySales creado al inicio. ![Asociar acciones inmediatas](https://www.billmysales.com/img/content/docs/datasources/zohobooks/configuracion-inicial/asociar-acciones-inmediatas.png) 11. Haz clic en el botón **Asociar** Y la regla de flujo debería quedar de la siguiente manera: ![Regla de flujo creada](https://www.billmysales.com/img/content/docs/datasources/zohobooks/configuracion-inicial/regla-de-flujo-creada.png) 12. Para finalizar, haz clic en el botón **Guardar** que se encuentra en la esquina inferior izquierda de la pantalla: ![Botón de guardar](https://www.billmysales.com/img/content/docs/datasources/zohobooks/configuracion-inicial/boton-de-guardar.png) --- ### Configuración de tipos de documentos Configuración de tipos de documentos # Configuración de tipos de documentos Mediante la configuración de campos personalizados se puede emitir boletas y facturas. A continuación se detallan los pasos para configurar los campos personalizados. 1. Haz clic en el botón del engranaje que se encuentra en la esquina superior derecha de la pantalla: ![Botón de engranaje](https://www.billmysales.com/img/content/docs/datasources/zohobooks/configuracion-tipos-de-documentos/boton-de-engranaje.png) 2. Luego, ingresa a la opción **Clientes y vendedores** que se encuentra en el recuadro **General**: ![Opción de clientes y vendedores](https://www.billmysales.com/img/content/docs/datasources/zohobooks/configuracion-tipos-de-documentos/opcion-de-clientes-y-vendedores.png) 3. Dirígete a la pestaña **Personalización de campo**: ![Pestaña personalización de campo](https://www.billmysales.com/img/content/docs/datasources/zohobooks/configuracion-tipos-de-documentos/pestania-personalizacion-de-campo.png) 4. Haz clic en el botón **Nuevo campo personalizado** que se encuentra en la esquina superior derecha de la pantalla: ![Botón de nuevo campo personalizado](https://www.billmysales.com/img/content/docs/datasources/zohobooks/configuracion-tipos-de-documentos/boton-de-nuevo-campo-personalizado.png) 5. Crea los siguientes campos: - **RUT:** - Tipo de dato: Cuadro de texto (línea única). - Obligatorio (Siempre y cuando se requiera). - **GIRO:** - Tipo de dato: Cuadro de texto (línea única). - Obligatorio (Siempre y cuando se requiera). - **RUT EMPRESA:** - Tipo de dato: Cuadro de texto (línea única). - Obligatorio (Siempre y cuando se requiera). - **TIPO DE DOCUMENTO:** - Tipo de dato: Selección múltiple. - Obligatorio (Siempre y cuando se requiera). - Opciones de selección multiple: - Factura. - Boleta. 6. La configuración de los campos debería visualizarse de la siguiente manera: ![Campos personalizados creados y configurados](https://www.billmysales.com/img/content/docs/datasources/zohobooks/configuracion-tipos-de-documentos/campos-personalizados-creados-y-configurados.png) --- ### Configuración de tipo de precio Configuración de tipo de precio # Configuración de tipo de precio El tipo de precio lo debes configurar en la configuración de la pasarela en BillMySales en la pestaña **"Facturador"** campo **"Configuración de precios en el origen de datos"** de la pasarela de facturación. ![Configuración de precios](https://www.billmysales.com/img/content/docs/datasources/zohobooks/manual/bms_zoho_14.png) --- Last updated on 25/08/2026