--- audiencia: usuario screen_key: compras/notas-credito titulo: Nota de Crédito de Compra aliases: [nota de credito de compra, nota de crédito de compra, nc compra, nc de compra, nota credito compra, devolucion al proveedor, devolución al proveedor, devolver mercaderia al proveedor, devolver mercadería al proveedor, descuento del proveedor, ajuste de precio del proveedor, bonificacion del proveedor, bonificación del proveedor, acreditar compra, nc parcial de compra, anular nc compra, reversar compra parcial, credito del proveedor, nota credito recibida, documento recibido del proveedor, nc sobre gasto, nota de credito sobre factura de gasto, nc de gasto, acreedor vario, acreedores varios, factura de gasto deducible, credito sobre gasto, nc factura ya pagada, nc sobre factura pagada, que pasa con el pago al emitir nc, se anula el pago con la nc, saldo a favor del proveedor] --- # Nota de Crédito de Compra — Guía para el Usuario Esta guía cubre las **Notas de Crédito de Compra**: el documento que **recibís de un proveedor** cuando le devolvés mercadería, te aplica un descuento posterior a una factura ya cargada, o te corrige un precio. Explica todas las validaciones, el impacto en stock, cuentas por pagar, contabilidad y reportes fiscales, además del manejo de **NC parciales**. > **Clave**: una NC de compra es un **documento que el proveedor te emite a vos**. **No se envía a SIFEN** — es un registro interno para ajustar tu deuda, tu stock y tu IVA Crédito. (Es lo contrario de la *Nota de Crédito de Venta*, que sí es electrónica y la emitís vos al cliente.) --- ## ¿Dónde encuentro esto en el menú? - **Compras → Notas de crédito**: listado de NC de compra registradas, con buscador y filtros. - **Compras → Notas de crédito → Nueva NC de compra**: pantalla completa de alta (`/compras/notas-credito/nueva`). - **Compras → Cuentas a Pagar**: para ver cómo la NC redujo el saldo del proveedor. - **Contabilidad → Asientos**: para ver el asiento inverso generado automáticamente. - **Contabilidad → Conciliación**: origen **"Notas de crédito de compra"**, por si hay que regenerar asientos. - **Reportes → Libro IVA Compras** y **Reportes → Liquidación de IVA**: la NC **resta** del IVA Crédito del período. - **Reportes → Resumen de Compras**: tarjetas **"(−) NC de compra"** y **"Neto (compras − NC)"**. --- ## Conceptos generales ### ¿Qué es una NC de compra? Es el comprobante que el proveedor te entrega para **reducir** una operación de compra previa. Se usa cuando: - **Devolvés mercadería** al proveedor (producto fallado, sobrante, vencido). - El proveedor te da un **descuento** o **bonificación** después de haber facturado. - Hubo un **error de precio** y el proveedor lo corrige a la baja. ### Diferencia con la Nota de Crédito de Venta | Aspecto | NC de **compra** (esta guía) | NC de **venta** | |---|---|---| | Quién la emite | El **proveedor** (vos la recibís) | **Vos** (la emitís al cliente) | | SIFEN | **No** — registro interno | **Sí** — documento electrónico | | Efecto en IVA | Reduce IVA **Crédito** | Reduce IVA **Débito** | | Efecto en cuentas | Reduce **Cuentas por Pagar** | Reduce **Cuentas por Cobrar** | | Stock | **Sale** del depósito (devolución) | **Entra** al depósito (devolución del cliente) | ### ¿Qué impacta al registrar una NC de compra? 1. **Cuentas por Pagar (CxP)**: reduce el saldo pendiente del proveedor (FIFO por vencimiento). 2. **Estado de la compra origen**: se recalcula desde la CxP (ver *"Estado de la compra origen"*). 3. **Stock** (si el ítem afecta stock): **sale** la cantidad devuelta del depósito. 4. **IVA Crédito**: se reduce en el Libro IVA Compras y en la Liquidación de IVA. 5. **Contabilidad**: genera un **asiento inverso** al de la compra. 6. **Auditoría**: todo queda registrado en `audit_logs`. --- ## Prerrequisitos (antes de registrar) Para que la NC funcione completa, conviene tener: - **Proveedor activo** cargado. Si tiene **timbrado** guardado, se **precarga** al seleccionarlo. - **Compra origen** cargada (opcional pero recomendado): al asociarla, la NC hereda **moneda** y **depósito**, y habilita el control de **parciales**. - **Período contable abierto** en la fecha de emisión (si el módulo Contabilidad está activo). Si no hay período abierto, el asiento no se genera (queda en el log). - **Mapeo de conceptos contables** (Contabilidad → Mapeo de Cuentas), como mínimo: - `INVENTARIO` - `IVA_CREDITO_10` y `IVA_CREDITO_5` - Cuenta pasivo del proveedor (`PROVEEDORES` o la específica del proveedor). > Si falta algún mapeo, la NC **se registra igual** (stock y CxP se afectan), pero el **asiento no se genera** — falla en silencio y queda una advertencia en el log del servidor. Completá el mapeo y regenerá desde **Conciliación**. --- ## Alta de una NC de compra Se hace en una **pantalla completa** (no en un modal), igual que una factura. Antes de registrar, siempre se muestra una **preview de confirmación** con todos los datos. ### Cabecera | Campo | Obligatorio | Notas | |---|---|---| | **Proveedor** | Sí | Debe estar activo. Precarga el timbrado si lo tiene. | | **Compra origen** | Recomendado | Se elige desde un buscador. Al asociarla, fija moneda y depósito y habilita parciales. | | **Timbrado** | Sí | Se precarga del proveedor. | | **Establecimiento** | Sí | Se autocompleta con ceros a la izquierda a **3** dígitos (ej. `1` → `001`). Solo números. | | **Punto de expedición** | Sí | Autocompleta a **3** dígitos. Solo números. | | **Número** | Sí | Autocompleta a **7** dígitos (ej. `21` → `0000021`). Solo números. | | **Fecha de emisión** | Sí | Define el período contable y fiscal. | | **Moneda** | Sí | Si hay compra asociada, se toma **de la compra** y queda **solo lectura** (no se puede cambiar). | | **Depósito (salida)** | Según stock | Es el depósito **de donde SALE** la mercadería devuelta. Si hay compra asociada, se toma el de la compra. | | **Motivo** | Recomendado | Texto libre (devolución, ajuste de precios, bonificación, etc.). | > **Número completo**: la NC se identifica por `establecimiento-puntoExpedicion-numero` (ej. `012-021-0000021`). Ese número se usa en las observaciones del movimiento de inventario y en la auditoría. ### Ítems Cada ítem puede venir de **tres orígenes**: 1. **De la compra** (`origen: compra`): al asociar la compra, aparecen sus ítems. La **descripción es fija** (no se edita); solo ajustás cantidad/precio dentro de lo disponible. 2. **Producto del catálogo** (`origen: producto`): buscador de productos reutilizable (el mismo de facturas de compra). Descripción **editable**. Afecta stock. 3. **Concepto libre** (`origen: libre`): texto libre, **sin stock** (para descuentos/ajustes que no devuelven mercadería). Por ítem se define: - **Cantidad**. - **Precio unitario** (se ingresa con el formateador de montos estándar `MonedaInput`). - **% IVA** (10, 5 o exento). El IVA se calcula **incluido** en el precio (convención Paraguay): `IVA = subtotal − subtotal / (1 + tasa/100)`. - **Afecta stock**: si el ítem descuenta inventario. Los conceptos libres nunca afectan stock. --- ## NC parciales (devolución parcial) No estás obligado a acreditar la compra completa. El sistema controla, **por ítem de la compra**, cuánto ya se acreditó: - Cada `compra_det` guarda `cantidad_acreditada_nc` (cuánto de ese ítem ya se devolvió/acreditó con NC). - **Disponible para acreditar** = `cantidad − cantidad_acreditada_nc`. - Al cargar el ítem en la NC, **no podés superar lo disponible** (validación del backend). - Podés emitir **varias NC parciales** contra la misma compra hasta agotar el disponible. ### En el buscador de compras Cuando elegís la compra origen, cada compra muestra su **estado de acreditación**: - **—**: sin NC previa (se puede acreditar todo). - **Parcial** (chip amarillo): ya tiene NC pero queda saldo por acreditar. - **Acreditada total** (chip gris): ya se acreditó todo → la compra **queda bloqueada** (no seleccionable), porque no queda nada por devolver. --- ## Documento origen: compra **o** factura de gasto La NC de compra puede ajustar **dos tipos** de documento origen (o ninguno — concepto libre): - una **compra** (mercadería), o - una **factura de gasto** deducible (servicios, combustible, alquiler, honorarios, etc.). Además del proveedor común, el selector incluye a los **acreedores varios** (proveedores de gastos que no venden mercadería). ### Cómo asociar el origen En **"Documento origen (opcional)"** → *Buscar compra o gasto a asociar* se abre un buscador con **dos pestañas**: - **Compras**: las compras del proveedor (con estado de acreditación, ver arriba). - **Facturas de gasto**: las facturas de gasto **deducibles** del proveedor, con su **estado** (Pendiente / Parcial / Pagada / Contado) y **saldo**. Al elegir una **factura de gasto**: - Se **precargan sus ítems como concepto libre** (descripción, monto e IVA del gasto). Podés editarlos. - Se fija la **moneda** del gasto. - **Nunca afecta stock**: un gasto es un egreso deducible, no mercadería. No pide depósito ni genera movimiento de inventario. - Al registrar, la NC reduce el **saldo por pagar de ese gasto** (si tiene saldo abierto) y genera el asiento inverso. > Solo se listan gastos **deducibles**: una NC de compra aplica sobre el crédito fiscal, así que no tiene sentido sobre un gasto no deducible. ### ¿Y si la factura (compra o gasto) ya estaba **pagada**? **Se puede emitir la NC igual**, y el resultado es el mismo criterio para compras y gastos: | Documento | ¿Qué le pasa al emitir la NC? | |---|---| | La **factura** original | Queda como está (ya emitida). | | El **pago / la Orden de Pago (OP)** | **NO se toca. La plata ya salió — es un hecho real y no se revierte.** | | La **NC** | Se registra + genera el **asiento contable inverso** (reduce IVA Crédito). | Cuando el documento **ya está saldado**, la NC **no encuentra saldo por pagar que reducir**. Como pagaste de más, el proveedor **te queda debiendo** la diferencia → eso es un **saldo a favor** con ese proveedor, que se resuelve: - **aplicándolo a una compra/gasto futuro** de ese proveedor, o - pidiendo un **reembolso** (el proveedor te devuelve la plata → entra como un ingreso). > **Un pago (OP) solo se anula si el pago en sí estuvo mal** (factura equivocada, pago duplicado) — eso es *anular la OP*, una operación aparte que **la NC nunca dispara**. Emitir una NC **nunca** revierte un pago. > > **Estado actual:** hoy el sistema registra la NC + el asiento y **deja la OP intacta** (correcto), pero el saldo a favor **todavía no se guarda** como crédito rastreable para aplicarlo/reembolsarlo — es una mejora planificada (ver *"Limitaciones"*). --- ## Validaciones del backend Al registrar (`POST /nota-credito-compras`): - **Proveedor**: debe existir y estar activo → si no, `"Proveedor no encontrado"`. - **Anti-duplicado**: no puede existir otra NC **no anulada** del mismo proveedor con igual **timbrado + establecimiento + punto de expedición + número** → `"Ya existe una nota de crédito {est}-{pexp}-{num} de este proveedor con ese timbrado"`. - **Compra origen** (si se envía): debe existir en la empresa → `"Compra origen no encontrada"`. - **Depósito**: si el indicado no existe/está inactivo, se resuelve al de la compra o al principal. - **Parciales**: por cada ítem asociado a un `compra_det`, la cantidad no puede superar el disponible (`cantidad − cantidad_acreditada_nc`). - **Confirmación**: la pantalla exige pasar por la **preview** antes de registrar. Al anular (`PATCH /nota-credito-compras/:id/anular`): - **Motivo obligatorio** → `"Debe indicar un motivo de anulación"`. - **No se puede anular dos veces** → `"La nota de crédito ya está anulada"`. --- ## Efectos al registrar (paso a paso) 1. **Stock** (ítems con afecta_stock): movimiento **SALIDA** desde el depósito, con observación `NC compra {numero} — devolución al proveedor`. 2. **Cantidad acreditada**: incrementa `compra_det.cantidad_acreditada_nc` por la cantidad devuelta de cada ítem. 3. **Cuentas por Pagar**: reduce el saldo pendiente del proveedor **FIFO por vencimiento**, acotado a la compra origen. Cada cuota pasa a `parcial` o `pagada` según quede saldo. 4. **Estado de la compra origen**: se recalcula (ver abajo). 5. **Contabilidad**: asiento inverso (ver *"Asiento contable"*). 6. **Auditoría**: acción `CREATE` sobre `nota_credito_compra`, con número, total, CxP reducida y si descontó stock. --- ## Estado de la compra origen El `estado` de una compra **se deriva de su Cuenta por Pagar**, no se marca a mano. Una NC lo actualiza automáticamente: | Situación tras la NC | Estado de la compra | |---|---| | La NC deja el saldo de la CxP en **0** | **Pagada** (saldada — no queda deuda) | | Queda saldo pendiente (`0 < saldo < total`) | **Parcial** | | No cambia el saldo | Se mantiene | > Una compra a **crédito** cuya NC cubre el 100 % pasa a **Pagada** (saldada), aunque no haya habido un pago en efectivo: la deuda se extinguió con el crédito del proveedor. Al **anular** la NC, la CxP se restaura y el estado vuelve a **Pendiente/Parcial**. > > Las compras de **contado** no tienen CxP abierta, así que su estado no se toca. (Ver *"Limitaciones"* sobre el saldo a favor en contado.) --- ## Asiento contable (automático) La NC genera un asiento **inverso** al de la compra. Ejemplo, NC de Gs. 100.000 con IVA 10 %: | Cuenta | Debe | Haber | |---|---:|---:| | Proveedores (pasivo del proveedor) | 100.000 | | | Inventario / Mercaderías | | 90.909 | | IVA Crédito 10 % | | 9.091 | - Tipo de documento contable: `NOTA_CREDITO_COMPRA`. - Se genera en cuanto se registra la NC (fire-and-forget: no bloquea el alta). - **Idempotente**: no duplica el asiento si ya existe uno confirmado. --- ## Anulación de una NC de compra Requiere **motivo**. Al anular se revierte todo, en espejo del alta: 1. **Stock**: repone lo devuelto con un movimiento **ENTRADA**, observación `Anulación NC compra {numero}`. 2. **Cantidad acreditada**: baja `cantidad_acreditada_nc` (nunca por debajo de 0). 3. **Cuentas por Pagar**: restaura el saldo **FIFO simétrico** — reparte el total entre las mismas cuotas que había reducido, sin superar el `monto_original` de cada cuota. 4. **Estado de la compra**: se recalcula (vuelve a Pendiente/Parcial). 5. **Contabilidad**: se genera un asiento de **REVERSIÓN** del asiento original. 6. **Auditoría**: acción `ANULAR` con el motivo. --- ## Reportes fiscales y de gestión - **Libro IVA Compras**: las NC del período aparecen como **filas negativas** (resaltadas en rojo, chip "NC"), y el **crédito fiscal neto** = IVA de facturas − IVA de NC. Los totales dicen "neto de NC". - **Liquidación de IVA (Form. 120)**: el crédito de compras se toma **neto de NC**. El bloque muestra "Compras − N NC". - **Resumen de Compras**: tarjetas **Total Compras** (solo facturas), **(−) NC de compra** y **Neto (compras − NC)**. La tabla de facturas no se mezcla con NC. - **Conciliación Contable**: origen **"Notas de crédito de compra"** (`nota_credito_compra_cab`), con botón *Regenerar* si algún asiento quedó pendiente (típicamente por mapeo incompleto). > Ambos reportes (Libro IVA y Liquidación) **reconcilian** entre sí: el Libro IVA calcula el IVA de la NC desde el detalle y la Liquidación desde el cabezal; como el cabezal y el detalle coinciden, el neto es idéntico. --- ## Detalle de una NC (qué muestra) El detalle enriquece los datos con la **compra origen**: número, fecha de la compra, timbrado de la compra, condición (contado/crédito) y total. Además, el detalle de la **factura de compra** muestra una tarjeta **"NOTAS DE CRÉDITO (NC)"** con las NC vinculadas (número, estado, fecha, monto). Las anuladas se muestran tachadas. --- ## Casos de uso frecuentes - **Devolví 3 de 10 unidades**: NC parcial con esos 3 ítems desde la compra. El resto (7) sigue disponible para otra NC. - **El proveedor me bonificó Gs. X sin devolver nada**: NC con **concepto libre** (sin stock), reduce CxP e IVA Crédito. - **Me facturaron a precio mayor**: NC por la diferencia (concepto libre o ajuste de ítem). - **Devolví toda la compra a crédito**: NC total → la compra pasa a **Pagada** (saldada) y la CxP a 0. --- ## Limitaciones (versión actual) - **Documento ya pagado (compra o gasto)**: si no hay CxP abierta (contado, o crédito ya pagado con OP), la NC **no encuentra saldo que reducir**; el crédito a favor del proveedor **no se materializa** como cuenta por cobrar/nota a favor rastreable (queda como saldo a favor implícito, logueado en la auditoría). El **pago/OP no se revierte** (correcto). Modelar ese saldo a favor —para compras y gastos— es una mejora planificada. - **Costo (COGS)**: el asiento usa el neto de la NC; el costo FIFO exacto que consumió la compra no se re-imputa línea por línea. --- ## Preguntas frecuentes **¿La NC de compra se envía a SIFEN?** No. Es un documento que **recibís** del proveedor; se registra internamente. Solo la NC de **venta** es electrónica. **Registré la NC pero no veo el asiento.** Casi siempre es **mapeo contable incompleto** (falta `INVENTARIO`, `IVA_CREDITO_10/5` o la cuenta del proveedor) o **período cerrado**. Completá el mapeo / abrí el período y **Regenerá** desde Conciliación. **¿Puedo emitir dos NC iguales?** No: hay validación anti-duplicado por proveedor + timbrado + establecimiento + punto + número (entre las no anuladas). **¿Por qué la compra quedó "Pagada" si no pagué nada?** Porque la NC cubrió el 100 % del saldo. "Pagada" significa **saldada** (sin saldo pendiente), no necesariamente pagada en efectivo. Al anular la NC vuelve a Pendiente/Parcial. **Si la factura (compra o gasto acreedor) ya estaba pagada y emito la NC, ¿se anula el pago?** **No.** El pago (la Orden de Pago) **no se toca**: la plata ya salió, es un hecho real. La NC se registra y genera su asiento, pero como no hay saldo por pagar, la diferencia queda como **saldo a favor** del proveedor (para aplicar a una compra/gasto futuro o pedir reembolso). Un pago solo se anula si el pago en sí estuvo mal (factura equivocada, duplicado) — eso es *anular la OP*, algo que la NC nunca dispara. **¿Puedo hacer una NC sobre una factura de gasto?** Sí, si el gasto es **deducible**. En *Buscar compra o gasto a asociar* → pestaña **Facturas de gasto**. Precarga los ítems como concepto libre y **no afecta stock** (un gasto no es mercadería). Reduce el saldo por pagar del gasto si tiene saldo abierto. **¿Puedo cambiar la moneda de la NC?** No si hay compra asociada: se toma la moneda de la compra y queda en solo lectura, para que el crédito cuadre con la operación original. --- ## Endpoints (referencia técnica) | Método | Ruta | Descripción | |---|---|---| | `POST` | `/nota-credito-compras` | Registrar NC (reduce stock/CxP, genera asiento). | | `GET` | `/nota-credito-compras` | Listar. Filtros: `page`, `limit`, `proveedor_id`, `search`, `estado` (`registrada`/`anulada`). | | `GET` | `/nota-credito-compras/:id` | Detalle enriquecido (con datos de la compra origen). | | `PATCH` | `/nota-credito-compras/:id/anular` | Anular (repone stock, restaura CxP, revierte asiento). Body: `{ motivo }`. | | `GET` | `/nota-credito-compras/gastos-origen?proveedor_id=&search=` | Facturas de gasto **deducibles** del proveedor (con estado y saldo) para asociar. | | `GET` | `/nota-credito-compras/gastos-origen/:gastoId` | Detalle del gasto para precargar los ítems (concepto libre). | Tablas: `nota_credito_compra_cab` (con `compra_id` **o** `gasto_id`, excluyentes) / `nota_credito_compra_det`. Seguimiento de parciales de compra: `compra_det.cantidad_acreditada_nc`. Saldo del gasto: `cuentas_pagar` (`origen_tipo='gasto'`). Ver también: [`guia-compras.md`](guia-compras.md), [`guia-gastos.md`](guia-gastos.md), [`guia-contabilidad.md`](guia-contabilidad.md), [`guia-conciliacion-contable.md`](guia-conciliacion-contable.md), [`guia-pagos-a-proveedores.md`](guia-pagos-a-proveedores.md).