--- title: "WooCommerce" description: "WooCommerce" 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.stage.billmysales.com/docs/datasources/woocommerce" --- # WooCommerce --- ## Configuración inicial Descarga, instala y activa el plugin BillMySales en tu tienda, y conéctalo a la pasarela con la URL de notificación y el secreto. # Configuración de WooCommerce En esta sección se explican los pasos para descargar, instalar y configurar el plugin BillMySales en tu tienda WooCommerce. > [!INFO] Información importante > > Esta integración recupera las órdenes mediante **webhook**: un aviso automático que WooCommerce envía a BillMySales cuando un pedido cambia de estado, sin que tengas que hacer nada manualmente. Además, este plugin agrega campos personalizados al checkout (RUT, Documento, Giro) que BillMySales necesita para facturar correctamente. ## Antes de empezar Necesitas tener listo lo siguiente en BillMySales antes de instalar el plugin: 1. Tener una cuenta en BillMySales (cualquier plan, incluyendo gratuito). 2. [Crear una pasarela de facturación](https://www.billmysales.com/academy/capacitacion-inicial/pasarelas-de-facturacion/crear-pasarela-de-facturacion) con origen **WooCommerce** y el facturador de tu elección. Una **pasarela de facturación** es la conexión que creas en BillMySales para vincular tu tienda WooCommerce con tu facturador. Los datos que copiarás más adelante (URL y secreto) se obtienen desde la [configuración de esa pasarela](https://app.billmysales.com/billing_gateways). ## Requisitos 1. Tener WordPress 5.6 o superior. 2. Tener WooCommerce 8.9 o superior, instalado y activo. 3. Tener PHP 7.4 o superior. 4. Tener el checkout por bloques de WooCommerce habilitado (Cart & Checkout Blocks), si vas a usar los campos personalizados del checkout. --- ## Descargar e instalar el plugin Realizando esta configuración vas a dejar el plugin BillMySales instalado y activo en tu tienda, listo para configurar la pasarela. **1. Descargar el plugin** Debes ingresar a [este enlace](https://github.com/BillMySales/billmysales-plugin-woocommerce/archive/refs/heads/master.zip) desde tu navegador para descargar el plugin. Se descargará un archivo `.zip` listo para cargar en WordPress. **2. Acceder a subir plugin** Dentro del panel de administración de WordPress debes dirigirte a **"Plugins"** → **"Agregar plugin"** → **"Subir plugin"**: ![Menú Plugins](https://www.billmysales.com/img/content/docs/datasources/woocommerce/manual/bms_woo_01.png) **3. Seleccionar el archivo e instalar** Selecciona el archivo `.zip` que descargaste en **"Seleccionar archivo"** (1) y haz clic en **"Instalar ahora"** (2): ![Archivo .zip seleccionado, listo para instalar](https://www.billmysales.com/img/content/docs/datasources/woocommerce/manual/bms_woo_02.png) > [!INFO] Error al subir el archivo > > Si te aparece el error "The uploaded file could not be moved to wp-content/uploads/..." (en español: *No se pudo mover el archivo subido*), es un problema de permisos de escritura del servidor sobre `wp-content/uploads/`, no del archivo del plugin. Pide al administrador del hosting que revise los permisos de esa carpeta. **4. Activar el plugin** Una vez instalado, haz clic en **"Activar plugin"**: ![Plugin instalado, listo para activar](https://www.billmysales.com/img/content/docs/datasources/woocommerce/manual/bms_woo_03.png) --- ## Configuración básica de la pasarela Realizando esta configuración la integración permitirá recibir notificaciones del pago de tus pedidos, incluyendo los campos personalizados que necesita BillMySales para facturar. **1. Acceder a BillMySales dentro de WooCommerce** Con el plugin activo, dentro del panel de WordPress debes dirigirte a **"WooCommerce"** → **"BillMySales"**: ![Menú WooCommerce → BillMySales](https://www.billmysales.com/img/content/docs/datasources/woocommerce/manual/bms_woo_04.png) **2. Configurar el Webhook** Para completar esta parte necesitas extraer dos datos desde la configuración de la pasarela en BillMySales, y pegarlos en los campos correspondientes de la pestaña **"Configuración"** del plugin, en WordPress: - **URL de notificación:** entra a la pestaña **"Webhook"** (1) de la pasarela en BillMySales, copia la URL que aparece (2), y pégala en el campo **"URL de notificación"** (3) del plugin: **BillMySales:** ![Pestaña Webhook en la pasarela de BillMySales, con la URL](https://www.billmysales.com/img/content/docs/datasources/woocommerce/manual/bms_woo_05.png) **Plugin BillMySales:** ![Pestaña Configuración del plugin BillMySales, con la URL de notificación](https://www.billmysales.com/img/content/docs/datasources/woocommerce/manual/bms_woo_06.png) - **Secreto:** entra a la pestaña **"Origen de datos"** (1) de la misma pasarela en BillMySales, copia la clave secreta (2), y pégala en el campo **"Secreto"** (3) del plugin: **BillMySales:** ![Pestaña Origen de datos en la pasarela de BillMySales, con la clave secreta](https://www.billmysales.com/img/content/docs/datasources/woocommerce/manual/bms_woo_07.png) **Plugin BillMySales:** ![Pestaña Configuración del plugin BillMySales, con la clave secreta](https://www.billmysales.com/img/content/docs/datasources/woocommerce/manual/bms_woo_08.png) - **Estados que notifican:** los estados de pedido que deben disparar una notificación. Marca los mismos estados que configuraste en BillMySales (recomendado: **Completado**; si facturas antes de completar el pedido, también **Procesando**). - **Activo:** marcado. **3. Guardar la configuración** Completa los campos anteriores y haz clic en **"Guardar configuración"**: ![Pestaña Configuración con la URL, el secreto y los estados completos](https://www.billmysales.com/img/content/docs/datasources/woocommerce/manual/bms_woo_09.png) Si todo está correcto, desaparece el aviso amarillo que indica que faltan la URL o el secreto. --- ## Siguiente paso Con el plugin conectado, continúa con **Configuración de tipos de documentos** (en el menú lateral de esta documentación) para agregar los campos del checkout. --- ## Configuración de tipos de documentos Agrega los campos RUT, Documento y Giro al checkout para emitir boletas y facturas. # Configuración de tipos de documentos Continúa aquí después de completar la **Configuración inicial**: con el plugin instalado y la pasarela conectada, en esta sección se configuran los campos del checkout para emitir facturas y boletas. > [!INFO] 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. --- ## Configurar los campos del checkout **1. Acceder a la pestaña "Campos del checkout"** Con el plugin activo, dentro del panel de WordPress debes dirigirte a **"WooCommerce"** → **"BillMySales"** → **"Campos del checkout"**. **2. Agregar los campos obligatorios** En esa pestaña debes agregar los tres campos que BillMySales necesita para facturar correctamente: **"RUT"**, **"Documento"** y **"Giro"**. Agrégalos de a uno con "**+ Agregar otro campo**", en este orden, y marca los tres como obligatorios: ![Pestaña Campos del checkout, sin datos todavía](https://www.billmysales.com/img/content/docs/datasources/woocommerce/manual/bms_woo_10.png) **2.1. Campo "RUT"** En **"Etiqueta"** escribe **RUT** y deja **"Valores"** vacío, para que el cliente lo complete como texto libre. Marca **"Obligatorio"**: ![Campo RUT, con Valores vacío y marcado como obligatorio](https://www.billmysales.com/img/content/docs/datasources/woocommerce/manual/bms_woo_11.png) **2.2. Campo "Documento"** En **"Etiqueta"** escribe **Documento** y en **"Valores"** escribe **Boleta, Factura** separados por coma: al tener valores, el campo se muestra en el checkout como un selector con esas dos opciones. Marca **"Obligatorio"**: ![Campo Documento, con los valores Boleta, Factura y marcado como obligatorio](https://www.billmysales.com/img/content/docs/datasources/woocommerce/manual/bms_woo_12.png) **2.3. Campo "Giro"** En **"Etiqueta"** escribe **Giro** y deja **"Valores"** vacío, igual que el RUT. Marca **"Obligatorio"**: ![Campo Giro, con Valores vacío y marcado como obligatorio](https://www.billmysales.com/img/content/docs/datasources/woocommerce/manual/bms_woo_13.png) Con los tres campos agregados, guarda con **"Guardar campos"**. > [!INFO] Clave interna de cada campo > > Cada campo tiene una clave interna que lo identifica dentro del JSON enviado a BillMySales (se muestra como texto de referencia bajo la Etiqueta, no es editable). Se genera automáticamente a partir de la Etiqueta y se recalcula cada vez que la cambias y guardas; no hace falta definirla a mano. **3. Confirmar que los campos quedaron guardados** Una vez guardados, los tres campos quedan visibles en la pestaña, cada uno con su clave interna: ![Los tres campos (RUT, Documento, Giro) ya guardados](https://www.billmysales.com/img/content/docs/datasources/woocommerce/manual/bms_woo_14.png) --- ## Siguiente paso Si necesitas revisar cómo WooCommerce envía montos netos o afectos/exentos a BillMySales, continúa con **Configuración de tipo de precio** (en el menú lateral de esta documentación). --- ## Configuración de tipo de precio Identifica si un ítem es afecto o exento y elige la opción de precios correcta, considerando que WooCommerce envía montos netos. ## ¿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_18.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_19.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_20.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_21.png) --- ## ¿Cómo actualizar estados de ordenes masivamente? Reprocesa en lote las órdenes que no se facturaron, cambiando su estado desde el listado de pedidos de WooCommerce. # ¿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. --- Última actualización el 09/09/2026