Nota de Débito Electrónica

Cómo emitir una Nota de Débito (NDE) para incrementar el monto de una factura aprobada.

La 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?

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.

La NDE solo aplica a documentos en estado APROBADO. Si vas a corregir una FE rechazada, emití una nueva FE en lugar de una NDE.

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

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.

Motivos válidos de emisión

Valor	Motivo
`INTERES`	Intereses por mora o financiamiento
`GASTO_TRANSPORTE`	Gastos de transporte / fletes facturados después
`AUMENTO_PRECIO`	Aumento de precio sobre lo facturado originalmente
`otros`	Otros motivos no contemplados

motivoEmision es un string enum, no un código numérico. La API valida contra estos valores exactos.

Paso 1: Armá el request

Ejemplo de NDE por intereses sobre una FE B2B aprobada:

{
  "tipoDocumento": "NOTA_DE_DEBITO_ELECTRONICA",
  "fechaEmision": "2026-04-27T16:15:00",
  "tipoEmision": "NORMAL",
  "numeroEstablecimiento": 1,
  "puntoExpedicion": 1,
  "monedaOperacion": "PYG",
  "motivoEmision": "INTERES",
  "receptor": {
    "tipoContribuyente": "CONTRIBUYENTE",
    "tipoOperacion": "B2B",
    "numeroDocumento": "80012345",
    "digitoVerificador": "1",
    "nombreRazonSocial": "Comercial Guaraní S.A."
  },
  "documentoAsociado": {
    "tipo": "ELECTRONICO",
    "cdc": "01800123451001001000000122026042710000000006"
  },
  "items": [
    {
      "codigo": "INT-MORA",
      "descripcion": "Intereses por mora - Factura 001-001-0000123",
      "cantidad": 1,
      "unidadMedida": "UNI",
      "precioUnitario": 75000,
      "afectacionTributaria": "GRAVADO",
      "tasaIVA": 10
    }
  ]
}

Paso 2: Enviá la NDE

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: 202 Accepted con un body DocumentoElectronicoEmisionResponseDTO (id, cdc, estado: "PENDIENTE", numeroFormateado, qrUrl, statusUrl, kudeUrl). Guardá los identificadores como en la FE.

Paso 3: Verificá el estado

El procesamiento es asíncrono. Aplicá la misma estrategia de polling que para FE y NCE; ver Consultar Estado.

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 `INTERES`, `GASTO_TRANSPORTE`, `AUMENTO_PRECIO` u `otros`
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

¿Necesitás revertir un cargo? → Nota de Crédito.
¿Vas a entregar el comprobante al cliente? → Descargar KuDE.
¿Tenés errores de receptor? → Receptor B2B y B2C.

Nota de Débito Electrónica

On this page