> ## Documentation Index
> Fetch the complete documentation index at: https://help.chateea.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Importar archivo CSV de pedidos: formatos de campo

> Sube pedidos en lote con el formato correcto, incluidos los de varios artículos.

Con la importación por CSV puedes cargar muchos pedidos de una sola vez, por ejemplo ventas que hiciste en otra plataforma. Esta guía te explica cómo preparar el archivo, con el formato y las reglas necesarias para que la importación salga bien.

## Requisitos del archivo

| Requisito | Detalle |
| - | - |
| **Extensión** | El archivo debe estar en formato `.csv` |
| **Encabezados** | Deben coincidir **exactamente** con los del archivo de ejemplo |
| **Una fila por artículo** | Cada fila representa un único artículo del pedido |
| **Campos obligatorios** | Deben estar todos completos para evitar errores |

> [!WARNING]
>
> **Pedidos con varios artículos (la regla que más se confunde):** si un pedido tiene varios artículos, cada artículo va en su **propia fila**, y **todos los campos del pedido se repiten** en cada una (mismo cliente, misma fecha, mismo total).
>
> Es lo que agrupa las filas en un solo pedido. Si no repites los datos del pedido, el sistema los trata como pedidos distintos.

## Descripciones y ejemplos de columnas

Cada columna representa un dato del pedido. Esta es la estructura completa, con su descripción y un ejemplo:

| Columna | Descripción | Ejemplo |
| - | - | - |
| **Nombre del cliente** | Nombre del cliente | Jane |
| **Apellido del cliente** | Apellido del cliente | Smith |
| **Correo del cliente** | Dirección de correo del cliente | [jane.smith@example.com](mailto:jane.smith@example.com) |
| **Teléfono del cliente** | Teléfono (incluye código de país si lo tienes) | +14155552671 |
| **Divisa** | Moneda del pedido (código ISO) | USD |
| **Subtotal** | Costo del pedido antes de impuestos, descuentos y envío | 120.00 |
| **Descuento** | Descuento aplicado al pedido | 10.00 |
| **Importe total del impuesto** | Total de impuesto cobrado | 8.40 |
| **Importe pagado** | Importe final pagado (Subtotal − Descuento + Impuestos) | 118.40 |
| **Fecha del pedido** | Fecha en formato `DD/MM/AAAA` | 25/01/2025 |
| **Hora del pedido** | Hora en formato 24 h `HH:MM` | 00:45 |
| **Método de pago** | Tarjeta de crédito, PayPal, efectivo, ACH | Tarjeta de crédito |
| **Proveedor de pagos** | Pasarela o proveedor que procesó la transacción | Stripe |
| **Nombre del artículo** | Nombre del artículo individual del pedido | Camiseta azul |
| **Cantidad de artículo** | Cantidad de cada artículo | 2 |
| **Precio del artículo** | Precio por unidad, antes de impuestos y descuentos | 25.00 |
| **Dirección Línea 1** | Línea 1 de la dirección del comprador | Calle principal 123 |
| **Ciudad** | Ciudad de la dirección | San Francisco |
| **Estado** | Estado o provincia | California |
| **País** | País del comprador (nombre completo o ISO de 2 letras) | US |
| **Código Postal** | Código postal de la dirección | 94105 |

> [!NOTE]
>
> Los nombres de esta tabla describen cada dato. Al armar tu archivo, usa los encabezados **exactamente** como aparecen en el archivo de ejemplo de la pantalla de importación.

## Errores comunes que debes evitar

| Error | Cómo evitarlo |
| - | - |
| **Fecha u hora incorrecta o vacía** | Respeta `DD/MM/AAAA` y `HH:MM` en 24 horas |
| **Moneda mal escrita** | Usa el ISO de 3 letras: `USD`, no `$` |
| **Correo o teléfono inválido** | Revisa el formato de ambos |
| **Artículos no agrupados** | Repite los datos del pedido en cada fila de artículo |
| **Importes que no cuadran** | Verifica que `Importe pagado = Subtotal − Descuento + Impuesto` |

> [!TIP]
>
> Antes de subir, abre tu CSV y toma un pedido de varios artículos como prueba: confirma que todas sus filas tienen el mismo cliente, la misma fecha y los mismos totales, y que solo cambian el nombre, la cantidad y el precio del artículo. Si eso está bien, el resto suele estarlo.

## Si no puedes cargar el archivo

Revisa el formato con la tabla de arriba. Si el problema sigue, escribe a soporte de Chateea en **[help@chateea.com](mailto:help@chateea.com)** o por WhatsApp al **+1 829-580-7071**.

## Continúa

> **[Importar CSV de transacciones](https://help.chateea.com/docs/pagos/importar-transacciones-csv.md)**
>
> La guía equivalente para registros de pago.

> **[Importar facturas por CSV](https://help.chateea.com/docs/pagos/importar-facturas-csv.md)**
>
> La guía equivalente para facturas.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.