Carga de pedidos mayoristas

Pedidos → Carga mayorista permite registrar desde el dashboard una venta para un cliente mayorista. La orden se crea primero en Tienda Nube, se importa al sistema local y continúa por las mismas colas operativas que cualquier otro pedido.

Antes de cargar el pedido

1. Marcá al comprador como Cliente mayorista desde Clientes. La búsqueda de esta pantalla excluye a los clientes minoristas.
2. Si será delivery, guardá al menos una dirección de facturación/entrega en el cliente. Se pueden almacenar varias y elegir una por pedido.
3. Configurá las zonas y sus precios desde Configuración → Zonas.
4. Revisá los porcentajes de efectivo y transferencia en Configuración → Descuentos → Mayorista.
5. Creá y activá los descuentos de lista que el operador podrá elegir durante la carga.

1. Agregar productos

1. 01Abrí el catálogoPulsá Agregar productos. El panel consulta el catálogo activo de Tienda Nube y permite buscar por nombre.
2. 02Elegí productos y variantesSeleccioná uno o varios productos y confirmá. Si un producto tiene variantes, podés cambiar la elegida o sumar otra variante como una línea adicional.
3. 03Indicá las unidadesDefiní una cantidad mínima de 1 por línea. El precio unitario usa el precio promocional de la variante cuando es válido y menor que el precio normal.

2. Descuentos, entrega y pago

Orden del cálculo

1. Subtotal = suma de precio unitario × cantidad.
2. Si Tienda Nube informa un cupón real, primero se conserva y descuenta ese importe.
3. Después se resta el descuento de lista seleccionado.
4. Sobre el saldo resultante se calcula el descuento mayorista por método de pago.
5. En delivery se suma el precio de la zona.
6. El resultado se guarda como total final del pedido; nunca puede quedar por debajo de cero.

3. Seleccionar y revisar el cliente

1. 01Buscá al mayoristaEscribí nombre, email, teléfono o DNI. Solo aparecen clientes marcados como mayoristas.
2. 02Revisá sus datosPodés corregir nombre, email, teléfono o DNI. Los cambios se guardan automáticamente al confirmar la orden.
3. 03Elegí la direcciónPara delivery, seleccioná una de las direcciones registradas. Esa dirección se envía a Tienda Nube y se geocodifica para crear el destino operativo del reparto.

4. Solicitar factura

Activá Requiere Factura cuando la venta deba pasar por el circuito de comprobantes. Podés usar los mismos datos del cliente del pedido o cargar datos fiscales diferentes.

• Datos obligatorios: nombre, apellido o razón social, CUIT/DNI y email.
• Dato opcional: teléfono.
• Tipos disponibles: Factura A, Factura B y Factura C.
• Si los datos fiscales son distintos, el sistema reutiliza un cliente existente por email o DNI; si no existe, crea el registro necesario para el comprobante.
• El comprobante queda vinculado directamente al pedido, aunque no exista una transacción de caja.

5. Elegir el estado del pago

6. Confirmar y continuar

1. 01ValidaciónEl panel exige cliente, al menos un producto y, para delivery, zona y dirección. Si requiere factura también valida los datos fiscales obligatorios.
2. 02Crear la ordenPulsá Agregar orden. Esperá la pantalla ¡Orden creada con éxito! y el número asignado por Tienda Nube.
3. 03Abrir el resultadoIr al pedido dirige a Por asignar ruta si es delivery o a Por recoger si es retiro. También podés elegir Cargar otro pedido mayorista.

Qué sucede por detrás

1. El dashboard envía la carga al endpoint protegido POST /tienda-nube/wholesale-order.
2. El backend valida que el cliente exista, sea mayorista y que descuentos, zona, dirección y factura sean válidos.
3. Se crea la orden mediante POST /orders de Tienda Nube con sus productos, cliente, dirección, envío, pago y descuento total.
4. El webhook order/created puede llegar al mismo tiempo. La importación es idempotente por TN_ID para evitar pedidos locales duplicados.
5. Después de importar, se aplican los datos mayoristas locales: cliente, método de pago, zona, destino, descuento de lista, descuento por método y estado operativo.
6. Se registra una entrada de trazabilidad con origen Admin y los metadatos principales de la carga.
7. Si se pidió factura, se crea el comprobante pendiente enlazado al pedido para que aparezca en Facturación.