Manual de configuración de WooCommerce
Requisitos
-
Tener cuenta en WooCommerce con cualquier plan de pago.
-
Tener cuenta en BillMySales con cualquier plan, incluyendo gratuito.
- Si requiere usar sondeo necesitará un plan que lo permita.
-
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:

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:

3. Dirigirse a Webhooks
Debes dirigirte a la opción “Webhooks”:

4. Añadir Webhook
Y seleccionar la opción “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”:

- Secreto: Este campo lo obtienes en la configuración de la pasarela en BillMySales en la pestaña “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”:


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

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

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

3. Instalar y activar Code Snippets
Luego debes instalar y activar la siguiente aplicación:

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.

4. Ir a Plugins instalados
Una vez ya instalado y activo, te debes dirigir a la opción de “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”:

6. Añadir nuevo Snippet
Dentro de Snippets seleccionar la opción “Add New”:

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:

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

Importante: Esta configuración es válida cuando en tu cuenta de Woocommerce tienes una configuración de impuestos. Por ejemplo:

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:

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