Factura con ICBPER

Factura con Impuesto al Consumo de Bolsas de Plástico. Agrega impuestoBolsa: true en el ítem correspondiente.

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 con ICBPER. Usa 0101.Ej: 0101

tipoComprobante

stringrequerido

01 = Factura electrónica.Ej: 01

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

descuento

number | nullopcional

Descuento por ítem (con IGV incluido).

impuestoBolsa

boolean | nullopcional

true = aplica ICBPER (S/ 0.50 por bolsa). Activar en el ítem correspondiente.Ej: true

Factura con ICBPERjson

{
  "webhook": false,
  "documento": {
    "sunatTransaccion": "0101",
    "tipoComprobante": "01",
    "serie": "F001",
    "correlativo": "1",
    "fechaEmision": "2026-06-13",
    "formaPago": "CONTADO",
    "moneda": "PEN",
    "cliente": {
      "tipoDocumento": "6",
      "numeroDocumento": "20000000001",
      "denominacion": "EMPRESA S.A.C.",
      "direccion": "AV. LIMA 123 - LIMA - LIMA - LIMA",
      "correo": "cliente@empresa.com"
    },
    "items": [
      {
        "unidadMedida": "NIU",
        "descripcion": "Bolsa plástica pequeña",
        "cantidad": 100,
        "precioUnitario": 1.18,
        "tipoIgv": "10",
        "impuestoBolsa": true
      },
      {
        "unidadMedida": "NIU",
        "descripcion": "Producto normal",
        "cantidad": 2,
        "precioUnitario": 50,
        "tipoIgv": "10"
      }
    ]
  }
}

Respuesta exitosajson

{
  "success": true,
  "message": "La Factura número F001-00000001, ha sido aceptada.",
  "data": {
    "estado": "ACEPTADA",
    "entorno": "demo",
    "documento": {
      "id": "83ad82a0-680e-11f1-8e35-2d93ac0f2c84",
      "estado": "ACEPTADA",
      "serie": "F001",
      "correlativo": "00000001",
      "tipo": "FACTURA",
      "tipoCodigo": "01",
      "fechaEmision": "2026-06-13",
      "fechaVencimiento": "2026-06-14",
      "moneda": "PEN",
      "formaPago": "CONTADO",
      "cliente": {
        "tipoDocumento": "6",
        "numeroDocumento": "20000000001",
        "denominacion": "EMPRESA S.A.C.",
        "direccion": "AV. LIMA 123 - LIMA - LIMA - LIMA"
      },
      "totales": {
        "gravada": 118.5,
        "exonerada": 0,
        "inafecta": 0,
        "exportacion": 0,
        "gratuita": 0,
        "descuento": 0,
        "anticipo": 0,
        "isc": 0,
        "igv": 21.33,
        "impuestoBolsa": 0,
        "otrosCargos": 0,
        "total": 157.33
      },
      "items": [
        {
          "codigo": "",
          "descripcion": "Bolsa plástica pequeña",
          "unidad": "NIU",
          "cantidad": 100,
          "valorUnitario": 1,
          "precioUnitario": 1.18,
          "descuento": 0,
          "subtotal": 100,
          "tipoIgv": "10",
          "tipoIgvDescripcion": "GRAVADO - OPERACIÓN ONEROSA",
          "igv": 18,
          "total": 118
        },
        {
          "codigo": "",
          "descripcion": "Producto normal",
          "unidad": "NIU",
          "cantidad": 2,
          "valorUnitario": 50,
          "precioUnitario": 59,
          "descuento": 0,
          "subtotal": 100,
          "tipoIgv": "10",
          "tipoIgvDescripcion": "GRAVADO - OPERACIÓN ONEROSA",
          "igv": 18,
          "total": 118
        }
      ],
      "guias": [],
      "cuotas": []
    },
    "sunat": {
      "estado": "ACEPTADA",
      "codigo": "0",
      "mensaje": "La Factura numero F001-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 | 01 | F001 | 00000001 | 13/06/2026 | 20000000001 | 157.33.00 | xvQpVbLssRc8FlD8/0LuSYeIPo8= |",
    "codigoBarras": "20601476551 | 01 | F001 | 00000001 | 13/06/2026 | 20000000001 | 157.33.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": "F001",
      "correlativo": "00000001",
      "tipo": "FACTURA",
      "tipoCodigo": "01",
      "fechaEmision": "2026-06-13",
      "fechaVencimiento": "2026-06-15",
      "moneda": "PEN",
      "formaPago": "CONTADO",
      "cliente": {
        "tipoDocumento": "6",
        "numeroDocumento": "20000000001",
        "denominacion": "EMPRESA S.A.C.",
        "direccion": "AV. LIMA 123 - LIMA - LIMA - LIMA"
      },
      "totales": {
        "gravada": 0,
        "exonerada": 0,
        "inafecta": 0,
        "exportacion": 0,
        "gratuita": 0,
        "descuento": 0,
        "anticipo": 0,
        "isc": 0,
        "igv": 0,
        "impuestoBolsa": 0,
        "otrosCargos": 0,
        "total": 0
      },
      "items": [
        {
          "codigo": "",
          "descripcion": "Bolsa plástica pequeña",
          "unidad": "NIU",
          "cantidad": 100,
          "valorUnitario": 1,
          "precioUnitario": 1.18,
          "descuento": 0,
          "subtotal": 100,
          "tipoIgv": "10",
          "tipoIgvDescripcion": "GRAVADO - OPERACIÓN ONEROSA",
          "igv": 18,
          "total": 118
        },
        {
          "codigo": "",
          "descripcion": "Producto normal",
          "unidad": "NIU",
          "cantidad": 2,
          "valorUnitario": 50,
          "precioUnitario": 59,
          "descuento": 0,
          "subtotal": 100,
          "tipoIgv": "10",
          "tipoIgvDescripcion": "GRAVADO - OPERACIÓN ONEROSA",
          "igv": 18,
          "total": 118
        }
      ],
      "guias": [],
      "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": []
    }
  }
}