Emitir una nota de crédito electrónica

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

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:

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:

{
  "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:

{
  "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):

{
  "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 hasta A. El KuDE de la NC se descarga igual que el de una factura.

Empezar

Conceptos

Tutoriales — Emisión

Tutoriales — Eventos y errores

Errores

Emitir una nota de crédito electrónica

Variables del ejemplo

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

Caso 2 — Descuento parcial sobre factura emitida

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

Caso 4 — NC sobre una constancia (casos especiales)

Motivos de NC (`motivo_nc`)

Validaciones que hace SIFEN

Errores típicos

Siguiente paso

​Variables del ejemplo

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

​Caso 2 — Descuento parcial sobre factura emitida

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

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

​Motivos de NC (motivo_nc)

​Validaciones que hace SIFEN

​Errores típicos

​Siguiente paso

Variables del ejemplo

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

Caso 2 — Descuento parcial sobre factura emitida

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

Caso 4 — NC sobre una constancia (casos especiales)

Motivos de NC (`motivo_nc`)

Validaciones que hace SIFEN

Errores típicos

Siguiente paso