Integración con Square Online
Integración con Square Online
Integra tu tienda de Square Online con AtoShip para agilizar los envíos de tus pedidos de e-commerce.
Requisitos previos
Antes de empezar:
- Una tienda de Square Online
- Una cuenta de Square (cualquier plan)
- Una cuenta de AtoShip
- Acceso de administrador en Square
Ecosistema de Square
Productos de Square:
| Producto | Uso con AtoShip |
|---|---|
| Square Online | Sí (e-commerce) |
| Square POS | Limitado (retiro en tienda) |
| Square for Retail | Sí (pedidos con envío) |
Cómo conectar Square
Conexión por OAuth:
- Ve a Configuración de AtoShip
- Selecciona Integraciones
- Haz clic en Square Online
- Inicia sesión en Square
- Autoriza a AtoShip
- Selecciona las ubicaciones
Permisos de acceso
A qué accedemos:
- Pedidos (lectura)
- Cumplimiento (actualización)
- Artículos (lectura)
- Clientes (lectura)
- Ubicaciones (lectura)
Importación de pedidos
Qué se importa:
- Detalles del pedido
- Dirección del cliente
- Información de los artículos
- Método de envío seleccionado
- Notas del pedido
Filtrado de pedidos
Condiciones de importación:
| Estado | ¿Se importa? |
|---|---|
| Abierto (Open) | Sí |
| Completado (Completed) | No |
| Cancelado (Canceled) | No |
| Pendiente de cumplimiento (Needs fulfillment) | Sí |
Gestión de ubicaciones
Múltiples ubicaciones:
- Conecta ubicaciones específicas
- Envía desde distintos orígenes
- Inventario por ubicación
Métodos de envío
Vincula los métodos de Square con los transportistas:
Square Method → AtoShip Service
Free Shipping → USPS Ground
Standard → USPS Priority
Express → UPS Ground
Next Day → FedEx Priority
Sincronización de productos
Información del artículo:
- Nombre del producto
- SKU (si está configurado)
- Peso
- Precio
- Variantes
Actualizaciones de cumplimiento
Proceso automático:
- Se importa el pedido
- Se crea la etiqueta en AtoShip
- Se captura el número de seguimiento
- Se actualiza Square
- Se notifica al cliente
Webhooks en tiempo real
Notificaciones de eventos:
- Nuevo pedido creado
- Pedido actualizado
- Pedido cancelado
- Pago completado
Consideraciones de inventario
Gestión de stock:
- Square lleva el control del inventario
- Envía desde el stock disponible
- Actualiza tras el envío
Retiro en tienda vs. envío
Tipos de pedido:
- Pedidos con envío → Usa AtoShip
- Pedidos con retiro en tienda → Gestiónalos en Square
- Pedidos con entrega local → Mensajería local
Comunicación con el cliente
Flujo de notificaciones:
- Square envía la confirmación del pedido
- AtoShip envía la confirmación del envío
- El seguimiento se actualiza automáticamente
- Notificaciones de entrega
Vendedores multicanal
Envíos unificados:
- Pedidos de Square Online
- Pedidos de otros canales
- Una sola cola de envíos
Configuraciones habituales
Consejos de configuración:
- Define un método de envío predeterminado
- Configura pesos predeterminados
- Activa la importación automática
- Configura las notificaciones
Manejo de errores
Problemas comunes:
| Error | Causa | Solución |
|---|---|---|
| Error de autorización | Token vencido | Vuelve a conectar |
| No hay pedidos | Filtro demasiado estricto | Ajusta la configuración |
| Falta la dirección | Pedido de retiro en tienda | Omitir |
Prueba de la integración
Verifica la configuración:
- Realiza un pedido de prueba
- Comprueba la importación
- Crea una etiqueta de prueba
- Verifica la actualización en Square
Buenas prácticas
Para vendedores de Square:
- Mantén actualizados los pesos de los artículos
- Usa SKU consistentes
- Monitorea la cola de pedidos
- Revisa los envíos a diario
Limitaciones
Restricciones actuales:
- Solo envíos dentro de EE. UU.
- Sin Square Invoices
- Solo pedidos de e-commerce
Solución de problemas
Faltan pedidos:
- Revisa el estado del pedido
- Verifica si es envío o retiro en tienda
- Revisa el filtro de ubicaciones
- Prueba la conexión del webhook
Cómo desconectar
Para eliminar la integración:
- AtoShip → Configuración
- Integraciones → Square
- Desconectar
- Revoca el acceso en el Panel de Square