Integración de pedidos de corte a medida en tu propia tienda o ERP
El CutOptim Configurator se conecta a una tienda o a un ERP propios con dos comprobaciones en tu servidor: el presupuesto firmado y el webhook firmado. Ambos son HMAC-SHA256 sencillo, verificable en cualquier lenguaje, y unos ejemplos de referencia en Node y PHP muestran cómo.
Respuesta rápida
Para recibir los pedidos del configurador en una plataforma propia, tu servidor hace dos cosas. Verifica el presupuesto firmado antes de que una línea entre en el carrito, y verifica el webhook firmado antes de guardar un pedido. CutOptim no cobra pagos ni aloja ninguna tienda: el carrito, el pago y el registro del pedido se quedan contigo.
Dos comprobaciones, ambas en tu servidor
Una plataforma propia no tiene un plug-in en el que apoyarse, así que la confianza descansa en dos firmas. El navegador puede mostrar un precio, pero solo tu servidor decide si se lo cree.
| Momento | Qué llega | Qué comprueba tu servidor |
|---|---|---|
| El cliente pide en la página | El evento cutoptim:order con el pedido y su presupuesto firmado | El token del presupuesto, con tu clave secreta en /cfg/v1/quote/verify |
| Se realiza el pedido | Un webhook firmado a la dirección que registraste | La firma, la ventana de cinco minutos y el id del evento |
| Un reintento o un reenvío | El mismo evento otra vez | Nada: el id ya está guardado |
Comprueba el presupuesto antes del carrito
El token del presupuesto es la promesa de precio. Tu servidor pregunta a CutOptim si es auténtico, vigente y no usado, y compara lo que declara con la línea del carrito.
Recibe el pedido
La página entrega a tu script el evento cutoptim:order con el pedido y su token de presupuesto.
Pregunta a CutOptim
Tu servidor envía el token a /cfg/v1/quote/verify con tu clave secreta. La respuesta indica si es válido, si un pedido ya lo ha usado y qué declaraciones lleva.
Compara las declaraciones
El inquilino, la moneda, la caducidad y el hash de las líneas con precio deben coincidir con la línea que vas a añadir. Todo lo demás se rechaza.
Añade o rechaza
Solo un token que pasa llega al carrito. Un precio cambiado en el navegador falla aquí.
La clave de firma nunca se entrega a las tiendas. Comprobar en local la forma y la caducidad de un token ahorra una petición, pero solo /cfg/v1/quote/verify puede confirmar la firma.
Recibe el pedido por webhook
Cuando se realiza un pedido, CutOptim lo envía a la dirección que registraste, firmado para que puedas saber que viene de nosotros.
- — La cabecera CutOptim-Signature lleva una marca de tiempo t y una firma v1: un HMAC-SHA256 de la marca de tiempo, un punto y el cuerpo en bruto.
- — Verifica los bytes en bruto exactamente como llegan; un cuerpo que se ha analizado y vuelto a escribir ya no coincide.
- — Rechaza una marca de tiempo con más de cinco minutos de diferencia y compara las firmas en tiempo constante.
- — Guarda el id del evento y responde con éxito a un id ya visto: un reintento lo repite.
Código de referencia en Node y PHP
Dos ejemplos pequeños hacen justo esto, sin framework ni dependencias: un módulo de Node y un único archivo PHP. Copia el que te encaje, cambia el almacén en memoria por una tabla con clave única sobre el id del evento.
import { createWebhookReceiver } from './cutoptim-verify.mjs';
const receive = createWebhookReceiver({
secrets: [process.env.WEBHOOK_SECRET], // whsec_... from the admin route, never in the repository
async onEvent(event) { /* store event.data.order, keyed by event.id */ },
});
// in your HTTP handler - the RAW body, not parsed JSON:
const { status } = await receive({ rawBody, headers: req.headers });
res.writeHead(status).end();Qué se queda contigo
El configurador calcula el precio y planifica el corte; tu plataforma conserva todo lo que viene después.
- — El carrito, la caja y el pago: CutOptim no cobra pagos.
- — El registro del pedido y su tramitación, en tu base de datos o ERP.
- — Tus clientes y las páginas de tu tienda: no hay tienda alojada.
Empieza un sandbox gratuito en la consola para obtener tus claves y tu secreto de webhook. Ejemplos de referencia descargables aquí.
Dónde encaja
Cualquier sistema que pueda recibir una petición HTTPS y calcular un HMAC puede aceptar estos pedidos: una tienda propia, un frontal headless, una herramienta de presupuestos o un ERP. Si solo necesitas el motor de corte, sin pantalla de pedido, la Engine API se encarga.
Preguntas frecuentes
¿Necesito un plug-in para conectar mi propia plataforma?
¿Cómo sé que un precio no se ha cambiado en el navegador?
¿Qué pasa si mi endpoint está caído cuando llega un pedido?
¿CutOptim cobra el pago o aloja mi tienda?
¿Qué lenguajes de programación cubren los ejemplos?
Calculadoras, guías y sectores relacionados
Más sobre el configurador
El configurador de productos para corte a medida de tu tienda online: plan de corte y precio en directo, y pedidos directos a tu tienda.
Introduce piezas en una tienda de demostración y mira cómo se actualizan el plan de corte y el precio mientras escribes.
Una línea de código; en la propia página, en ventana emergente, panel lateral o página propia, con tu marca.
Por plancha, por m², por metro de corte, canteado, mecanizado, IVA y mínimos: tus precios, en directo.
Empieza por un armario, una estantería o un ropero: las piezas, el plan y el precio siguen la medida.
Distribuidores de tableros, servicios de corte y tiendas de planchas: los clientes piden online, con plan en directo y tus precios.
Un botón de corte a medida en tus productos WooCommerce; solo un presupuesto verificado se convierte en línea de carrito.
Las comprobaciones en el servidor para una tienda o un ERP sin plugin.
¿Solo necesitas el motor de corte? Mira la Engine API
Información legalCondiciones del configurador (EN) ·Contrato de encargo de tratamiento (EN) ·Aviso de privacidad para compradores ·Licencias de terceros (EN)