--- audiencia: usuario screen_key: ventas/remisiones titulo: Nota de Remisión aliases: [nota remision, nota de remisión, remisión, remision, remito, traslado de mercadería, mercadería en tránsito, transportista, chofer, vehículo, agente de transporte, facturar remisiones, remisión sin factura, remisionar, documento asociado, itide 7, kude remisión, sifen remisión, motivo de emisión, ecan remisión, salida por remisión, reporte de remisiones, reporte de traslados, reporte por chofer, remisiones pendientes de facturar, logística, kilómetros recorridos, traslados por chofer] --- # Nota de Remisión — Guía para el Usuario Esta guía cubre el módulo de **Nota de Remisión** (comprobante electrónico de traslado de mercadería, tipo de documento SIFEN **7**): cómo se crea, qué datos de transporte exige la SET, cómo mueve el stock, cómo se vincula con las facturas en **ambos sentidos** (facturar remisiones a fin de mes, o generar la remisión desde una factura ya emitida), qué valida el backend antes de aceptarla y cómo se envía a SIFEN. La nota de remisión acompaña físicamente la carga cuando la mercadería sale del depósito. Es obligatoria ante la SET para trasladar bienes por rutas públicas. --- ## ¿Dónde encuentro esto en el menú? - **Ventas → Facturación → Remisiones**: listado y creación de notas de remisión. - **Ventas → Facturación → Remisiones → Nueva Remisión**: formulario de alta. - **POS (Punto de Venta)**: botón **"Facturar Remisiones"** en la cabecera del cliente — para consolidar en una factura las remisiones que salieron sin documento asociado (flujo de fin de mes). - **Contactos**: ABM de las entidades de transporte que la remisión necesita: - **Transportistas** (deben ser contribuyentes con RUC/DV). - **Choferes** (con libreta de conducir y vencimiento de licencia). - **Vehículos** (matrícula o número de identificación / chasis). - **Agentes de transporte** (opcional). - No existe una pantalla "Configuración → Numeraciones": la numeración del tipo de documento **7 (Nota de Remisión)** se administra, como cualquier otro tipo de documento, dentro de un **punto de expedición** en **Configuración → Puntos de Venta → Sucursales y Cajas → [sucursal] → tab Cajas → [caja] → punto de expedición → # NUMERACIONES** (ver `guia-sucursales-cajas-pos.md`). - **Reportes → Logística / Traslados**: reportes de traslados (**Remisiones/Traslados** y **Remisiones pendientes de facturar**). La solapa Remisiones solo aparece si el módulo **REMISION** está activo para la empresa (tier Profesional o superior). --- ## Conceptos generales ### Tipo de documento y numeración La remisión usa el mismo sistema de numeración que las facturas, con **tipo de documento = 7**. El número tiene el formato `EST-PEX-NRO` (ej. `001-001-0000001`). El sistema asigna el número al guardar; si la numeración está inactiva o agotada, el guardado falla. | Código | Tipo de documento | Tabla | |--------|-------------------|-------| | 7 | Nota de Remisión | `nota_remision_cab` | ### Estados de la remisión `Pendiente → Aprobado / Rechazado / Anulado` - **Pendiente**: creada en el ERP, todavía no enviada a SIFEN o sin respuesta. - **Aprobado**: SIFEN la aceptó. Se completan **CDC** (44 dígitos), QR y fecha de firma. - **Rechazado**: SIFEN la rechazó. El motivo queda en "mensaje SIFEN". - **Anulado**: cancelada (repone stock si lo había descontado; ver más abajo). ### CDC, QR y KUDE (PDF) - El **CDC** identifica la remisión ante la SET; se genera al enviar a SIFEN. - El **KUDE** es el PDF con el QR que acompaña la carga. Mientras no esté aprobada, muestra un PDF provisorio. - Al guardar una remisión se abre automáticamente la **vista previa del KUDE** (igual que las facturas). ### Documento asociado Una remisión puede o no referenciar otro comprobante. Es el eje que decide **si mueve stock**: | Tipo | Qué significa | ¿Mueve stock la remisión? | |------|---------------|---------------------------| | **Ninguno** (`tipo_documento_asociado = null`) | La mercadería sale sin factura previa ("remisiono ahora, facturo a fin de mes") | **Sí, descuenta stock al crear** | | **Electrónico** (`1`) | Referencia el **CDC** de una factura electrónica ya emitida | **No** (la factura ya descontó) | | **Impreso** (`2` / `3`) | Referencia un comprobante impreso (timbrado + establecimiento + punto + número + fecha) | No mueve stock automáticamente | --- ## Crear una nota de remisión **Ventas → Facturación → Remisiones → Nueva Remisión.** El formulario tiene cuatro bloques. ### ① Datos del documento - **Cliente / destinatario** (obligatorio): se valida como contribuyente/persona igual que en factura. - **Sucursal**, **punto de expedición**, **numeración** (tipo 7), **fecha de emisión**. - **Motivo de emisión** (obligatorio, selector con buscador). Por defecto arranca en **1 - Traslado por venta**. Catálogo SET: | Código | Motivo | |--------|--------| | 1 | Traslado por venta | | 2 | Traslado por consignación | | 3 | Traslado por devolución | | 4 | Traslado entre locales de la empresa (interno) | | 5 | Traslado por exhibición / demostración | | 6 | Traslado por importación | | 7 | Traslado por exportación | | 99 | Otro (se debe describir manualmente) | - **Responsable de la emisión** (1 = emisor de la factura, 2 = receptor). - **Kilómetros** (obligatorio): distancia total del recorrido. - **Documento asociado**: Ninguno / Electrónico (CDC) / Impreso (timbrado + establecimiento + punto + número + fecha). Al elegir "Ninguno", la remisión descontará stock y aparece el selector de depósito. ### ② Datos de transporte - **Transportista** (obligatorio): **debe ser contribuyente** (con RUC y DV). Se valida en el backend. - **Chofer** (obligatorio): nombre, documento y **dirección obligatoria** (`dDirChof`). - **Vehículo** (obligatorio): según el **tipo de identificación** del vehículo se valida **matrícula** (tipo 1) o **número de identificación / chasis** (tipo 2), con sus límites de longitud. La misma validación aplica en el ABM de vehículos. - **Agente de transporte** (opcional). - **Tipo de transporte** (1 terrestre, 2 fluvial, 3 aéreo, 4 multimodal), **modalidad** (1 carga general, 2 contenedor, 3 granel, 4 refrigerado), **condición de negociación** (Incoterm, opcional). - **Fecha de inicio** y **fecha de fin** del traslado. ### ③ Direcciones (salida y entrega) Departamento → distrito → ciudad (códigos SIFEN), dirección, número de casa, complemento y teléfono para el punto de **salida** y el de **entrega**. Si la remisión referencia una factura electrónica, se pueden tomar los datos de entrega de esa factura (primero hay que seleccionar el cliente). ### ④ Mercaderías - Productos del **catálogo** (obligatorio), con descripción, unidad de medida (código SIFEN), cantidad y precio. **La remisión no lleva IVA**. - **Depósito** (solo cuando la remisión descuenta stock): selector "Depósito (descuenta stock)" con default al **principal ★** de la sucursal. - **Información adicional** (textarea). Al guardar, la remisión queda **Pendiente** y se abre la vista previa del KUDE. Desde el listado se envía a SIFEN. --- ## Impacto en el stock — IMPORTANTE (modelo vigente) > Este es el punto que más cambió respecto de versiones anteriores. **La remisión SÍ puede mover stock por sí sola.** La regla del sistema es: **el stock se mueve al CREAR** (realidad física); la **contabilidad va en la factura** al aprobar SIFEN. La remisión **no genera asiento contable** (no es un hecho fiscal en sí). | Escenario | ¿Afecta stock? | Detalle | |-----------|----------------|---------| | **Remisión SIN documento asociado** | **Sí, descuenta al crear** | Movimiento `SALIDA_REMISION` (permite negativo). Solo productos con `maneja_inventario`. La mercadería físicamente salió. | | **Remisión CON factura electrónica asociada** | **No** | La factura ya descontó el stock → se evita el doble descuento. | | **Remisión rechazada por SIFEN** | **No revierte** | El rechazo no repone; la mercadería igual salió. Solo la anulación repone. | | **Remisión anulada** | **Sí, repone** | Movimiento inverso `ENTRADA_REM_ANULADA` + se revierten las cantidades aplicadas. | | **Factura creada desde remisión** | **No vuelve a descontar** | La remisión ya movió el stock; la factura solo lo vincula (ver flujo abajo). | Consideraciones que respeta el descuento: - **Solo productos con `maneja_inventario = true`** (los de servicio se saltan). - **Política de stock de la sucursal** (`empresas_sucursales.config.politica_stock`): `estricto` **bloquea** la remisión si `disponible < cantidad` (rollback); `advertencia` / `libre` permiten negativo. Mismo criterio que la factura. - La **observación** del movimiento incluye el **número de remisión**, para ubicarlo fácil en Movimientos de Stock. --- ## Vinculación factura ↔ remisión (bidireccional) Una remisión puede estar asociada a **cero, una o varias facturas**, y una factura a **cero, una o varias remisiones**. Se trackea a dos niveles: cabecera (`nota_remision_factura`) y detalle con cantidades (`nota_remision_det_aplicacion`). ### Flujo A — Factura → Remisión (generar remisión desde una factura) Se crea la remisión referenciando una factura electrónica ya emitida. La remisión nace "aplicada" sobre esa factura: cada ítem descuenta de `factura_det.cantidad_aplicada_remision`. **No mueve stock** (la factura ya lo hizo). Es el caso clásico "facturé y ahora despacho". ### Flujo B — Remisión → Factura (facturar remisiones sin documento asociado) Es el caso "**remisiono durante el mes sin factura, y a fin de mes facturo**" consolidando varias remisiones. Se hace **desde el POS**: 1. En el POS, seleccionar el **cliente**. 2. Botón **"Facturar Remisiones"** (aparece con cliente seleccionado). Abre un diálogo con las remisiones **facturables** del cliente: aprobadas, **sin documento asociado**, con saldo por facturar. 3. Elegir una o varias remisiones (multi-select) → **"Cargar al carrito"**. 4. El carrito se **precarga consolidando por `producto + descripción`** (una línea por producto, cantidad sumada de todas las remisiones). Se puede **ajustar antes de facturar**. 5. Facturar normalmente. Qué pasa al facturar desde remisiones: - **No se vuelve a descontar stock** para esos ítems (la remisión ya lo hizo). El descuento se decide **por ítem**: en una misma factura pueden convivir ítems de remisión (no descuentan) con productos agregados manualmente (sí descuentan). - Se crean los vínculos `nota_remision_det_aplicacion` (ítem↔ítem) y `nota_remision_factura` (cabecera), y se incrementa `nota_remision_det.cantidad_facturada`. - La factura envía a SIFEN el grupo **DocumentosAsociados** con el **CDC de cada remisión** (`iTipDocAso: '1'`, `dCdCDERef: `), para cerrar el círculo fiscal. Reglas del flujo B: - **Facturación parcial**: si se factura menos de lo disponible, el remanente **sigue apareciendo** en "Facturar Remisiones" para otra factura. La cantidad facturada se reparte entre las remisiones en orden **FIFO** (la más antigua primero). - **Tope de cantidad**: no se puede facturar **más** de lo remisionado disponible; si se intenta subir la cantidad por encima, el sistema la limita al máximo y avisa. - **Indicador en pantalla**: mientras hay remisiones cargadas, la cabecera del cliente muestra chips con los números de remisión ("Facturando remisiones: 001-001-…"), el botón muestra el conteo, y al reabrir el diálogo aparecen tildadas. Si se borran los ítems del carrito, el indicador se actualiza solo. - **Anular la factura** revierte todo: baja `cantidad_facturada`, borra los vínculos, y la remisión **reaparece** como facturable. **No toca stock** (la factura nunca lo descontó; el stock lo tiene la remisión). ### Dónde ver los vínculos - **Detalle de la remisión** (`RemisionDetalleDialog`): muestra las facturas vinculadas y, por ítem, un chip **"Facturado X / Y"** (verde = total, amarillo = parcial). - **Detalle de la factura** (`FacturaDetalleDialog`): sección "Remisiones vinculadas" + columna "Remisionado X/Y" por ítem. --- ## Reportes de traslados En **Reportes → Logística / Traslados** hay dos reportes de remisiones. ### Remisiones (Traslados) Análisis operativo de los traslados, con un selector **"Agrupar por"** que cubre varias vistas con un mismo reporte: **Chofer, Transportista, Vehículo, Cliente, Destino, Motivo o Estado**. Así, el pedido típico de "reporte por chofer" se obtiene eligiendo esa dimensión, y el mismo reporte sirve por transportista, vehículo, destino, etc. - **Filtros**: rango de fechas (por defecto el mes en curso), estado, estado SIFEN, y facturación (sin facturar / parcial / facturada). - **KPIs**: cantidad de remisiones, kilómetros totales, unidades trasladadas, % facturadas, sin facturar/parcial, anuladas. - **Tabla agrupada** (ej. por chofer): # remisiones, km total, km promedio, unidades, facturadas, pendientes y % del total (participación por unidades). - **Detalle**: botón "Ver detalle" lista una fila por remisión (número, fecha, cliente, chofer, vehículo, origen→destino, km, unidades, estado, facturación). - **Exportar Excel**: genera **dos hojas** — Resumen (agrupado) y Detalle (todas las remisiones del período/filtros, no solo la página visible). Usos típicos: carga de trabajo y kilómetros por **chofer**; despachos por **transportista tercero** (base para liquidar flete); uso de **flota** por vehículo; cobertura por **destino**; y control de **% facturado** para detectar mercadería que salió y no se facturó. ### Remisiones pendientes de facturar Lista de acción: remisiones **aprobadas, sin documento asociado**, que todavía tienen saldo por facturar. Complementa el flujo "Facturar Remisiones" del POS y evita que quede mercadería despachada sin facturar a fin de mes. - Agrupadas **por cliente** (tarjetas expandibles con sus remisiones). - Muestra **días sin facturar** (chip verde <30, amarillo ≥30, rojo ≥60), **unidades pendientes**, chofer y vehículo. - **KPIs**: remisiones sin facturar, unidades pendientes, clientes, antigüedad promedio. - Filtro de **antigüedad mínima** (ej. "más de 30 días sin facturar"). - Botón **"Facturar"** por cliente → abre el POS-Admin para facturar sus remisiones. ### Nota sobre montos Los reportes muestran **métricas operativas** (remisiones, km, unidades, estado de facturación) y **no un valor monetario**: la nota de remisión **no guarda moneda**, y sumar montos de distintas monedas sería incorrecto. Para valorizar traslados se usa la facturación asociada (reportes de Ventas). --- ## Casos de uso y preguntas del usuario Escenarios reales fraseados como los pregunta el usuario final, con la respuesta y los pasos. Sirven para responder consultas directas. ### Traslado y creación **"Necesito llevar mercadería al cliente pero todavía no le facturé. ¿Qué hago?"** Crear una **remisión sin documento asociado** (Ventas → Remisiones → Nueva, opción "Documento asociado: Ninguno"). Esa remisión **descuenta el stock** al guardarse y acompaña la carga. Más adelante facturás con "Facturar Remisiones" desde el POS. **"Ya emití la factura y ahora tengo que despachar la mercadería. ¿Necesito remisión?"** Sí, para trasladar por ruta hace falta el comprobante de traslado. Generá la remisión referenciando esa **factura electrónica** (documento asociado: Electrónico + CDC). En este caso la remisión **no vuelve a descontar stock** (la factura ya lo hizo). **"Quiero mover productos de una sucursal a otra."** Remisión con **motivo 4 – Traslado entre locales de la empresa**. Cargá dirección de salida (origen) y entrega (destino). **"Estoy mandando mercadería en consignación."** Remisión con **motivo 2 – Traslado por consignación**, sin documento asociado (descuenta stock). **"El cliente me devuelve mercadería."** Remisión con **motivo 3 – Traslado por devolución**. **"¿La remisión lleva IVA / precio con impuesto?"** No. La remisión no es un comprobante fiscal de venta: lleva descripción, cantidad y precio de referencia, **sin IVA**. El IVA se liquida en la factura. **"¿Es obligatorio cargar transportista, chofer y vehículo?"** Sí, los tres son obligatorios. El **transportista debe ser contribuyente** (RUC + DV) y tener domicilio fiscal; el **chofer** necesita dirección; el **vehículo**, matrícula o número de identificación según su tipo. Se dan de alta en Contactos. ### Facturación de remisiones (fin de mes) **"Durante el mes remisioné varias veces a un cliente sin factura. ¿Cómo le facturo todo junto?"** En el **POS**: seleccioná el cliente → botón **"Facturar Remisiones"** → marcá las remisiones → "Cargar al carrito". El carrito se arma **consolidando por producto** (suma las cantidades de todas las remisiones). Ajustás si hace falta y facturás. No se vuelve a descontar stock y las remisiones quedan vinculadas. **"El mismo producto salió en dos remisiones distintas. ¿Se factura en dos líneas?"** No, se **consolida en una sola línea** con la cantidad sumada (agrupa por producto + descripción). Internamente el sistema recuerda de qué remisiones vino cada unidad. **"Solo quiero facturar una parte de lo que remisioné, el resto lo facturo después."** Se puede: bajá la cantidad de la línea antes de facturar. El **remanente sigue apareciendo** como facturable para otra factura. El sistema reparte lo facturado entre las remisiones empezando por la más antigua (FIFO). **"¿Puedo facturar más cantidad de la que remisioné?"** No desde ese ítem: el sistema **limita la cantidad al máximo remisionado disponible** y avisa. Si querés vender más, agregá el producto por separado en la factura (ese excedente sí descuenta stock como venta normal). **"En la misma factura quiero poner productos remisionados y otros productos nuevos."** Se puede. El sistema decide **por ítem**: los que vienen de remisión no descuentan stock; los que agregás manualmente sí descuentan normalmente. **"Facturé desde remisiones pero me equivoqué. Anulé la factura. ¿Puedo volver a facturarlas?"** Sí. Al anular, las remisiones **reaparecen** como facturables y las cantidades vuelven a estar disponibles. El stock no se toca (siempre lo tuvo la remisión). **"¿Por qué un cliente no me aparece con remisiones para facturar?"** Solo aparecen remisiones **Aprobadas por SIFEN**, **sin documento asociado** y con **saldo pendiente** (que no se hayan facturado ya). Si la remisión tenía factura asociada, o ya se facturó por completo, no aparece. **"Cargué remisiones en el carrito pero no veo cuáles son."** En la cabecera del cliente aparecen chips con los números ("Facturando remisiones: 001-001-…") y el botón muestra el conteo. Si borrás los ítems del carrito, el indicador se actualiza solo. ### Stock **"¿La remisión me descuenta el stock o no?"** Depende: **sin documento asociado → sí descuenta** (al crearla); **con factura electrónica asociada → no** (ya descontó la factura). Nunca se descuenta dos veces. **"Emití una remisión y el stock no bajó. ¿Está bien?"** Está bien **solo si** la remisión tiene factura electrónica asociada. Si es sin documento asociado, debería descontar — revisá que el producto tenga control de inventario (`maneja_inventario`) y no sea un servicio. **"¿En qué depósito descuenta?"** En el que elegís en el selector "Depósito (descuenta stock)" del formulario; por defecto el **principal ★** de la sucursal. **"No me deja guardar la remisión por falta de stock."** La sucursal tiene **política de stock estricta** y no hay disponible suficiente. Reponé stock, cambiá de depósito, o ajustá la política de la sucursal. **"Anulé una remisión que había descontado stock. ¿Se repone?"** Sí, la anulación **repone** el stock (movimiento inverso). ### Correcciones y anulación **"Me equivoqué en una remisión que ya está aprobada por SIFEN."** No se edita ni se borra directamente. Si pasaron **menos de 7 días** desde el envío, cancelala con el **evento ECAN** (desde el menú de eventos SIFEN). Si pasaron más de 7 días, ya no se puede cancelar por SIFEN. **"¿Cuánto tiempo tengo para cancelar una remisión?"** **7 días (168 horas)** desde el envío a SIFEN — es una ventana más amplia que la de facturas/NC (48 h). **"La remisión está Pendiente hace rato y no se aprueba."** SIFEN no respondió. Usá **Sincronizar estado SIFEN** o reenviala. **"SIFEN me rechazó la remisión."** El motivo queda en "mensaje SIFEN". Corregí el dato (en estado Rechazado se puede editar) y reenviá. Ojo: el rechazo **no repone** el stock que ya se descontó; si no vas a reemitir, anulala para reponerlo. ### Vínculos y trazabilidad **"¿Dónde veo qué facturas se hicieron con una remisión?"** En la **vista detalle de la remisión**: lista las facturas vinculadas y, por ítem, un chip **"Facturado X / Y"** (verde si se facturó todo, amarillo si es parcial). **"¿Dónde veo qué remisiones respaldan una factura?"** En la **vista detalle de la factura**: sección "Remisiones vinculadas" y columna "Remisionado X/Y" por ítem. **"¿Una factura puede tener varias remisiones y una remisión varias facturas?"** Sí, en ambos sentidos (relación muchos-a-muchos). Se trackea con cantidades por ítem. ### Reportes **"Quiero un reporte de las remisiones por chofer / cuántos kilómetros hizo cada uno."** Reportes → **Logística / Traslados → Remisiones (Traslados)**, y en "Agrupar por" elegí **Chofer**. Ves por chofer: cantidad de remisiones, km total, km promedio y unidades. El mismo reporte agrupa por transportista, vehículo, cliente, destino o motivo cambiando el selector. **"¿Cuánta mercadería remisioné y todavía no facturé?"** Reportes → **Logística / Traslados → Remisiones pendientes de facturar**: lista por cliente las remisiones aprobadas sin factura con saldo, con días sin facturar y unidades pendientes. Desde ahí, el botón "Facturar" te lleva al POS. **"Necesito exportar los traslados a Excel."** En "Remisiones (Traslados)", botón **Exportar Excel**: baja dos hojas, Resumen (agrupado) y Detalle (todas las remisiones del período). **"¿Por qué el reporte no muestra el monto / valor en guaraníes?"** Porque la remisión no guarda moneda y sumar montos de distintas monedas sería incorrecto. Los reportes de traslado muestran métricas operativas (remisiones, km, unidades, estado de facturación). Para montos, usá los reportes de Ventas sobre las facturas asociadas. --- ## Envío a SIFEN y eventos - **Enviar a SIFEN**: desde el listado (menú de eventos SIFEN, con gating por permisos y por `sifenActivo`). El payload es `iTiDE = 7`. - **KUDE**: al aprobarse, se genera el PDF oficial con QR (`kude_remision.js` en msv-kude). - **Eventos**: - **ECAN (cancelación)**: la remisión tiene una ventana de **168 horas / 7 días** desde el envío (excepción SIFEN para remisión; factura y NC son 48 h). Pasado ese plazo, el tooltip avisa "Han pasado más de 7 días desde el envío". - **EINU (inutilización)**: con permiso `VEN_REMISION_SIFEN_INUTILIZAR`. - **Sincronizar estado SIFEN**: refleja en el ERP el estado actual del portal. --- ## Validaciones que aplica el backend Antes de enviar al middleware, el backend valida (igual que factura/NC, retornando el error al frontend en vez de guardar igual): - **La nota de remisión debe tener al menos un ítem.** - **Cliente** válido y perteneciente a la empresa (validación de persona/contribuyente). - **Transportista**: debe existir y **ser contribuyente** (RUC + DV según su naturaleza). - **Transportista — domicilio fiscal** (`dDirTrans`) obligatorio. - **Chofer**: nombre, documento y **dirección** (`dDirChof`) obligatorios. - **Vehículo**: identificación válida según el tipo (1 = matrícula, 2 = número de identificación / chasis) y su longitud. - **Transportista / Chofer / Vehículo / Agente no encontrado**: cargar primero el catálogo en Contactos. - **Numeración**: activa y con número disponible ("La numeración está inactiva" / "…alcanzó su límite"). - **Motivo de emisión** válido (catálogo SET; si es 99, describir manualmente). - **Política de stock estricta**: si la remisión descuenta stock y `disponible < cantidad`, se bloquea (rollback). - **La nota de remisión ya está anulada** (al intentar anular dos veces). - En el flujo B (facturar remisiones): la cantidad a facturar por ítem no puede superar `cantidad - cantidad_facturada` de ese ítem de remisión. --- ## Auditoría Todas las operaciones quedan auditadas (`AuditService`, nunca corta el flujo): - **CREATE**: número, cliente / transportista / chofer / vehículo / agente, motivo, transporte, km, direcciones, ítems, documento asociado, si afecta stock y el depósito usado, usuario. - **ANULAR**: estado anterior + cantidad de ítems con stock repuesto. - **Envío SIFEN**: resultado OK/ERROR del middleware. - **Sincronización SIFEN**: transición de estado (Aprobado / Rechazado). - **Factura desde remisiones**: la auditoría de la factura registra cuántas remisiones consolidó (sin descuento de stock). --- ## Consideraciones de seguridad y estado 1. **Multi-tenant**: todos los endpoints filtran por `empresa_id` del usuario autenticado. 2. **Edición**: solo en estado `Pendiente` o `Rechazado`. 3. **Remisión aprobada por SIFEN**: no se puede editar ni anular directamente — requiere evento SIFEN (ECAN). 4. **Cantidades**: siempre se valida `cantidad_a_aplicar <= cantidad_disponible` antes de guardar el vínculo. 5. **Anulación en cascada**: al anular, se revierten todas las aplicaciones y se repone el stock antes de cambiar el estado. 6. **Vínculo consume disponibilidad**: una remisión Pendiente / Rechazada / Aprobada sigue consumiendo la cantidad disponible; solo la **anulación** la libera. --- ## Qué ve cada usuario (alcance por sucursal) Un usuario **asignado a una o más sucursales** ve únicamente las remisiones de esas sucursales, tanto en el listado como en los **dos reportes de traslados**. Uno **sin asignaciones** ve toda la empresa. La remisión es un comprobante fiscal: no guarda la sucursal, se ata a ella por el **punto de establecimiento** (los tres primeros dígitos del número). Si la sucursal no tiene ese código cargado, sus remisiones no se le pueden atribuir a nadie. Detalle completo en `guia-alcance-por-sucursal.md`. --- ## Problemas frecuentes - **"Facturé una remisión pero no aparece vinculada"**: verificar que se usó el botón **"Facturar Remisiones"** del POS (que precarga las aplicaciones). Facturar los mismos productos "a mano" no crea el vínculo. Si la factura se creó antes de esta funcionalidad, quedó sin vincular y además descontó stock; conviene anularla y rehacerla desde el flujo. - **"La remisión descontó stock dos veces"**: no debería. Si el producto salió por remisión sin factura, la factura posterior **no** vuelve a descontar. Si ves doble descuento, revisá que la factura se haya creado desde "Facturar Remisiones" (no manual). - **"El producto de la remisión no descontó stock"**: verificar que tenga `maneja_inventario = true` (los servicios no mueven stock) y que la remisión sea **sin documento asociado** (con factura electrónica, el descuento lo hace la factura). - **"No me deja facturar más cantidad de la que remisioné"**: es correcto — el flujo B limita la cantidad a lo remisionado disponible. Para vender más, agregá el producto aparte (descuenta stock normal). - **"Este cliente no tiene remisiones pendientes de facturar"**: solo aparecen remisiones **Aprobadas**, **sin documento asociado** y con saldo (`cantidad > cantidad_facturada`). - **"SIFEN rechazó la factura por el documento asociado"**: el CDC de la remisión referenciada debe existir y estar **aprobado en SIFEN**. Facturar solo remisiones efectivamente aprobadas. - **"No puedo cancelar la remisión (ECAN)"**: pasaron más de **7 días** desde el envío a SIFEN (ventana de remisión). - **"El transportista no me deja guardar"**: debe ser **contribuyente** (RUC + DV) y tener domicilio fiscal cargado. - **Remisión en "Pendiente" mucho tiempo**: SIFEN no respondió. Usar **Sincronizar estado SIFEN** o reenviar. - **"Un usuario no ve remisiones que sí existen"**: está asignado a una sucursal y sólo ve las de ella. Si no ve **ninguna**, revisar que esa sucursal tenga cargado el punto de establecimiento. Ver `guia-alcance-por-sucursal.md`. - **"Los KPI del reporte de traslados no coinciden entre dos usuarios"**: cada uno mide sobre sus propias sucursales. Comparar también el período de cada pantalla. --- ## Lo que NO se puede hacer - Editar o anular directamente una remisión ya **aprobada por SIFEN** (usar evento ECAN dentro de los 7 días). - Facturar **más** de lo remisionado disponible desde el flujo "Facturar Remisiones". - Usar un transportista que **no sea contribuyente**. - Cargar una remisión sin transportista, chofer o vehículo. - Cancelar por ECAN una remisión con más de 7 días desde el envío. - Anular dos veces la misma remisión. --- ## Limitaciones actuales (MVP) - **Costo (COGS)** de una factura creada desde remisiones cae a `producto.precio_costo`, no al costo FIFO real que consumió la remisión (el stock/lotes ya se consumieron al remisionar). Refinable después. - El flujo **"Facturar Remisiones"** está disponible en **POS-Admin**; en POS-Retail no (retail es contado sin documentos-origen). - **Facturables** = solo remisiones `estado = 'Aprobado'` sin documento asociado. Ajustable si se necesita incluir otros estados. - **Fase 7.3 enterprise** (depósito/cuenta "Mercadería en tránsito" + reclasificación contable en la remisión y reconocimiento de ingreso+COGS al facturar) está **pendiente**; hoy se acepta el desfase intra-mes (inventario baja en la remisión, COGS en la factura). - Deuda de estándar UI en `NuevaRemisionTemplate` (Paper sections / Grid v7 / ScreenGuia / InlineValidationBanner) y cascada de direcciones — ver `plan-nota-remision.md`. --- ## Documentos relacionados - `guia-alcance-por-sucursal.md` — qué remisiones ve cada usuario según sus asignaciones. - `guia-facturacion.md` — facturas, notas de crédito/débito y su relación con remisiones. - `guia-inventario.md` — movimientos que afectan stock y cálculo de costo (FIFO / lotes). - `guia-contactos.md` — ABM de transportistas, choferes, vehículos y agentes. - `guia-sucursales-cajas-pos.md` — política de stock por sucursal y depósito principal. - `plan-nota-remision.md` — diseño técnico completo, modelo de datos, fases y decisiones. - `plan-reportes-remision.md` — diseño de los reportes de traslados (dimensiones, endpoints, decisión multi-moneda).