Búsqueda puntual por códigos OE / AM en el propio software de gestión

Vista general

Integrando el propio software de gestión en Quoting24 es posible devolver en tiempo real precios y disponibilidad personalizados para el cliente específico con el que se está escribiendo cuando se buscan códigos.

De este modo se obtienen rápidamente las condiciones comerciales específicas del cliente con el que se está hablando.

El objetivo es permitir que Quoting24, una vez identificado un código de producto, recupere automáticamente:

Disponibilidad y precio neto del cliente específico
Metadatos del producto: información descriptiva, marca, posibles promociones activas y otros atributos relacionados.
El flujo está diseñado para interactuar de forma transparente con las API ERP del sistema de gestión del Proveedor.

Parámetros de búsqueda

De Quoting24 al Proveedor

Parámetros obligatorios

Token de autenticación
Un token único que identifica de forma unívoca los servidores de Quoting24.
Código de búsqueda
Preferiblemente un código AM u OE.
La búsqueda no debería limitarse solo a los códigos de producto exactos, sino que también debería:
Buscar códigos alternativos
Buscar en bases externas

⚠️ Si este comportamiento no está soportado, debe comunicarse claramente.
Como mínimo, la búsqueda debe incluir los datos de ficha del producto y no solo los códigos internos exactos.

Identificación del cliente

Debe proporcionarse al menos uno de los siguientes

ID (como está registrado en el software de gestión) de la sede de tu cliente
ID (como está registrado en el software de gestión) de la empresa de tu cliente
NIF/CIF del cliente
ID de categoría de descuento
Usado para:
Clientes no registrados
Permitir al operador modificar dinámicamente las reglas de descuento

Parámetros opcionales

ID operador (opcional pero recomendado)
Utilizado para rastrear quién ha generado el presupuesto.
Cantidad
Puede incluirse en la solicitud si es estrictamente necesario.
Enfoque preferido: gestión de la cantidad en la respuesta, no en la solicitud.
Marca / Fabricante
Para permitir búsquedas más precisas.
Modalidad de búsqueda
Parámetro de opción de búsqueda exacta puntual o búsqueda con cruces (que también produce resultados de productos alternativos).

Parámetros de respuesta

Del proveedor a Quoting24

La respuesta debe contener un listado de productos, cada uno con los siguientes campos.

Campos obligatorios (por producto)

Código de producto del proveedor
Código de pedido interno, incluidos los prefijos, exactamente como se utiliza en los sistemas del Proveedor.
Fabricante
Nombre del fabricante (ej. LUK, Magneti Marelli, Brembo).
Puede estar estructurado en 2 campos:
Versión abreviada/precódigo (ej. MAR)
Nombre completo (ej. Magneti Marelli)
Precio de venta neto al cliente
Precio neto (IVA excluido)
Costes de envío excluidos
Los gastos de envío pueden devolverse por separado, si corresponde
Disponibilidad
Valor numérico que representa la cantidad disponible en almacén.
Almacén
Nombre del almacén, estantería o referencia a la ubicación interna.

Campos opcionales

Descripción del producto
Texto libre (ej. Pastillas de freno) y/o categoría de mercancía.
Código identificativo del Fabricante
Obligatorio cuando el código de producto ERP difiere del código del fabricante.
Precio de lista
No necesario pero reproducible si hace falta.
Promociones
Presencia de promoción (binario)
Texto de la promoción (opcional)
Si el texto está vacío → promoción no activa
Imagen del producto
URL de la imagen
O imagen Base64
URL ficha de producto
Enlace a la página de detalles del producto en el e-commerce o en el sitio externo.
Si el enlace directo no es posible:
Proporcionar reglas de sintaxis URL
O devolver una URL genérica de la página de acceso
Precios basados en la cantidad / Descuentos
Si existen descuentos por cantidad, devuelve los niveles en cualquier formato analizable, por ejemplo:

{
  "from": 2,
  "to": 10,
  "price": "50.00"
}