Boleta con guía de remisión

Boleta que referencia una guía de remisión.

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 guía vinculada. Usa 0101.Ej: 0101

tipoComprobante

stringrequerido

03 = Boleta de venta.Ej: 03

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

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

Boleta con guía de remisiónjson

{
  "webhook": false,
  "documento": {
    "sunatTransaccion": "0101",
    "tipoComprobante": "03",
    "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"
    },
    "guias": [
      {
        "tipoDocumento": "09",
        "numeroDocumento": "T001-00000001"
      }
    ],
    "items": [
      {
        "unidadMedida": "NIU",
        "descripcion": "Producto con guía de remisión",
        "cantidad": 3,
        "precioUnitario": 118,
        "tipoIgv": "10"
      }
    ]
  }
}

Respuesta exitosajson

{
  "success": true,
  "message": "La Boleta numero B001-1, ha sido aceptada",
  "data": {
    "estado": "ACEPTADA",
    "entorno": "demo",
    "documento": {
      "id": "b8731080-6723-11f1-89fc-7d6d1075fa47",
      "estado": "ACEPTADA",
      "serie": "B001",
      "correlativo": "1",
      "tipo": "BOLETA",
      "tipoCodigo": "03",
      "fechaEmision": "2026-06-13",
      "fechaVencimiento": "2026-06-13",
      "moneda": "PEN",
      "formaPago": "CONTADO",
      "cliente": {
        "tipoDocumento": "1",
        "numeroDocumento": "12345678",
        "denominacion": "NOMBRES Y APELLIDOS"
      },
      "totales": {
        "gravada": 300,
        "exonerada": 0,
        "inafecta": 0,
        "exportacion": 0,
        "gratuita": 0,
        "descuento": 0,
        "anticipo": 0,
        "isc": 0,
        "igv": 54,
        "impuestoBolsa": 0,
        "otrosCargos": 0,
        "total": 354
      },
      "items": [
        {
          "codigo": "",
          "descripcion": "Producto con guía de remisión",
          "unidad": "NIU",
          "cantidad": 3,
          "valorUnitario": 100,
          "precioUnitario": 118,
          "descuento": 0,
          "subtotal": 300,
          "tipoIgv": "10",
          "tipoIgvDescripcion": "GRAVADO - OPERACIÓN ONEROSA",
          "igv": 54,
          "total": 354
        }
      ],
      "guias": [
        {
          "tipoDocumento": "09",
          "numeroDocumento": "T001-00000001"
        }
      ],
      "cuotas": []
    },
    "sunat": {
      "estado": "ACEPTADA",
      "codigo": "0",
      "mensaje": "La Boleta numero B001-1, ha sido aceptada",
      "notas": []
    },
    "enlaces": {
      "pdf": "https://api.facturalo.pe/api/v3/documentos/b8731080-6723-11f1-89fc-7d6d1075fa47.pdf",
      "xml": "https://api.facturalo.pe/api/v3/documentos/b8731080-6723-11f1-89fc-7d6d1075fa47.xml",
      "cdr": "https://api.facturalo.pe/api/v3/documentos/b8731080-6723-11f1-89fc-7d6d1075fa47.cdr"
    },
    "hash": "xvQpVbLssRc8FlD8/0LuSYeIPo8=",
    "cadenaQr": "20601476551 | 03 | B001 | 000001 | 54.00 | 354.00 | 13/06/2026 | 1 | 12345678 | xvQpVbLssRc8FlD8/0LuSYeIPo8= |",
    "codigoBarras": "20601476551 | 03 | B001 | 000001 | 54.00 | 354.00 | 13/06/2026 | 1 | 12345678 | 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": "1",
      "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": 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"
    }
  }
}

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": []
    }
  }
}