Conectar Ordoro: verificar sus credenciales de API

Cree una clave de API en Ordoro en Settings → Account Settings → API Keys, pegue su Client ID y Client Secret en Integration y pruebe: la prueba usa HTTP Basic para listar sus shippers en modo de solo lectura y confirmar que las credenciales funcionan.

Esta conexión de Ordoro verifica que sus credenciales de API de Ordoro funcionen en Integration: comprueba el Client ID y el Client Secret de una clave de API de Ordoro mediante HTTP Basic y lee su lista de shippers. Tenga claro el alcance: esta conexión es solo para verificación de credenciales. No cotiza tarifas, no compra etiquetas ni busca rastreo por número de seguimiento, porque en Ordoro las tarifas y las etiquetas pasan por endpoints por pedido. Una prueba aprobada solo demuestra que sus credenciales son utilizables, y nada más.

Requisitos previos#

• Una cuenta de Ordoro a la que pueda acceder, con acceso a Settings → Account Settings → API Keys.
• Permiso para crear una clave de API en esa página. Una clave le da los dos valores que necesita: un Client ID y un Client Secret.
• No piense usar aquí su correo y contraseña de acceso a Ordoro. Esa forma de autenticarse en la API ha sido retirada por Ordoro y no funcionará en estos campos: vea la primera entrada de la FAQ.

Obtener credenciales#

1. Inicie sesión en Ordoro y vaya a Settings → Account Settings → API Keys.
2. Cree una clave de API en esa página.
3. Copie el Client ID de la clave que acaba de crear. Este Client ID es el nombre de usuario para la autenticación HTTP Basic.
4. Copie el Client Secret de esa misma clave de API y guárdelo en un lugar seguro. Este Client Secret es la contraseña para la autenticación HTTP Basic, y debe venir de la misma clave que el Client ID anterior.

Completar en Integration#

1. Abra Integration → Marketplace → Ordoro → Nueva conexión.
2. API Key Client ID (client_id): pegue el Client ID de su clave de API de Ordoro, el que copió de Settings → Account Settings → API Keys. Se trata como secreto y nunca se muestra. No complete aquí su correo de acceso a Ordoro.
3. API Key Client Secret (client_secret): pegue el Client Secret de esa misma clave de API. Se trata como secreto y nunca se muestra. No complete aquí su contraseña de acceso a Ordoro, ni combine un Secret de otra clave con el Client ID anterior.
4. Eso es todo: esta conexión tiene solo estos dos campos. No hay ningún campo de número de cuenta, dominio de tienda ni entorno que completar.

Probar la conexión#

Haga clic en Probar la conexión. La prueba primero comprueba que ambos campos estén completos y luego usa HTTP Basic —su Client ID como nombre de usuario y su Client Secret como contraseña— para listar sus shippers en solo lectura (GET /shipper/?limit=1). Si vuelve una lista de shippers, la prueba pasa. Interprete ese resultado de forma estricta: una prueba aprobada solo demuestra que las credenciales de la clave de API pueden autenticarse y leer esa lista. No demuestra que tarifas, etiquetas, pedidos o rastreo funcionen por esta conexión. Si la prueba falla, anote el error y revise la FAQ siguiente.

Mapping / elegir plantilla#

En esta conexión no hay mapping que configurar ni plantilla que elegir. No trae pedidos ni devuelve nada, así que no hay campos de pedido que mapear. La comparación de tarifas, la compra de etiquetas y el rastreo por número de seguimiento tampoco forman parte de esta conexión: en Ordoro, las tarifas y las etiquetas se gestionan mediante endpoints por pedido que parten de un pedido de Ordoro, y la información de rastreo está en el propio pedido. Use esta conexión para el único trabajo que hace —verificar que las credenciales de su clave de API de Ordoro funcionan— y gestione tarifas y etiquetas mediante el flujo por pedido en Ordoro.

Activar#

Cuando la prueba pase, active la conexión para guardarla en Integration con estas credenciales verificadas, así podrá probarla de nuevo más tarde con los mismos valores. La activación no inicia ningún flujo de datos: por esta conexión no se traen pedidos, no se cotizan tarifas, no se compran etiquetas ni se sincroniza rastreo. Si más adelante crea una nueva clave de API en Ordoro, actualice aquí ambos campos con los valores de la nueva clave y pruebe de nuevo antes de confiar en la conexión.

Preguntas frecuentes#

Completé mi correo y contraseña de Ordoro, pero la prueba falla

Estos dos campos no aceptan sus credenciales de acceso. Autenticarse en la API de Ordoro con correo y contraseña ha sido retirado por Ordoro, así que un correo de acceso en el campo Client ID y una contraseña de acceso en el campo Client Secret se rechazan siempre.

Vaya a Ordoro → Settings → Account Settings → API Keys, cree una clave de API, ponga su Client ID en el campo client_id y el Client Secret de esa misma clave en el campo client_secret, y pruebe de nuevo.

La prueba falla con 401

Ordoro no aceptó el par Client ID y Client Secret. Las causas habituales son un error al escribir o copiar, los dos valores intercambiados entre campos, espacios extra copiados con un valor, o un Client ID combinado con el Client Secret de otra clave de API.

Abra la única clave de API que quiere usar en Ordoro → Settings → Account Settings → API Keys, vuelva a copiar ambos valores de esa misma clave sin espacios extra, asegúrese de que el Client ID esté en client_id y el Client Secret en client_secret, y pruebe de nuevo.

La prueba pasó, pero aquí no puedo cotizar tarifas, comprar una etiqueta ni rastrear un envío

Ese es el alcance real de esta conexión, no un fallo de su configuración. En Ordoro, las tarifas y las etiquetas se gestionan mediante endpoints por pedido, así que no hay ninguna llamada independiente de tarifa o etiqueta que esta conexión pueda hacer, y la información de rastreo está en el pedido de Ordoro en lugar de detrás de una búsqueda por número de seguimiento. Esta conexión solo verifica credenciales con una lista de shippers en solo lectura.

Trate una prueba aprobada como prueba de que sus credenciales funcionan, y nada más. Para tarifas y etiquetas, siga el flujo por pedido en Ordoro, partiendo del pedido de Ordoro; para el rastreo, revise la información de envío de ese pedido en Ordoro.

La prueba dice que faltan credenciales

Uno o ambos campos están vacíos. La prueba comprueba primero los campos e informa de credenciales faltantes en lugar de informar de éxito, así que una conexión incompleta nunca puede parecer conectada.

Complete ambos campos —el Client ID de una clave de API de Ordoro en client_id y el Client Secret de esa misma clave en client_secret—, guarde y pruebe de nuevo.