/ Comprobantes

Notas de débito

Cobra montos adicionales sobre un comprobante ya emitido: intereses por mora, penalidades o cargos omitidos.

Crear nota de débito

POST/notas-debito

Una nota de débito (tipo 08) aumenta el valor de un comprobante. Los ítems representan el monto adicional a cobrar. Usa series FD01 para facturas y BD01 para boletas.

Documento afectado y motivo

doc_afectado_tipostringObligatorio: 01 factura, 03 boleta o 12 ticket.
doc_afectado_seriestringObligatorio: Serie del comprobante original.
doc_afectado_correlativostringObligatorio: Correlativo del comprobante original.
cod_motivostringObligatorio: Código del motivo (tabla siguiente).
des_motivostringObligatorio: Descripción libre, máx. 250.

Motivos (catálogo 10)

Código	Motivo
01	Intereses por mora
02	Aumento en el valor
03	Otros conceptos
04	Ajustes de valor de exportación
05	Ajustes por corrección de la moneda
06	Ajustes por corrección de la cantidad
07	Ajustes por descuentos no aplicados
08	Ajustes por cargos adicionales
09	Otros
11	Ajustes de operaciones de exportación
12	Ajustes afectos al IVAP
13	Penalidades (vigente desde 01/01/2027)

El motivo 13 (penalidades) rige desde 2027: solo para operaciones inafectas (tip_afe_igv: "30") y el documento afectado es opcional. SUNAT aún lo rechaza hasta esa fecha.

curl -X POST "https://apifact.gavi-cloud.com/api/v1/notas-debito" \
  -H "X-Api-Key: TU_API_KEY" \
  -H "X-Api-Secret: TU_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "serie": "FD01",
    "fecha_emision": "2026-10-20",
    "cliente": {
      "tipo_doc": "6",
      "num_doc": "20555666777",
      "razon_social": "ACME CORP SAC"
    },
    "doc_afectado_tipo": "01",
    "doc_afectado_serie": "F001",
    "doc_afectado_correlativo": "00000123",
    "cod_motivo": "01",
    "des_motivo": "Intereses por mora 15 días",
    "items": [
      {
        "descripcion": "INTERES POR MORA",
        "unidad": "ZZ",
        "cantidad": 1,
        "precio_unitario": 100,
        "tip_afe_igv": "10"
      }
    ]
  }'

Respuesta201 Created

{
  "estado": "exito",
  "mensaje": "Nota de débito creada y encolada para envío a SUNAT.",
  "datos": {
    "id": 21,
    "tipo_documento": "08",
    "numero_completo": "FD01-21",
    "cod_motivo": "01",
    "mto_imp_venta": "100.00",
    "sunat_status": "pendiente"
  }
}

Listar notas de débito

GET/notas-debito

Devuelve los comprobantes de tu empresa, paginados y filtrables.

Parámetros de consulta

searchstring: Búsqueda libre: razón social, documento, serie o correlativo.
seriestring: Serie exacta (F001) o con comodín (F0%).
client_num_docstring: RUC o DNI exacto del cliente.
sunat_statusstring: pendiente, enviado, aceptado, rechazado o anulado. Acepta varios separados por coma.
fecha_desdedate: Fecha de emisión mínima (yyyy-mm-dd).
fecha_hastadate: Fecha de emisión máxima.
monto_minnumber: Total mínimo.
monto_maxnumber: Total máximo.
sucursal_idinteger: Filtra por sucursal.
constring: Relaciones a incluir: items, payments.
ordenar_porstring: fecha_emision, correlativo, mto_imp_venta, created_at (por defecto).
ordenstring: desc (por defecto) o asc.
por_paginainteger: Por defecto 15, máximo 100.

curl "https://apifact.gavi-cloud.com/api/v1/notas-debito?sunat_status=aceptado&fecha_desde=2026-10-01&fecha_hasta=2026-10-31" \
  -H "X-Api-Key: TU_API_KEY" \
  -H "X-Api-Secret: TU_API_SECRET"

Respuesta200 OK

{
  "estado": "exito",
  "datos": {
    "datos": [
      "..."
    ],
    "paginacion": {
      "pagina_actual": 1,
      "ultima_pagina": 8,
      "por_pagina": 15,
      "total": 112
    }
  }
}

Ver nota de débito

GET/notas-debito/{id}

Devuelve el comprobante con sus ítems, pagos, estado SUNAT y, si ya fue rechazado, el código y descripción del error.

curl "https://apifact.gavi-cloud.com/api/v1/notas-debito/123" \
  -H "X-Api-Key: TU_API_KEY" \
  -H "X-Api-Secret: TU_API_SECRET"

XML, CDR y PDF

Con el id de la nota de débito descargas cada archivo. El PDF admite formato A4, A5 o ticket. El CDR está disponible cuando SUNAT aceptó el comprobante.

Método	Ruta	Devuelve
GET	/notas-debito/{id}/xml	XML firmado
GET	/notas-debito/{id}/cdr	CDR de SUNAT
GET	/notas-debito/{id}/pdf	Representación impresa
POST	/notas-debito/{id}/reenviar	Reenvía a SUNAT un comprobante pendiente o rechazado

curl "https://apifact.gavi-cloud.com/api/v1/notas-debito/123/pdf" \
  -H "X-Api-Key: TU_API_KEY" \
  -H "X-Api-Secret: TU_API_SECRET"