Documentación

Nota de débito

Intereses, gastos de cobranza y otros cargos sobre una factura.

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

Campos

compradorObligatorio: síDescripción: El comprador de la factura original.
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).
motivos[].razonObligatorio: síDescripción: Concepto del cargo.
motivos[].valorObligatorio: síDescripción: Valor sin IVA.
motivos[].ivaObligatorio: síDescripción: Tarifa de IVA del cargo.
pagosObligatorio: noDescripción: Formas de pago, como en la factura.

Campo	Obligatorio	Descripción
comprador	sí	El comprador de la factura original.
documentoModificado.numero	sí	Número de la factura original: 001-001-000000123.
documentoModificado.fechaEmision	sí	Fecha de emisión de la factura original.
documentoModificado.codDoc	no	Tipo del documento modificado: `factura` (01, por defecto), `notaVenta` (02) o `liquidacionCompra` (03).
motivos[].razon	sí	Concepto del cargo.
motivos[].valor	sí	Valor sin IVA.
motivos[].iva	sí	Tarifa de IVA del cargo.
pagos	no	Formas de pago, como en la factura.

Casos

Intereses por mora y gastos de cobranza

Cobra valores adicionales sobre una factura ya emitida. Cada motivo lleva su valor y su tarifa de IVA.

POST /v1/notas-debito

curl -X POST "https://api.devfact.fonles.com/v1/notas-debito" \
  -H "Authorization: Bearer $DEVFACT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: nd-mora-1" \
  -d '{
  "comprador": {
    "tipoIdentificacion": "ruc",
    "identificacion": "1792146739001",
    "razonSocial": "DISTRIBUIDORA EL SOL S.A.",
    "email": "cobros@example.com"
  },
  "documentoModificado": {
    "codDoc": "01",
    "numero": "001-001-000000500",
    "fechaEmision": "2026-10-15"
  },
  "motivos": [
    {
      "razon": "Intereses por mora (15 días)",
      "valor": "12.50",
      "iva": "15"
    },
    {
      "razon": "Gastos de cobranza",
      "valor": "5.00",
      "iva": "15"
    }
  ],
  "pagos": [
    {
      "formaPago": "transferencia"
    }
  ]
}'