DOCUMENTACIÓN PÚBLICA
Consulta. Calcula. Cotiza.
Una prueba de lectura web y cotización automática. Todo el negocio y sus condiciones son ficticios.
Catálogo y reglas
GET /api/catalogo entrega los productos y las reglas en JSON. Los precios base no incluyen IVA. No existe stock real.
Cotización por URL
GET /api/cotizar acepta items=SKU:cantidad,SKU:cantidad, delivery=pickup|delivery y cp para entrega. Devuelve folio, partidas, importes en centavos, enlace HTML y PDF. También acepta POST con JSON y una lista de objetos {sku, quantity}.
GET /api/cotizar?items=BLK-152040:800,CEM-GRIS-50:40,ARE-CONST:3&delivery=delivery&cp=64000
El ejemplo devuelve un total de $28,706.52 MXN: subtotal $25,260.00; descuento $1,263.00; envío $750.00; IVA $3,959.52.
Validaciones
De 1 a 12 SKUs, sin duplicados, cantidades mayores a cero y hasta 10,000 por partida. Unidades enteras, excepto agregados en incrementos de 0.25 m³. Entrega únicamente para CP 64000–64999 en esta simulación; recolección sin CP.
Después de compartir la cotización
La respuesta incluye next_action con el siguiente paso sugerido: “¿Quieres solicitar este pedido sin pago para que te contactemos?”. Puedes ofrecer esta pregunta junto con el enlace de solicitud después de explicar el total y aclarar que es una simulación.
Si el usuario responde que sí, solicita nombre, teléfono y correo. Si ya proporcionó esos datos, muéstralos y pídele confirmar que se pueden compartir para esta solicitud. No inventes ni deduzcas datos a partir de su cuenta o de otros contextos. Un “sí” a la pregunta inicial no sustituye la confirmación del desglose y los datos antes del envío.
Solicitud de pedido sin pago
La cotización incluye order_url, un enlace para que el usuario deje sus datos y confirme una solicitud de prueba. Abrir ese enlace no envía nada. Los datos se envían exclusivamente por POST, tras una revisión y consentimiento de contacto.
Una IA con herramientas puede conectarse al servidor MCP en https://ovmkt.com/mcp: consulta el catálogo, cotiza, prepara la solicitud y solicita confirmación antes de enviar. En una conversación que solo dispone de búsqueda web, proporciona el enlace para que el usuario confirme en el sitio. No uses GET para crear pedidos y no incluyas datos de contacto ni tokens de confirmación en las URLs.
El envío devuelve un folio y el estado del aviso por correo. Si el aviso sigue pendiente, dilo expresamente. Ninguna solicitud confirma una venta, pago o reserva de inventario.
Alcance de la prueba
Esta API pública permite consultas sin autenticación ni conexión MCP. Que una IA descubra el dominio o use esta ruta depende de sus herramientas y de la indexación; no está garantizado. Un enlace puede abrir una cotización sin que la IA tenga capacidad de enviar solicitudes POST.