Conectar Overstock: recibir pedidos y enviar fulfillment
Tome la URL base de la API y la clave API de su documentación de integración de socio de Overstock, péguelas en Integration, pruebe, mapee y active.
El conector de Overstock trae pedidos de Overstock — ahora operando como la plataforma Bed Bath & Beyond — a OMS y devuelve fulfillment a la plataforma. También puede enviar actualizaciones de producto e inventario, para que pedidos, envíos y stock estén sincronizados en ambos lados.
Requisitos previos#
- Una cuenta de socio de Overstock que vende en la plataforma ahora con la marca Bed Bath & Beyond.
- Su documentación de integración de socio de Overstock. La URL base de la API y las rutas de los endpoints salen de esa documentación: Overstock no publica una especificación REST, así que los endpoints no se pueden contrastar en ningún otro sitio.
- La clave API de socio emitida para su cuenta, tal como se describe en esa misma documentación de integración. Téngala lista para copiar: la pegará en Integration, no la escriba de memoria.
Obtener credenciales#
- Abra la documentación de integración de socio de Overstock de su cuenta. Los dos valores que necesita — la URL base de la API y la clave API — se toman de esa documentación; no hay una especificación REST pública donde buscarlos en su lugar.
- En esa documentación, encuentre la URL raíz de la API y cópiela exactamente. Es el valor del campo URL base de la API y empieza por https://. Copie la URL raíz tal como está escrita y confirme las rutas de los endpoints con la misma documentación.
- En la misma documentación, encuentre su clave API de socio y cópiela. Guárdela en un lugar seguro: es un secreto, se envía como cabecera x-api-key en cada solicitud e Integration nunca la vuelve a mostrar después de guardar.
Completar en Integration#
- Abra Integration → Marketplace → Overstock → Nueva conexión.
- URL base de la API (obligatorio): pegue la URL raíz de la API copiada de su documentación de integración de socio de Overstock, con la forma https://… . Pegue la URL raíz tal como está en la documentación: no escriba la dirección de la tienda de la plataforma ni adivine una dirección, porque Overstock no publica especificación REST y la documentación es la única fuente de este valor.
- Clave API (obligatorio): pegue la clave API de socio de la misma documentación. Se envía como cabecera x-api-key, se cifra en reposo y nunca se vuelve a mostrar: tras guardar, el campo ya no mostrará la clave, así que conserve su propia copia de la documentación.
Probar la conexión#
Haga clic en Probar la conexión. La prueba usa su URL base de la API y envía su clave API como cabecera x-api-key para comprobar la conectividad, y luego muestra una vista previa a nivel de documento con un pedido real, campos de la plataforma junto al pedido estándar. Si su cuenta aún no tiene pedidos, la conectividad puede pasar igualmente: espere o disponga un pedido real antes de juzgar la vista previa, y vea las preguntas frecuentes si la prueba falla.
Mapping / elegir plantilla#
Elija la plantilla estándar de Overstock. Mapea número de pedido, SKU de línea, cantidades y dirección de envío al pedido estándar, y devuelve fulfillment en formato de la plataforma. Revise la vista previa antes de activar, sobre todo que cada SKU de la plataforma esté vinculado al producto correcto, para que los envíos de producto e inventario informen los artículos correctos.
Activar#
Tras activar, Integration trae nuevos pedidos de Overstock según la frecuencia definida y devuelve fulfillment con tracking, además de actualizaciones de producto e inventario, a la plataforma. Vigile los primeros pedidos en Runs / Logs antes de confiar en el proceso sin supervisión.
Preguntas frecuentes#
La prueba falla: la clave API es rechazada
La clave API es incorrecta. Cada solicitud lleva la clave como cabecera x-api-key, así que una clave copiada con un carácter menos, una clave de otra cuenta o un valor que no sea la clave API de socio será rechazado en la primera llamada: la URL base ni siquiera llega a importar.
Vuelva a su documentación de integración de socio de Overstock, copie de nuevo la clave API de socio desde allí, reemplace el valor de la clave API en la conexión, guarde y pruebe de nuevo. Péguela, no la escriba a mano.
La prueba falla: no se llega a la plataforma con la URL base de la API
La URL base de la API está mal completada. El campo necesita la URL raíz de la API de su documentación de integración; la dirección de la tienda de la plataforma, una dirección de página copiada del navegador o una dirección adivinada apuntan a sitios donde la API no responde. Como Overstock no publica especificación REST, una URL que parece plausible también puede ser incorrecta: solo la documentación define la correcta, rutas de endpoints incluidas.
Abra su documentación de integración, copie de nuevo la URL raíz de la API exactamente como está escrita, reemplace la URL base de la API en la conexión y confirme las rutas de los endpoints con la misma documentación. Guarde y pruebe de nuevo.
Conectado pero no llegan pedidos
La conexión está bien — la prueba pasa — pero la plataforma aún no tiene pedidos nuevos para su cuenta, así que no hay nada que traer. Una conexión que funciona con la lista de pedidos vacía se ve exactamente así hasta que llega el siguiente pedido.
Espere el próximo pedido real en la plataforma, luego ejecute una extracción manual y revise Runs / Logs. Los pedidos nuevos aparecen una vez que la plataforma los emite; si hay pedidos en la plataforma y aun así no aparecen tras una extracción manual, vuelva a contrastar primero la URL base de la API y la clave API con su documentación de integración.