# Nota de Débito Electrónica (/docs/guias/nota-debito)



La &#x2A;*Nota de Débito Electrónica (NDE)** se emite para agregar cargos a una Factura Electrónica ya aprobada: intereses, ajustes por diferencias de cambio, fletes facturados después, recargos por mora, etc.

## Cuándo emitir una NDE [#cuándo-emitir-una-nde]

Emití una NDE cuando necesitás **incrementar** el monto cobrado al receptor sobre una FE ya aprobada. Algunos casos típicos:

* Intereses por mora.
* Ajustes positivos por diferencia de cambio en facturas en moneda extranjera.
* Fletes o servicios adicionales no incluidos en la FE original.
* Recargos pactados después de la emisión.

<Callout type="warn">
  La NDE **solo aplica a documentos registrados en SIFEN**: estado `APROBADO` o `APROBADO_OBSERVACION`. Si vas a corregir una FE rechazada, emití una nueva FE en lugar de una NDE.
</Callout>

## Estructura [#estructura]

La NDE usa el mismo patrón que la NCE: requiere `documentoAsociado` con el CDC de la FE original y un `motivoEmision`. La diferencia es que el efecto es **aumentar** el monto, no descontarlo.

| Aspecto             | FE                    | NDE                                       |
| ------------------- | --------------------- | ----------------------------------------- |
| `tipoDocumento`     | `FACTURA_ELECTRONICA` | `NOTA_DE_DEBITO_ELECTRONICA`              |
| `documentoAsociado` | Opcional              | **Obligatorio** (CDC de la FE original)   |
| `motivoEmision`     | No aplica             | **Obligatorio** (string enum)             |
| `tipoTransaccion`   | Obligatorio           | No se envía (lo hereda de la FE original) |
| Receptor innominado | Permitido             | **No permitido**                          |

## Restricción de receptor [#restricción-de-receptor]

<Callout type="warn">
  Igual que la NCE, la NDE **no admite receptor innominado**. Si la FE original era innominada, identificá al receptor con cédula o RUC en la NDE.
</Callout>

## Motivos válidos de emisión [#motivos-válidos-de-emisión]

| Valor                             | Motivo                                     |
| --------------------------------- | ------------------------------------------ |
| `DEVOLUCION_Y_AJUSTES_DE_PRECIOS` | Devolución combinada con ajuste de precios |
| `DEVOLUCION`                      | Devolución                                 |
| `DESCUENTO`                       | Descuento                                  |
| `BONIFICACION`                    | Bonificación                               |
| `CREDITO_INCOBRABLE`              | Crédito declarado incobrable               |
| `RECUPERO_DE_COSTO`               | Recupero de costos                         |
| `RECUPERO_DE_GASTO`               | Recupero de gastos                         |
| `AJUSTE_DE_PRECIO`                | Ajuste de precio                           |

<Callout type="info">
  `motivoEmision` es un **string enum**, no un código numérico. La API valida contra estos valores exactos.
</Callout>

## Paso 1: Prepará la solicitud [#paso-1-prepará-la-solicitud]

Ejemplo de NDE por ajuste de precio sobre una FE B2B aprobada:

```json
{
  "tipoDocumento": "NOTA_DE_DEBITO_ELECTRONICA",
  "fechaEmision": "2026-04-27T16:15:00",
  "tipoEmision": "NORMAL",
  "numeroEstablecimiento": 1,
  "puntoExpedicion": 1,
  "monedaOperacion": "PYG",
  "motivoEmision": "AJUSTE_DE_PRECIO",
  "receptor": {
    "tipoContribuyente": "CONTRIBUYENTE",
    "tipoOperacion": "B2B",
    "tipoContribuyenteReceptor": "PERSONA_JURIDICA",
    "numeroDocumento": "80012345",
    "digitoVerificador": "0",
    "nombreRazonSocial": "Comercial Guaraní S.A."
  },
  "documentoAsociado": {
    "tipoDocumento": "ELECTRONICO",
    "cdc": "01800123451001001000000122026042710000000006"
  },
  "items": [
    {
      "codigo": "AJ-PRECIO",
      "descripcion": "Ajuste de precio - Factura 001-001-0000123",
      "cantidad": 1,
      "unidadMedida": "UNI",
      "precioUnitario": 75000,
      "afectacionTributaria": "GRAVADO",
      "tasaIVA": 10
    }
  ]
}
```

## Paso 2: Enviá la NDE [#paso-2-enviá-la-nde]

```bash
curl -X POST https://api.sifende.com.py/api/v1/documento-electronico \
  -H "Authorization: Bearer $SIFENDE_API_KEY" \
  -H "Content-Type: application/json" \
  -d @nota-debito.json
```

Respuesta exitosa: &#x2A;*`202 Accepted`** con una respuesta con (`id`, `cdc`, `estado: "PENDIENTE"`, `numeroFormateado`, `qrUrl`, `statusUrl`, `kudeUrl`). Guardá los identificadores como en la FE.

## Paso 3: Verificá el estado [#paso-3-verificá-el-estado]

El procesamiento es asíncrono. Aplicá la misma estrategia de polling que para FE y NCE; ver [Consultar Estado](/docs/guias/consultar-estado).

## Errores frecuentes [#errores-frecuentes]

| Status | Tipo                 | Causa                                          | Solución                                                  |
| ------ | -------------------- | ---------------------------------------------- | --------------------------------------------------------- |
| 400    | `validation-error`   | Falta `documentoAsociado` o `motivoEmision`    | Completar ambos campos                                    |
| 400    | `invalid-enum-value` | `motivoEmision` no es uno de los enums válidos | Usar uno de los valores documentados en la tabla anterior |
| 422    | SIFEN (CDC asociado) | CDC referenciado no existe o no está aprobado  | Confirmar estado de la FE original                        |
| 422    | SIFEN (receptor)     | Se intentó usar receptor innominado            | Identificar al receptor                                   |

## Próximos pasos [#próximos-pasos]

* Si necesitás revertir un cargo → [Nota de Crédito](/docs/guias/nota-credito).
* Si vas a entregar el comprobante al cliente → [Descargar KuDE](/docs/guias/descargar-kude).
* Si tenés errores de receptor → [Receptor B2B y B2C](/docs/guias/receptor-b2b-b2c).
