> For the complete documentation index, see [llms.txt](https://nextcommerce.gitbook.io/nextcommerce-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nextcommerce.gitbook.io/nextcommerce-docs/02-ventas.md).
# Ventas
La sección de **Ventas** (también conocida como Órdenes) te permite gestionar todos los pedidos realizados en tu tienda online.
***
## Vista General
El listado de ventas se divide en dos pestañas:
* **Activas**: Órdenes en proceso o completadas
* **Canceladas**: Órdenes que han sido canceladas
### Columnas del Listado
| Columna | Descripción |
| ------------ | ----------------------------------------------- |
| **#** | Número de orden (ID único) |
| **Fecha** | Fecha y hora de creación |
| **Cliente** | Nombre del cliente (clickeable para ver perfil) |
| **Total** | Monto total de la orden |
| **Pago** | Estado del pago + método de pago |
| **Envío** | Estado del envío + método de entrega |
| **Acciones** | Botones de acción |
***
## Funciones Principales
### Barra de Herramientas
* **🔍 Buscar**: Busca por email, número de orden o nombre del cliente
* **⚙️ Filtrar**: Panel de filtros avanzados
* **📊 Exportar**: Descarga las ventas en Excel
* **➕ Agregar Venta**: Crea una venta manual
### Filtros Avanzados
Haz clic en **Filtrar** para acceder a:
**Por Período:**
* Hoy
* Ayer
* Esta semana
* Este mes
* Período personalizado (desde - hasta)
**Por Estado de Pago:**
* Pendiente
* Autorizado
* Recibido
* Anulado
* Reembolsado
* Abandonado
**Por Estado de Envío:**
* Por empaquetar
* En armado
* Empaquetado
* Enviada
* Devuelto
* Cancelado
***
## Estados de la Orden
### Estados de Pago
| Estado | Color | Descripción |
| --------------- | ----------- | --------------------------------- |
| **Pendiente** | 🟡 Amarillo | Esperando pago |
| **Autorizado** | 🔵 Azul | Pago autorizado pero no capturado |
| **Recibido** | 🟢 Verde | Pago completado |
| **Anulado** | 🔴 Rojo | Pago cancelado |
| **Reembolsado** | 🟣 Púrpura | Dinero devuelto |
| **Abandonado** | ⚫ Gris | Carrito abandonado |
> **💡 Tip**: Haz clic en el estado de pago para cambiarlo rápidamente al siguiente estado en el flujo: Pendiente → Recibido
### Estados de Envío
| Estado | Color | Descripción |
| ------------------ | ----------- | --------------------- |
| **Por empaquetar** | 🟡 Amarillo | Listo para preparar |
| **En armado** | 🔵 Azul | Se está preparando |
| **Empaquetado** | 🟢 Verde | Listo para enviar |
| **Enviada** | 🟢 Verde | En camino al cliente |
| **Devuelto** | 🟣 Púrpura | Devuelto al remitente |
| **Cancelado** | 🔴 Rojo | Envío cancelado |
> **💡 Tip**: Haz clic en el estado de envío para avanzar al siguiente estado: Por empaquetar → En armado → Empaquetado → Enviada
***
## Ver Orden
Para ver el detalle de una orden, haz clic en el **número de orden** o en el botón **👁️ Ver**.
La vista de detalle incluye:
### Información del Cliente
* Nombre completo
* Email
* Teléfono
* Identificación (DNI/CUIT)
### Dirección de Envío
* Calle y número
* Piso y departamento
* Localidad y código postal
* Ciudad y provincia
### Items de la Orden
Listado de productos comprados con:
* Imagen del producto
* Nombre y variante
* Cantidad
* Precio unitario
* Subtotal
### Resumen de la Orden
| Concepto | Descripción |
| ------------- | -------------------------------------- |
| **Subtotal** | Suma de todos los productos |
| **Descuento** | Descuentos aplicados (promociones) |
| **Cupón** | Descuento por código de cupón |
| **IVA** | Impuestos (si aplica) |
| **Envío** | Costo del envío |
| **Recargo** | Recargo por método de pago (si aplica) |
| **Total** | Monto final a pagar |
### Métodos
* Método de pago seleccionado
* Método de envío seleccionado
***
## Crear Venta Manual
Para crear una venta directamente desde el panel:
1. Haz clic en **➕ Agregar Venta**
2. Completa la información:
### Información del Cliente
1. Haz clic en "Buscar cliente" para seleccionar uno existente, o
2. Completa los datos de un nuevo cliente
### Métodos de Pago y Envío
1. Selecciona el método de pago
2. Selecciona el método de envío
3. Los costos se calcularán automáticamente
### Agregar Productos
1. Haz clic en "Agregar producto"
2. Busca y selecciona los productos
3. Ajusta cantidades si es necesario
4. Aplica descuentos por item si corresponde
### Configurar Totales
* **Envío**: Ajusta el costo de envío manualmente si es necesario
* **Descuento**: Aplica descuento porcentual o de monto fijo
* **IVA**: Selecciona 0%, 10.5% o 21%
* **Recargo**: Aplica recargo si el método de pago lo requiere
### Notas
Agrega observaciones internas sobre la orden.
***
## Acciones sobre Órdenes
### Ver (👁️)
Abre la vista de detalle de la orden.
### Imprimir (🖨️)
Genera una versión imprimible de la orden con todos los detalles.
### Cancelar (🚫)
Cancela la orden activa:
1. La orden pasa a la pestaña "Canceladas"
2. Si hay integración ERP, también se cancela en el sistema externo
3. Se envía email de notificación al cliente
### Eliminar (🗑️)
Solo disponible para órdenes canceladas. Elimina permanentemente la orden.
***
## Indicadores Especiales
### Sincronización ERP
Si la orden está sincronizada con un sistema ERP externo, verás un indicador ✓ verde junto al número de orden.
### Notificaciones Automáticas
El sistema envía emails automáticos al cliente cuando:
* Se confirma el pago
* Se cancela la orden
***
## Exportar Ventas
1. Haz clic en **📊 Exportar**
2. Selecciona el período y filtros
3. El archivo Excel incluirá:
* Datos de la orden
* Información del cliente
* Detalle de productos
* Totales y métodos
***
## Paginación
Navega entre las ventas usando los controles de paginación:
* Cambia entre páginas
* Ajusta la cantidad de registros por página (10, 25, 50, 100)
* Visualiza el total de ventas
***
## Carritos en curso
Además del listado de órdenes, la sección de **Carritos en curso** te permite ver los carritos que los clientes iniciaron pero todavía no completaron como compra.
### Acceso
1. En el menú lateral, ve a **Ventas > Carritos en curso**.
2. Verás una tabla con los carritos activos y sus datos principales.
### Barra de herramientas
* **Exportar**: descarga un archivo con los carritos listados (para análisis externo o remarketing).
* **Agregar Carrito**: crea un carrito manualmente (por ejemplo, para asistencia telefónica o ventas internas).
### Búsqueda
En la parte superior:
* Campo **Buscar carritos activos**:
* Podés buscar por email, ID de carrito o nombre del cliente.
* Al presionar **Enter**, se fija un “tag” de búsqueda debajo del campo.
* Podés quitar el filtro haciendo clic en la `X` del tag o en **limpiar búsqueda**.
### Tabla de carritos
En la tabla verás, para cada carrito:
* Cliente / email (si está disponible).
* Fecha de creación.
* Cantidad de ítems del carrito.
* Monto estimado.
* Acciones posibles (por ejemplo, convertir en orden, según la configuración actual).
> **Uso típico**: revisar qué clientes abandonan el proceso de compra y, junto con las notificaciones y campañas de marketing, trabajar en recuperarlos.
### Paginación
Al pie de la pantalla podés:
* Cambiar de página.
* Ajustar la cantidad de carritos por página (10, 25, 50, 100).
* Ver cuántos carritos coinciden con tu búsqueda actual.
***
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://nextcommerce.gitbook.io/nextcommerce-docs/02-ventas.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.