Guía de importación de pedidos por CSV
Guía de importación de pedidos por CSV
Importa pedidos desde cualquier origen usando archivos CSV. Ideal para plataformas sin integración directa o para cargar pedidos manualmente.
Cuándo usar la importación por CSV
Ideal para:
- Plataformas sin integración por API
- Carga manual de pedidos
- Importaciones masivas de historial
- Orígenes de pedidos personalizados
- Flujos de trabajo basados en hojas de cálculo
Requisitos del archivo CSV
Especificaciones de formato:
- Formato de archivo: .csv
- Codificación: UTF-8
- Tamaño máximo del archivo: 10MB
- Máximo de filas: 10,000
Columnas obligatorias
Campos mínimos:
| Columna | Descripción | Ejemplo |
|---|---|---|
| order_id | Identificador único | ORD-001 |
| ship_name | Nombre del destinatario | John Smith |
| ship_address1 | Dirección (calle) | 123 Main St |
| ship_city | Ciudad | New York |
| ship_state | Código de estado | NY |
| ship_zip | Código postal | 10001 |
| ship_country | Código de país | US |
Columnas opcionales
Campos adicionales:
| Columna | Descripción |
|---|---|
| ship_address2 | Depto./Suite |
| ship_phone | Número de teléfono |
| ship_email | Correo electrónico |
| weight | Peso del paquete (oz) |
| length | Largo (in) |
| width | Ancho (in) |
| height | Alto (in) |
| service | Servicio de envío |
| items | Descripción de los artículos |
CSV de ejemplo
Archivo de ejemplo:
order_id,ship_name,ship_address1,ship_city,ship_state,ship_zip,ship_country,weight
ORD-001,John Smith,123 Main St,New York,NY,10001,US,16
ORD-002,Jane Doe,456 Oak Ave,Los Angeles,CA,90001,US,8
ORD-003,Bob Wilson,789 Pine Rd,Chicago,IL,60601,US,24
Proceso de importación
Paso a paso:
- Prepara tu archivo CSV
- Ve a Pedidos → Importar
- Haz clic en «Subir CSV»
- Asigna las columnas a los campos
- Previsualiza la importación
- Confirma e importa
Asignación de columnas
Asignación flexible:
- Detección automática de encabezados comunes
- Asignación manual para columnas personalizadas
- Guarda plantillas de asignación
- Reutilízalas en futuras importaciones
Reglas de validación
Comprobaciones previas a la importación:
- Campos obligatorios presentes
- Direcciones válidas
- Formato correcto
- Sin duplicados
Gestión de errores
Errores comunes:
| Error | Causa | Solución |
|---|---|---|
| Dirección inválida | Falta un campo | Completa la dirección |
| Pedido duplicado | Mismo order_id | Elimina el duplicado |
| Estado inválido | Código incorrecto | Usa el código de 2 letras |
| Codificación errónea | No es UTF-8 | Vuelve a guardar como UTF-8 |
Vista previa de la importación
Revisa antes de importar:
- Cantidad de filas
- Cantidad de errores
- Lista de advertencias
- Filas de muestra
Importaciones parciales
Gestión de errores:
- Omite las filas inválidas
- Importa solo las válidas
- Descarga el informe de errores
- Corrige y vuelve a importar
Historial de importaciones
Registra todas las importaciones:
- Fecha y hora
- Nombre del archivo
- Cantidad de filas
- Cantidad de éxitos/errores
- Descarga el archivo original
Plantillas
Plantillas predefinidas:
- Pedidos básicos
- Con dimensiones
- Pedidos internacionales
- Plantillas personalizadas
Exportar plantillas
Obtén una plantilla en blanco:
- Pedidos → Importar
- Descargar plantilla
- Elige el formato
- Completa los datos
Buenas prácticas
Para importaciones exitosas:
- Usa codificación UTF-8
- Incluye los encabezados
- Valida las direcciones primero
- Prueba con un lote pequeño
- Revisa si hay duplicados
Formato de direcciones
Direcciones en EE. UU.:
ship_state: Usa el código de 2 letras (NY, CA)
ship_zip: 5 o 9 dígitos (10001)
ship_country: US
Internacionales:
ship_state: Provincia/región
ship_zip: Formato local
ship_country: Código ISO de 2 letras
Peso y dimensiones
Unidades:
- Peso: onzas (oz)
- Dimensiones: pulgadas (in)
- Convierte si es necesario
Programar importaciones
Opciones automatizadas:
- Subida por SFTP
- Monitoreo programado de carpeta
- Endpoint de subida por API
Pedidos con varios paquetes
Cómo gestionarlos:
- Una fila por paquete
- El mismo order_id
- Un número de seguimiento distinto para cada uno
Después de importar
Siguientes pasos:
- Revisa los pedidos importados
- Verifica las direcciones
- Selecciona el servicio de envío
- Genera las etiquetas
Solución de problemas
La importación falló:
- Revisa la codificación del archivo
- Verifica los encabezados de las columnas
- Revisa el registro de errores
- Valida las direcciones
- Prueba con un lote más pequeño
Limitaciones
Límites actuales:
- 10,000 filas máximo
- 10MB de tamaño de archivo
- Solo UTF-8
- Sin celdas con fórmulas