GENERAR COMPROBANTE DE RETENCIÓN
POST/api/retentions
Es una constancia de que alguna persona moral te retuvo algún tipo de impuesto, (relativo al Impuesto Sobre la Renta), y sirve para demostrar que dicho impuesto te fue retenido, y presentarlo a la autoridad fiscal en caso que te sea requerido.
Para generar un comprobante de retención puede usar el siguiente servicio, necesitará la url, el token, y los datos del documento.
Ejemplo:
- URL: https://empresa1.demo3pro6.ibu.pe/api/retentions
- TOKEN: HOHYgwd4atPalTxqi2IIspythpLAU7eP239oByfjk9VuveiOpfUTm4Yg0Szt
Request
- application/json
- application/xml
- application/x-www-form-urlencoded
Body
required
- JSON A ENVIAR
Array [
Array [
]
]
serie_documentostring
Example:
R001numero_documentostring
Example:
#fecha_de_emisiondate
Example:
2018-10-09hora_de_emisiontime
Example:
10:11:11codigo_tipo_documentostring
Example:
20datos_del_emisor
object
codigo_paisstring
Example:
PEubigeostring
Example:
150101direccionstring
Example:
Av. 2 de Mayocorreo_electronicostring
Example:
demo@gmail.comtelefonostring
Example:
427-1148codigo_del_domicilio_fiscalstring
Example:
0000datos_del_proveedor
object
codigo_tipo_documento_identidadstring
Example:
6numero_documentostring
Example:
10414711225apellidos_y_nombres_o_razon_socialstring
Example:
EMPRESA XYZ S.A.nombre_comercialstring
Example:
EMPRESA XYZcodigo_paisstring
Example:
PEubigeostring
Example:
150101direccionstring
Example:
Av. 2 de Mayocorreo_electronicostring
Example:
demo@gmail.comtelefonostring
Example:
427-1148codigo_tipo_retencionstring
Example:
01observacionesstring
Example:
-totales
object
total_retenidofloat
Example:
30total_pagadofloat
Example:
1000documentos
object[]
codigo_tipo_documentostring
Example:
01serie_documentostring
Example:
F001numero_documentostring
Example:
3fecha_de_emisiondate
Example:
2018-10-09codigo_tipo_monedastring
Example:
PENpagos
object[]
fecha_de_pagodate
Example:
2018-10-09total_pagofloat
Example:
200codigo_tipo_monedastring
Example:
PENtipo_de_cambio
object
codigo_tipo_moneda_referenciastring
Example:
PENcodigo_tipo_moneda_objetivostring
Example:
PENfactorfloat
Example:
1fecha_tipo_de_cambiodate
Example:
2018-10-09fecha_de_retenciondate
Example:
2018-10-09total_documentofloat
Example:
400total_retenidofloat
Example:
12total_a_pagarfloat
Example:
412total_pagadofloat
Example:
412Body
required
- JSON A ENVIAR
Array [
Array [
]
]
serie_documentostring
Example:
R001numero_documentostring
Example:
#fecha_de_emisiondate
Example:
2018-10-09hora_de_emisiontime
Example:
10:11:11codigo_tipo_documentostring
Example:
20datos_del_emisor
object
codigo_paisstring
Example:
PEubigeostring
Example:
150101direccionstring
Example:
Av. 2 de Mayocorreo_electronicostring
Example:
demo@gmail.comtelefonostring
Example:
427-1148codigo_del_domicilio_fiscalstring
Example:
0000datos_del_proveedor
object
codigo_tipo_documento_identidadstring
Example:
6numero_documentostring
Example:
10414711225apellidos_y_nombres_o_razon_socialstring
Example:
EMPRESA XYZ S.A.nombre_comercialstring
Example:
EMPRESA XYZcodigo_paisstring
Example:
PEubigeostring
Example:
150101direccionstring
Example:
Av. 2 de Mayocorreo_electronicostring
Example:
demo@gmail.comtelefonostring
Example:
427-1148codigo_tipo_retencionstring
Example:
01observacionesstring
Example:
-totales
object
total_retenidofloat
Example:
30total_pagadofloat
Example:
1000documentos
object[]
codigo_tipo_documentostring
Example:
01serie_documentostring
Example:
F001numero_documentostring
Example:
3fecha_de_emisiondate
Example:
2018-10-09codigo_tipo_monedastring
Example:
PENpagos
object[]
fecha_de_pagodate
Example:
2018-10-09total_pagofloat
Example:
200codigo_tipo_monedastring
Example:
PENtipo_de_cambio
object
codigo_tipo_moneda_referenciastring
Example:
PENcodigo_tipo_moneda_objetivostring
Example:
PENfactorfloat
Example:
1fecha_tipo_de_cambiodate
Example:
2018-10-09fecha_de_retenciondate
Example:
2018-10-09total_documentofloat
Example:
400total_retenidofloat
Example:
12total_a_pagarfloat
Example:
412total_pagadofloat
Example:
412Body
required
- JSON A ENVIAR
Array [
Array [
]
]
serie_documentostring
Example:
R001numero_documentostring
Example:
#fecha_de_emisiondate
Example:
2018-10-09hora_de_emisiontime
Example:
10:11:11codigo_tipo_documentostring
Example:
20datos_del_emisor
object
codigo_paisstring
Example:
PEubigeostring
Example:
150101direccionstring
Example:
Av. 2 de Mayocorreo_electronicostring
Example:
demo@gmail.comtelefonostring
Example:
427-1148codigo_del_domicilio_fiscalstring
Example:
0000datos_del_proveedor
object
codigo_tipo_documento_identidadstring
Example:
6numero_documentostring
Example:
10414711225apellidos_y_nombres_o_razon_socialstring
Example:
EMPRESA XYZ S.A.nombre_comercialstring
Example:
EMPRESA XYZcodigo_paisstring
Example:
PEubigeostring
Example:
150101direccionstring
Example:
Av. 2 de Mayocorreo_electronicostring
Example:
demo@gmail.comtelefonostring
Example:
427-1148codigo_tipo_retencionstring
Example:
01observacionesstring
Example:
-totales
object
total_retenidofloat
Example:
30total_pagadofloat
Example:
1000documentos
object[]
codigo_tipo_documentostring
Example:
01serie_documentostring
Example:
F001numero_documentostring
Example:
3fecha_de_emisiondate
Example:
2018-10-09codigo_tipo_monedastring
Example:
PENpagos
object[]
fecha_de_pagodate
Example:
2018-10-09total_pagofloat
Example:
200codigo_tipo_monedastring
Example:
PENtipo_de_cambio
object
codigo_tipo_moneda_referenciastring
Example:
PENcodigo_tipo_moneda_objetivostring
Example:
PENfactorfloat
Example:
1fecha_tipo_de_cambiodate
Example:
2018-10-09fecha_de_retenciondate
Example:
2018-10-09total_documentofloat
Example:
400total_retenidofloat
Example:
12total_a_pagarfloat
Example:
412total_pagadofloat
Example:
412Responses
- 200
- 400
- 422
JSON RESPUESTA
- application/json
- application/xml
- Schema
- Example (from schema)
Schema
successboolean
Example:
truedata
object
numberstring
Example:
R001-3filenamestring
Example:
11111111111-20-R001-3external_idstring
Example:
9d997b38-92a6-42f2-b827-4b73ec5ca1a3links
object
xmluri
Example:
https://empresa1.demo3pro6.ibu.pe/downloads/retention/xml/9d997b38-92a6-42f2-b827-4b73ec5ca1a3pdfuri
Example:
https://empresa1.demo3pro6.ibu.pe/downloads/retention/pdf/9d997b38-92a6-42f2-b827-4b73ec5ca1a3cdruri
Example:
https://empresa1.demo3pro6.ibu.pe/downloads/retention/cdr/9d997b38-92a6-42f2-b827-4b73ec5ca1a3response
object
codestring
Example:
0descriptionstring
Example:
El Comprobante numero R001-3 ha sido aceptadonotesstring[]
{
"success": true,
"data": {
"number": "R001-3",
"filename": "11111111111-20-R001-3",
"external_id": "9d997b38-92a6-42f2-b827-4b73ec5ca1a3"
},
"links": {
"xml": "https://empresa1.demo3pro6.ibu.pe/downloads/retention/xml/9d997b38-92a6-42f2-b827-4b73ec5ca1a3",
"pdf": "https://empresa1.demo3pro6.ibu.pe/downloads/retention/pdf/9d997b38-92a6-42f2-b827-4b73ec5ca1a3",
"cdr": "https://empresa1.demo3pro6.ibu.pe/downloads/retention/cdr/9d997b38-92a6-42f2-b827-4b73ec5ca1a3"
},
"response": {
"code": "0",
"description": "El Comprobante numero R001-3 ha sido aceptado",
"notes": [
[]
]
}
}
- Schema
- Example (from schema)
Schema
successboolean
Example:
truedata
object
numberstring
Example:
R001-3filenamestring
Example:
11111111111-20-R001-3external_idstring
Example:
9d997b38-92a6-42f2-b827-4b73ec5ca1a3links
object
xmluri
Example:
https://empresa1.demo3pro6.ibu.pe/downloads/retention/xml/9d997b38-92a6-42f2-b827-4b73ec5ca1a3pdfuri
Example:
https://empresa1.demo3pro6.ibu.pe/downloads/retention/pdf/9d997b38-92a6-42f2-b827-4b73ec5ca1a3cdruri
Example:
https://empresa1.demo3pro6.ibu.pe/downloads/retention/cdr/9d997b38-92a6-42f2-b827-4b73ec5ca1a3response
object
codestring
Example:
0descriptionstring
Example:
El Comprobante numero R001-3 ha sido aceptadonotesstring[]
<root>
<success>true</success>
<data>
<number>R001-3</number>
<filename>11111111111-20-R001-3</filename>
<external_id>9d997b38-92a6-42f2-b827-4b73ec5ca1a3</external_id>
</data>
<links>
<xml>https://empresa1.demo3pro6.ibu.pe/downloads/retention/xml/9d997b38-92a6-42f2-b827-4b73ec5ca1a3</xml>
<pdf>https://empresa1.demo3pro6.ibu.pe/downloads/retention/pdf/9d997b38-92a6-42f2-b827-4b73ec5ca1a3</pdf>
<cdr>https://empresa1.demo3pro6.ibu.pe/downloads/retention/cdr/9d997b38-92a6-42f2-b827-4b73ec5ca1a3</cdr>
</links>
<response>
<code>0</code>
<description>El Comprobante numero R001-3 ha sido aceptado</description>
</response>
</root>
Invalid input
Validation exception