Manual de configuración de WooCommerce

Requisitos

  1. Tener cuenta en WooCommerce con cualquier plan de pago.

  2. Tener cuenta en BillMySales con cualquier plan, incluyendo gratuito.

  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

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

3. Dirigirse a Webhooks

Debes dirigirte a la opción “Webhooks”:

Opción Webhooks

4. Añadir Webhook

Y seleccionar la opción “Añadir Webhook”:

Añadir Webhook

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

  • 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

6. Activar la pasarela en BillMySales

Para poder guardar el Webhook en Woocommerce se primero se debe activar la pasarela de facturación en BillMySales en la pestaña “General”:

Pestañas de configuración

Activar pasarela

7. Guardar el Webhook

Una vez realizado esto se puede guardar el webhook creado en la tienda y quedará completamente funcional:

Guardar webhook


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

2. Buscar Code Snippets

Dentro de esta opción debes buscar lo siguiente “Code Snippets”:

Buscar Code Snippets

3. Instalar y activar Code Snippets

Luego debes instalar y activar la siguiente aplicación:

Instalar y activar Code Snippets

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

4. Ir a Plugins instalados

Una vez ya instalado y activo, te debes dirigir a la opción de “Plugins instalados”:

Plugins instalados

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

6. Añadir nuevo Snippet

Dentro de Snippets seleccionar la opción “Add New”:

Add New Snippet

7. Ingresar el código

Al ingresar a esta opción se debe debes ingresar el código se descarga del siguiente enlace y debería quedar la la siguiente manera:

Código del snippet

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.


¿Cómo configuro el tipo de precio en BillMySales?

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

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


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

Caso exento

El índice tax debe tener un valor cero además, el índice taxes debe estar vacío, por ejemplo:

Ejemplo caso exento

On this page

Last updated on 16/10/2025 by Anonymous