API Endpoints

Generar una Boleta de Venta

post
https://api.alanube.co/per/v1/sell-ticket

Este endpoint permite generar una boleta de venta

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
required
length between 26 and 26

Id de la empresa

Body Params

Objeto JSON con la información de la boleta de venta

Datos generales solicitados para emitir una Boleta de Venta Electrónica

information
object
required

Información general de la boleta electrónica.

XML tag: <Invoice>

issuer
object

Información del emisor electrónico.

XML tag: <cac:AccountingSupplierParty>

customer
object

Información del cliente o receptor

Si este elemento no es enviado, la API emitirá la boleta utilizando los datos del "CLIENTE VARIOS" para operaciones cuyo importe sea menor o igual a S/. 700.00 (IGV incluido).

Para operaciones que superen dicho monto, el objeto customer será obligatorio.

XML tag: <cac:AccountingCustomerParty>

itemDetails
array of objects
required
length ≥ 1

Datos del detalle o Ítem del documento.

XML tag: <cac:InvoiceLine>

itemDetails*
string
required
length between 1 and 500

Descripción detallada del servicio prestado, bien vendido o cedido en uso, indicando las características.

XML tag: <cac:Item> <cbc:Description>

number
required
1e-10 to 1000000000000

Cantidad de unidades por ítem.

XML tag: <cbc:InvoicedQuantity>

string
required
length between 1 and 3

Unidad de medida

Código que identifica la unidad de medida del bien o servicio facturado, según el catálogo de unidades de medida.

Se utiliza para indicar cómo se cuantifica el ítem (por ejemplo: unidad, kilogramo, hora, servicio, etc.).

XML tag: <cbc:InvoicedQuantity @unitCode>

codes
object

Objeto que agrupa los distintos códigos de identificación del bien o servicio, incluyendo el código interno del producto, el código de producto SUNAT y el código GTIN, según corresponda y estén disponibles.

number
required
0 to 1000000000000

Valor de venta unitario del bien o servicio por ítem, expresado sin incluir impuestos, descuentos u otros cargos adicionales.

XML tag: <cac:Price> <cbc:PriceAmount>

number
required
0 to 1000000000000

Precio de venta unitario final del ítem

Corresponde al monto unitario que paga el cliente por el bien o servicio. Este valor debe incluir los descuentos y cargos aplicados a nivel de ítem, así como los impuestos correspondientes (por ejemplo, IGV).

Es el precio final por unidad que se refleja en la transacción.

XML tag: <cac:PricingReference> <cac:AlternativeConditionPrice> <cbc:PriceAmount>

number
0 to 1000000000000

Valor referencial unitario del bien o servicio por ítem utilizado en operaciones gratuitas o no onerosas, consignado únicamente para efectos tributarios.

XML tag: <cac:AlternativeConditionPrice> <cbc:PriceAmount>

adjustment
object

Importe que representa un cargo o un descuento aplicado a nivel de ítem, que incrementa o disminuye el valor del bien o servicio, según corresponda, conforme a la normativa de SUNAT.

XML tag: <cac:AllowanceCharge>

number
required
0 to 1000000000000

Valor de venta total del ítem, obtenido como la suma del valor unitario multiplicado por la cantidad, considerando los cargos y descuentos aplicables, y expresado sin incluir impuestos.

XML tag: <cbc:LineExtensionAmount>

taxes
object
required

Objeto que agrupa los impuestos aplicables al ítem, incluyendo el Impuesto General a las Ventas (IGV) y otros tributos que puedan corresponder, indicando para cada uno su tipo de afectación, porcentaje y monto calculado, conforme a la normativa de SUNAT.

XML tag: <cac:TaxTotal>

string
length between 1 and 8

Número de placa del vehículo automotor

Sustenta gastos vinculados a un vehículo de la empresa (combustible, mantenimiento, seguro, reparación), conforme al inciso w) del Art. 37 de la Ley del Impuesto a la Renta. No depende de profileId — aplica en cualquier factura.

XML tag: <cac:InvoiceLine> <cac:Item> <cac:AdditionalItemProperty> <cbc:Value> con NameCode = "7000" (Catálogo N° 55)

adjustment
object

Objeto que contiene la información de los cargos y/o descuentos aplicados de manera global al comprobante electrónico.

XML tag: <cac:AllowanceCharge>

totals
object
required

Objeto que agrupa los importes totales del comprobante electrónico, incluyendo los valores de venta, impuestos, cargos, descuentos y el importe total a pagar, calculados conforme a la normativa de SUNAT.

perception
object

Datos de la percepción del comprobante, los montos enviados en este objeto deben estar en Soles (PEN).
Obligatorio en operaciones sujetas a percepciones (2001).

XML tags:

  • <cac:AllowanceCharge>
  • <cac:PaymentTerms>
detraction
object

Datos de la detracción del comprobante, los montos enviados en este objeto deben estar en soles (PEN).

Obligatorio en operaciones sujetas a detracciones (information.profileId): 1001, 1002, 1003, 1004.

XML tags:

  • <cac:PaymentTerms>
  • <cac:PaymentMeans>
relatedDocuments
object

Agrupa los documentos externos relacionados con la operación comercial del comprobante electrónico. Permite referenciar guías de remisión, órdenes de compra o servicio, y otros documentos vinculados a la transacción. Cada tipo de documento se envía en su propio array y puede incluir múltiples referencias simultáneamente.

Responses

Updated 2 months ago

Language
Credentials
Bearer
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 2 months ago