eBay + AtoShip
Importa los pedidos de tu cuenta de vendedor de eBay a atoship, compra etiquetas USPS / UPS / FedEx con descuento y envía de vuelta el seguimiento y la gestión del envío, todo mediante OAuth seguro y sin necesidad de plugins.
Cómo funciona
eBay utiliza OAuth 2.0 para una autorización segura. Conectas tu cuenta de vendedor desde el panel de atoship, autorizas el acceso en eBay y los pedidos se sincronizan según la frecuencia que configures. Cuando compras una etiqueta, la información de seguimiento se envía de vuelta a eBay automáticamente.
Conecta con OAuth
Autoriza atoship en tu cuenta de vendedor de eBay
Los pedidos se sincronizan solos
Los pedidos pagados se importan vía la Fulfillment API
Compra la etiqueta, pedido enviado
El número de seguimiento se envía de vuelta a eBay automáticamente
Conectar tu cuenta de eBay
Paso 1 — Inicia la conexión
En tu panel de atoship, ve a Canales → Agregar canal → eBay. Haz clic en Conectar cuenta de eBay para iniciar el flujo de OAuth.
Se admiten tanto el entorno de sandbox como el de producción de eBay. El sandbox es útil para hacer pruebas antes de salir en vivo.
Paso 2 — Autoriza en eBay
Serás redirigido a la pantalla de consentimiento de eBay. Revisa los permisos que atoship necesita (venta, gestión de envíos) y haz clic en Acepto.
atoship solicita acceso a tus datos de venta y de gestión de envíos. Tu contraseña de eBay nunca se guarda: solo un token OAuth seguro y revocable.
Paso 3 — Verifica la conexión
Tras autorizar, se te redirige de vuelta al panel de atoship. Tu cuenta de eBay debería aparecer en Canales con el estado Activo. Puedes disparar una sincronización manual de inmediato o configurar la sincronización automática.
Sincronización de pedidos
atoship usa la Sell Fulfillment API de eBay para extraer los pedidos. Los pedidos se filtran por fecha de creación y se importan con todos los detalles, incluidos la dirección de envío, las líneas de artículos y la información de pago.
Métodos de sincronización
- Sincronización manual — Haz clic en el botón «Sincronizar pedidos» en la página de tu tienda de eBay para extraer los pedidos cuando quieras.
- Sincronización automática — Activa la sincronización programada (cada 1, 2, 4 u 8 horas) para que los pedidos entren solos de forma continua.
Ventana de sincronización
Configura hasta cuánto tiempo atrás buscar pedidos: 1 semana, 2 semanas o 1 mes. Solo se sincronizan los pedidos dentro de esta ventana. Los pedidos que ya están en el sistema se actualizan (no se duplican), usando el ID de pedido único de eBay.
Gestión de tokens
Los tokens de acceso de eBay caducan a las 2 horas. atoship los renueva automáticamente usando el token de actualización de larga duración (válido durante 18 meses). Si la renovación falla, el estado del canal cambia para indicar que se necesita volver a autorizar.
Gestión de envíos y seguimiento
Cuando compras una etiqueta de envío en atoship para un pedido de eBay, el número de seguimiento y la información del transportista se envían de vuelta a eBay automáticamente vía la Fulfillment API.
Cómo funciona el reenvío del seguimiento
- Compras una etiqueta en atoship (USPS, UPS, FedEx, etc.)
- atoship llama al endpoint de eBay
POST /sell/fulfillment/v1/order/{orderId}/shipping_fulfillment - eBay marca el pedido como «Enviado» y muestra el seguimiento al comprador
- eBay consulta por su cuenta al transportista para obtener actualizaciones del tránsito (in_transit, delivered, etc.)
Solo necesitas enviar el número de seguimiento una vez. A partir de ahí, eBay se encarga automáticamente de toda la consulta de estado al transportista y de las notificaciones al comprador; atoship no necesita hacer ninguna actualización posterior.
Ajustes de sincronización
Haz clic en tu tienda de eBay conectada y luego abre la pestaña Sincronización de pedidos. Esto es lo que hace cada opción:
Sincronización de pedidos
- Sincronización automática — Activa o desactiva la importación automática de pedidos.
- Frecuencia de sincronización — Con qué frecuencia extraer pedidos: 1, 2, 4 u 8 horas.
- Ventana de sincronización — Hasta cuánto tiempo atrás buscar pedidos: 1 semana, 2 semanas o 1 mes.
Gestión de envíos y seguimiento
- Actualizar estado de gestión — Cuando se compra una etiqueta, envía automáticamente el seguimiento y marca el pedido como enviado en eBay.
- Enviar correos de seguimiento — eBay envía notificaciones de seguimiento a los compradores cuando se crea la gestión. Desactiva esto si prefieres encargarte tú de las notificaciones.
Qué se sincroniza
eBay → atoship
- ID de pedido, fecha, totales
- Dirección de envío (de las instrucciones de gestión)
- Líneas de artículos con título, SKU, cantidad y precio
- Nombre de usuario y correo del comprador
- Estado de pago (pagado, reembolsado, etc.)
- Estado de gestión (sin iniciar, en curso, gestionado)
- Notas de pago del comprador
atoship → eBay
- Número de seguimiento
- Código de transportista (USPS, UPS, FedEx, DHL)
- Fecha de envío
- Detalles de gestión por línea de artículo
- Pedido marcado como «Enviado»
La sincronización de pedidos usa la Fulfillment API de eBay con paginación basada en desplazamiento (offset). Los pedidos duplicados se detectan mediante el ID de pedido único de eBay: sincronizar el mismo periodo dos veces no crea duplicados.
Correspondencia de estados
eBay maneja el estado de pago y el de gestión por separado. atoship los asigna a estados unificados:
Estado de pago
PAID→PAIDPENDING→PENDINGPARTIALLY_REFUNDED→PARTIALLY_REFUNDEDFULLY_REFUNDED→REFUNDEDFAILED→FAILEDEstado de gestión
NOT_STARTED→UNFULFILLEDIN_PROGRESS→PARTIALLY_FULFILLEDFULFILLED→FULFILLEDDesconectar
Para desconectar tu cuenta de eBay:
- Desde atoship: Ve a Canales, haz clic en tu tienda de eBay y luego en Eliminar tienda. Escribe «delete» para confirmar. El token OAuth se revoca del lado de atoship.
- Desde eBay: Ve a tu cuenta de eBay → Configuración de la cuenta → Aplicaciones autorizadas, busca atoship y revoca su acceso.
Desconectar no elimina ningún pedido, etiqueta ni dato de seguimiento que ya esté en atoship. Solo detiene las sincronizaciones futuras.
Solución de problemas
La redirección de OAuth falla o se agota el tiempo
El flujo de consentimiento de eBay tiene un límite de tiempo. Si esperaste demasiado, vuelve a Canales e inténtalo de nuevo. Asegúrate de que las ventanas emergentes no estén bloqueadas para ebay.com.
Los pedidos no se sincronizan
Revisa el ajuste de la ventana de sincronización: solo se importan los pedidos dentro del rango de tiempo configurado. Comprueba también que tu cuenta de eBay tenga pedidos recientes con estado de pago «PAID». Puedes disparar una sincronización manual desde la página de ajustes de la tienda.
Token caducado / se necesita volver a autorizar
Los tokens de acceso de eBay caducan cada 2 horas. atoship los renueva automáticamente, pero si el propio token de actualización caduca (a los 18 meses) o se revoca, tendrás que volver a autorizar desconectando y reconectando la tienda.
El seguimiento no aparece en eBay
Asegúrate de que «Actualizar estado de gestión» esté activado en tus ajustes de sincronización. El pedido debe tener un platformOrderId válido para que el reenvío del seguimiento funcione. Revisa los registros del canal si el envío falla.
Sandbox frente a producción
Asegúrate de estar usando el entorno correcto. Los pedidos de sandbox no aparecen en producción y viceversa. El entorno se muestra en la página de detalle de la tienda.
Requisitos
- Cuenta de vendedor de eBay (cualquier nivel: Starter, Basic, Premium, Anchor, Enterprise)
- Anuncios activos y pedidos para sincronizar
- No se requiere ninguna app ni plugin de eBay: la conexión es solo por OAuth
- Mercados admitidos: EE. UU. (ebay.com), con más próximamente