API Endpoints

Generar un documento de percepción electrónica

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

Este endpoint permite generar un documento de percepción 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 del documento de percepción electrónica

Datos generales solicitados para emitir una Percepción electrónica

information
object
required

Información general del documento de percepción electrónica.

issuer
object

Información del emisor electrónico.

XML tag: <cac:AgentParty>

customer
object
required

Información del cliente del documento de percepción.

XML tag: <cac:ReceiverParty>

perception
object
required

Datos de la percepción del CRE, los montos enviados en este objeto deben estar en Soles (PEN).

referencedDocuments
array of objects
required
length ≥ 1

Documentos referenciados.

referencedDocuments*

Información de documento referenciado.

XML tag: <sac:SUNATPerceptionDocumentReference>

string
enum
required

Tipo de documento:
01 = FACTURA.
03 = BOLETA.
07 = NOTA DE CRÉDITO.
08 = NOTA DE DÉBITO.

XML tag: cac:PartyIdentification/cbc:ID @schemeID>

Allowed:
string
required
^[a-zA-Z0-9]{1,20}$

Serie del documento.

XML tag: <cbc:ID>

string
required
^\d{1,8}$

Número del documento.

XML tag: <cbc:ID>

string
required
^\d{4}-\d{2}-\d{2}$

Fecha de emisión del documento. Formato AAAA-MM-DD.

XML tag: <cbc:IssueDate>

string
enum
required

Código de moneda del documento. Ver catalogo de monedas.

XML tag: @currencyID

number
0.01 to 9999.999999

⚠️ Tipo de cambio aplicado
Obligatorio cuando la moneda del documento relacionado es distinta de PEN. Representa el factor usado para convertir de la moneda de origen a soles.
XML attribute: <sac:SUNATPerceptionInformation> <cac:ExchangeRate> <cbc:CalculationRate>

string
^\d{4}-\d{2}-\d{2}$

⚠️ Fecha del tipo de cambio
Obligatoria cuando la moneda del documento relacionado es distinta de PEN. Indica la fecha en la que aplica el tipo de cambio usado.
XML attribute: <sac:SUNATPerceptionInformation> <cac:ExchangeRate> <cbc:Date>

number
required
0.01 to 999999999999.99

Importe total del documento en su moneda original.

XML tag: <cbc:TotalInvoiceAmount>

string
required
^\d{4}-\d{2}-\d{2}$

Fecha de cobro del documento relacionado. Formato AAAA-MM-DD.

XML tag: <cac:Payment> <cbc:PaidDate>

integer
required
1 to 999999999

Número correlativo del cobro. Empieza desde el 1.
Ejemplo:
1 (si es un solo cobro o primer cobro)
2 (si es segundo cobro)
3 (si es tercer cobro)

XML tag: <cac:Payment> <cbc:ID>

number
required
0.01 to 999999999999.99

Importe del cobro sin percepción.

XML tag: <cac:Payment> <cbc:PaidAmount>

number
required
0.01 to 999999999999.99

Importe de la percepción (PEN)
Siempre debe enviarse en soles.
Si la operación está en otra moneda, envía el valor percibido convertido a PEN usando el tipo de cambio.
Importe percibido en la otra moneda x Tipo de cambio aplicado

XML tag: <sac:SUNATPerceptionInformation/> <sac:SUNATPerceptionAmount>

string
required
^\d{4}-\d{2}-\d{2}$

Fecha de percepción. Formato AAAA-MM-DD.

XML tag: <sac:SUNATPerceptionInformation> <sac:SUNATPerceptionDate>

number
required
0.01 to 999999999999.99

Monto total cobrado (PEN)
Es el total cobrado del documento convertido a soles más la percepción en PEN.
Total x Tipo de cambio aplicado

XML tag: <sac:SUNATPerceptionInformation> <sac:SUNATNetTotalPaid>

Responses

Updated 6 months ago

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

Updated 6 months ago