La integración convierte cada Pedido Web pagado en un Pedido FinanzaPro y te avisa por correo electrónico. WooCommerce envía el pedido en el momento en que cambia a Procesando o Completado; FinanzaPro lo valida, arma el pedido y lo deja en la sección de Pedidos del punto de venta, igual que un pedido digitado a mano.
El camino normal termina en un Pedido FinanzaPro y en un correo de nuevo pedido; cuando el pedido no se puede crear, queda pendiente y se avisa mediante un correo de pedido pendiente.
Glosario
Término | Qué es |
Pedido Web | El pedido tal como existe en WooCommerce, con su número de pedido de la tienda. |
Pedido FinanzaPro | El pedido creado en FinanzaPro a partir del Pedido Web. Aparece en Pedidos con la referencia |
Pedido asignado | Pedido de FinanzaPro cuyos productos quedaron reservados en el inventario. Es el resultado normal. |
Pedido parcial | Pedido FinanzaPro creado con datos incompletos (faltan productos, cliente o cargos, o el total difiere del Pedido Web). Incluye una advertencia y requiere ser completado a mano. |
Pedido pendiente | Pedido Web que no se convirtió en Pedido de FinanzaPro. Queda registrado en la integración y se avisa por correo. |
Notas de envío | Campo del Pedido FinanzaPro, visible solo para tu equipo, donde la integración deja el detalle del Pedido Web y sus notas de procesamiento. |
Notas de procesamiento | Mensajes de error, advertencia o información sobre lo ocurrido al armar el pedido. Aparecen en las notas de envío y en el correo. |
Lo que la integración no hace
No envía nada de vuelta a WooCommerce por este canal: ni el estado del pedido ni la factura. (La sincronización de existencias, otra función de la integración, sí descuenta en la tienda lo que el pedido deja asignado.)
No procesa cambios posteriores al pedido: una edición, cancelación o reembolso en WooCommerce no modifica el Pedido FinanzaPro ya creado.
No crea el mismo Pedido Web dos veces, aunque WooCommerce lo reenvíe.
No reintenta un correo que no se pudo entregar; el pedido se crea igual.
No alerta por pedidos pendientes acumulados: el aviso es el correo de cada uno.
La sincronización de precios y existencias con la tienda es otra parte de la integración y no se describe aquí.
Paso a paso
Un pedido web suele aparecer como pedido en FinanzaPro en pocos minutos. Estos son los pasos:
WooCommerce envía el pedido. Cada vez que se crea o se actualiza el estado de un pedido, el webhook envía el pedido completo a FinanzaPro.
FinanzaPro verifica que proviene de tu tienda. Compara la firma del envío con la clave del webhook. Si no coincide, lo rechaza (401) y no pasa nada más.
Se descarta si ya fue procesado o si está pendiente. Un Pedido Web que ya generó un Pedido FinanzaPro, o que tiene un pedido pendiente activo, no se procesa de nuevo aunque WooCommerce lo reenvíe.
Solo entran los pedidos en un estado permitido. La integración toma el pedido cuando su estado es "Procesando" o "Completado". Cualquier otro estado (Pendiente de pago, En espera, Cancelado…) se ignora sin dejar rastro; el pedido entrará cuando cambie a un estado permitido. Un pedido contra entrega entra en Procesando aunque aún no esté pagado.
Se arma el pedido. La integración busca el cliente, los productos, el método de envío y los cargos, calcula precios e impuestos y compara los totales con el Pedido Web (ver Cómo se arma el pedido en FinanzaPro).
Se crea el Pedido FinanzaPro en la tienda predeterminada, con la referencia
[WooCommerce] {número}y las notas de envío.Se intenta asignar el inventario. Si la asignación falla, el pedido queda creado pero sin asignar, con una nota de error.
Se envía el correo a los destinatarios de los nuevos pedidos.
Los cinco resultados posibles
Resultado | Cuándo ocurre | Qué ves |
Pedido creado | Todo se resolvió. | Pedido FinanzaPro asignado y correo sin la etiqueta "Requiere revisión". |
Pedido creado como parcial | Faltó un producto, el cliente, una línea de envío o un cargo del pedido, o el total (del pedido o de una línea) difiere del Pedido Web en más de ₡10. | Pedido FinanzaPro con la advertencia de datos parciales; correo con [Requiere revisión] y la sección "Qué revisar". |
Pedido creado sin asignar | El pedido se creó, pero no se pudo reservar el inventario. | Pedido FinanzaPro sin asignación y la nota de Productos sin asignar. |
Pedido pendiente | El pedido no se pudo crear: falta la tienda predeterminada, Facturación lo rechazó o el Pedido Web no se pudo leer. | No hay pedido en FinanzaPro. Correo [Pedido pendiente] a los destinatarios de los pedidos pendientes. |
Ignorado | El estado no está permitido, el pedido ya fue procesado o tiene un pedido pendiente activo. | Nada. |
Reintentos silenciosos
Si FinanzaPro está ocupado, una parte del sistema no responde o se repite un error interno, la integración reintenta automáticamente varias veces antes de darse por vencida. Durante ese tiempo no recibes correo ni ves el pedido. Si un pedido tarda más de lo habitual, casi siempre está en reintento. Son hasta 5 intentos en unos 12 minutos; si todos fallan, normalmente el pedido no se crea, no queda pendiente y no hay correo: aparece como 202 en el registro del webhook pero no en FinanzaPro. Avísale a Soporte con el número del pedido: Soporte recibe una alerta en estos casos y puede recuperar el pedido durante 14 días.
Seguridad
Cada envío se verifica mediante una firma HMAC calculada con la clave del webhook; un envío con firma incorrecta se rechaza sin procesarse.
La clave del webhook y el secreto del consumidor no se vuelven a mostrar después de guardarlos.
La tienda nunca recibe datos de FinanzaPro a través de este canal: el flujo de pedidos es unidireccional.