Una conexión PunchOut puede ser pequeña, pero cruza empresas. El proveedor controla Magento y el comprador su plataforma. Ambos necesitan la misma respuesta sobre identidad, productos, precios, unidades, devolución y soporte.
Respuesta breve: Empieza con un comprador concreto y un flujo documentado. Recopila mensajes de ejemplo, configura un perfil independiente, mapea artículos, protege endpoints y prueba el carrito dentro de la aprobación real. Añade pedidos, avisos de envío o facturas únicamente como flujos claramente definidos.
1. Definir el alcance
- Identificar organización compradora y plataforma.
- Confirmar OCI o cXML y la versión requerida.
- Decidir si se crean, editan o inspeccionan carritos.
- Elegir web, vista de tienda y moneda Magento.
- Determinar catálogo y precios contractuales.
- Confirmar si el alcance termina al devolver el carrito.
- Describir pedidos, envíos y facturas como flujos separados.
“Conectar Magento con Ariba” no es una especificación suficiente. No define identidad, mensajes ni campos.
2. Asignar responsables
| Área | Responsable proveedor | Responsable comprador | Acordado |
|---|---|---|---|
| Cuenta y catálogo Magento | |||
| Configuración OCI o cXML | |||
| Credenciales y rotación | |||
| Productos y unidades | |||
| Entorno de pruebas | |||
| Aceptación y producción | |||
| Escalado de incidencias |
Los fallos suelen quedar entre dos sistemas. Los responsables evitan que ambos equipos esperen al otro.
3. Reunir el contrato de conexión
Para OCI, solicita requisitos de hook URL, parámetros, retorno, campos, índices, versión y carrito de ejemplo.
Para cXML, solicita un PunchOutSetupRequest saneado, dominios de identidad, reglas de remitente y secreto, operaciones, destino, PunchOutOrderMessage esperado y extrinsics obligatorios.
Para ambos, recopila:
- identificador de producto
- códigos de unidad
- moneda e impuestos
- clasificación
- campos personalizados y validación
- longitudes máximas
- endpoints de prueba y producción
- contacto para mensajes rechazados
4. Configurar el perfil Magento
- Crear un perfil separado para la organización.
- Guardar credenciales de forma segura y planificar su rotación.
- Asociar cliente, empresa o grupo.
- Seleccionar sitio web y vista.
- Elegir mapeo OCI o cXML.
- Restringir direcciones de origen si son estables.
- Permitir solo operaciones necesarias.
- Validar destinos de retorno.
No agrupes compradores no relacionados en un perfil genérico. Separarlos hace más seguros precios, credenciales y diagnóstico.
5. Construir y revisar el mapeo
Documenta la fuente de cada valor. Usa tablas cuando los sistemas empleen códigos distintos y transformaciones solo con una regla empresarial clara.
Revisa SKU o referencia, nombre, cantidad, unidad, precio, moneda, clasificación, URL y campos propios. En productos configurables, acuerda si se necesita el identificador padre, hijo o ambos.
Conserva un ejemplo aprobado por el comprador como referencia para futuros cambios.
6. Probar seguridad y errores
- Credenciales incorrectas se rechazan sin revelar el valor esperado.
- Sesiones caducadas o reutilizadas no alteran otro carrito.
- Las acciones están ligadas al token PunchOut.
- Se rechazan destinos no aprobados.
- XML inseguro o mal formado se detiene.
- Los secretos no aparecen en trazas.
- Los permisos administrativos son mínimos.
- Los reintentos no duplican documentos.
7. Ejecutar la aceptación completa
- Acceso válido y contexto correcto.
- Credenciales erróneas y comprador desconocido.
- Catálogo y precios contractuales.
- Un artículo simple.
- Varios artículos y cantidades.
- Opciones o productos configurables.
- Unidad, moneda, impuestos y clasificación.
- Crear, editar e inspeccionar, si aplica.
- Caducidad, doble envío y botón atrás.
- Aprobación tras devolver el carrito.
- Pedido aprobado hacia Magento, si aplica.
- Envío y factura, si aplican.
Documenta resultado esperado y evidencia. Que la página se abra no constituye una aceptación PunchOut.
8. Preparar la operación
- Acordar ventana de lanzamiento y criterio de vuelta atrás.
- Cambiar credenciales y endpoints mediante un proceso controlado.
- Activar solo el registro necesario.
- Documentar identificadores de correlación y trazas.
- Alertar sobre fallos repetidos y reintentos agotados.
- Registrar contactos de escalado.
- Revisar periódicamente credenciales y mapeos.
- Repetir pruebas tras cambios en Magento, plataforma o catálogo.
Preguntas frecuentes
¿Cuánto tarda una implementación?
Depende más de obtener la especificación, acordar el mapeo y acceder a pruebas que de instalar la extensión. Un comprador estándar es mucho menor que un despliegue con varios compradores y documentos.
¿Conviene empezar con OCI y cXML a la vez?
Solo si dos compradores comprometidos lo requieren. Suele ser más claro completar una conexión real y reutilizar después el modelo operativo.
¿PunchOut necesita integración de pedidos?
No. Acceso y devolución pueden ser el primer alcance completo. Añade pedidos entrantes cuando el pedido aprobado deba crear o actualizar un pedido Magento.
¿Qué debe supervisarse después?
Solicitudes rechazadas, fallos de retorno, valores sin mapear, sesiones caducadas, documentos fallidos y reintentos agotados. Los identificadores de correlación permiten hablar de la misma transacción.