--- title: "Shopify" description: "Shopify" type: "docs" category: "doc" tags: [] authors: [Anonymous] date: "2026-09-09" last_update: "2026-09-09" time_minutes: 1 draft: false unlisted: false url: "https://www.billmysales.com/docs/datasources/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) --- Última actualización el 09/09/2026