Artículos y cantidades
Número de artículo, descripción, cantidad y código de unidad acordado.
STASTO × SU SISTEMA DE ADQUISICIONES
Seleccionar en la tienda.
Seguir trabajando en el ERP.
Abra el catálogo de STASTO desde su sistema de compras. Busque los componentes adecuados e incorpore la cesta de la compra a su proceso de compra.
Su sistema de comprasIniciar sesión en el catálogo
OCI
STASTO STOREBuscar. Seleccionar. Añadir al carrito.
NeumáticaVálvulas
Entrega de la cesta de la compra
Volver al proceso de compraComprobar y seguir tramitando en el ERP
01 / PUNCHOUT
De cuatro pasos, del catálogo a la compra.
- 01
Iniciar sesión en el ERP
Inicie el catálogo de STASTO desde su sistema de compras. El acceso al catálogo y la dirección de retorno se transfieren a la tienda.
- 02
Seleccionar componentes
Busque por número de artículo o palabra clave, seleccione a través de las imágenes de los productos y filtre las variantes con los filtros técnicos.
- 03
Transferir la cesta de la compra
Inicie PunchOut desde el carrito de la compra. Compruebe el resumen de la transferencia y, a continuación, confirme la devolución a su ERP.
- 04
Continuar con la compra
Compruebe las partidas transferidas en su sistema de compras y continúe con su proceso interno de autorización y pedido.
El simple hecho de enviar la cesta de la compra no genera por sí solo un pedido en STASTO. Los pasos siguientes del proceso de compra se realizan en su sistema de compras.
02 / CONFIGURACIÓN
Todo lo que necesita su equipo de integración.
Inicio del catálogo
POST
https://www.stasto.eu/oci/catalogPunto final productivo. Antes de realizar la prueba de integración, coordina con STASTO un entorno de prueba independiente.
| Parámetros | Significado |
|---|---|
HOOK_URL | Obligatorio. La dirección de redireccionamiento proporcionada por su sistema de adquisición para la sesión actual. |
nombre de usuario | El nombre de usuario configurado para el catálogo. Es obligatorio indicarlo al iniciar sesión mediante parámetros. |
contraseña | La contraseña de este acceso al catálogo. Es necesaria para iniciar sesión mediante parámetros. |
Ejemplo de llamada · POST
Ejemplo con marcadores de posición. Envíe los valores codificados como URL en el cuerpo de la solicitud y sustituya todos los marcadores de posición en su configuración de integración.
POST /oci/catalog HTTP/1.1
Host: www.stasto.eu
Content-Type: application/x-www-form-urlencoded
HOOK_URL=https%3A%2F%2Ferp.example%2Foci%2Freturn&username=STASTO_LOGIN&password=STASTO_PASSWORDFormas alternativas de registro y comportamiento durante la sesión
También se admite la autenticación básica HTTP. En este caso, omita los parámetros «username» y «password» y envíe los datos de acceso en el encabezado «Authorization». «HOOK_URL» sigue siendo obligatorio.
Se acepta GET para los sistemas compatibles. Es recomendable utilizar HTTPS con POST para que los datos de acceso no aparezcan en el historial de la URL ni en los registros de URL. Tras iniciar sesión, el navegador se redirige a /shop; mantenga la misma sesión del navegador para la transferencia del carrito de la compra.
03 / DATOS
Lo que se registra en su ERP.
El formulario de devolución envía los datos de las posiciones mediante un POST del navegador a tu HOOK_URL. Los campos se numeran a partir del 1 para cada posición del carrito. La tabla muestra la asignación predeterminada; los ajustes personalizados del cliente pueden sobrescribir valores concretos.
Precios y plazos de entrega
Precio unitario tras el descuento, moneda y plazo de entrega en días completos.
Clasificación y datos de clientes
Categoría de producto, referencia opcional del cliente e imagen del producto.
Referencia de campo OCI
| Campo | Contenido estándar |
|---|---|
NEW_ITEM-VENDORMAT[1] | N.º de artículo de STASTO. |
NEW_ITEM-DESCRIPTION[1] | Nombre del producto. |
NEW_ITEM-LONGTEXT_1:132[] | Descripción comercial o, en su defecto, el nombre del producto. |
NEW_ITEM-QUANTITY[1] | Cantidad del artículo de la cesta de la compra. |
NEW_ITEM-UNIT[1] | Asignación de unidades específica del cliente; en caso contrario, la unidad OCI registrada; valor por defecto C62. Las comprobaciones estrictas pueden bloquear una asignación no válida. |
NEW_ITEM-PRICE[1] | Precio unitario del carrito de la compra tras aplicar el descuento. |
NEW_ITEM-PRICEUNIT[1] | 1 (precio por unidad). |
NEW_ITEM-CURRENCY[1] | Moneda de la cesta de la compra, por ejemplo, EUR. |
NEW_ITEM-VENDOR[1] | Nombre de la empresa STASTO que realiza la venta. |
NEW_ITEM-LEADTIME[1] | Plazo de entrega en días completos, redondeado al día superior. |
NEW_ITEM-MATGROUP[1] | Código de eClass configurado o valor de reserva de categoría. Consulte las indicaciones sobre clasificación que figuran a continuación. |
NEW_ITEM_ATTACHMENT[1] | URL absoluta de la imagen del producto, siempre que se haya introducido una imagen. |
NEW_ITEM_ATTACHMENT_TITLE[1] | Título del producto correspondiente a la imagen. |
NEW_ITEM-CUST_FIELD1[1] … NEW_ITEM-CUST_FIELD4[1] | Por defecto, está vacío; se pueden configurar valores fijos específicos para cada cliente. |
NEW_ITEM-CUST_FIELD5[1] | Número de artículo del cliente, si se ha definido, o un valor fijo configurado. |
Además, el formulario de devolución envía ~OkCode=ADDI, ~target=_top, ~ForceTarget=yes y ~caller=CTLG. Acordá estos campos de control con tu destinatario en el momento de la aceptación.
eClass, grupos de productos y asignación de unidades
eClass 7.1 es el estándar. eClass 8.1 requiere que el campo correspondiente esté configurado y que los datos estén actualizados. La primera categoría de sitio web asignada proporciona la clasificación; los guiones se eliminan del código.
Si falta el código seleccionado, se comprueba la versión de reserva configurada y, a continuación, se utiliza la categoría interna o «General». Si la clasificación está desactivada, se envía «General». Indique qué valores acepta su ERP.
Los códigos de unidad y los valores fijos de los campos se configuran para la empresa del cliente. El campo «Proveedor» siempre hace referencia a la empresa vendedora. Las imágenes de los productos se transmiten como enlaces; la transferencia de la cesta de la compra no incluye ningún paquete de documentos.
04 / CHECK
Comprobar el proceso completo.
Antes de dar acceso a sus compradores, utilice un entorno de prueba coordinado y una pequeña cesta de la compra de ejemplo.
- Abrir el catálogo desde el ERP y comprobar el contexto del cliente correcto, así como los precios.
- Selecciona dos artículos diferentes y modifica al menos una cantidad.
- Comprueba los números de artículo, la cantidad, la unidad, la moneda, el precio y el plazo de entrega en el resumen de la transferencia.
- Confirmar la devolución y comparar todas las partidas transferidas en el ERP, incluyendo la clasificación y los campos de cliente.
En el carrito de la compra, la opción para vaciarlo está activada de forma predeterminada. El vaciado se lleva a cabo al crear el resumen de transferencia, antes de que el ERP confirme la recepción. Tenga esto en cuenta al realizar una nueva prueba de transferencia.
05 / ASISTENCIA TÉCNICA
¿Tienes alguna duda sobre la conexión?
Cuando realice una solicitud de asistencia, indique su sistema de compras, la hora en que se produjo el intento y el mensaje de error. Comparta los datos de acceso únicamente a través de un canal seguro acordado previamente.
Hablar sobre la conexiónFalta HOOK_URL: ¿qué significa eso?
Su ERP debe indicar la dirección de retorno al abrir /oci/catalog. Compruebe que el nombre HOOK_URL se escriba exactamente así, con mayúsculas, y que la URL esté correctamente codificada.
El registro falla. ¿Qué hay que comprobar?
Comprueba el nombre de usuario y la contraseña acordados para el catálogo, así como el método de inicio de sesión. Un estado HTTP correcto por sí solo no garantiza que el inicio de sesión se haya realizado con éxito: comprueba si el navegador se conecta correctamente a la tienda.
En la cesta de la compra falta el botón «PunchOut».
Inicie la sesión desde su ERP a través de /oci/catalog y añada un artículo. Al acceder directamente a la tienda no se almacena ninguna dirección de retorno de PunchOut. No cambie de sesión del navegador.
El carrito de la compra no se registra en el ERP.
Confirme el segundo paso de la transferencia en el resumen. Compruebe si la dirección de redireccionamiento acepta el envío POST del formulario, si la sesión ha caducado y si el navegador restringe las ventanas incrustadas. Si se ha vaciado la cesta de la compra, compruebe primero el ERP antes de volver a intentarlo.
Una partida se rechaza por motivos relacionados con la unidad o el grupo de productos.
Compare los valores transferidos de UNIT y MATGROUP con los valores permitidos en el ERP. Coordine con STASTO la asignación de unidades, la versión de eClass y los valores de reserva.
¿Se aplica esta guía también a cXML?
Esta guía describe la interfaz OCI implementada. Si se trata de otros protocolos o de requisitos específicos del sistema, consúltelos con STASTO antes de la configuración.
Descubre la tienda.Ir a la guía de la tiendaVer surtido