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

# Emitir una nota de crédito electrónica

> Tipo de DE 5 — anulación, devolución o descuento sobre una factura previa.

La **Nota de Crédito Electrónica** (`tipo_de: 5`) modifica el efecto fiscal de un comprobante anterior. La usás para:

* **Devolución** de mercadería entregada.
* **Descuento** o **bonificación** posterior a la emisión.
* **Ajuste** de precio cuando se descubre un error en la factura.
* **Crédito incobrable** o **recupero de costos/gastos**.

A diferencia de una factura, una NC siempre **referencia un documento previo** — la factura original que se está modificando.

## Variables del ejemplo

```bash theme={null}
export EMITI_BASE_URL="https://api.emiti.fravelabs.com"
export EMITI_API_KEY="emiti_k_xxxxxxxxxxxxxxxxxxxxxxxx"
```

## Caso 1 — Devolución total de mercadería (NC sobre factura electrónica)

El cliente devolvió la mercadería de la factura `FAC-2026-0001` (CDC `01548730457001001...`). Anulás el efecto fiscal emitiendo una NC por el mismo monto:

```bash theme={null}
curl -s "$EMITI_BASE_URL/v1/de/emitir" \
  -X POST \
  -H "Authorization: ApiKey $EMITI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "establecimiento": "001",
    "punto": "001",
    "tipo_de": 5,
    "id_interno": "NC-2026-0001",
    "motivo_nc": 1,
    "doc_asociado": {
      "tipo": 1,
      "cdc": "01548730457001001000000112026061712345678X"
    },
    "receptor": {
      "nombre": "Empresa Cliente SA",
      "ruc": "80012345-6",
      "tipo_documento": 1,
      "numero_documento": "12345678"
    },
    "items": [
      {
        "descripcion": "Producto X — devolución",
        "cantidad": "1.0",
        "precio_unitario": "100000.00",
        "iva_tipo": 1
      }
    ]
  }'
```

Campos clave:

* `tipo_de: 5` → nota de crédito.
* **`tipo_transaccion` no aplica** a Nota de Crédito/Débito — omitilo (se ignora si lo mandás).
* **`motivo_nc: 1`** → DEVOLUCION\_Y\_AJUSTE. Ver tabla completa abajo.
* **`doc_asociado.tipo: 1`** → documento electrónico. `cdc` es el del DE original.
* Los **datos del receptor deben coincidir** con los de la factura original (mismo RUC).
* **Los items reflejan lo que se está acreditando** — describí claramente que es devolución/descuento/etc.
* **Mismo IVA** que el documento original. Si la factura era IVA 10%, la NC también es IVA 10%.

## Caso 2 — Descuento parcial sobre factura emitida

Acordaste un 10% de descuento sobre la factura `FAC-2026-0042` ya emitida. NC por el monto del descuento:

```json theme={null}
{
  "establecimiento": "001",
  "punto": "001",
  "tipo_de": 5,
  "id_interno": "NC-2026-0002",
  "motivo_nc": 3,
  "doc_asociado": {
    "tipo": 1,
    "cdc": "01548730457001001000000422026061812345678X"
  },
  "receptor": {
    "nombre": "Empresa Cliente SA",
    "ruc": "80012345-6",
    "tipo_documento": 1,
    "numero_documento": "12345678"
  },
  "items": [
    {
      "descripcion": "Descuento 10% sobre factura FAC-2026-0042",
      "cantidad": "1.0",
      "precio_unitario": "150000.00",
      "iva_tipo": 1
    }
  ]
}
```

* `motivo_nc: 3` → DESCUENTO.

## Caso 3 — NC sobre factura impresa (pre-electrónica)

Si el documento original era una factura impresa (talonario físico, anterior a tu migración a SIFEN), `doc_asociado.tipo` cambia y los campos son distintos:

```json theme={null}
{
  "tipo_de": 5,
  "motivo_nc": 2,
  "doc_asociado": {
    "tipo": 2,
    "timbrado": "12345678",
    "establecimiento": "001",
    "punto": "001",
    "numero": "0000123",
    "fecha": "2025-12-15"
  },
  "receptor": { "nombre": "Cliente", "ruc": "80012345-6", "tipo_documento": 1, "numero_documento": "12345678" },
  "items": [ ... ]
}
```

* `doc_asociado.tipo: 2` → IMPRESO.
* Requiere `timbrado`, `establecimiento`, `punto`, `numero` y `fecha` de la factura física.

## Caso 4 — NC sobre una constancia (casos especiales)

Para documentar créditos contra constancias específicas (no-contribuyente o microproductores):

```json theme={null}
{
  "tipo_de": 5,
  "doc_asociado": {
    "tipo": 3,
    "constancia_tipo": 1,
    "constancia_numero": "123456789",
    "constancia_control": "ABCD1234"
  },
  ...
}
```

* `doc_asociado.tipo: 3` → CONSTANCIA.
* `constancia_tipo`: `1` NO\_CONTRIBUYENTE, `2` MICROPRODUCTORES.
* `constancia_numero` hasta 15 dígitos; `constancia_control` exactamente 8 caracteres alfanuméricos.

## Motivos de NC (`motivo_nc`)

| Valor | Motivo                | Cuándo usarlo                                    |
| ----- | --------------------- | ------------------------------------------------ |
| `1`   | DEVOLUCION\_Y\_AJUSTE | Default. Devolución total o ajuste general.      |
| `2`   | DEVOLUCION            | Devolución parcial o total de mercadería.        |
| `3`   | DESCUENTO             | Descuento acordado después de emitir la factura. |
| `4`   | BONIFICACION          | Bonificación comercial (ej. cantidad).           |
| `5`   | CREDITO\_INCOBRABLE   | El cliente no va a pagar — incobrable.           |
| `6`   | RECUPERO\_COSTO       | Recupero de costos imputables al cliente.        |
| `7`   | RECUPERO\_GASTO       | Recupero de gastos imputables al cliente.        |
| `8`   | AJUSTE\_PRECIO        | Corrección de precio facturado erróneamente.     |

Si no enviás `motivo_nc`, se asume `1` (DEVOLUCION\_Y\_AJUSTE).

## Validaciones que hace SIFEN

* **El CDC referenciado debe existir y estar aprobado** (estado `A`) en SIFEN. No podés emitir NC sobre un DE rechazado o pendiente.
* **El receptor debe coincidir** con el del documento original (mismo RUC / mismo número de documento).
* **El monto** no puede exceder el del documento original. SIFEN devuelve rechazo si la NC excede.
* **La fecha de emisión** de la NC debe ser **igual o posterior** a la del documento referenciado.

## Errores típicos

| Código                                               | Causa                                                           | Acción                                                               |
| ---------------------------------------------------- | --------------------------------------------------------------- | -------------------------------------------------------------------- |
| `VALIDACION_MULTIPLES_CAMPOS` con `doc_asociado.cdc` | El CDC referenciado no tiene 44 caracteres o tiene DV inválido. | Verificar el CDC del DE original.                                    |
| `0150`                                               | CDC duplicado — ya emitiste una NC con ese mismo `numero`.      | Omitir `numero` para que se asigne automático.                       |
| Rechazo SIFEN                                        | El DE referenciado no está aprobado, o el monto excede.         | Confirmar que la factura original está en estado `A`, ajustar items. |

## Siguiente paso

Mismo flujo que cualquier DE: [polling de estado](/concepts/flujo-asincrono) hasta `A`. El KuDE de la NC se descarga igual que el de una factura.
