El objetivo es que el Pedido FinanzaPro cobre exactamente lo que pagó el comprador. Para eso, la integración aplica estas reglas.
Cliente
Busca al cliente por número de identificación (cédula física o jurídica, o DIMEX del formulario de pago).
Si no lo encuentra, lo busca con el correo de facturación.
Si tampoco lo encuentra, crea un cliente nuevo con los datos de facturación.
Cuando el cliente ya existe, la integración actualiza su nombre, correo y teléfonos con los datos del pedido (nunca los borra; el nombre es siempre el nombre y apellido de facturación, nunca el de la empresa, y si no vienen, pasa a ser el correo) y le agrega la identificación si no la tenía; cada cambio queda registrado como nota informativa. Si el correo coincide con un cliente pero la identificación es distinta, la integración crea un cliente nuevo sin correo y lo reporta con una advertencia para que revises si es un duplicado.
La dirección de envío se guarda en el cliente como dirección de Pedido en Línea (cada cliente tiene una sola dirección de la integración, que se sobrescribe con cada pedido); en Costa Rica, el código postal se desglosa en provincia, cantón y distrito. La dirección se guarda solo si el pedido incluye la primera línea de la dirección.
Si el pedido no trae correo de facturación (aunque traiga identificación), la identificación es inválida o el cliente no se pudo resolver, el pedido se crea sin cliente, queda parcial y lleva una nota de error.
El campo de identificación predeterminado del formulario se lee como cédula física: una cédula jurídica o un DIMEX escritos ahí no pasan la validación y el pedido se crea sin cliente; si el formulario usa campos distintos de los predeterminados, hay que mapearlos. Un número con espacios alrededor tampoco pasa la validación. Formatos aceptados:
Tipo | Formato |
Física | 9 dígitos (guiones 1-4-4 opcionales) |
Jurídica y NITE | 10 dígitos (1-3-6) |
DIMEX | 11 o 12 dígitos sin guiones |
Extranjero no domiciliado y no contribuyente | Hasta 20 caracteres |
Dirección de envío
La dirección que el comprador escribió al pagar se guarda en dos lugares:
En el cliente, como la dirección “Pedido en Línea”. Cada cliente tiene una sola dirección administrada por la integración, con ese nombre. En cada pedido se actualiza la dirección; nunca se crea una segunda. Si alguien la borró, la integración la vuelve a crear (o recupera una con ese nombre que haya quedado suelta). Las demás direcciones del cliente no se tocan. El Pedido FinanzaPro se crea con esta dirección como dirección de envío.
En las notas de envío del pedido, en la sección
[Dirección de envío]: la transcripción completa de lo que envió la tienda, sin cambios.
La dirección “Pedido en Línea” incluye la empresa, la línea 1 y la línea 2 de la dirección de envío, y una línea de ubicación. No lleva el nombre del destinatario, que ya está en el cliente.
Código postal → provincia, cantón y distrito (solo en Costa Rica). En Costa Rica, el código postal es el código oficial del distrito, por lo que la integración lo busca en su copia de la base geográfica de FinanzaPro. Si lo encuentra, guarda la dirección con provincia, cantón y distrito estructurados, y la línea de ubicación queda solo con el código postal. Si no lo encuentra, guarda la dirección sin esa jerarquía y la línea de ubicación lleva la ciudad y la provincia tal como las escribió el comprador, además del código postal. En pedidos de otros países no se intenta y no hay nota.
Por eso conviene que el formulario de pago de la tienda solicite el código postal y lo valide como código postal de Costa Rica: es el único dato con el que FinanzaPro ubica la dirección.
Casos que dejan la nota Dirección de envío sin distrito (advertencia; la dirección se guarda igual):
El pedido no incluye el código postal.
El código postal no corresponde a ningún distrito.
No se pudo consultar la base geográfica.
El servicio de contactos rechazó el distrito porque su copia de la base geográfica no lo reconoce; la integración lo reintenta sin él.
En esos casos, agrega la provincia, el cantón y el distrito a la dirección “Pedido en Línea” del cliente. Si la dirección no se pudo guardar por otro motivo, el pedido se crea sin dirección de envío y se añade la nota: "Dirección de envío sin guardar: cópiala desde [Dirección de envío] en las notas de envío".
La dirección se guarda solo cuando el cliente se resolvió y el pedido incluye la línea 1 de la dirección; un pedido para recoger en tienda, sin dirección, no deja nota.
Productos
Cada línea del Pedido Web se busca por SKU (sin distinguir mayúsculas) entre los productos de la empresa en FinanzaPro (la integración usa su propia copia de los productos, que se actualiza sola cuando un producto se crea o cambia; si esa actualización se retrasa, un producto recién creado o con SKU recién cambiado no se encuentra). Una línea sin SKU, con SKU desconocido, con cantidad inválida o con montos ilegibles se excluye, aparece en Líneas con problemas y el pedido queda parcial.
Envío
El método de envío del Pedido FinanzaPro se deriva del mapeo del primer método del Pedido Web. Sin mapeo, el pedido se crea sin método y con una advertencia.
Cada método de envío del Pedido Web se convierte en una línea de cargo de envío (cantidad 1, después de los productos). El producto de esa línea se elige así: si el envío fue gratis, el producto de envío gratis a 0,01 (o ninguna línea, si así lo configuraste); si el método no está en la configuración de cargos, el producto de respaldo; si la resolución por clases de envío está activada y el pedido trae clases, la primera regla del método que coincida; en cualquier otro caso, el producto predeterminado del método. La resolución por clases está desactivada por defecto; mientras esté así, las reglas se guardan, pero no se aplican.
El impuesto de la línea de envío lo calcula FinanzaPro según la configuración del producto de cargo.
Si el método tiene configurada una tarifa de impuesto fija, esta define cómo se descuenta el impuesto del monto cobrado para obtener el precio; se aplica siempre y debe ser igual a la tarifa del producto de cargo.
Descuentos y cargos
Un descuento a nivel de pedido (un cargo negativo del Pedido Web) se reparte proporcionalmente entre las líneas de producto y se anota en las notas del pedido como
{nombre}: {monto}.Un recargo a nivel de pedido no se agrega: se marca como error y el pedido queda parcial, para que lo agregues a mano.
Los cupones no se leen como tales: se registran como el descuento de cada línea, es decir, como la diferencia entre el subtotal y el total en WooCommerce. Un producto a precio 0 se mantiene en 0 y no recibe su parte del descuento repartido.
Precios e impuestos
El precio unitario de cada línea se calcula a partir del subtotal con impuestos de WooCommerce (antes del cupón) y de la tarifa de impuestos del Pedido Web; el descuento de línea se aplica después como porcentaje. FinanzaPro aplica el IVA configurado en su propio producto, por lo que la tarifa del producto en FinanzaPro debe ser la misma que en WooCommerce; si difieren, el total de la línea no coincide y aparece la nota "Línea diferente a WooCommerce".
Si la información de impuestos de una línea falta o es inconsistente, la línea se valora al precio antes de impuestos en WooCommerce y se emite una advertencia: el total puede diferir.
La moneda es la del Pedido Web (USD si no se especifica). Al comparar con WooCommerce, una diferencia mayor que ₡1 en colones (0,01 en otras monedas) en una línea (o cualquier diferencia en su tarifa de IVA) o, en el total, mayor que una unidad por línea y por descuento repartido (hasta ₡10) produce una nota de error. El pedido se marca como parcial solo cuando el total del pedido o el de una línea difiere en más de ₡10 (0,10), o cuando las líneas no se pudieron comparar; una diferencia en impuestos o descuentos deja una nota, pero no marca el pedido como parcial.
Referencia y notas
Referencia:
[WooCommerce] {número del pedido}.Fecha del pedido: la fecha de creación del Pedido Web, no la de procesamiento.
Notas del pedido (visibles para el cliente y copiadas en la factura): solo las líneas de descuento aplicadas.
Notas de envío (solo para tu equipo): todo el detalle del Pedido Web y las notas de procesamiento. Ver Qué verás en el pedido: notas de envío y notas de procesamiento.