Introducción
¡Bienvenido a PunchOut Rocket!
Esta guía ofrece un recorrido completo para configurar su cuenta y permitir una integración PunchOut sin interrupciones entre su tienda de comercio electrónico y los sistemas de aprovisionamiento electrónico de sus clientes.
¿Qué es PunchOut Rocket?
PunchOut Rocket es una solución SaaS de middleware que conecta su plataforma de comercio electrónico (WooCommerce, Magento, NopCommerce o una solución personalizada) con cualquier sistema de aprovisionamiento electrónico utilizando protocolos cXML u OCI (como SAP Ariba, Coupa, Jaggaer). Permite a sus clientes empresariales «salir» de su sistema de aprovisionamiento, comprar en su sitio de comercio electrónico en vivo con sus precios de contrato y transferir su carrito de compras de nuevo a su sistema para crear una solicitud de compra, todo en un proceso fluido.
Esta guía cubrirá:
1. Gestión de la cuenta: Registro y gestión de su perfil.
2. Configuración del sitio de comercio electrónico: Conexión de su tienda y activación de una suscripción.
3. Configuración del cliente final: Configuración de la conexión PunchOut específica para cada uno de sus clientes.
4. Configuración del plugin de la plataforma de comercio electrónico: Finalización de la conexión en su tienda.
5. Monitorización: Visualización de los registros de comunicación.
Gestión de la cuenta
1.1. Registro e inicio de sesión por primera vez
Su primer paso es crear una cuenta en la plataforma PunchOut Rocket.
1. Navegue a https://platform.punchoutrocket.com.
2. Haga clic en el enlace «Registrarse».
3. Rellene el formulario de registro con su nombre, datos de la empresa, correo electrónico y una contraseña segura.
4. Haga clic en «Crear cuenta».
5. Una vez registrado, inicie sesión con sus credenciales. Será dirigido al Panel de control principal.


1.2. El Panel de control
El Panel de control es su centro neurálgico. Cuando inicie sesión por primera vez, verá:
Métricas clave: En la parte superior, verá contadores para sus «Sitios de comercio electrónico» y «Clientes finales» configurados.
Visión general del sistema: Un panel de bienvenida que le guía a través de los pasos de configuración inicial.
Información del sistema: Un panel a la derecha que resume los entornos, protocolos y plataformas compatibles.

1.3. Gestión de su perfil
Puede actualizar su información personal y de la empresa en cualquier momento.
- Haga clic en «Mi cuenta» en la barra lateral izquierda.
- Aquí puede modificar:
Información del usuario: Nombre, Apellidos y Contraseña. Tenga en cuenta que su dirección de correo electrónico (nombre de usuario) no se puede cambiar.
Información de la empresa: Nombre de la empresa y número de IVA. - Haga clic en «Guardar» para aplicar los cambios.
Configuración del sitio de comercio electrónico
Esta sección cubre la vinculación de su tienda de comercio electrónico con PunchOut Rocket.
2.1. Añada su sitio de comercio electrónico
Desde el panel «Empezar» del panel de control principal:
- Haga clic en el botón «+ Añadir su primer sitio de comercio electrónico».
- En la página de configuración, rellene los siguientes datos:
Nombre del sitio: Un nombre descriptivo para su tienda (por ejemplo, «Tienda B2B de mi empresa»). Esto es para su referencia interna.
URL del sitio: La URL completa y correcta de su tienda de comercio electrónico (por ejemplo, «https://www.ejemplotienda.com»).
Plataforma: Seleccione la plataforma de su tienda en el menú desplegable (por ejemplo, WooCommerce). - Haga clic en «Guardar».
2.2. Active su suscripción
Después de guardar, su sitio se crea, pero el servicio aún no está activo. Debe activar una suscripción para desbloquear la funcionalidad PunchOut.
- Será redirigido a la página «Editar sitio de comercio electrónico». El Estado se mostrará como Inactivo.
- Un mensaje indicará que necesita «Suscribirse para desbloquear opciones de configuración avanzadas». Haga clic en el botón verde «+ Suscribirse».
- Será redirigido de forma segura a nuestro procesador de pagos (Stripe). Introduzca su información de facturación para iniciar su suscripción.

- Después de un pago exitoso, verá un mensaje de «¡Pago confirmado!». Haga clic en el botón «Volver a la configuración del sitio» para regresar a la plataforma PunchOut Rocket.

2.3. Finalizar la configuración del sitio
WordPress – Woocommerce:

Nombre de usuario de la API:
El nombre de usuario de la API es el nombre de usuario de la aplicación de WordPress que se utiliza para la API REST. Este nombre de usuario es necesario para autenticar las solicitudes de la API entre su sitio de comercio electrónico y la integración de PunchOut Rocket. Introduzca el nombre de usuario apropiado que corresponda a la aplicación de WordPress (https://developer.wordpress.org/rest-api/reference/application-passwords/) que configuró para el acceso a la API.
Contraseña de la API:
La contraseña de la API es la contraseña asociada con la aplicación de WordPress (https://developer.wordpress.org/rest-api/reference/application-passwords/) utilizada para la API REST.
- Si deja este campo vacío, la contraseña actual permanecerá sin cambios.
- Para actualizar la contraseña, introduzca una nueva contraseña de al menos 10 caracteres.
Esta contraseña es crucial para mantener la seguridad de la conexión de la API.
Después de guardar, la contraseña de la API se cifrará por razones de seguridad y el sistema mostrará los últimos 4 caracteres de la misma.
- Número DUNS y ANID (ID de red de Ariba): Estos son identificadores utilizados en el protocolo cXML, a menudo requeridos por sistemas de aprovisionamiento como SAP Ariba.
- Número DUNS: El número de su empresa en el Sistema Universal de Numeración de Datos.
- ANID: Su ID de red de Ariba.
Introduzca estos valores si su cliente final los requiere. Se enviarán de vuelta al sistema de aprovisionamiento del cliente con los datos del carrito.
Magento:

Nombre de usuario de API:
El Nombre de usuario de API es el nombre de usuario asociado al usuario administrador de Magento utilizado para la API REST. Este nombre de usuario es necesario para autenticar las solicitudes de API entre su sitio de comercio electrónico y la integración de PunchOut Rocket.
Contraseña de API:
La Contraseña de API es la contraseña asociada al usuario administrador de Magento utilizado para la API REST.
- Si deja este campo vacío, la contraseña actual no cambiará.
- Para actualizar la contraseña, introduzca una nueva con al menos 10 caracteres.
Esta contraseña es fundamental para mantener la seguridad de la conexión API.
Una vez guardada, la contraseña de la API se cifrará por motivos de seguridad y el sistema mostrará los últimos 4 caracteres de la misma.
- Número DUNS y ANID (Ariba Network ID): estos son identificadores utilizados en el protocolo cXML, a menudo requeridos por sistemas de compras como SAP Ariba.
- Número DUNS: el número del Data Universal Numbering System de su empresa.
- ANID: su ID de Ariba Network.
Introduzca estos valores si su cliente final los requiere. Se enviarán de vuelta al sistema de compras del cliente junto con los datos del carrito.
NopCommerce:

- Clave de API: Esta es una clave secreta que autentica la conexión entre su sitio de comercio electrónico y PunchOut Rocket.
– Haga clic en el botón «Generar» para crear una clave fuerte y única.
– Deberá copiar esta clave y pegarla en la configuración del plugin de PunchOut Rocket en su plataforma de comercio electrónico.
Después de guardar, la clave de API se cifrará por razones de seguridad y el sistema mostrará los últimos 4 caracteres de la misma. - Número DUNS y ANID (ID de red de Ariba): Estos son identificadores utilizados en el protocolo cXML, a menudo requeridos por sistemas de aprovisionamiento como SAP Ariba.
- Número DUNS: El número de su empresa en el Sistema Universal de Numeración de Datos.
- ANID: Su ID de red de Ariba.
Introduzca estos valores si su cliente final los requiere. Se enviarán de vuelta al sistema de aprovisionamiento del cliente con los datos del carrito.
Plataforma de comercio electrónico personalizada:

- Clave de API: Esta es una clave secreta que autentica la conexión entre su sitio de comercio electrónico y PunchOut Rocket.
– Haga clic en el botón «Generar» para crear una clave fuerte y única.
– Deberá copiar esta clave y pegarla en la configuración del plugin de PunchOut Rocket en su plataforma de comercio electrónico.
Después de guardar, la clave de API se cifrará por razones de seguridad y el sistema mostrará los últimos 4 caracteres de la misma. - Número DUNS y ANID (ID de red de Ariba): Estos son identificadores utilizados en el protocolo cXML, a menudo requeridos por sistemas de aprovisionamiento como SAP Ariba.
- Número DUNS: El número de su empresa en el Sistema Universal de Numeración de Datos.
- ANID: Su ID de red de Ariba.
Introduzca estos valores si su cliente final los requiere. Se enviarán de vuelta al sistema de aprovisionamiento del cliente con los datos del carrito.
Configuración del cliente final
Un «Cliente final» representa una de sus empresas cliente que se conecta a través de PunchOut. Cada cliente final tiene su propia configuración única.
4.1. Crear un nuevo cliente final
- En la página de edición de su sitio, desplácese hasta «Clientes finales asociados».
- Haga clic en el botón «+ Añadir cliente final».
4.2. Configuración general del cliente final
- Nombre: Un nombre descriptivo para su empresa cliente (por ejemplo, «Global Corp Inc.»).
- Usuario de comercio electrónico a clonar: Esta es una configuración crítica.
Cómo funciona: Cree una cuenta de usuario dedicada en su tienda de comercio electrónico (por ejemplo, un rol de usuario específico en WooCommerce). Este usuario debe tener los permisos correctos para ver el catálogo de productos y los precios a los que este cliente final específico debe tener acceso. Introduzca la dirección de correo electrónico o el nombre de usuario de ese usuario aquí. Durante una sesión de PunchOut para este cliente final, PunchOut Rocket clonará la sesión de este usuario, asegurándose de que compre con los derechos correctos. - Protocolo: Elija el protocolo que utiliza su sistema: cXML o OCI.
- UNSPSC predeterminado: El Código Estándar de Productos y Servicios de la ONU. Este código se utilizará para cualquier producto que no tenga una categoría específica mapeada a continuación.
- Plazo de entrega predeterminado: El número estimado de días para enviar los productos, enviado para todos los artículos del carrito.
Anulación de EA y Anulación de BX: Algunos sistemas requieren Unidades de Medida (UOM) específicas. «EA» (Unidad) y «BX» (Caja) son comunes. Si el sistema de su cliente requiere códigos diferentes (por ejemplo, «PCE» para «Pieza»), introduzca los valores de anulación aquí.
4.3. Configuración del protocolo (cXML y OCI)
Introduzca las credenciales proporcionadas por el equipo de aprovisionamiento de su cliente. Estas deben coincidir exactamente con la configuración de su sistema.
Para cXML: «FormIdentity», «SenderIdentity», «SharedSecret» y la «URL cXML» de retorno.
Para OCI: Los parámetros clave-valor OCI requeridos, incluyendo `Username` y `Password` y campos opcionales que se devolverán con el carrito al sistema de aprovisionamiento de su cliente.
4.4. Mapeo de categorías
Vincule las categorías de su tienda a los códigos UNSPSC estándar.
- Haga clic en «Actualizar desde el comercio electrónico» para obtener su árbol de categorías.
- Para cada categoría, introduzca, cuando sea posible, el código UNSPSC correspondiente. Esto proporciona datos más ricos al sistema de aprovisionamiento de su cliente.
Configuración del plugin de la plataforma de comercio electrónico
El paso final es instalar y configurar el plugin de PunchOut Rocket en su tienda.
- Descargue e instale el plugin de PunchOut Rocket para su plataforma (WooCommerce, NopCommerce, Magento o Custom en caso de integraciones personalizadas).
- Navegue a la página de configuración del plugin en el panel de administración de su comercio electrónico.
- Copie la clave de API que generó en PunchOut Rocket (Sección 3.3) y péguela en el campo correspondiente en la configuración del plugin.
- Guarde la configuración. Su tienda ya está lista para recibir solicitudes de PunchOut.
Monitorización: Registros de comunicación
PunchOut Rocket registra todas las transacciones para facilitar la resolución de problemas.
- Desde la página de configuración del cliente final, haga clic en el botón «Ver registros».
- El visor de registros muestra todas las solicitudes de PunchOut, transmisiones de carrito y cualquier error. Puede inspeccionar el XML/datos completos de cada transacción, lo que facilita la depuración de problemas de conexión.



