Cómo configurar los datos fiscales del comprador en WooCommerce – Bling MX

Para poder emitir facturas de los pedidos que importas desde WooCommerce, Bling necesita saber en qué campos de tu tienda están los datos fiscales del comprador.

Esto es necesario porque WooCommerce no incluye campos fiscales de forma nativa. En su lugar, estos datos suelen configurarse mediante plugins que agregan campos personalizados en el checkout.

Al indicarle a Bling cuáles son esos campos, los datos fiscales se importan junto con el pedido de venta y así evitas capturarlos manualmente al facturar.

Antes de empezar: contexto rápido

En WooCommerce, los plugins de checkout pueden crear campos personalizados (también llamados metacampos). El nombre de esos campos no es estándar: cambia según el plugin y la configuración de cada tienda.

Por eso, Bling necesita que indiques el nombre exacto del campo que usa tu tienda para cada dato fiscal.

⚠️ Importante:

Esta configuración se basa en los campos que ya tengas en WooCommerce. Bling no crea esos campos; únicamente los mapea.

¿Dónde se configuran los datos fiscales en Bling?

Ve a Preferencias
Entra a Integraciones
Abre tu integración con WooCommerce
Selecciona Reglas de la operación
Entra a la pestaña Contactos

Aquí verás la sección Campos personalizados de Contactos.

Recuerda: Los nombres de los campos deben coincidir exactamente con los configurados en WooCommerce.

Qué debes escribir en cada campo

En cada campo de Bling debes escribir el nombre exacto del campo (metadato) en WooCommerce que contiene esa información.

Campo en Bling	Qué representa
RFC	El campo donde el comprador captura su RFC
Nombre completo / Razón social	Nombre o razón social fiscal del comprador
Régimen fiscal	Régimen fiscal del comprador
Uso de CFDI	Uso fiscal que el comprador dará a la factura
Código postal	Código postal del domicilio fiscal del comprador

Tip útil: No copies el valor que capturó el comprador. Copia el nombre del campo tal como está configurado en WooCommerce.

Cómo identificar los campos fiscales en WooCommerce

En WooCommerce, los campos fiscales no existen por defecto. Normalmente se agregan mediante plugins de checkout que permiten crear campos personalizados en el formulario de compra.

Por eso, para identificar correctamente los campos fiscales, es necesario revisar la configuración del plugin que estés usando en tu tienda.

Importante: Bling no crea ni modifica campos en WooCommerce. Solo importa la información que los plugins ya envían en los pedidos.

Paso 1: Instala un plugin de campos personalizados

Si aún no tienes un plugin para agregar campos fiscales, te recomendamos usar Checkout Field Editor for WooCommerce, ya que permite identificar fácilmente el nombre interno de cada campo.

Sigue estos pasos en WordPress:

Entra al panel de administración de WordPress.
Ve a Plugins > Agregar nuevo.

pluggin woocommerce.png

Busca Checkout Field Editor for WooCommerce.
Haz clic en Instalar y luego en Activar.

pluggin check woocommerce.png

Paso 2: Identifica el nombre del campo en el plugin

Una vez instalado el plugin, entra a la configuración y localiza los campos fiscales que hayas creado (RFC, Régimen fiscal, Uso de CFDI, etc.).

Cada campo muestra un nombre interno o ID. Ese valor es el que debes escribir en Bling.

CAMPO WOOCOMMERCE.png

Recuerda: No copies el valor que escribe el cliente. Copia exactamente el nombre del campo configurado en el plugin.

Verifica el tipo de checkout en WooCommerce

Antes de copiar los nombres de los campos, es importante identificar qué tipo de checkout estás usando en tu tienda, ya que esto puede cambiar la forma en que los plugins de checkout gestionan los campos.

WooCommerce tiene dos modelos de checkout:

Block (bloques)
Classic (formulario tradicional)

Para verificarlo:

Entra a tu panel de WordPress.
Ve a Pages.
Abre la página de checkout.

Al seleccionar el bloque de checkout, puede aparecer un mensaje que indica qué modelo estás usando. Si el sistema te sugiere cambiar a “Classic”, significa que estás utilizando el modelo Block.

Si al abrir la página ves un formulario tradicional con los campos visibles directamente, significa que estás usando el modelo Classic.

Importante:
Una vez identificado el modelo de checkout, debes copiar los nombres de los campos desde la configuración correspondiente dentro de tu plugin.

Si usas Block, utiliza los campos de esa pestaña en el plugin.
Si usas Classic, utiliza los campos de esa pestaña.

Ejemplos de nombres de campo (solo referencia)

Los nombres de los campos dependen del plugin y de tu configuración. Algunos ejemplos comunes son:

billing_rfc
cliente_rfc
regimen_fiscal
uso_cfdi
billing_postcode_fiscal

Importante: Estos valores son solo ejemplos. Debes usar el nombre exacto que aparezca en tu plugin, aunque sea diferente.

¿Qué significa el mensaje “Tienes campos pendientes por completar”?

Si uno o más campos fiscales no están configurados con el metadato correcto de WooCommerce, Bling mostrará un mensaje informativo tipo alert info en la pantalla de autenticación de la integración.

Significa que los datos fiscales del comprador no se importarán automáticamente en tus pedidos de venta.
Será necesario que completes el mapeo o que captures los datos manualmente al momento de facturar.

mensaje woocommerce.png

Cosas importantes que debes considerar

Si el nombre del campo no coincide exactamente o el dato llega vacío de la tienda, no se importará.
La información vacía de un pedido no reemplaza datos fiscales que ya existan previamente guardados en Bling para ese contacto.
El Régimen fiscal y Uso de CFDI solo se importan si el valor que se recibe de WooCommerce es válido ante el SAT.
El código postal solo se importará si tiene exactamente 5 dígitos numéricos.

Preguntas frecuentes

Ya configuré los campos, pero no se importan los datos

Verifica lo siguiente:

Que el nombre del campo esté escrito exactamente como en WooCommerce (sin espacios extra y respetando guiones bajos).
Que el plugin esté enviando esos datos en el pedido (haz una compra de prueba).

Veo un aviso de error en mi listado de pedidos de venta, ¿qué significa?

Si configuraste los campos pero el sistema muestra un error en el listado de ventas, significa que Bling no pudo identificar o leer el plugin de checkout que utilizas en WooCommerce para estructurar los datos del comprador.

En este escenario, realiza lo siguiente:

Haz clic en el enlace del aviso para regresar a la pantalla de configuración y verificar que los nombres de los metadatos estén bien escritos.
Si el error persiste después de una nueva importación, significa que tu plugin de checkout no está identificado actualmente en nuestra plataforma. Ponte en contacto inmediato con nuestro equipo de Soporte para iniciar el proceso de compatibilidad de tu plugin.

Mi plugin envía texto en lugar de código (por ejemplo, “Persona moral”)

En algunos casos, si el valor recibido no corresponde a un valor válido para el campo (por ejemplo, códigos fiscales), el dato puede no importarse. Te recomendamos validar qué está enviando tu plugin en el pedido.