Cómo cargar pedidos
- Vaya a Dashboard -> Orders -> Manage -> Upload orders.
- Descargue la plantilla CSV de la página de carga y complétela con los datos de sus pedidos.
- Cargue su CSV completado.
- Revise la pantalla de confirmación: los landed costs se calculan por fila y los errores o advertencias se muestran en línea.
- Haga clic en Create orders para enviar todos los pedidos con estado Ready.
Formato CSV
Descargue la plantilla CSV directamente desde la página de carga en Dashboard. La plantilla incluye todas las columnas obligatorias y opcionales; las columnas obligatorias están marcadas con un asterisco (*) en la fila de encabezado.
Columnas obligatorias
Cada fila representa un pedido. La información obligatoria de cada fila se divide en tres categorías:
Recipient — El nombre, el correo electrónico, el número de teléfono y la dirección de envío del destinatario, incluido el país de destino. El código postal y el estado/provincia son obligatorios solo para los países cuyo formato de dirección los utiliza; para un país sin códigos postales (por ejemplo, Hong Kong o Tanzania), simplemente deje la celda en blanco. Para los países con una lista de estados/provincias, utilice un nombre o código de región reconocido (por ejemplo, "Dubayy" o "DU" para Dubái) para que los transportistas puedan tarificar el destino.
Items — Como mínimo, nombre del artículo, cantidad y precio. Proporcionar un código HS y el país de origen mejora la precisión de la clasificación y puede reducir el tiempo de procesamiento en la pantalla de confirmación.
Shipping — Un código de nivel de servicio que coincida con un transportista configurado en su cuenta (por ejemplo, fedex.international_priority, ups_worldwide_expedited). La columna Shipping Amount es opcional: ingrese un monto (se permite 0) para usarlo como cargo de envío del pedido, o déjela en blanco y se calculará una estimación de tarifa del transportista para su nivel de servicio. Las filas calculadas tardan unos segundos adicionales cada una en la pantalla de confirmación, y el cargo final del transportista al crear la etiqueta puede diferir de la estimación. Algunos destinos no se pueden tarificar automáticamente (error de "service not available for destination country"); ingrese un monto de envío solo en esas filas; las filas en blanco y completadas pueden mezclarse libremente en un mismo archivo.
Columnas opcionales
Recipient tax ID — Utilice las columnas Tax ID Type y Tax ID Number para incluir un identificador fiscal del destinatario en el pedido. El tipo debe ser uno de los códigos siguientes (sin distinguir mayúsculas de minúsculas). Proporcione ambas columnas juntas; un tipo sin número (o viceversa) se marca como error en la pantalla de confirmación. El identificador fiscal se guarda en el destinatario del pedido y se envía al transportista cuando se crea una etiqueta. Para pedidos con varios artículos, se utiliza el identificador fiscal de la primera fila del pedido.
Utilice el código específico del país cuando exista; para cualquier país no incluido en la lista, utilice TIN.
| Country / Region↕ | Code↕ | Tax ID↕ |
|---|---|---|
| Argentina | CUIL | CUIL or CUIT |
| Argentina/Spain/Peru | DNI | National identity/tax number |
| Australia | OSR | AUSid GST registration |
| Australia/New Zealand | LVG | Overseas registered supplier (low-value goods) |
| Brazil | CNP | CNPJ (business federal tax ID) |
| Brazil | CPF | CPF (individual taxpayer registry) |
| Canada | GST | GST/HST registration number |
| Chile | RUN | Rol Único Tributario (RUT/RUN) |
| European Union | EU_EORI | EU EORI number |
| European Union | IOSS | Import One-Stop Shop number |
| France | FTPC | French customs VAT (low-value) |
| India | PAN | Permanent Account Number |
| Indonesia | NPWP | Tax identification number |
| Mexico | RFC | Registro Federal de Contribuyentes |
| Mexico | CURP | CURP (individuals) |
| Norway | VOEC | VAT on E-Commerce scheme number |
| Norway | VOEC_NO | Norwegian VAT number |
| Saudi Arabia | SA_VAT | Saudi VAT number |
| South Africa | TRN | Tax reference number |
| South Korea | PCC | Personal customs clearance code |
| United Arab Emirates | UAE_TRN | Tax registration number |
| United Kingdom | GB_EORI | UK EORI number |
| United Kingdom | HMRC | UK VAT registration (foreign sellers) |
| United States | EIN | Employer Identification Number |
| United States | SSN | Social Security Number |
| United States | STA | State tax ID |
| Any country | EORI | Economic operator registration ID |
| Any other country | TIN | General tax identification number |
Los códigos adicionales de propósito especial (FED, FTZ, DUN, y las cuentas de aplazamiento de aranceles e impuestos DAN/TAN/DTF) se aceptan cuando su representante de Zonos le indique que utilice uno.
Duty Paid By — DDP o DDU opcional por pedido. Déjelo en blanco para el comportamiento predeterminado: DDP dondequiera que el destino lo admita, con fallback automático a DDU donde no lo admita. Un DDP explícito es estricto: las filas generan error en lugar de hacer fallback, y DDU hace que el destinatario sea responsable de aranceles e impuestos en la entrega. La pantalla de confirmación y la descarga de resultados muestran cuál se aplicó a cada pedido, con una insignia naranja en las filas DDU. En pedidos con varios artículos, gana el primer valor especificado, y los valores conflictivos son un error.
Carton quantity — Si un pedido se envía en varias cajas idénticas, configure Carton Quantity junto con las columnas Carton Length/Width/Height/Weight. Las columnas de cartón describen una caja (el peso es el peso de una sola caja embalada), y la cantidad la multiplica; por ejemplo, 360 unidades empaquetadas 30 por caja utilizarían las dimensiones de la caja, el peso de una caja llena y una cantidad de cartón de 12. En blanco significa 1. Los pedidos con cajas de tamaños mixtos no pueden describirse en el CSV; deje las columnas de cartón en blanco en esos pedidos y Zonos los empaquetará automáticamente según los pesos de los artículos.
Consejos
- Utilice los códigos de nivel de servicio exactos que aparecen en la configuración de transportistas. Las filas con códigos de nivel de servicio no reconocidos mostrarán una advertencia en la pantalla de confirmación.
- Los territorios de EE. UU. difieren: las Islas Vírgenes de EE. UU. usan su propio código de país (
VI) y se envían como internacionales, mientras que Puerto Rico usaUSy se envía como doméstico. - Los transportistas (UPS en particular) rechazan direcciones de apartado postal (P.O. Box); las filas con "P.O. Box" en una línea de dirección pueden fallar la tarificación con un error genérico de disponibilidad de servicio. Use una dirección postal cuando sea posible.
- La puntuación tipográfica de Word o Excel (comillas curvas, guiones en/em) se corrige automáticamente. Los signos de interrogación que aparecen donde deberían ir letras acentuadas indican que el archivo perdió su codificación; esas filas se marcan para que pueda volver a ingresar el texto.
- Para los países de destino que requieren un código de estado o provincia (por ejemplo, Brasil, EE. UU., Canadá), asegúrese de que el campo de estado esté rellenado con el código ISO correcto.
- El
Order IDes obligatorio y debe ser único en toda su cuenta, incluidas cargas anteriores; un ID que se haya usado antes (incluso en un archivo de una temporada anterior o en un pedido cancelado) se rechaza al crear el pedido. ¿Reutiliza un archivo? Añada un sufijo a los ID (por ejemplo,ACALB-33para el volumen 33). El ID aparece en la pantalla de confirmación y se transfiere al pedido creado como referencia del comerciante.
Revisar la pantalla de confirmación
Después de la carga, una pantalla de confirmación muestra el desglose del landed cost calculado para cada pedido antes de crear nada. La pantalla muestra:
| Column↕ | Description↕ |
|---|---|
| Order ID | El ID de referencia de su CSV. |
| Items | Nombre y cantidad del artículo. |
| Recipient | El nombre del destinatario. |
| Country | El país de destino. |
| Duty paid by | Si la cotización seleccionada es DDP (usted paga aranceles e impuestos) o DDU (el destinatario paga en la entrega, con insignia naranja). |
| Service level | El nivel de servicio de envío utilizado para la tarificación. |
| Item total | El valor declarado del artículo. |
| Shipping | El costo de envío calculado. |
| Duties | Los aranceles calculados. |
| Taxes | Los impuestos calculados. |
| Fees | Las tarifas de Zonos. |
| LC total | El landed cost total (aranceles + impuestos + tarifas). |
| Grand total | El total que incluye el valor del artículo y el landed cost. |
| Status | Ready, Warning o Error. |
Las filas pueden mostrar $0 en aranceles, impuestos y tarifas cuando el destino no cobra tasas de importación al valor declarado del envío (está por debajo del umbral de minimis del país); el landed cost es genuinamente cero, no falta, y el envío es el único costo para esos pedidos.
El botón Create orders muestra la cantidad de pedidos que se enviarán (por ejemplo, Create 17 orders). Solo se incluyen las filas con estado Ready o Warning; las filas con errores se excluyen.
Use Download results CSV para exportar el desglose completo de cotizaciones (tarifa seleccionada, total de artículos, envío, aranceles, impuestos, tarifas y totales por pedido), útil para cotizar a sus clientes antes de crear pedidos. Haga clic en Start over para descartar la carga y comenzar de nuevo con un archivo revisado.
Cuando deja Shipping Amount en blanco, la columna de nivel de servicio muestra la tarifa que coincide con el nivel de servicio de su CSV. Si su nivel de servicio solicitado no está disponible para un destino, se selecciona la tarifa disponible más cercana y se marca con una insignia Different service level, o, cuando existen varias alternativas, un menú desplegable Select a rate le permite elegir antes de que se pueda crear el pedido.
Errores y advertencias
Los problemas se marcan en línea en la pantalla de confirmación.
Errores
Las filas con errores se excluyen al hacer clic en Create orders. Corrija el problema en su CSV y vuelva a cargar el archivo para incluir esas filas. Los errores comunes incluyen:
- Low-value orders not allowed — El valor del pedido está por debajo del umbral mínimo de su tienda.
- Invalid state code — El código de estado o provincia no es válido para el país de destino. Obligatorio para países como Brasil, EE. UU. y Canadá.
- Missing required field — Una columna obligatoria está vacía o no se puede analizar.
- Order ID already exists — Cada ID de pedido debe ser único en toda su cuenta, incluidos pedidos de cargas anteriores. Las filas con ID ya usados fallan al crearse mientras el resto del archivo tiene éxito; vuelva a cargar solo las filas fallidas con ID nuevos (un sufijo como
-33funciona bien).
Advertencias
Las filas con advertencias se incluyen en el envío. Revíselas antes de hacer clic en Create orders. Las advertencias comunes incluyen:
- Service level not configured — El código de nivel de servicio de su CSV no está conectado a su cuenta. El pedido se creará, pero puede que no se tarifique correctamente. Verifique la configuración de transportistas o actualice el código de nivel de servicio en su CSV.
Límites y procesamiento por lotes
El límite actual de carga es de 200 pedidos por CSV. Los pedidos se envían en lotes de hasta 50 por llamada a la API; si su carga contiene más de 50 pedidos listos, se procesan automáticamente en varios lotes.
Próximamente: Una actualización futura eliminará el límite de 200 pedidos y añadirá procesamiento de trabajos en segundo plano para cargas más grandes.
Carga masiva de pedidos
Cree hasta 200 pedidos a la vez cargando un archivo CSV.En lugar de crear pedidos uno por uno, puede cargar un archivo CSV para crear pedidos de forma masiva directamente desde Dashboard. Esta es una buena opción cuando necesita procesar un gran número de envíos a la vez. Los landed costs se calculan al momento para cada fila y se muestran en una pantalla de confirmación antes de enviar los pedidos, para que pueda revisar el desglose completo de costos de todo el lote antes de confirmar.