Boleta clásica (gravada)

Emite una boleta de venta electrónica gravada. Misma estructura que la factura pero con tipoComprobante: '03' y serie B001–B999.

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 gravada normal. Usa 0101.Ej: 0101

tipoComprobante

stringrequerido

03 = Boleta de venta. Para consumidores finales.Ej: 03

serie

stringrequerido

Serie de boleta: B001–B999.Ej: B001

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 (tasa normal 18%).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.

Boleta gravada — B001json

{
  "webhook": false,
  "documento": {
    "sunatTransaccion": "0101",
    "tipoComprobante": "03",
    "serie": "B001",
    "correlativo": "1",
    "fechaEmision": "2026-06-13",
    "moneda": "PEN",
    "formaPago": "CONTADO",
    "cliente": {
      "tipoDocumento": "1",
      "numeroDocumento": "12345678",
      "denominacion": "NOMBRES Y APELLIDOS",
      "direccion": "AV. LIMA 123 - LIMA - LIMA - LIMA",
      "correo": "persona@gmail.com"
    },
    "items": [
      {
        "unidadMedida": "NIU",
        "descripcion": "SERVICIO DE CONSULTORÍA",
        "cantidad": 2,
        "precioUnitario": 590,
        "tipoIgv": "10"
      },
      {
        "unidadMedida": "NIU",
        "descripcion": "LAPTOP DELL INSPIRON",
        "cantidad": 1,
        "precioUnitario": 3540,
        "tipoIgv": "10"
      }
    ]
  }
}

Respuesta exitosajson

{
  "success": true,
  "message": "La Boleta número B001-00000001, ha sido aceptada.",
  "data": {
    "estado": "ACEPTADA",
    "entorno": "demo",
    "documento": {
      "id": "83ad82a0-680e-11f1-8e35-2d93ac0f2c84",
      "estado": "ACEPTADA",
      "serie": "B001",
      "correlativo": "1",
      "tipo": "BOLETA",
      "tipoCodigo": "03",
      "fechaEmision": "2026-06-13",
      "fechaVencimiento": "2026-06-14",
      "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": [],
      "cuotas": []
    },
    "sunat": {
      "estado": "ACEPTADA",
      "codigo": "0",
      "mensaje": "La Boleta numero B001-00000001 ha sido aceptada",
      "notas": []
    },
    "enlaces": {
      "pdf": "https://api.facturalo.pe/api/v3/documentos/83ad82a0-680e-11f1-8e35-2d93ac0f2c84.pdf",
      "xml": "https://api.facturalo.pe/api/v3/documentos/83ad82a0-680e-11f1-8e35-2d93ac0f2c84.xml",
      "cdr": "https://api.facturalo.pe/api/v3/documentos/83ad82a0-680e-11f1-8e35-2d93ac0f2c84.cdr"
    },
    "hash": "xvQpVbLssRc8FlD8/0LuSYeIPo8=",
    "cadenaQr": "20601476551 | 03 | B001 | 00000001 | 13/06/2026 | 12345678 | 4720.00 | xvQpVbLssRc8FlD8/0LuSYeIPo8= |",
    "codigoBarras": "20601476551 | 03 | B001 | 00000001 | 13/06/2026 | 12345678 | 4720.00 | xvQpVbLssRc8FlD8/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": "BOLETA",
      "tipoCodigo": "03",
      "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": [],
      "cuotas": []
    },
    "enlaces": {
      "consulta": "https://api.facturalo.pe/api/v3/documentos/7111d8e0-6891-11f1-ab2a-23413cd2ac7c"
    }
  }
}