API Endpoints

Generar un documento de retención electrónico

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

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

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

information
object
required

Información general del comprobante de retención.

issuer
object

Información del emisor electrónico.

XML tag: <cac:AgentParty>

supplier
object
required

Información del proveedor sujeto de retención.

XML tag: <cac:ReceiverParty>

withholding
object
required

Datos de la retenció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: <cac:RetentionDocumentReference>

string
enum
required

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

XML tag: <cbc:DocumentTypeCode>

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.

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:SUNATRetentionInformation> <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:SUNATRetentionInformation> <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 pago del documento relacionado. Formato AAAA-MM-DD.

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

integer
required
1 to 999999999

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

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

number
required
0.01 to 999999999999.99

Importe del pago sin retención.

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

number
required
0.01 to 999999999999.99

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

XML tag: <sac:SUNATRetentionInformation/> <sac:SUNATRetentionAmount>

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

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

XML tag: <sac:SUNATRetentionInformation> <sac:SUNATRetentionDate>

number
required
0.01 to 999999999999.99

Monto total pagado (PEN)
Es el total del documento convertido a soles menos la retención en PEN.
Total x Tipo de cambio aplicado

XML tag: <sac:SUNATRetentionInformation> <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