Guía de integración con BigCommerce
Guía de integración con BigCommerce
Conecta tu tienda de BigCommerce con atoship y automatiza tu flujo de envíos con la sincronización de pedidos en tiempo real.
Requisitos previos
Antes de empezar:
- Tienda de BigCommerce (cualquier plan)
- Acceso como propietario o administrador de la tienda
- Cuenta de atoship
- Credenciales de API habilitadas
Métodos de conexión
Dos opciones:
| Método | Configuración | Ideal para |
|---|---|---|
| Instalar la app | 1 clic | La mayoría de los usuarios |
| Claves de API | Manual | Configuraciones personalizadas |
Instalación mediante la app de BigCommerce
Configuración rápida:
- Inicia sesión en BigCommerce
- Ve a Apps → Marketplace
- Busca «atoship»
- Haz clic en Install
- Autoriza los permisos
- Ajusta la configuración
Conexión manual por API
Paso a paso:
- BigCommerce → Settings
- API Accounts → Create
- Define los permisos:
- Orders: Read/Modify
- Products: Read
- Customers: Read
- Copia las credenciales
- Ingrésalas en atoship
Permisos requeridos
Alcances de API:
- Orders (read, modify)
- Fulfillment (create)
- Products (read)
- Customers (read)
Configuración de importación de pedidos
Configura la importación:
- Frecuencia de importación automática
- Filtro por estado del pedido
- Selección de rango de fechas
- Reglas de inclusión/exclusión
Estados de los pedidos
Asignación de estados:
| BigCommerce | Acción |
|---|---|
| Awaiting Fulfillment | Importar |
| Awaiting Shipment | Importar |
| Partially Shipped | Importar |
| Pending | Omitir |
| Shipped | Omitir |
Métodos de envío
Asignar transportistas:
BigCommerce Method → AtoShip Service
Standard Shipping → USPS Ground
Express Shipping → UPS Ground
Priority Shipping → UPS 2nd Day
Overnight → FedEx Priority
Soporte para múltiples escaparates
Función Enterprise:
- Conecta varios escaparates (storefronts)
- Pedidos separados o unificados
- Ajustes por escaparate
Información del producto
Qué se sincroniza:
- Nombre del producto
- SKU
- Peso
- Dimensiones
- Campos personalizados
Actualizaciones de cumplimiento
Sincronización automática:
- Crea la etiqueta en atoship
- Se captura el número de seguimiento
- Se actualiza BigCommerce
- El pedido se marca como enviado
- Se notifica al cliente
Zonas de envío
Configuración de zonas:
- Coincide con las zonas de BigCommerce
- Tarifas distintas por zona
- Opciones internacionales
Notas del pedido
Transferencia de datos:
- Se importan las notas del cliente
- Se incluyen los mensajes de regalo
- Se sincronizan las instrucciones especiales
Sincronización de inventario
Función opcional:
- Sincronización de inventario en dos sentidos
- Actualización de niveles de stock
- Alertas de stock bajo
Pedidos multicanal
Flujo unificado:
- Combina con otros canales
- Una sola cola de envíos
- Proceso consistente
Eventos de webhook
Actualizaciones en tiempo real:
- Notificación de pedido nuevo
- Alertas de cambios en pedidos
- Avisos de cancelación
Manejo de errores
Problemas frecuentes:
| Error | Causa | Solución |
|---|---|---|
| Falló la autenticación | Token vencido | Vuelve a conectar la app |
| Pedido no encontrado | Ya fue cumplido | Omitir |
| Límite de solicitudes | Demasiadas peticiones | Espera y reintenta |
Prueba tu conexión
Pasos de verificación:
- Realiza un pedido de prueba
- Verifica la importación en atoship
- Crea una etiqueta de prueba
- Confirma la actualización en BigCommerce
- Confirma la sincronización del seguimiento
Buenas prácticas
Para BigCommerce:
- Define zonas de envío consistentes
- Activa las notificaciones por webhook
- Revisa la cola de pedidos a diario
- Mantén el inventario exacto
- Supervisa el estado de la sincronización
Solución de problemas
Los pedidos no se importan:
- Revisa el filtro por estado del pedido
- Verifica las credenciales de API
- Revisa la configuración de webhooks
- Prueba la conexión
Desconexión
Para eliminar la integración:
- atoship → Settings
- Integrations → BigCommerce
- Desconectar
- Si lo deseas, revoca las claves de API