API Endpoints

Generar nota electrónica

post
https://api.alanube.co/per/v1/notes

Este endpoint permite generar una nota de crédito o débito electrónica.

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 nota electrónica.

Datos generales solicitados para emitir una Nota de Ajuste

information
object
required

Información general de la nota crédito / débito.

issuer
object

Información del emisor electrónico.

XML tag: <cac:AccountingSupplierParty>

customer
object

Información del cliente o receptor

Obligatorio cuando se referencian Facturas de Venta Electrónicas.

Si este elemento no es enviado, la API emitirá la nota 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>

billingReferences
object

Lista de comprobantes que modifica esta nota

Referencia los comprobante(s) que modifica la nota electrónica. Todos los documentos referenciados deben ser del mismo tipo, por lo que se declara una sola vez a nivel del objeto y aplica a todos.

Obligatorio salvo cuando reason.type es 10 (Otros Conceptos).

XML tag: <cac:BillingReference>

payment
object

Información del pago en facturas de venta a crédito.

Este objeto solo podrá ser enviado en notas crédito reason.type = 13 (Corrección o modificación del monto neto pendiente de pago y/o la(s) fecha(s) de vencimiento del pago único o de las cuotas y/o los montos correspondientes a cada cuota, de ser el caso).

XML tag: <cac:PaymentTerms>

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 unitario del bien o servicio expresado sin impuestos. Si el comprobante original incluía descuentos o cargos sobre este ítem, envía aquí el valor ya con esos ajustes aplicados.

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

number
required
0 to 1000000000000

Precio de venta unitario final del ítem

Valor de venta total del ítem, obtenido como la suma del valor unitario multiplicado por la cantidad, expresado sin incluir impuestos.

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>

number
required
0 to 1000000000000

Valor de venta total del ítem, obtenido como la suma del valor unitario multiplicado por la cantidad, 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>

adjustment
object

Objeto que contiene la información de los cargos 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 y el importe total a pagar, calculados conforme a la normativa de SUNAT.

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 3 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 3 months ago