Shopify + AtoShip
Importa los pedidos de tu tienda Shopify a atoship, compra etiquetas de USPS / UPS / FedEx con descuento y devuelve el seguimiento y el estado de cumplimiento a la tienda: todo mediante OAuth seguro, sin instalar ningún plugin.
Cómo funciona
A diferencia de WooCommerce, Shopify usa un modelo de app OAuth nativo: no hay ningún plugin que instalar. Instala atoship desde la Shopify App Store (o conéctala desde el panel de atoship), autoriza el acceso en Shopify y los webhooks se encargan del resto en tiempo real.
Conecta por OAuth
Autoriza atoship en tu panel de Shopify
Los pedidos se sincronizan solos
Los pedidos nuevos llegan por webhooks + sincronización programada
Compra la etiqueta y el pedido queda cumplido
El seguimiento y el cumplimiento se devuelven a Shopify
Recorrido completo: desde la instalación en la Shopify App Store hasta la compra de tu primera etiqueta.
Conectar tu tienda
La forma más rápida: la Shopify App Store. Abre apps.shopify.com/atoship, haz clic en Add app, aprueba los permisos y tu tienda quedará conectada: atoship se abre automáticamente. ¿Prefieres empezar desde atoship? Usa los pasos del panel que aparecen más abajo.
Paso 1: iniciar la conexión
En tu panel de atoship, ve a Canales → Agregar canal → Shopify. Ingresa el dominio de tu tienda (por ejemplo, my-store.myshopify.com o solo my-store). Haz clic en Conectar.
Puedes ingresar el dominio completo *.myshopify.como solo el nombre de la tienda: atoship lo normaliza automáticamente.
Paso 2: autorizar en Shopify
Se te redirigirá a tu panel de Shopify. Revisa los permisos que atoship necesita (pedidos, productos, cumplimiento, inventario y envíos) y haz clic en Install app.
atoship solicita acceso de lectura/escritura para pedidos, productos, cumplimientos, inventario y envíos. Tu contraseña de Shopify nunca se guarda: solo un token de acceso seguro y revocable.
Paso 3: verificar la conexión
Tras autorizar, se te redirige de vuelta al panel de atoship. Tu tienda debería aparecer en Canales → Shopify con el estado Activa. Los webhooks se registran automáticamente en segundo plano: los pedidos nuevos empezarán a llegar de inmediato.
Del lado de Shopify, verás atoship listada en Apps en la barra lateral del panel de tu tienda. Los pedidos comenzarán a sincronizarse enseguida.
Comprar etiquetas desde Shopify
Una vez conectada, puedes comprar etiquetas de envío directamente desde tu panel de Shopify, sin necesidad de cambiar al panel de atoship. Hay dos puntos de entrada:
Desde la lista de pedidos (en lote)
Selecciona uno o varios pedidos, haz clic en el menú … y elige atoship - smart label en Apps. Esto te lleva a atoship con esos pedidos ya seleccionados, listos para comparar tarifas y comprar etiquetas en lote.
Desde un solo pedido
Abre cualquier pedido, haz clic en More actions y selecciona atoship - Smart Label. Se te llevará directamente a atoship con los datos del pedido ya rellenados: compara tarifas de transportistas e imprime una etiqueta en segundos.
Ajustes de sincronización
Haz clic en tu tienda conectada y abre la pestaña Ajustes. 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: cada cuánto se traen los pedidos: 1, 2, 4 u 8 horas. Los webhooks brindan actualizaciones en tiempo real entre las sincronizaciones programadas.
- Ventana de sincronización: hasta dónde retroceder para buscar pedidos: 1 semana, 2 semanas o 1 mes.
Filtros de estado del pedido
- Estado de cumplimiento: qué pedidos importar según su estado de cumplimiento. Predeterminado: sin cumplir y parcialmente cumplidos.
- Estado de pago: qué pedidos importar según su estado de pago. Predeterminado: autorizado, pagado y parcialmente reembolsado.
- Excluir países: omite los pedidos que se envían a determinados países.
- Excluir etiquetas: omite los pedidos con ciertas etiquetas de Shopify (por ejemplo,
hold,do-not-ship).
Cumplimiento y seguimiento
- Actualizar estado del pedido: cuándo marcar el pedido de Shopify como cumplido: al comprar la etiqueta, X horas después, a diario a una hora fija, o nunca.
- Desactivar correo de seguimiento: evita que Shopify envíe su correo de confirmación de envío predeterminado. Útil si tú mismo gestionas las notificaciones.
- Sincronizar direcciones automáticamente: envía de vuelta a Shopify las correcciones de dirección hechas en atoship.
Sincronización de productos
- Activar sincronización de productos: importa tu catálogo de productos de Shopify (incluidas variantes, SKU y niveles de inventario) a atoship.
- Colecciones: tanto las colecciones personalizadas como las inteligentes se sincronizan automáticamente cuando la sincronización de productos está activa.
- Peso por defecto: peso predeterminado para los productos sin datos de peso (se usa para calcular las tarifas).
- Dimensiones por defecto: dimensiones de paquete predeterminadas para los productos sin datos de dimensiones.
Qué se sincroniza
Shopify → atoship
- Número de pedido, fecha y totales
- Direcciones de facturación y envío
- Líneas de pedido con SKU, cantidad y peso
- Etiquetas y notas del pedido
- Nombre y correo del cliente
- Productos, variantes y niveles de inventario
- Colecciones personalizadas e inteligentes
- Estado financiero y de cumplimiento
atoship → Shopify
- Número de seguimiento y transportista
- URL de seguimiento
- Actualizaciones del estado de cumplimiento
- Confirmación de envío (dispara el correo de Shopify)
- Notificaciones de entrega y de excepción
El cumplimiento usa la moderna API FulfillmentOrder de Shopify. Cuando se crea una etiqueta en atoship, se envía a Shopify un cumplimiento con la información de seguimiento, que puede notificar automáticamente al cliente.
Webhooks en tiempo real
atoship registra automáticamente los webhooks en tu tienda Shopify durante la conexión. Brindan actualizaciones en tiempo real entre las sincronizaciones programadas: no necesitas configurar nada manualmente.
orders/create— Se hizo un pedido nuevoorders/updated— Se modificó un pedidoorders/fulfilled— Pedido cumplido externamenteorders/cancelled— Pedido canceladoproducts/create— Se agregó un producto nuevoproducts/update— Cambió un productoproducts/delete— Se eliminó un productoapp/uninstalled— App eliminada de la tiendaTodos los webhooks se verifican con firmas HMAC-SHA256. Si desinstalas la app desde Shopify, el webhook app/uninstalled limpia automáticamente la conexión del lado de atoship.
Desconectar
Puedes desconectar desde cualquiera de los dos lados:
- Desde atoship: ve a Canales, busca tu tienda Shopify y haz clic en Eliminar tienda. Los webhooks del lado de Shopify se dan de baja automáticamente.
- Desde Shopify: ve a tu panel de Shopify → Settings → Apps, busca atoship y haz clic en Uninstall. El webhook
app/uninstalledavisa a atoship para que limpie la conexión.
Desconectar no elimina ningún pedido, etiqueta ni dato de seguimiento que ya esté en atoship. Solo detiene la sincronización futura.
Solución de problemas
La redirección de OAuth falla o se agota el tiempo
Asegúrate de ingresar el dominio de tienda correcto. El token de estado de OAuth expira a los 10 minutos: si te demoraste demasiado en la pantalla de consentimiento, vuelve a Canales e inténtalo de nuevo.
La tienda aparece como «ya conectada»
Cada tienda Shopify solo puede estar conectada a una organización de atoship. Si conectaste esta tienda antes con otra cuenta, desconéctala allí primero y luego vuelve a conectarla desde tu cuenta actual.
Los pedidos no se sincronizan
Revisa tus ajustes de sincronización: los pedidos se filtran por estado de cumplimiento (predeterminado: sin cumplir + parcial) y estado de pago (predeterminado: autorizado + pagado + parcialmente reembolsado). Los pedidos que no cumplan estos filtros no se importan. También puedes lanzar una sincronización manual desde la página de ajustes de la tienda.
El seguimiento no aparece en los pedidos de Shopify
Revisa el ajuste «Actualizar estado del pedido». Si está en «nunca», atoship no devolverá los cumplimientos. Cámbialo a «al comprar la etiqueta» para actualizar el seguimiento de inmediato. Verifica también que el pedido tenga cumplimientos (fulfillment orders) abiertos del lado de Shopify.
Los productos no se sincronizan
La sincronización de productos es un interruptor aparte: asegúrate de que esté activada en los ajustes de tu tienda. Los productos se emparejan por vínculos existentes, luego por SKU y luego por UPC. Si no hay coincidencia, se crea un producto nuevo con un SKU generado automáticamente.
Los clientes reciben correos de envío duplicados
Cuando atoship cumple un pedido en Shopify, Shopify envía su correo estándar de confirmación de envío. Si además envías notificaciones desde atoship, activa Desactivar correo de seguimiento en los ajustes de tu tienda para suprimir el correo de Shopify.
Requisitos
- Cualquier plan de Shopify (Basic, Shopify, Advanced o Plus)
- Cuenta de propietario o de personal con permisos para instalar apps
- No se requiere ningún plugin ni cambio de código en tu tienda