Conectar ShippingEasy: verificar sus credenciales de API

Copie su API Key y su API Secret desde la misma página de API Credentials de ShippingEasy, péguelas en Integration y ejecute la prueba firmada: esta conexión solo verifica credenciales.

El conector de ShippingEasy verifica sus credenciales de API de ShippingEasy en Integration. Ingresa una API Key y un API Secret; cada solicitud se firma con el secret mediante HMAC-SHA256, y el secret en sí nunca se envía en texto plano. Esta conexión es solo para verificación de credenciales: con la Customer API de ShippingEasy no ofrece comparación de tarifas, compra de etiquetas ni consulta de rastreo por número de seguimiento.

Requisitos previos#

• Una cuenta de ShippingEasy, con acceso a Settings → API Credentials.
• Tenga listos su API Key y su API Secret: ambos están en la misma página, Settings → API Credentials (app.shippingeasy.com/settings/api_credentials).
• Sepa para qué sirve esta conexión antes de empezar: solo verifica credenciales. No añade a Integration comparación de tarifas, compra de etiquetas ni consulta de rastreo.

Obtener credenciales#

1. Inicie sesión en ShippingEasy y vaya a Settings → API Credentials (app.shippingeasy.com/settings/api_credentials).
2. En esa página, copie la API Key. Es la clave de API pública de esta cuenta.
3. En la misma página, copie el API Secret. Es el secreto de API privado: cada solicitud se firma con él mediante HMAC-SHA256, y el secret en sí nunca se envía en texto plano.
4. Guarde la Key y el Secret juntos como un par tomado de esa única página, y guarde el Secret en un lugar seguro.

Completar en Integration#

1. Abra Integration → Marketplace → ShippingEasy → Nueva conexión.
2. API Key (api_key), obligatorio: pegue la API Key de ShippingEasy → Settings → API Credentials. Ingrese la Key solo en el campo Key: no la intercambie con el Secret.
3. API Secret (api_secret), obligatorio: pegue el API Secret de la misma página Settings → API Credentials. Se cifra en reposo y nunca se muestra; Integration lo usa para firmar cada solicitud con HMAC-SHA256, y el Secret en sí no se envía en texto plano.

Probar la conexión#

Haga clic en Probar la conexión. La prueba firma una solicitud de solo lectura con su API Secret y lista pedidos con GET https://app.shippingeasy.com/api/orders?per_page=1: solo 1 pedido como sonda. Si pasa, las credenciales firmadas funcionan y pueden listar pedidos. No prueba nada más: no comprueba tarifas, no compra una etiqueta ni busca rastreo, porque esta conexión no ofrece esas funciones.

Mapping / elegir plantilla#

En esta conexión no hay mapping ni plantilla para elegir. No trae pedidos a otro sistema ni mapea servicios de envío: con la Customer API de ShippingEasy, la comparación de tarifas, la compra de etiquetas y la consulta de rastreo por número de seguimiento no se admiten a través de esta conexión, así que no hay nada que mapear para ellas. Si necesita tarifas o etiquetas, haga ese trabajo en la propia ShippingEasy.

Activar#

Tras activar, la conexión se guarda como verificada y queda lista para comprobaciones de credenciales. Nada más empieza a funcionar a través de ella: la comparación de tarifas, la compra de etiquetas y la consulta de rastreo no forman parte de esta conexión, así que siga haciéndolas en la propia ShippingEasy. Si sustituye la API Key o el API Secret en ShippingEasy, actualice ambos valores aquí y pruebe de nuevo.

Preguntas frecuentes#

La prueba falla con 401

La API Key o el API Secret son incorrectos, o los dos se intercambiaron, por lo que la firma HMAC-SHA256 no coincide y ShippingEasy rechaza la sonda firmada.

Vuelva a ShippingEasy → Settings → API Credentials (app.shippingeasy.com/settings/api_credentials), copie la API Key en el campo API Key y el API Secret en el campo API Secret tal cual aparecen en esa misma página, y pruebe de nuevo.

La prueba dice que faltan credenciales

Uno o ambos campos están vacíos. La prueba no puede firmar una solicitud sin la API Key y el API Secret a la vez, así que se detiene antes de ejecutar la sonda.

Complete ambos campos desde la misma página Settings → API Credentials, guarde y pruebe de nuevo. Completar solo uno de los dos no basta.

La prueba pasa, pero no puedo comparar tarifas, comprar una etiqueta ni consultar el rastreo

Ese es el alcance de esta conexión, no un fallo: solo verifica credenciales. Una prueba aprobada solo demuestra que las credenciales firmadas pueden listar pedidos: la Customer API de ShippingEasy no da a esta conexión un endpoint de tarifas, un endpoint de compra de etiquetas ni un endpoint de rastreo por número.

Use esta conexión solo para comprobaciones de credenciales, y siga haciendo tarifas, etiquetas y el resto del trabajo de envíos en la propia ShippingEasy. No espere que una prueba aprobada active esas funciones en Integration.