El plug-in conecta el configurador con una tienda WooCommerce. Está en acceso anticipado: no está en el directorio de plug-ins de WordPress, no tiene precio publicado y todavía no se ha ejecutado de extremo a extremo con un WordPress y un WooCommerce reales en nuestro entorno de pruebas, así que pruébelo primero en una tienda de pruebas (staging).

Qué hace

• Añade un botón Order cut to size (la etiqueta puede cambiarla usted) a las páginas de producto que elija.
• Abre el configurador en una ventana emergente, un panel lateral o en la página, con el tablero del producto ya seleccionado.
• Pone el resultado en el carrito de WooCommerce como una sola línea, con el precio del presupuesto verificado.
• Conserva el id de pedido de CutOptim y el hash del presupuesto en la línea del pedido, y muestra en el pedido un breve resumen legible «Cut to size».
• Recibe los webhooks firmados de CutOptim y añade una nota al pedido de WooCommerce.

Instalación y ajustes

Requisitos: WordPress 6.0 o posterior, PHP 7.4 o posterior y WooCommerce.

1. Instale y active WooCommerce y después el plug-in.
2. Abra WooCommerce > CutOptim Configurator e introduzca el id del tenant, la clave publicable y la clave secreta. La clave secreta puede definirse en su lugar en wp-config.php como CUTOPTIM_API_SECRET. Las claves proceden de la consola; la clave publicable solo funciona en las direcciones web que usted indicó allí para ella.
3. Elija cómo se abre el configurador, la etiqueta del botón y las categorías de producto que reciben el botón (ninguna seleccionada significa todos los productos mapeados).
4. Mapee los productos a tableros (más abajo).
5. Para las notas de pedido, introduzca el secreto del webhook en el plug-in y añada a su configuración la dirección de webhook que muestra la página de ajustes (vea pedidos). Se permiten varios secretos, uno por línea, para poder rotar un secreto.

Mapear un producto a un tablero

El botón aparece solo en un producto que representa un tablero de su catálogo de CutOptim. El plug-in resuelve el tablero en este orden:

1. los campos CutOptim board y CutOptim thickness (mm) del propio producto en los datos de producto;
2. una regla SKU to board en los ajustes, una por línea, por ejemplo MDF-18 = MDF raw | 18 o PLY-* = Birch plywood; un SKU exacto prevalece sobre un prefijo, y una línea que empieza por # es un comentario;
3. los atributos de producto cutoptim_material y cutoptim_thickness.

Un nombre de tablero con marcado o un grosor fuera de 0 a 200 mm se descarta, no se repara. Con un tablero mapeado, el configurador se abre en la lista de corte.

Cómo llega el precio al carrito

El configurador en el navegador comunica el pedido, pero un número del navegador nunca es de fiar. La única vía del plug-in hacia el carrito es una ruta REST en su propio servidor. Esa ruta:

1. envía el presupuesto firmado a CutOptim para su verificación con su clave secreta y lo rechaza si no es válido;
2. comprueba que el presupuesto coincide con las líneas que vio el cliente;
3. comprueba la moneda con la de la tienda y rechaza una discrepancia;
4. añade una línea de carrito con el precio de los totales verificados, con o sin impuestos según el ajuste fiscal de su tienda.

Si algo falla, no se añade nada y se pide al cliente que lo intente de nuevo. En el pago en caja, el id de pedido de CutOptim y el hash del presupuesto se copian a la línea del pedido. La confirmación de un webhook solo cuenta si su hash de plan coincide con el almacenado en la línea.

Las comprobaciones y las llamadas a la API que hay detrás están en la referencia de la API del configurador.

Límites

• Acceso anticipado. No está en el directorio de WordPress; pruébelo primero en staging.
• Moneda. La moneda de la tienda y la de la configuración de CutOptim deben ser la misma.
• Idioma. Los textos propios del plug-in (ajustes y mensajes) están en inglés; el widget del configurador en sí está en diez idiomas.
• Pago. El pago, el stock, los impuestos y el envío son tarea de WooCommerce.
• Notas de pedido. El plug-in acepta eventos de estado de pedido; el servicio solo envía un evento de estado cuando usted cambia el estado de un pedido en la consola.