Nota de débito (contado)

Nota de débito de boleta al contado. tipoComprobante: 08. Incluye el objeto nota con los datos del documento original.

POSThttps://api.facturalo.pe/api/v3/documentos/enviar

Parámetros del body

webhook

booleanopcional

Si es true, la respuesta es inmediata (EN_PROCESO) y el resultado llega al webhook configurado. Default: false (síncrono).Ej: false

establecimiento

string | nullopcional

UUID del establecimiento emisor. Si se omite, se usa el establecimiento principal de la empresa.

documento

objectrequerido

Datos del comprobante electrónico.

sunatTransaccion

stringrequerido

Operación de nota de débito. Usa 0101.Ej: 0101

tipoComprobante

stringrequerido

08 = Nota de Débito. Incrementa el valor de una boleta previa.Ej: 08

serie

stringrequerido

Serie del comprobante. Facturas: F001–F999. Boletas: B001–B999. Exactamente 4 caracteres.Ej: F001

correlativo

stringrequerido

Correlativo numérico. Máximo 8 caracteres.Ej: 1

fechaEmision

stringrequerido

Fecha de emisión en formato YYYY-MM-DD.Ej: 2026-06-13

fechaVencimiento

string | nullopcional

Fecha de vencimiento. Formato YYYY-MM-DD. Si no se envía, se toma la fechaEmision como fecha de vencimiento.

formaPago

stringrequerido

"CONTADO" | "CREDITO". Si es CREDITO, se requiere el array cuotas.Ej: CONTADO

moneda

stringrequerido

"PEN" (Soles) | "USD" (Dólares).Ej: PEN

observaciones

string | nullopcional

Texto libre que aparece en el comprobante.

placaVehiculo

string | nullopcional

Placa del vehículo asociado a la operación.

ordenCompra

string | nullopcional

Número de orden de compra del cliente.

descuentoGlobal

number | nullopcional

Descuento global aplicado al total del documento (con IGV incluido).

enviarCorreo

booleanopcional

Si es true, envía el PDF y XML al correo del cliente tras la aceptación. Default: false.Ej: true

cliente

objectrequerido

Datos del adquirente.

tipoDocumento

stringrequerido

6 = RUC · 1 = DNI · 0 = Sin documento (clientes varios).Ej: 6

numeroDocumento

stringrequerido

Número sin puntos ni guiones. RUC: 11 dígitos. DNI: 8 dígitos.Ej: 20609753413

denominacion

stringrequerido

Razón social o nombre completo.Ej: TEC WORLD S.A.C.

direccion

string | nullopcional

Requerida si tipoDocumento = 6 (RUC).

correo

string | nullopcional

Correo del cliente para envío del PDF/XML.

celular

string | nullopcional

Número de celular. Exactamente 9 dígitos.

items

arrayrequerido

Líneas del comprobante. Mínimo 1 ítem.

unidadMedida

stringrequerido

Código SUNAT: NIU = unidad · ZZ = servicio · BX = caja · KGM = kilogramo · GLI = galón.Ej: NIU

codigo

string | nullopcional

Código interno del producto (max 30 caracteres).

descripcion

stringrequerido

Descripción del producto o servicio (max 250 caracteres).Ej: SERVICIO DE CONSULTORÍA

cantidad

numberrequerido

Cantidad de unidades. Mínimo 0.Ej: 2

precioUnitario

numberrequerido

Precio por unidad con IGV incluido. La API calcula el IGV automáticamente.Ej: 590

tipoIgv

stringrequerido

10 = Gravado oneroso (misma tasa que el documento original).Ej: 10

descuento

number | nullopcional

Descuento por ítem (con IGV incluido).

impuestoBolsa

boolean | nullopcional

Si es true, aplica ICBPER (impuesto a bolsas plásticas) a este ítem.

Nota de débito al contado — tipoComprobante: 08json

{
  "documento": {
    "tipoComprobante": "08",
    "serie": "B001",
    "correlativo": "1",
    "fechaEmision": "2026-06-13",
    "formaPago": "CONTADO",
    "moneda": "PEN",
    "cliente": {
      "tipoDocumento": "1",
      "numeroDocumento": "12345678",
      "denominacion": "NOMBRES Y APELLIDOS",
      "direccion": "AV. LIMA 123 - LIMA - LIMA - LIMA",
      "correo": "persona@gmail.com"
    },
    "nota": {
      "documentoQueSeModifica": "BOLETA",
      "documentoQueSeModificaSerie": "B001",
      "documentoQueSeModificaCorrelativo": "1",
      "tipoDeNotaDeDebito": "02",
      "sustento": "Aumento de valor por ajuste de precio"
    },
    "items": [
      {
        "cantidad": 1,
        "unidadMedida": "ZZ",
        "descripcion": "Ajuste de precio - Servicio de consultoría",
        "precioUnitario": 236,
        "tipoIgv": "10"
      }
    ]
  }
}

Respuesta exitosajson

{
  "success": true,
  "message": "La Nota de Débito numero B001-1, ha sido aceptada",
  "data": {
    "estado": "ACEPTADA",
    "entorno": "demo",
    "documento": {
      "id": "dd4e5f6a-67d9-11f1-8bd0-5b2bb30404ab",
      "estado": "ACEPTADA",
      "serie": "B001",
      "correlativo": "1",
      "tipo": "NOTA_DEBITO",
      "tipoCodigo": "08",
      "fechaEmision": "2026-06-13",
      "fechaVencimiento": "2026-06-13",
      "moneda": "PEN",
      "formaPago": "CONTADO",
      "cliente": {
        "tipoDocumento": "1",
        "numeroDocumento": "12345678",
        "denominacion": "NOMBRES Y APELLIDOS"
      },
      "totales": {
        "gravada": 200,
        "exonerada": 0,
        "inafecta": 0,
        "exportacion": 0,
        "gratuita": 0,
        "descuento": 0,
        "anticipo": 0,
        "isc": 0,
        "igv": 36,
        "impuestoBolsa": 0,
        "otrosCargos": 0,
        "total": 236
      },
      "items": [
        {
          "codigo": "",
          "descripcion": "Ajuste de precio - Servicio de consultoría",
          "unidad": "ZZ",
          "cantidad": 1,
          "valorUnitario": 200,
          "precioUnitario": 236,
          "descuento": 0,
          "subtotal": 200,
          "tipoIgv": "10",
          "tipoIgvDescripcion": "GRAVADO - OPERACIÓN ONEROSA",
          "igv": 36,
          "total": 236
        }
      ],
      "guias": [],
      "cuotas": [],
      "nota": {
        "documentoQueSeModifica": "BOLETA",
        "documentoQueSeModificaSerie": "B001",
        "documentoQueSeModificaCorrelativo": "00000001",
        "tipoNota": "01",
        "tipoNotaDescripcion": "INTERESES POR MORA",
        "sustento": "INTERESES POR MORA"
      }
    },
    "sunat": {
      "estado": "ACEPTADA",
      "codigo": "0",
      "mensaje": "La Nota de Débito numero B001-1, ha sido aceptada",
      "notas": []
    },
    "enlaces": {
      "pdf": "https://api.facturalo.pe/api/v3/documentos/dd4e5f6a-67d9-11f1-8bd0-5b2bb30404ab.pdf",
      "xml": "https://api.facturalo.pe/api/v3/documentos/dd4e5f6a-67d9-11f1-8bd0-5b2bb30404ab.xml",
      "cdr": "https://api.facturalo.pe/api/v3/documentos/dd4e5f6a-67d9-11f1-8bd0-5b2bb30404ab.cdr"
    },
    "hash": "mNkQpVbLssRc8FlD8/0LuSYeIPo8=",
    "cadenaQr": "20601476551 | 08 | B001 | 000001 | 36.00 | 236.00 | 13/06/2026 | 1 | 12345678 | mNkQpVbLssRc8FlD8/0LuSYeIPo8= |",
    "codigoBarras": "20601476551 | 08 | B001 | 000001 | 36.00 | 236.00 | 13/06/2026 | 1 | 12345678 | mNkQpVbLssRc8FlD8/0LuSYeIPo8= |"
  }
}

200 — webhook: true (EN_PROCESO)json

{
  "success": true,
  "message": "El documento está siendo procesado por SUNAT. Recibirá una notificación en su webhook o puede consultar el estado en el enlace adjunto.",
  "data": {
    "entorno": "demo",
    "documento": {
      "id": "7111d8e0-6891-11f1-ab2a-23413cd2ac7c",
      "estado": "EN_PROCESO",
      "serie": "B001",
      "correlativo": "1",
      "tipo": "NOTA_DEBITO",
      "tipoCodigo": "08",
      "fechaEmision": "2026-06-13",
      "fechaVencimiento": "2026-06-15",
      "moneda": "PEN",
      "formaPago": "CONTADO",
      "cliente": {
        "tipoDocumento": "1",
        "numeroDocumento": "12345678",
        "denominacion": "NOMBRES Y APELLIDOS",
        "direccion": "AV. LIMA 123 - LIMA - LIMA - LIMA",
        "correo": "persona@gmail.com"
      },
      "totales": {
        "gravada": 4000,
        "exonerada": 0,
        "inafecta": 0,
        "exportacion": 0,
        "gratuita": 0,
        "descuento": 0,
        "anticipo": 0,
        "isc": 0,
        "igv": 720,
        "impuestoBolsa": 0,
        "otrosCargos": 0,
        "total": 4720
      },
      "items": [
        {
          "codigo": "",
          "descripcion": "SERVICIO DE CONSULTORÍA",
          "unidad": "NIU",
          "cantidad": 2,
          "valorUnitario": 500,
          "precioUnitario": 590,
          "descuento": 0,
          "subtotal": 1000,
          "tipoIgv": "10",
          "tipoIgvDescripcion": "GRAVADO - OPERACIÓN ONEROSA",
          "igv": 180,
          "total": 1180
        },
        {
          "codigo": "",
          "descripcion": "LAPTOP DELL INSPIRON",
          "unidad": "NIU",
          "cantidad": 1,
          "valorUnitario": 3000,
          "precioUnitario": 3540,
          "descuento": 0,
          "subtotal": 3000,
          "tipoIgv": "10",
          "tipoIgvDescripcion": "GRAVADO - OPERACIÓN ONEROSA",
          "igv": 540,
          "total": 3540
        }
      ],
      "guias": [],
      "nota": {
        "documentoQueSeModifica": "BOLETA",
        "documentoQueSeModificaSerie": "B001",
        "documentoQueSeModificaCorrelativo": "00000001",
        "tipoNota": "01",
        "tipoNotaDescripcion": "INTERESES POR MORA",
        "sustento": "INTERESES POR MORA"
      },
      "cuotas": []
    },
    "enlaces": {
      "consulta": "https://api.facturalo.pe/api/v3/documentos/7111d8e0-6891-11f1-ab2a-23413cd2ac7c"
    }
  }
}

422 — Error de validaciónjson

{
  "success": false,
  "message": "Los datos enviados no son válidos.",
  "errors": {
    "documento.cliente.numeroDocumento": [
      "El número de documento debe tener 11 dígitos para tipo RUC."
    ],
    "documento.items": [
      "El campo items es requerido."
    ]
  }
}

200 — Rechazada por SUNATjson

{
  "success": false,
  "message": "El documento fue rechazado por SUNAT.",
  "data": {
    "estado": "RECHAZADA",
    "entorno": "demo",
    "documento": {
      "id": "9c948140-674e-11f1-85b5-d764057e10c4",
      "serie": "F001",
      "correlativo": "1",
      "tipo": "FACTURA"
    },
    "sunat": {
      "codigo": "2800",
      "mensaje": "El número de RUC del emisor no existe.",
      "notas": []
    }
  }
}