Manual de configuración de Shopify como origen de datos en BillMySales

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 el costado izquierdo de la página:

   

2. Dentro de Configuración debes ingresar a Notificaciones

   

3. Debes ingresar en “Webhooks” hacer clic en “Crear webhook”:

   

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:

   

5. Una vez creado el Webhook, en esa misma página se indica una clave secreta propia de la tienda.

   

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”:

   

7. Finalmente se debe guardar la configuración al final de la página en “Guardar cambios”:

   

Configuración para emitir boletas y facturas [Opcional]

Para poder emitir estos tipos de documentos actualmente existen 2 opciones:

Opción 1:

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:

   

2. Dentro de Settings ingresar a “Pantalla de pago”:

   

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)

   

   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)

   

   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”.

   

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
   b. Optional company label: RUT
   c. Address2 label: Giro (sólo para factura)
   d. Optional address2 label: Giro (sólo para factura)
   

   

   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

   

10. Luego ir a “Campos del cliente” y los siguientes campos se debe modificar como se muestra en la siguiente imagen:

    

    ◦ 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”.

Nota: Si deseas que al cliente se le emita una factura debes 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.”:

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.

Opción 2:

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”.

   

2. Dentro de temas dirigirte al icono de los tres puntos y seleccionar “Editar código”.

   

3. En Edit code, debes buscar una carpeta llamada “Secciones” y seleccionarla para visualizar los campos.

   

4. Dentro de la carpeta ya seleccionada debes buscar un campo llamado “main-cart-item.liquid”.

   

5. Luego ingresar al campo indicado donde debes descargar y pegar uno de los códigos que se encuentra en el siguiente enlace. 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:

8. Una vez terminado ya se podrían emitir boletas nominativas o facturas de las ventas que se realicen en la tienda.

¿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.

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:

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:

• Precio compra del producto:

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:

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:

Donde nos indica que el impuesto correspondiente ya está incluido en el precio.

Importante: Si nuestros precios están definidos como “Precios configurados para items afectos y exentos, el origen de datos envía montos brutos”, también se debe asignar el envió bruto.

Anexos

¿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.

Caso exento El índice taxable debe tener un valor False además, el índice tax_lines debe estar vacío.

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.

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.

Configuración del Sondeo [Opcional]

¿Qué es el 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.

2. Lo anterior abrirá la página de ajuste de Shopify, aquí debes seleccionar: Aplicaciones y canales de Ventas

3. Luego presionar en Desarrollar aplicaciones.

4. Permitimos el desarrollo de aplicaciones en Permitir el desarrollo de aplicaciones personalizadas.

5. Con esto podremos crear la Aplicación en Crear aplicación.

6. Completamos los campos Nombre de la aplicación y Desarrollador de aplicaciones.

Posterior a esto presionamos en Crear aplicación.

7. Ingresamos a Configurar los ámbitos de la API de administración.

8. Seleccionamos los siguientes accesos a la aplicación y luego presionamos en Guardar.

9. Nos dirigimos a Credenciales API y luego presionamos en Instalar aplicación.

10. Instala la aplicación podremos obtener el Token de acceso, presionamos Revelar token una vez. Este Token solo se puede ver una sola vez, debe almacenarlos para poder utilizarlo en BillMySales.

11. Ahora guardamos el Token en BillMySales en el campo API Token.

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.

13. Identificado el código, lo almacenamos en BillMySales en el campo Código de la tienda.

14. Finalmente, nos dirigimos al final de la página de configuración de BillMySales y presionamos en Guardar cambios.