Nota de Crédito Electrónica

Cómo emitir una Nota de Crédito (NCE) para anular total o parcialmente una factura aprobada.

La Nota de Crédito Electrónica (NCE) se emite para revertir, descontar o anular una Factura Electrónica que ya fue aprobada por SIFEN. No reemplaza a la FE original; la complementa.

¿Cuándo emitir una NCE?

Emití una NCE para:

Devoluciones totales o parciales de mercadería ya facturada.
Descuentos aplicados después de la emisión de la FE.
Anular una FE aprobada por error en datos no críticos (la FE original sigue existiendo en SIFEN).

La NCE solo aplica a documentos en estado APROBADO. Si tu FE fue rechazada por SIFEN, no necesitás (ni podés) emitir una NCE: corregí los datos y emití una nueva FE. Ver Reintentar Rechazados.

Diferencias clave con una FE

Aspecto	FE	NCE
`tipoDocumento`	`FACTURA_ELECTRONICA`	`NOTA_DE_CREDITO_ELECTRONICA`
`documentoAsociado`	Opcional	Obligatorio (referencia a 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 (siempre identificado)
`condicionPago`	Obligatoria	No aplica

Restricción importante: receptor identificado

La NCE no acepta receptor innominado (NT-010 / NT-023). Si la FE original fue innominada (consumo final), igual debés identificar al receptor en la NCE con cédula o RUC.

Paso 1: Identificá la FE a referenciar

Necesitás el CDC de la FE original y conocer el motivo de emisión. Los motivos válidos para NCE son:

Valor	Motivo
`DEVOLUCION`	Devolución total o parcial de mercadería
`DESCUENTO`	Descuento aplicado posterior a la emisión
`BONIFICACION`	Bonificación comercial
`PRECIO`	Ajuste de precio
`otros`	Otros motivos no contemplados

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

Paso 2: Armá el request

{
  "tipoDocumento": "NOTA_DE_CREDITO_ELECTRONICA",
  "fechaEmision": "2026-04-27T14:00:00",
  "tipoEmision": "NORMAL",
  "numeroEstablecimiento": 1,
  "puntoExpedicion": 1,
  "monedaOperacion": "PYG",
  "motivoEmision": "DEVOLUCION",
  "receptor": {
    "tipoContribuyente": "NO_CONTRIBUYENTE",
    "tipoOperacion": "B2C",
    "tipoDocumento": "CEDULA_PARAGUAYA",
    "numeroDocumento": "1234567",
    "nombreRazonSocial": "Juan Pérez"
  },
  "documentoAsociado": {
    "tipo": "ELECTRONICO",
    "cdc": "01800123451001001000000122026042710000000006"
  },
  "items": [
    {
      "codigo": "PROD-A4-75",
      "descripcion": "Resma de papel A4 75g - devolución",
      "cantidad": 2,
      "unidadMedida": "UNI",
      "precioUnitario": 15000,
      "afectacionTributaria": "GRAVADO",
      "tasaIVA": 10
    }
  ]
}

Paso 3: Enviá la NCE

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-credito.json

Respuesta exitosa: 202 Accepted con un body DocumentoElectronicoEmisionResponseDTO que incluye el id, el cdc, estado: "PENDIENTE", numeroFormateado, qrUrl, statusUrl y kudeUrl. Guardalos igual que con la FE.

Paso 4: Confirmá la aprobación

Igual que con la FE, esperá el procesamiento asíncrono de SIFEN. Ver Consultar Estado.

Errores frecuentes

Status	Tipo	Causa	Solución
400	`validation-error`	Falta `motivoEmision` o `documentoAsociado`	Completar ambos campos
400	`invalid-enum-value`	`motivoEmision` no es uno de los enums válidos	Usar `DEVOLUCION`, `DESCUENTO`, `BONIFICACION`, `PRECIO` u `otros`
422	SIFEN 2026	CDC referenciado no existe en SIFEN o no está aprobado	Verificar que la FE original esté `APROBADO`
422	SIFEN (receptor inválido)	Se intentó usar receptor innominado	Identificar al receptor con cédula o RUC

Próximos pasos

¿Necesitás cobrar más por la operación original? → Nota de Débito.
¿La FE estaba dirigida a una empresa? → Receptor B2B y B2C para estructurar el receptor.
Si SIFEN rechaza la NCE, consultá Manejar Errores.

Nota de Crédito Electrónica

On this page