API DocsCreate Ticket

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:

ProductoUso con AtoShip
Square OnlineSí (e-commerce)
Square POSLimitado (retiro en tienda)
Square for RetailSí (pedidos con envío)

Cómo conectar Square

Conexión por OAuth:

  1. Ve a Configuración de AtoShip
  2. Selecciona Integraciones
  3. Haz clic en Square Online
  4. Inicia sesión en Square
  5. Autoriza a AtoShip
  6. 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)
Completado (Completed)No
Cancelado (Canceled)No
Pendiente de cumplimiento (Needs fulfillment)

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:

  1. Se importa el pedido
  2. Se crea la etiqueta en AtoShip
  3. Se captura el número de seguimiento
  4. Se actualiza Square
  5. 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:

  1. Define un método de envío predeterminado
  2. Configura pesos predeterminados
  3. Activa la importación automática
  4. Configura las notificaciones

Manejo de errores

Problemas comunes:

ErrorCausaSolución
Error de autorizaciónToken vencidoVuelve a conectar
No hay pedidosFiltro demasiado estrictoAjusta la configuración
Falta la direcciónPedido de retiro en tiendaOmitir

Prueba de la integración

Verifica la configuración:

  1. Realiza un pedido de prueba
  2. Comprueba la importación
  3. Crea una etiqueta de prueba
  4. Verifica la actualización en Square

Buenas prácticas

Para vendedores de Square:

  1. Mantén actualizados los pesos de los artículos
  2. Usa SKU consistentes
  3. Monitorea la cola de pedidos
  4. 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:

  1. Revisa el estado del pedido
  2. Verifica si es envío o retiro en tienda
  3. Revisa el filtro de ubicaciones
  4. Prueba la conexión del webhook

Cómo desconectar

Para eliminar la integración:

  1. AtoShip → Configuración
  2. Integraciones → Square
  3. Desconectar
  4. Revoca el acceso en el Panel de Square

Was this article helpful?