End Point para Boletas

POST https://emisor.pe/facturacionv9/api/procesar_venta
Request
JSON
{
    "contribuyente":{
       "token_contribuyente":"SBGV15GKOE3WPKSZTH24RU0MWTYTM9VM88VM3",
       "id_usuario_vendedor":2,
       "tipo_proceso":"prueba",
       "tipo_envio":"inmediato"
    },
    "cliente":{
       "tipo_docidentidad":1,
       "numerodocumento":"42719520",
       "nombre":"Razón social de tu cliente",
       "email":"email_cliente@gmail.com",
       "direccion":"",
       "ubigeo":"",
       "sexo":"",
       "fecha_nac":"",
       "celular":""
    },
    "cabecera_comprobante":{
       "tipo_documento":"03",
       "moneda":"PEN",
       "idsucursal": 691,
       "id_condicionpago":"",
       "fecha_comprobante":"19/05/2026",
       "nro_placa":"",
       "nro_orden":"",
       "guia_remision":"",
       "descuento_monto":0,
       "descuento_porcentaje":0,
       "observacion":""
    },
    "detalle":[
       {
          "idproducto":0,
          "codigo":"TV_CODIGOPROD",
          "afecto_icbper":"no",
          "id_tipoafectacionigv":10,
          "descripcion":"Producto de Ejemplo",
          "idunidadmedida":"NIU",
          "precio_venta":5,
          "cantidad":111
       },
       {
          "idproducto":0,
          "codigo":"TV_CODIGOPROD2",
          "afecto_icbper":"no",
          "id_tipoafectacionigv":20,
          "descripcion":"Producto de Ejemplo",
          "idunidadmedida":"NIU",
          "precio_venta":78.56,
          "cantidad":2.89
       }
    ]
}
Response
Respuesta JSON
{
    "respuesta": "ok",
    "save_doc": "ok",
    "send_api": "ok",
    "documento": {
        "respuesta": "ok",
        "id_contribuyente": 1,
        "id_tipodoc_electronico": "01",
        "serie_comprobante": "B001",
        "numero_comprobante": 54,
        "tipo_envio_sunat": "prueba",
        "idusuario": 1
    },
    "titulo": "El Documento se ha Guardado Correctamente!",
    "mensaje": "Se guardó y envió a SUNAT correctamente el documento: B001-54.",
    "repuesta_api": "El Documento N°: B001-54, se guardó correctamente. <br /> Sin embargo no se logró enviar a SUNAT, nosotros recomendamos verificar el estado del documento!<br /><br /> ERROR: No se puede leer (parsear) el archivo XML - Detalle: http://xxx.xxx.xxx/ol-ti-itcpfegem-beta/billService: cvc-particle 2.1: in element {urn:oasis:names:specification:ubl:schema:xsd:Invoice-2}Invoice of type {urn:oasis:names:specification:ubl:schema:xsd:Invoice-2}InvoiceType, found <cbc:DueDate> (in namespace urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2), but next item should be {urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2}AccountingSupplierParty",
    "url_whatsapp": "",
    "url_whatsapp_api": "",
    "url_whatsapp_web": "",
    "respuesta_email": "202\nArray\n(\n    [0] => HTTP/1.1 202 Accepted\n    [1] => Date: Mon, 18 May 2026 22:24:08 GMT\n    [2] => Content-Length: 0\n    [3] => Connection: keep-alive\n    [4] => Server: nginx\n    [5] => X-Message-Id: -NWsv2NdQ1O3tsQKp_XW4w\n    [6] => Access-Control-Allow-Origin: https://sendgrid.api-docs.io\n    [7] => Access-Control-Allow-Methods: POST\n    [8] => Access-Control-Allow-Headers: Authorization, Content-Type, On-behalf-of, x-sg-elas-acl\n    [9] => Access-Control-Max-Age: 600\n    [10] => X-No-CORS-Reason: https://sendgrid.com/docs/Classroom/Basics/API/cors.html\n    [11] => Strict-Transport-Security: max-age=31536000; includeSubDomains\n    [12] => Content-Security-Policy: frame-ancestors 'none'\n    [13] => Cache-Control: no-cache\n    [14] => X-Content-Type-Options: no-sniff\n    [15] => Referrer-Policy: strict-origin-when-cross-origin\n    [16] => \n    [17] => \n)\n\nnull",
    "cadena_a4": "FcFW1Ofd3pq56O6RlQOR2kotg7Vm0AF5vVPA",
    "cadena_ticket": "FcFW1Ofd3pq56O6RlQOR2kotg7Vm0AF5vUad3iA12Q==",
    "url_absoluta_a4": "https://emisor.pe/facturacionv9/printpdf/?file=FcFW1Ofd3pq56O6RlQOR2kotg7Vm0AF5vVPA",
    "url_absoluta_ticket": "https://emisor.pe/facturacionv9/printpdf/?file=FcFW1Ofd3pq56O6RlQOR2kotg7Vm0AF5vUad3iA12Q%3D%3D",
    "url_relativa_a4": "/facturacionv9/printpdf/?file=FcFW1Ofd3pq56O6RlQOR2kotg7Vm0AF5vVPA",
    "url_relativa_ticket": "/facturacionv9/printpdf/?file=FcFW1Ofd3pq56O6RlQOR2kotg7Vm0AF5vUad3iA12Q%3D%3D",
    "cadena_xml": "/1/01/B001/54/xml_cpe_zip",
    "url_relativa_xml": "/facturacionv9/download/downloadcpe/1/01/B001/54/xml_cpe_zip",
    "url_absoluta_xml": "https://emisor.pe/facturacionv9/download/downloadcpe/1/01/B001/54/xml_cpe_zip",
    "cadena_xml_cdr": "/1/01/B001/B001/xml_cdr_zip",
    "url_relativa_xml_cdr": "/facturacionv9/download/downloadcpe/1/01/B001/54/xml_cdr_zip",
    "url_absoluta_xml_cdr": "https://emisor.pe/facturacionv9/download/downloadcpe/1/01/B001/54/xml_cdr_zip",
    "estado_envio_sunat": "pendiente",
    "hash_cpe": null,
    "hash_cdr": null,
    "cod_sunat": null
}
⚠️
¡Importante sobre Serie y Correlativo!

Los comprobantes que se emiten no llevan en el request la serie ni el correlativo, ya que esto se configura y autogestiona automáticamente desde la sucursal del sistema.

Si tu sistema local necesita conocer qué número correlativo se asignará al comprobante antes de emitirlo (para evitar desfases de numeración en tu base de datos local), debes realizar una consulta previa.

Para ver el flujo de consulta, parámetros del request y ejemplos de respuesta, revisa la sección dedicada: Guía de Comprobar Correlativo 🔍.

Parámetros: contribuyente

ParámetroTipoReq.Descripción
token_contribuyentestringEl token único del contribuyente asignado por eFacturando.
id_usuario_vendedorintegerID del usuario vendedor en el sistema.
tipo_procesostringEntorno de envío.
pruebaproduccion
tipo_enviostringTipo de envío del comprobante.
inmediatoprogramado

Parámetros: cliente

ParámetroTipoReq.Descripción
tipo_docidentidad
integerTipo de documento de identidad.
0 = Sin doc1 = DNI6 = RUC4 = CE
numerodocumentostringSí*Número de RUC/DNI. Obligatorio si tipo_docidentidad ≠ 0.
nombrestringRazón social o nombre completo del cliente.
emailstringNoCorreo del cliente. Si se incluye, se envía el comprobante por email.
direccionstringNoDirección fiscal del cliente.
ubigeo
stringNoCódigo de ubigeo INEI (6 dígitos). Ej: 150101
sexostringNoSexo del cliente.
masculinofemenino
fecha_nacstringNoFecha de nacimiento en formato DD/MM/YYYY.
celularstringNoNúmero de celular del cliente.

Parámetros: cabecera_comprobante

ParámetroTipoReq.Descripción
tipo_documento
stringTipo de comprobante SUNAT.
"01" = Factura"03" = Boleta
moneda
stringCódigo de moneda ISO 4217.
PENUSD
idsucursalintegerID de la sucursal emisora configurada en tu cuenta.
id_condicionpagostringNoID de la condición de pago configurada en tu catálogo.
fecha_comprobantestringFecha de emisión en formato DD/MM/YYYY.
nro_placastringNoNúmero de placa vehicular (sector transporte).
nro_ordenstringNoNúmero de orden de compra asociada.
guia_remisionstringNoNúmero de guía de remisión relacionada. Ej: T001-0000123
descuento_montodecimalNoDescuento global en monto. Ej: 50.00
descuento_porcentajedecimalNoDescuento global en porcentaje. Ej: 10.00
observacionstringNoObservaciones libres que aparecerán en el PDF.

Parámetros: detalle (array de ítems)

ParámetroTipoReq.Descripción
idproductointegerID interno del producto en tu catálogo (usar 0 para productos manuales).
codigostringCódigo interno del producto en tu catálogo.
afecto_icbperstring¿Aplica impuesto a la bolsa plástica ICBPER?
sino
id_tipoafectacionigv
integerCódigo SUNAT de afectación al IGV.
10 = Gravado20 = Exonerado30 = Inafecto40 = Exportación
descripcionstringDescripción del bien o servicio. Máx. 250 caracteres.
idunidadmedida
stringCódigo de unidad de medida SUNAT. Principal: NIU (Unidad).
NIU = UnidadZZ = ServicioKGM = KilogramoLTR = Litro
precio_ventadecimalPrecio de venta unitario del ítem con IGV incluido.
cantidaddecimalCantidad del ítem. Hasta 4 decimales.
Catálogo