La configuración tiene tres partes: lo que obtienes de WooCommerce, lo que decides en la configuración de la integración con WooCommerce en FinanzaPro, y lo que configura Soporte. La tabla de referencia al final de este artículo resume todos los valores.
Lo que obtienes de WooCommerce
URL de la tienda. La dirección raíz del sitio (por ejemplo,
https://mitienda.com/). La integración la usa para sincronizar productos y para el botón "Ver pedido web" en los correos.Clave y secreto del consumidor (API REST). En WooCommerce, ve a WooCommerce › Ajustes › Avanzado › REST API y crea una clave con permisos de lectura y escritura. Copia la clave y el secreto en el momento: WooCommerce no vuelve a mostrar el secreto. Estas credenciales sirven para la sincronización de productos; los pedidos no las utilizan.
Webhook de pedidos. En WooCommerce › Ajustes › Avanzado › Webhooks crea un webhook con:
Estado: Activo.
Tema: Pedido creado (
order.created). Agrega también uno con Pedido actualizado (order.updated): hace falta cuando el pago se confirma después de crear el pedido. La integración solo toma el pedido cuando está en estado Procesando o Completado.URL de entrega: la dirección que te proporciona Soporte, en el formato
https://…/woocommerce/v2/company/{id}/inbound-webhooks/orders.Secreto: una cadena larga que tú inventas. Es la clave del webhook que también guardarás en FinanzaPro; debe ser idéntica en ambos lados.
Versión de la API: la más reciente (
WP REST API Integration v3).
En la misma pantalla, WooCommerce muestra el registro de las entregas de cada webhook. Ahí verás la respuesta de FinanzaPro a cada envío: 202 aceptado para procesar (aunque luego se ignore por su estado), 200 pedido ya procesado, 401 clave del webhook incorrecta o no guardada, o URL de entrega con otro ID de empresa (se comprueba antes que todo: una integración apagada con clave incorrecta también responde 401), 403 integración apagada, 400 envío que no se pudo leer. La prueba que WooCommerce realiza al crear el webhook devuelve un 200, aunque la clave o la integración estén mal, por lo que no sirve para comprobar la configuración.
Lo que decides en FinanzaPro
Configuración | Qué afecta |
Integración activa | Mientras esté apagada, FinanzaPro rechaza todos los webhooks. Para activarla, se necesitan la URL, la clave y el secreto del consumidor, así como el nombre de la tienda. La clave del webhook no es obligatoria para activarlo, pero sin ella, todo pedido se rechaza con un código 401. |
Nombre de la tienda | Encabezado de los correos. Obligatorio para encender la integración. |
Clave del webhook | Con ella, FinanzaPro verifica que cada pedido proviene de tu tienda. Una vez guardada, no se vuelve a mostrar. |
Destinatarios de nuevos pedidos | Reciben el correo de cada pedido creado en FinanzaPro. Lista vacía = sin correo. |
Destinatarios de pedidos pendientes | Reciben un correo por cada pedido que no se pudo crear. Lista vacía = sin correo. |
Mapeo de métodos de envío | Para cada método de WooCommerce (método e instancia, por ejemplo, Tarifa plana de la zona GAM), el método de envío de FinanzaPro que lleva el pedido. |
Cargos de envío | Qué producto de FinanzaPro se usa en la línea de envío: el de envío gratis, el de respaldo para métodos sin configuración, y un producto predeterminado por método de envío; reglas por clase de envío, la opción de no agregar línea cuando el envío es gratis, y una tarifa de impuesto fija con la que se descuenta el impuesto del monto cobrado (debe coincidir con la del producto de cargo y ser mayor que 0: no sirve para envío exento). Las reglas por clase solo se aplican cuando la resolución por clases de envío está activada; por defecto, está desactivada. |
Tipos de identificación | Qué campo del formulario de pago trae cada tipo de identificación. Viene con valores predeterminados para cédula física, cédula jurídica y DIMEX (los campos de los plugins de facturación más comunes en Costa Rica); NITE, extranjero no domiciliado y no contribuyente hay que mapearlos. Si el pedido contiene varios campos, se usa el primero según el orden de la lista de mapeos. |
Lista de precios | Solo para la sincronización de precios con la tienda. No interviene en los pedidos. |
Lo que configura Soporte
Tienda predeterminada: la sucursal de FinanzaPro en la que se crean los pedidos. Sin ella, todos los pedidos quedan pendientes.
Estados que se procesan: por defecto, Procesando y Completado. Si tu tienda utiliza un flujo de estados diferente, Soporte puede ajustarlo.
Si cambias la URL de la tienda, vuelve a guardar la clave y el secreto del consumidor. Si cambias el secreto del webhook en WooCommerce, cámbialo también en FinanzaPro: si no coinciden, los pedidos se rechazan con un 401.
Al guardar la configuración, FinanzaPro comprueba que cada método de envío mapeado y cada producto de cargo existan, y que los destinatarios sean correos válidos; si algo no existe, el guardado de la configuración falla y lo indica.
Referencia de configuraciones
Configuración | Dónde se obtiene o decide | Qué afecta | Si falta o está mal |
URL de la tienda | WooCommerce (dirección del sitio) | Sincronización de productos; botón "Ver pedido web"; encabezado del correo si no hay nombre de la tienda. | No se puede activar la integración. |
Clave y secreto del consumidor | WooCommerce › Ajustes › Avanzado › REST API | Sincronización de productos. No intervienen en los pedidos. | No se puede activar la integración; la sincronización falla. |
Webhook de pedidos | WooCommerce › Ajustes › Avanzado › Webhooks | Es lo que se envía con cada pedido a FinanzaPro. | Ningún pedido llega. |
Clave del webhook | La inventas tú; se guarda en WooCommerce y en FinanzaPro. | Verificación de que el pedido proviene de tu tienda. | Todo pedido se rechaza con el código 401 y WooCommerce desactiva el webhook. |
Integración activa | FinanzaPro | Apagada, rechaza todos los webhooks (403). | Ningún pedido se procesa. |
Nombre de la tienda | FinanzaPro | Encabezado de los correos. | No se puede activar la integración. |
Destinatarios de nuevos pedidos | FinanzaPro | Correo de cada pedido creado en FinanzaPro. | Nadie recibe aviso de los pedidos creados. |
Destinatarios de pedidos pendientes | FinanzaPro | Correo de cada pedido que no se pudo crear. | Nadie recibe aviso de los pendientes. |
Mapeo de métodos de envío | FinanzaPro | Método de envío del Pedido FinanzaPro. | Pedido sin método de envío, con advertencia. |
Cargos de envío: producto de respaldo | FinanzaPro | Línea de envío de métodos sin configuración propia. | Sin línea de envío y pedido parcial (solo si la configuración de cargos nunca se guardó: al guardarla, ambos productos son obligatorios). |
Cargos de envío: producto de envío gratis | FinanzaPro | Línea de envío a 0,01 cuando el envío fue gratis. | Sin línea de envío y con pedido parcial (solo si la configuración de cargos nunca se guardó). |
Cargos de envío: configuración por método | FinanzaPro | Producto predeterminado, reglas por clase de envío (solo con la resolución por clases activada), opción de no agregar línea al envío gratis y tarifa de impuesto fija para cada método. | Se usa el producto de respaldo, con advertencia. |
Tipos de identificación | FinanzaPro (con valores predeterminados) | ¿Qué campo del pago incluye la cédula física, la jurídica o la DIMEX? | Sin mapeo, el cliente se busca solo por correo; con un mapeo al tipo equivocado, el número casi siempre falla la validación y el pedido se crea sin cliente; si el formato coincide, el cliente queda con el tipo equivocado. |
Lista de precios | FinanzaPro | Sincronización de precios hacia la tienda. | No afecta a los pedidos. |
Tienda predeterminada | Soporte | Sucursal de FinanzaPro donde se crean los pedidos. | Todos los pedidos quedan pendientes. |
Estados que se procesan | Soporte (predeterminado: Procesando, Completado) | ¿Qué estados del Pedido Web generan un Pedido FinanzaPro? | Los pedidos en otros estados se ignoran. |
Plugin Integración de FinanzaPro para WooCommerce 1.7.0+ | Instalado en la tienda | Clases de envío para las reglas de cargo de envío; inventario por ubicación. | Las reglas por clase no aplican. |