Saltar al contenido
DevFact

Documentación

Nota de crédito

Devoluciones y descuentos sobre una factura ya autorizada.

Se emite con POST /v1/notas-credito (o POST /v1/comprobantes con "tipo": "notaCredito"). Los totales los calcula el servicio a partir de los ítems.

Campos

  • compradorObligatorio: síDescripción: El mismo comprador de la factura. Las notas de crédito no admiten consumidor final.
  • documentoModificado.numeroObligatorio: síDescripción: Número de la factura original: 001-001-000000123.
  • documentoModificado.fechaEmisionObligatorio: síDescripción: Fecha de emisión de la factura original.
  • documentoModificado.codDocObligatorio: noDescripción: Tipo del documento modificado: factura (01, por defecto), notaVenta (02) o liquidacionCompra (03).
  • motivoObligatorio: síDescripción: Por qué se emite (devolución, descuento, corrección…).
  • items[].descripcionObligatorio: síDescripción: Hasta 300 caracteres.
  • items[].cantidadObligatorio: síDescripción: Mayor que cero, hasta 6 decimales.
  • items[].precioUnitarioObligatorio: síDescripción: Precio sin IVA, hasta 6 decimales.
  • items[].ivaObligatorio: síDescripción: Tarifa: 15, 5, 8, 0, noObjeto o exento.
  • items[].descuentoObligatorio: noDescripción: Descuento del ítem en dólares (no porcentaje).
  • items[].codigoObligatorio: noDescripción: Tu código de producto (hasta 25 caracteres).
  • items[].iceObligatorio: noDescripción: ICE: { codigoPorcentaje, tarifa } según la Tabla 18 del SRI.
  • items[].detallesAdicionalesObligatorio: noDescripción: Hasta 3 pares nombre: valor que se imprimen en el RIDE (talla, color, lote…).

Casos

Devolución de mercadería

Anula total o parcialmente una factura ya autorizada. Indica el número y la fecha de la factura original.

POST /v1/notas-credito
curl -X POST "https://api.devfact.fonles.com/v1/notas-credito" \
  -H "Authorization: Bearer $DEVFACT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: nc-devolucion-1" \
  -d '{
  "comprador": {
    "tipoIdentificacion": "cedula",
    "identificacion": "0912345675",
    "razonSocial": "María Cliente",
    "email": "maria@example.com"
  },
  "documentoModificado": {
    "numero": "001-001-000000123",
    "fechaEmision": "2026-10-01"
  },
  "motivo": "Devolución de un martillo defectuoso",
  "items": [
    {
      "codigo": "P-001",
      "descripcion": "Martillo de acero",
      "cantidad": 1,
      "precioUnitario": "10.00",
      "iva": "15"
    }
  ]
}'
  • Si la factura la emitió este servicio, se rechaza una nota por más que su total (NC_SUPERA_DOCUMENTO).
  • El SRI no admite notas de crédito a consumidor final: identifica siempre al comprador.

Descuento después de facturar

Para un descuento por pronto pago o una rebaja acordada después de emitir la factura.

POST /v1/notas-credito
curl -X POST "https://api.devfact.fonles.com/v1/notas-credito" \
  -H "Authorization: Bearer $DEVFACT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: nc-descuento-posterior-1" \
  -d '{
  "comprador": {
    "tipoIdentificacion": "ruc",
    "identificacion": "1792146739001",
    "razonSocial": "DISTRIBUIDORA EL SOL S.A."
  },
  "documentoModificado": {
    "numero": "001-001-000000500",
    "fechaEmision": "2026-10-15"
  },
  "motivo": "Descuento por pronto pago (2 %)",
  "items": [
    {
      "descripcion": "Descuento por pronto pago",
      "cantidad": 1,
      "precioUnitario": "72.00",
      "iva": "15"
    }
  ]
}'
  • Las notas de crédito aceptan las tarifas históricas de IVA (12 %, 14 %) para corregir facturas antiguas.
La consulta de una factura emitida aquí trae notasCredito con lo ya acreditado y el saldo, para no acreditar dos veces.