Sistema Integrado Registro Electrónico- SIRE

Ventas

SERVICIOS WEB API - SIRE VENTAS

Manual de Usuario
Introducción

Este documento Manual de usuario de los Servicios Web Api - SIRE VENTAS, ha sido diseñado
para ser usado como instructivo en la integración de los servicios Web Api expuestos del SIRE
Ventas por la SUNAT con los sistemas informáticos de los declarantes, que tienen la
necesidad de integrarlos desde sus aplicaciones.

El proyecto SIRE VENTAS que expone los servicios aquí descritos, ha sido desarrollado con la
finalidad de facilitar el cumplimiento voluntario de las obligaciones tributarias de los
contribuyentes y toma como base al comprobante de pago electrónico para el control del
flujo de la transacción del IGV y la información que se genera en cada fase.

El SIRE Ventas una vez autenticado le permite al contribuyente:

Servicios principales:

● Descargar la propuesta (Servicio: Descargar propuesta) con el detalle individualizado

de los comprobantes y documentos que deberían integrar el registro de ventas que
genere, la cual podría ser la propuesta inicial de la SUNAT o aquella que fue
actualizada por el contribuyente.

● Aceptar Propuesta (Servicio: Aceptar propuesta) permite actualizar el estado del

registro libro y Control de procesos para indicar que se está registrando un preliminar
a través de la propuesta aceptada.
● Reemplazar propuesta (Servicio: Reemplazar propuesta) permite al generador,
reemplazar la propuesta SUNAT con lo considerado por el contribuyente mediante el
uso de un archivo de formato .txt.

2
 ● Registrar preliminar (Servicio: Registrar preliminar) permite registrar los
comprobantes del preliminar según corresponda al proceso ejecutado por el
generador.

Servicios complementarios al proceso:

● Descargar inconsistencias por comprobantes de pago (Servicio: Descargar

Inconsistencias por comprobantes) este servicio WEB API permite descargar las
inconsistencias asociadas a los comprobantes que se encuentran en la fase actual de
proceso del RVIE, que pueden ser 1-Propuesta o 3-Preliminar.

● Consultar el estado del ticket (Servicio: Consultar estado del ticket) permite al
generador consultar el estado del número ticket asociado al proceso que genera el
archivo de descarga o carga. Si el estado es "Terminado", devuelve el nombre del
archivo generado, si el estado del ticket es diferente, devuelve el estado del ticket.

● Descargar archivo (Servicio: Descargar archivo ticket generado) permite realizar la

descarga de los archivos generados zipeados y particionados guardados en el
fileserver.

Entre otros servicios, que se detallarán en el presente manual.

La siguiente imagen muestra el flujo mínimo para registrar el preliminar del Registro de
Ventas Electrónico de un periodo:

Aceptar propuesta:

Reemplazar propuesta:

El manual comienza con la sección que describe el procedimiento inicial para obtener las
credenciales del token, necesarios para hacer uso de los servicios.

3
Tabla de contenido
Control de cambios del documento ................................................................................................. 6
I. Guía de Uso ............................................................................................................................... 8
1. Servicio prerrequisito ............................................................................................................... 8
2. Secuencia de servicios mínimos para Registrar Preliminar................................................... 10
Funcionalidad 1: Aceptar Propuesta ........................................................................................... 10
Funcionalidad 2: Reemplazar Propuesta..................................................................................... 11
Funcionalidad 3: Registrar Preliminar ......................................................................................... 12
3. Secuencia de servicios interdependientes que completan funcionalidades del SIRE Ventas
13
Funcionalidad 1: Tipo de cambio ................................................................................................ 13
Funcionalidad 2: Importar comprobantes en propuesta ............................................................ 14
Funcionalidad 3: Importar comprobantes en preliminar ............................................................ 15
Funcionalidad 4: Importar ajustes posteriores ........................................................................... 16
Funcionalidad 5: Importar ajustes posteriores de periodos anteriores ..................................... 16
Funcionalidad 6: Eliminar comprobantes en preliminar ............................................................. 17
Funcionalidad 7: Consultar estado de envío de ticket ................................................................ 17
Funcionalidad 8: Descargar archivo ............................................................................................ 18
4. Servicios accesorios que pueden ser consumidos en el SIRE Ventas.................................... 19
5. Documentación Servicios Web API ........................................................................................ 21
5.1 Servicio Api Seguridad ........................................................................................................... 21
5.2 Servicio Web Api consultar año y mes .................................................................................. 22
5.3 Servicio Web Api importar reemplazo de la propuesta ........................................................ 23
5.4 Servicio Web Api importar nuevos comprobantes propuesta .............................................. 25
5.5 Servicio Web Api importar nuevos comprobantes preliminar.............................................. 27
5.6 Servicio Web Api importar ajustes posteriores..................................................................... 28
5.7 Servicio Web Api importar ajustes posteriores de periodos anteriores ............................... 30
5.8 Servicio Web Api aceptar propuesta del RVIE....................................................................... 31
5.9 Servicio Web Api registrar preliminar ................................................................................... 32
5.10 Servicio Web Api exclusión definitiva de notas de crédito y facturas ................................ 33
5.11 Servicio Web Api agregar tipo de cambio masivo ............................................................... 34
5.12 Servicio Web Api editar tipo de cambio individual ............................................................. 36
5.13 Servicio Web Api eliminar comprobante propuesta ........................................................... 37
5.14 Servicio Web Api eliminar comprobante preliminar ........................................................... 38
5.15 Servicio Web Api eliminar reemplazo propuesta ................................................................ 40
5.16 Servicio Web Api consultar estado de envío de ticket ........................................................ 40

4
 5.17 Servicio Web Api descargar archivo .................................................................................... 43
5.18 Servicio Web Api descargar propuesta ............................................................................... 45
5.19 Servicio Web Api descargar no incluidos ............................................................................ 47
5.20 Servicio Web Api descargar resumen.................................................................................. 48
5.21 Servicio Web Api descargar resumen inconsistencias ........................................................ 49
5.22 Servicio Web Api exportar preliminar de registro de Ventas ............................................. 51
5.23 Servicio Web Api descargar reporte de casillas .................................................................. 53
5.24 Servicio Web Api descargar inconsistencias en registros preliminar registrado ................ 54
5.25 Servicio Web Api descargar inconsistencias por comprobante pago ................................. 55
5.26 Servicio Web Api descargar constancia de recepción ......................................................... 56
5.27 Servicio Web Api descargar RVIE por periodo .................................................................... 57
5.28 Servicio Web Api descargar reporte consolidado por periodo ........................................... 59
5.29 Servicio Web Api descargar ajustes posteriores ................................................................. 60
5.30 Servicio Web Api descargar ajustes posteriores de periodos anteriores ........................... 61
5.31 Servicio Web Api descargar reporte inconsistencias por periodo ...................................... 63
5.32 Servicio Web Api descargar reporte CAR ............................................................................ 64
5.33 Servicio Web Api descargar reporte estadístico ................................................................. 65
5.34 Servicio Web Api descargar reporte de cumplimiento ....................................................... 66
5.35 Servicio Web Api reporte de exportadores ......................................................................... 68
5.36 Servicio Web Api eliminar preliminar registrado ................................................................ 69
6. Documentación TUS.IO .......................................................................................................... 70
6.1 Implementación TUS.IO con Angular ....................................... ¡Error! Marcador no definido.
7. Anexos..................................................................................................................................... 71
7.1 Anexo I: Indicador de carga masiva....................................................................................... 71
7.2 Anexo II: Tipo de correlativo ................................................................................................. 72
7.3 Anexo III: Código de estado de envío .................................................................................... 73
7.4 Anexo IV: Extension del archivo a descargar........................................................................ 73

5
Control de cambios del documento

N. Respo
Descripción Fecha Versión Motivo de cambio
° nsable

Creación del FSW

1 01/04/2023 1 Creación
documento III

Actualización del
2 31/05/2023 15 FSW Actualización
documento

Actualización del
3 04/08/2023 16 FSW Actualización
documento

Actualización del
4 15/08/2023 17 FSW Actualización
documento

Actualización del
5 16/08/2023 18 FSW Actualización
documento

Actualización del
6 03/11/2023 19 INSI Actualización
documento

Actualización del
7 06/11/2023 20 FSW Actualización
documento

Se agrega nuevo modelo de

Actualización del cliente TUS JAVA que permite
8 09/01/2024 21 INSI
documento recuperar los mensajes de error
422.

- Se retira el parámetro
numRuc(obligatorio) de todos
los servicios dado que ese dato
se encuentra en el token del
contribuyente.

- Se modifica el parámetro
codOrigenEnvio en algunos
servicios del valor 1 al valor 2
(indicador de servicio api)

- Se modifica de obligatorio a
Actualización del
9 08/03/2024 22 INSI opcional el parámetro id de
documento
registro del servicio 5.36

- Se actualiza el servicio 5.36

Servicio Web Api eliminar
preliminar registrado - VENTAS
dice:
id-alfanumérico-String Id de
registro (Obligatorio)
debe decir:
id-alfanumérico-String Id de
registro (Opcional])

6
Mensaje Error

debe incluir en el punto

Mensaje Error :
● 1010 - El libro electronico
con los siguientes
datos: numero de RUC:
XXXXXXXX periodo Tributario:
AAAAMM y codigo de
Libro:140000 no existe.

7
I. Guía de Uso
1. Servicio prerrequisito
a) Diagrama: Esquema gráfico de la secuencia de pasos para llegar a consumir el
servicio web, a nivel de proceso para obtener el token

El contribuyente, usuario del sistema SIRE Ventas, que se encuentra obligado a

generar el registro de Ventas de manera periódica, debe ingresar al Portal SOL de la
SUNAT (https://e-menu.sunat.gob.pe/cl-ti-itmenu/MenuInternet.htm) e iniciar
sesión con su correspondiente Clave SOL.
Ingresar a la opción “EMPRESAS / Credenciales de API SUNAT / Credenciales de API
SUNAT/ Credenciales de API SUNAT/ Gestión Credenciales de API SUNAT”

Se muestran las secciones:

● REGISTRE SU APLICACIÓN
○ Nombre de su aplicación: Alfanumérico, obligatorio y con longitud de
50 caracteres. Ejemplo: Mi Organización ABC
○ URL de su aplicación: Alfanumérico, obligatorio y con longitud de
260. Ejemplo: https://miOrganizacionAbc.com

● SECCIÓN LISTADO DE URI’S

○ Botón de acción:
■ Seleccionar Todos, permite seleccionar o marcar todas las
casillas que hacen referencia a la URI’s
■ Deseleccionar Todos, permite desmarcar todas las casillas
que han sido marcadas o seleccionadas.
○ Lista de URI’s, muestra un listado de URI´s donde el contribuyente
debe seleccionar las URI´s que va consumir para que el sistema le
brinde el acceso correspondiente.
○ El contribuyente deberá seleccionar la URI: “MIGE RCE y RVIE - SIRE”

8
● ALCANCE
○ Desktop, indica que la(s) uri(s) seleccionada(s) van a ser consumidas
desde una interfaz de escritorio.
○ Web, indica que la(s) uri(s) seleccionada(s) van a ser consumidas
desde una interfaz web.

● BOTÓN DE ACCIÓN
○ Guardar, registrar en la base de datos la información de la empresa
del contribuyente, las uris el cual va a consumir y el alcance.
○ Si el contribuyente ya registró su aplicación y las URI´s
correspondientes
○ Seleccionar el botón Editar ubicado en la parte superior derecha
○ El usuario del SIRE, debe ingresar los datos solicitados.
○ Una vez completados los datos requeridos debe seleccionar MIGE
RCE y RVIE - SIRE y seleccionar como alcance Web.

○ Seleccionar el botón Guardar.

○ Al presionar el botón “ACEPTAR”, el sistema genera las credenciales
correspondientes:

9
 El usuario del SIRE que utiliza los servicios Rest, debe almacenar estos valores para
ser utilizado mediante su Sistema de Información.
Una vez que el usuario cuente con los datos del client_id y client_secret además
de su cuenta de usuario y clave SOL, podrán generar el token del api-seguridad-
SUNAT con la siguiente url:
https://api-seguridad.sunat.gob.pe/v1/clientessol/{client_id}/oauth2/token/
Ejemplo:
https://api-seguridad.sunat.gob.pe/v1/clientessol/9cae24a9-10d7-48b0-bee0-
e94bd56947e3/oauth2/token/

b) Servicios Necesarios:
● 5.1 Servicio Api Seguridad (ver detalle en el punto 5. Documentación
Servicios Web API)
2. Secuencia de servicios mínimos para Registrar Preliminar
Funcionalidad 1: Aceptar Propuesta
a) Diagrama: Esquema gráfico de la secuencia de pasos para llegar a consumir el
servicio aceptar la propuesta

10
Nota: Este servicio permite registrar un preliminar del RVIE mediante la
aceptación de una propuesta, como resultado se obtiene un ticket asociado al
proceso.
Este servicio debe enviar comprobantes de la propuesta en este caso:
● Se activa el proceso 5 En Generación de registro, etapa: Preliminar registrado
● codTipoRegistro (2 Registro de Ventas)
● Devuelve respuesta (T o F)

b) Servicios que se pueden invocar:

● 5.1 Servicio Api Seguridad (necesario)
● 5.2 Servicio Web Api consultar año y mes (opcional)
● 5.18 Servicio Web Api descargar propuesta (opcional)
● 5.16 Servicio Web Api consultar estado de envío de ticket (opcional)
● 5.17 Servicio Web Api descargar archivo (opcional)
● 5.8 Servicio Web Api aceptar propuesta del RVIE (necesario)

Funcionalidad 2: Reemplazar Propuesta

a) Diagrama: Esquema gráfico de la secuencia de pasos para llegar a consumir el
servicio reemplazar la propuesta

11
Nota: Servicio web api que permite al generador, reemplazar la propuesta
SUNAT con lo considerado por el contribuyente mediante el uso de un archivo
de formato .txt zipeado.
Si el estado del generador es “baja definitiva”, solo se permitirá actualizar la
información correspondiente a los periodos donde estuvo activo o con
suspensión temporal (generó y/o fue omiso a la generación del registro), en caso
haya generado el registro solo se permitirá la presentación de ajustes
posteriores.

b) Servicios que se pueden invocar:

● 5.1 Servicio Api Seguridad (necesario)
● 5.2 Servicio Web Api consultar año y mes (necesario)
● 5.18 Servicio Web Api descargar propuesta (opcional)
● 5.16 Servicio Web Api consultar estado de envío de ticket (opcional)
● 5.17 Servicio Web Api descargar archivo (opcional)
● 5.3 Servicio Web Api Importar reemplazo de la propuesta (necesario)

Funcionalidad 3: Registrar Preliminar

a) Diagrama: Esquema gráfico de la ejecución de servicios que mantienen
interdependencia para consumir el servicio Registrar preliminar

12
 Servicio web api que permitirá al generador registrar el preliminar enviando con
esa acción a la opción de generación.
Si el estado del generador es baja definitiva, solo se debe permitir actualizar la
información correspondiente a los periodos donde estuvo activo (generó y/o fue
omiso a la generación). En caso haya generado el registro solo se permite la
presentación de ajustes posteriores.

b) Servicios que se pueden invocar:

● 5.1 Servicio Api Seguridad (necesario)
● 5.2 Servicio Web Api consultar año y mes (necesario)
● 5.4 Servicio Web Api importar nuevos comprobantes propuesta (opcional)
● 5.13 Servicio Web Api eliminar comprobante propuesta (opcional)
● 5.14 Servicio Web Api eliminar comprobante preliminar (opcional)
● 5.9 Servicio Web Api registrar preliminar (necesario)

3. Secuencia de servicios interdependientes que completan

funcionalidades del SIRE Ventas
Funcionalidad 1: Tipo de cambio
a) Diagrama: Esquema gráfico de la ejecución de servicios que mantienen
interdependencia para consumir el servicio Tipo de cambio

13
Servicio web api que permite al generador, importar el tipo de cambio en la
propuesta.

b) Servicios que se pueden invocar:

● 5.1 Servicio Api Seguridad (necesario)
● 5.2 Servicio Web Api consultar año y mes (necesario)
● 5.4 Servicio Web Api importar nuevos comprobantes propuesta (opcional)
● 5.11 Servicio Web Api agregar tipo de cambio masivo (necesario)

Funcionalidad 2: Importar comprobantes en propuesta

a) Diagrama: Esquema gráfico de la ejecución de servicios que mantienen
interdependencia para consumir el servicio importar comprobantes en
propuesta

14
Servicio web api que permite al generador, complementar la propuesta
mediante el uso de un archivo de formato .txt zipeado.

b) Servicios que se pueden invocar:

● 5.1 Servicio Api Seguridad (necesario)
● 5.2 Servicio Web Api consultar año y mes (necesario)
● 5.4 Servicio Web Api importar nuevos comprobantes propuesta (necesario)

Funcionalidad 3: Importar comprobantes en preliminar

a) Diagrama: Esquema gráfico de la ejecución de servicios que mantienen
interdependencia para consumir el servicio importar comprobantes en
preliminar

15
Para poder consumir el servicio importar comprobantes en preliminar,
previamente debe haber reemplazado la propuesta.

b) Servicios que se pueden invocar:

● 5.1 Servicio Api Seguridad (necesario)
● 5.2 Servicio Web Api consultar año y mes (necesario)
● 5.3 Servicio Web Api importar reemplazo de la propuesta (necesario)
● 5.5 Servicio Web Api importar nuevos comprobantes preliminar (necesario)

Funcionalidad 4: Importar ajustes posteriores

a) Diagrama: Esquema gráfico de la ejecución de servicios que mantienen
interdependencia para consumir el servicio importar ajustes posteriores

Para poder consumir el servicio importar ajustes posteriores, debe primero

haber generado el periodo que desea ajustar.

b) Servicios que se pueden invocar:

● 5.1 Servicio Api Seguridad (necesario)
● 5.2 Servicio Web Api consultar año y mes (necesario)
● 5.6 Servicio Web Api importar ajustes posteriores (necesario)

Funcionalidad 5: Importar ajustes posteriores de periodos anteriores

a) Diagrama: Esquema gráfico de la ejecución de servicios que mantienen
interdependencia para consumir el servicio importar ajustes posteriores de
periodos anteriores

16
Para poder consumir el servicio importar ajustes posteriores de periodos
anteriores, debe hacerlo referenciando al último periodo generado en el SIRE.

b) Servicios que se pueden invocar:

● 5.1 Servicio Api Seguridad (necesario)
● 5.2 Servicio Web Api consultar año y mes (necesario)
● 5.7 Servicio Web Api importar ajustes posteriores de periodos anteriores
(necesario)

Funcionalidad 6: Eliminar comprobantes en preliminar

a) Diagrama: Esquema gráfico de la ejecución de servicios que mantienen
interdependencia para consumir el servicio Eliminar comprobantes en
preliminar

Para poder consumir el servicio eliminar comprobantes preliminar, previamente

debe haber reemplazado la propuesta.

b) Servicios que se pueden invocar:

● 5.1 Servicio Api Seguridad (necesario)
● 5.2 Servicio Web Api consultar año y mes (necesario)
● 5.3 Servicio Web Api importar reemplazo de la propuesta (necesario)
● 5.5 Servicio Web Api importar nuevos comprobantes preliminar (necesario)
● 5.14 Servicio Web Api eliminar comprobante preliminar (necesario)

Funcionalidad 7: Consultar estado de envío de ticket

a) Diagrama: Esquema gráfico de la ejecución de servicios que mantienen
interdependencia para consumir el servicio consultar estado de envío de ticket

Para poder consumir el servicio consulta de estado de envío de ticket,

previamente debe haberse ejecutado al menos un proceso que genere ticket,
por ejemplo, aceptar propuesta, reemplazar propuesta, descargar propuesta,
entre otros.
17
b) Servicios que se pueden invocar:
● 5.1 Servicio Api Seguridad (necesario)
● 5.8 Servicio Web Api aceptar propuesta del RVIE (al menos 1 debe ejecutarse)
● 5.3 Servicio Web Api importar reemplazo de la propuesta (al menos 1 debe
ejecutarse)
● 5.5 Servicio Web Api Importar nuevos comprobantes preliminar (al menos 1
debe ejecutarse)
● 5.6 Servicio Web Api importar ajustes posteriores (al menos 1 debe
ejecutarse)
● 5.7 Servicio Web Api importar ajustes posteriores de periodos anteriores (al
menos 1 debe ejecutarse)
● 5.18 Servicio Web Api descargar propuesta (al menos 1 debe ejecutarse)
● 5.22 Servicio Web Api exportar preliminar de registro de Ventas (al menos 1
debe ejecutarse)
● 5.23 Servicio Web Api descargar reporte de casillas. (al menos 1 debe
ejecutarse)
● 5.24 Servicio Web Api descargar inconsistencias en registros del preliminar
registrado. (al menos 1 debe ejecutarse)
● 5.32 Servicio Web Api descargar reporte CAR (al menos 1 debe ejecutarse)
● 5.29 Servicio Web Api descargar ajustes posteriores (al menos 1 debe
ejecutarse)
● 5.30 Servicio Web Api descargar ajustes posteriores de periodos anteriores.
(al menos 1 debe ejecutarse)
● 5.16 Servicio Web Api consultar estado de envío de ticket. (opcional)
● 5.28 Servicio Web Api descargar reporte consolidado por periodo. (al menos
1 debe ejecutarse)
● 5.27 Servicio Web Api descargar RVIE por periodo. (al menos 1 debe
ejecutarse)
● 5.31 Servicio Web Api descargar reporte inconsistencias por periodo. (al
menos 1 debe ejecutarse)

Funcionalidad 8: Descargar archivo

a) Diagrama: Esquema gráfico de la ejecución de servicios que mantienen
interdependencia para consumir el servicio descargar archivo

Para poder consumir el servicio de descargar archivo”, previamente debe haberse

ejecutado algún proceso que genere un archivo o más, por ejemplo: “Descargar
propuesta”, entre otros. Es recomendable verificar el estado del ticket haciendo
uso del servicio consultar estado de envío de ticket. El estado debe encontrarse
“Terminado”.

b) Servicios que se pueden invocar:

● 5.1 Servicio Api Seguridad (necesario)
● 5.8 Servicio Web Api aceptar propuesta del RVIE (al menos 1 debe ejecutarse)

18
 ● 5.3 Servicio Web Api importar reemplazo de la propuesta (al menos 1 debe
ejecutarse)
● 5.5 Servicio Web Api Importar nuevos comprobantes preliminar (al menos 1
debe ejecutarse)
● 5.6 Servicio Web Api importar ajustes posteriores (al menos 1 debe
ejecutarse)
● 5.7 Servicio Web Api importar ajustes posteriores de periodos anteriores (al
menos 1 debe ejecutarse)
● 5.18 Servicio Web Api descargar propuesta (al menos 1 debe ejecutarse)
● 5.22 Servicio Web Api exportar preliminar de registro de Ventas (al menos 1
debe ejecutarse)
● 5.23 Servicio Web Api descargar reporte de casillas. (al menos 1 debe
ejecutarse)
● 5.24 Servicio Web Api descargar inconsistencias en registros del preliminar
registrado. (al menos 1 debe ejecutarse)
● 5.32 Servicio Web Api descargar reporte CAR (al menos 1 debe ejecutarse)
● 5.29 Servicio Web Api descargar ajustes posteriores (al menos 1 debe
ejecutarse)
● 5.30 Servicio Web Api descargar ajustes posteriores de periodos anteriores.
(al menos 1 debe ejecutarse)
● 5.16 Servicio Web Api consultar estado de envío de ticket. (opcional)
● 5.28 Servicio Web Api descargar reporte consolidado por periodo. (al menos
1 debe ejecutarse)
● 5.27 Servicio Web Api descargar RVIE por periodo. (al menos 1 debe
ejecutarse)
● 5.31 Servicio Web Api descargar reporte inconsistencias por periodo. (al
menos 1 debe ejecutarse)
● 5.33 Servicio Web Api descargar reporte estadístico. (al menos 1 debe
ejecutarse)

4. Servicios accesorios que pueden ser consumidos en el SIRE Ventas

a) Diagrama: Esquema gráfico de la secuencia de todos los servicios que SUNAT
pone a disposición de los contribuyentes.

19
20
 b) Servicios que se pueden invocar (servicios opcionales):
● 5.34 Servicio Web Api descargar reporte de cumplimiento
● 5.26 Servicio Web Api descargar constancia de recepción.
● 5.20 Servicio Web Api descargar resumen.
● 5.21 Servicio Web Api descargar resumen inconsistencias
● 5.23 Servicio Web Api descargar reporte de casillas.
● 5.24 Servicio Web Api descargar inconsistencias en registros preliminar
registrado.
● 5.32 Servicio Web Api descargar reporte CAR
● 5.2 Servicio Web Api consultar año y mes
● 5.6 Servicio Web Api importar ajustes Posteriores
● 5.27 Servicio Web Api descargar RVIE por periodo.
● 5.28 Servicio Web Api descargar reporte consolidado por periodo.
● 5.31 Servicio Web Api descargar reporte inconsistencias por periodo.
● 5.33 Servicio Web Api descargar reporte estadístico

5. Documentación Servicios Web API

Importante: los servicios del API SIRE no deben ser consumidos desde un cliente
Web, en caso de utilizar un cliente Web se producirá error de CORS. Así mismo los
servicios API REST que impliquen el desarrollo de un cliente TUS (Open Protocol
for Resumable File Uploads) deben ser desarrollados en el lenguaje JAVA (Ver
Anexo 7.5)

5.1 Servicio Api Seguridad

Nombre Web Api Seguridad

Services

Descripción Permite generar el token para consumo de API’s expuestas por SUNAT.

Url https://api-seguridad.sunat.gob.pe/v1/clientessol/9cae24a9-10d7-48b0-bee0-
e94bd56947e3/oauth2/token/

Parámetros[body] Descripción:
grant_type: password
(credenciales del cliente - usar por defecto: password)
scope: https://api-sire.sunat.gob.pe
(uri que permitirá el acceso con el token - por defecto:
https://api-sire.sunat.gob.pe)
client_id: ababababa-9abc-453s-s5s4s4-s457555
(se obtiene desde la opción Credenciales de API SUNAT)
client_secret: CSCSSKSJDSKSNSKSKSSKSJDDN
(se obtiene desde la opción Credenciales de API SUNAT)
username: {RUC} {USUARIO} (RUC y Usuario del generador)
password: {CLAVESOL} (Clave sol del generador)

Parámetros[header] Descripción:
Content-type: tipo de contenido a enviar
Valores:
Content-type: application/x-www-form-urlencoded (opcional)
Método: POST

21
Evidencias URL
https://api-seguridad.sunat.gob.pe/v1/clientessol/9cae24a9-10d7-48b0-bee0-
e94bd56947e3/oauth2/token/
Headers
(No aplica)
Body

Result OK

Result Fail

5.2 Servicio Web Api consultar año y mes

Nombre Web Services Servicio Web Api que consulta años y meses de RVIE.
Descripción Permite consultar los periodos (años y meses) habilitados para el contribuyente.
Url https://api-
sire.sunat.gob.pe/v1/contribuyente/migeigv/libros/rvierce/padron/web/omisos/{codLibro}
/periodos
Parámetros[URL] Param-formato-tipo Descripción
codLibro-alfanumérico-String Código de libro: 140000 RVIE (Obligatorio)
Parámetros[body] No aplica
Parámetros[header] Descripción:
Content-type: tipo de contenido a enviar
Valores:
Parámetros valor
Content-Type application/json
Accept application/json
Authorization Bearer token obtenido de la autenticación
Método: GET

22
Parámetros[salida] Parámetros de Salida Descripción
Object- Object- Object Object inicio
numEjercicio-alfanumérico-String Año o ejericicio
desEstado-alfanumérico-String Descripcion del ejercicio
lisPeriodos-array-array Array lista de periodos - inicio
perTributario-alfanumérico-String Periodo tributario
codEstado-alfanumérico-String Código del estado del periodo tributario
desEstado-alfanumérico-String Descripcion del estado del periodo tributario
lisPeriodos-array-array Array lista de periodos - fin
Object- Object- Object Object fin
Evidencias URL
https://api-
sire.sunat.gob.pe/v1/contribuyente/migeigv/libros/rvierce/padron/web/omisos/140000/p
eriodos
Headers

Body
(No aplica)
Result OK

Result Fail
{ "cod":"500", "msg":"Internal Server Error - Se presento una condicion inesperada que
impidio completar el Request", "exc":"java.lang.NullPointerException at ..." }
Mensaje Error { "cod":"422", "msg":"Unprocessable Entity - Se presentaron errores de validacion que
impidieron completar el Request", "errors":[ { "cod":"1001", "msg":"El campo “numRuc” no
enviado o es vacío" }] }
Lista de errores 422:
● 1140 - El campo “codLibro” no enviado o es vacío

5.3 Servicio Web Api importar reemplazo de la propuesta

Nombre Web Servicio Web Api importar reemplazo de la propuesta

Services
Descripción Servicio web api que permite al generador, reemplazar la propuesta SUNAT con lo
considerado por el contribuyente mediante el uso de un archivo de formato .txt
Url https://api-
sire.sunat.gob.pe/v1/contribuyente/migeigv/libros/rvierce/receptorpropuesta/web/propues
ta/upload
Parámetros[body] No aplica

23
Parámetros[header] Valores:
Content-type: application/x-www-form-urlencoded
Metadata Cliente TUS
Param-formato-tipo Descripción
filename-alfanumérico-String Nombre de archivo (Obligatorio)
filetype-alfanumérico-String Tipo de archivo (Obligatorio)
perTributario-alfanumérico-String Periodo tributario (Obligatorio)
codOrigenEnvio-alfanumérico- Código de origen de envío: 2 Servicio web
String (Obligatorio)
codProceso-alfanumérico-String Código del indicador de carga masiva: 3.Reemplazo
de la Propuesta (Ver Anexo I: Indicador de carga
masiva) (Obligatorio)
codTipoCorrelativo-alfanumérico- Tipo de correlativo: 01: Tipo envíos masivos (Ver
String Anexo II: Tipo de correlativo) (Obligatorio)
nomArchivoImportacion- Nombre del archivo utilizado para la importación o
alfanumérico-String nombre de archivo generado, definido en la tabla 6
del Anexo N° 1 de la Resolución de Superintendencia
112-2021/SUNAT, estructuras e información del
registro electrónico - RVIE, la estructura es la
siguiente:
LERRRRRRRRRRRAAAAMM0014040002OIM2.txt.
(Obligatorio)
codLibro-alfanumérico-String Código de libro: 140000 RVIE (Obligatorio)
Parámetros[salida] Parámetros
Descripción Formato Tipo dato
de Salida
Número de ticket de envío [AAAA99999999]
AAAA: Año
numTicket alfanumerico String
99: Tipo de correlativo
99999999: Número correlativo de envío
Evidencias URL
https://api-sire.sunat.gob.pe
/v1/contribuyente/migeigv/libros/rvierce/receptorpropuesta/web/propuesta/upload
Headers (metadata)
filename TEUyMDEwMDE3NjQ1MDIwMjMwMjAwMTQwNDAwMDIwMTEyLnppcA==,filetype
YXBwbGljYXRpb24vemlw,numRuc MjAxMDAxNzY0NTA=,perTributario
MjAyMzAy,codOrigenEnvio MQ==,codProceso Mw==,codTipoCorrelativo
MQ==,nomArchivoImportacion
TEUyMDEwMDE3NjQ1MDIwMjMwMjAwMTQwNDAwMDIwMTEyLnppcA==,codLibro
MTQwMDAw
Body
(No aplica)
Result OK

Result Fail
{"cod":"500", "msg":"Internal Server Error - Se presento una condicion inesperada que
impidio completar el Request", "exc":"java.lang.NullPointerException at ..." }
Mensaje Error {"cod":"422", "msg":"Unprocessable Entity - Se presentaron errores de validacion que
impidieron completar el Request", "errors":[ { "cod":"1001", "msg":"El campo “numRuc” no
enviado o es vacío" }] }
Lista de errores 422:
● 1001 - El campo “numRuc” no enviado o es vacío
● 1002 - Solo se permite dato numérico de 11 dígitos para el número de RUC.
● 1003 - El RUC ingresado no existe o no es válido
● 1005 - El campo ‘perTributario’ no enviado o es vacio
● 1006 - Formato de perTributario no cumple con el formato ‘yyyymm’
● 1007 - El perTributario de búsqueda no debe ser mayor a la fecha actual
● 1028 - El campo “codOrigenEnvio” no enviado o es vacío
● 1029 - Código tipo de Origen de Envio no permitido o no valido
● 1030 - Solo se permite dato numérico de 1 dígito para el codOrigenEnvio

24
 ● 1025 - El campo “codProceso” no enviado o es vacío
● 1026 - Código Proceso no permitido o no valido
● 1027 - Solo se permite dato numérico para el codProceso
● 1138 - El campo "codProceso" es nulo o vacío
● 1139 - Código de Proceso no permitido o no valido
● 1048 - Solo se permite dato numérico de 1 dígito para el codTipoOrigen
● 1022 - nombre del archivo no enviado o es vacio.
● 1024 - El archivo <nombre del archivo txt> fue previamente enviado.
● 1044 - Error en la <<Posición - Descripción>> del nombre del archivo plano, favor
de corregir
● 1348 - La extensión del archivo es diferente a “.zip”, por favor corregir
● 1346 - El tamaño del archivo comprimido en formato “.zip” debe ser menor o igual
a 6GB.
● 1350 - El tamaño del archivo mayor a 0 Kb.
● 1351 - Se ha producido un error al realizar el envío del archivo, por favor volver a
intentar el envío
● 1048 - Solo se permite dato numérico de 2 dígitos para el codTipoCorrelativo
● 1049 - El campo “codTipoCorrelativo” no enviado o es vacio
● 1050 - Código tipo de Correlativo no permitido o no valido
● 1140 - El campo “codLibro” no enviado o es vacío
Tecnología Uso del protocolo TUS.IO (Ver ítem 6. Documentación TUS.IO)

5.4 Servicio Web Api importar nuevos comprobantes propuesta

Nombre Web Servicio Web Api importar nuevos comprobantes en propuesta

Services
Descripción Servicio web api que permite al generador, agregar nuevos comprobantes que no han sido
propuestos por la administración.
Url https://api-
sire.sunat.gob.pe/v1/contribuyente/migeigv/libros/rvierce/receptorpropuesta/web/propuest
a/upload
Parámetros[body] No aplica
Parámetros[header] Descripción:
Content-type: tipo de contenido a enviar
Valores:
Content-type: application/x-www-form-urlencoded
Metadata Cliente TUS
Param-formato-tipo Descripción
filename-alfanumérico-String Nombre de archivo (Obligatorio)
filetype-alfanumérico-String Tipo de archivo (Obligatorio)
perTributario-alfanumérico-String Periodo tributario (Obligatorio)
codOrigenEnvio-alfanumérico-String Código de origen de envío: 2 Servicio web
(Obligatorio)
codProceso-alfanumérico-String Código del indicador de carga masiva: 1.Importar
CP (Ver Anexo I: Indicador de carga masiva)
(Obligatorio)
codTipoCorrelativo-alfanumérico- Tipo de correlativo: 01: Tipo envíos masivos (Ver
String Anexo II: Tipo de correlativo) (Obligatorio)
nomArchivoImportacion- Nombre del archivo utilizado para la importación
alfanumérico-String o nombre de archivo generado, definido en la
tabla 6 del Anexo N° 1 de la Resolución de
Superintendencia 112-2021/SUNAT, estructura e
información del archivo texto para
complementar la propuesta del RVIE con
comprobantes de pago físicos, la estructura es la
siguiente:
RRRRRRRRRRR-CPF-AAAAMM-Correlativo.txt
(Obligatorio)
codLibro-alfanumérico-String Código de libro: 140000 RVIE (Obligatorio)
Parámetros[salida] Parámetros Tipo
Descripción Formato
de Salida dato

25
 Número de ticket de envío [AAAA99999999]
AAAA: Año
numTicket alfanumerico String
99: Tipo de correlativo
99999999: Número correlativo de envío
Evidencias URL
https://api-
sire.sunat.gob.pe/v1/contribuyente/migeigv/libros/rvierce/receptorpropuesta/web/propuest
a/upload
Headers (metadata)
filename MjAxMDAxNzY0NTAtQ1BGLTIwMjMwMi0wMS56aXA=,filetype
YXBwbGljYXRpb24vemlw,numRuc MjAxMDAxNzY0NTA=,perTributario
MjAyMzAy,codOrigenEnvio MQ==,codProceso MQ==,codTipoCorrelativo
MQ==,nomArchivoImportacion
MjAxMDAxNzY0NTAtQ1BGLTIwMjMwMi0wMS56aXA=,codLibro MTQwMDAw
Body
(No aplica)
Result OK

Result
Fail
{ "cod":"500", "msg":"Internal Server Error - Se presento una condicion inesperada que
impidio completar el Request", "exc":"java.lang.NullPointerException at ..." }
Mensaje Error { "cod":"422", "msg":"Unprocessable Entity - Se presentaron errores de validacion que
impidieron completar el Request", "errors":[ { "cod":"1001", "msg":"El campo “numRuc” no
enviado o es vacío" }] }
Lista de errores 422:
● 1001 - El campo “numRuc” no enviado o es vacío
● 1002 - Solo se permite dato numérico de 11 dígitos para el número de RUC.
● 1003 - El RUC ingresado no existe o no es válido
● 1005 - El campo ‘perTributario’ no enviado o es vacio
● 1006 - Formato de perTributario no cumple con el formato ‘yyyymm’
● 1007 - El perTributario de búsqueda no debe ser mayor a la fecha actual
● 1028 - El campo “codOrigenEnvio” no enviado o es vacío
● 1029 - Código tipo de Origen de Envio no permitido o no valido
● 1030 - Solo se permite dato numérico de 1 dígito para el codOrigenEnvio
● 1025 - El campo “codProceso” no enviado o es vacío
● 1026 - Código Proceso no permitido o no valido
● 1027 - Solo se permite dato numérico para el codProceso
● 1138 - El campo "codProceso" es nulo o vacío
● 1139 - Código de Proceso no permitido o no valido
● 1048 - Solo se permite dato numérico de 1 dígito para el codTipoOrigen
● 1022 - nombre del archivo no enviado o es vacio.
● 1024 - El archivo <nombre del archivo txt> fue previamente enviado.
● 1044 - Error en la <<Posición - Descripción>> del nombre del archivo plano, favor de
corregir
● 1348 - La extensión del archivo es diferente a “.zip”, por favor corregir
● 1346 - El tamaño del archivo comprimido en formato “.zip” debe ser menor o igual
a 6GB.
● 1350 - El tamaño del archivo mayor a 0 Kb.
● 1351 - Se ha producido un error al realizar el envío del archivo, por favor volver a
intentar el envío
● 1048 - Solo se permite dato numérico de 2 dígitos para el codTipoCorrelativo
● 1049 - El campo “codTipoCorrelativo” no enviado o es vacio
● 1050 - Código tipo de Correlativo no permitido o no valido
● 1140 - El campo “codLibro” no enviado o es vacío
Tecnología Uso del protocolo TUS.IO (Ver ítem 6. Documentación TUS.IO)

26
 5.5 Servicio Web Api importar nuevos comprobantes preliminar

Nombre Web Servicio Web Api importar nuevos comprobantes en el preliminar

Services
Descripción Permite importar nuevos comprobantes en el preliminar de RVIE.
Url https://api-
sire.sunat.gob.pe/v1/contribuyente/migeigv/libros/rvierce/receptorpreliminar/web/prelimin
ar/upload
Parámetros[header] Descripción:
Content-type: tipo de contenido a enviar
Valores:
Content-type: application/x-www-form-urlencoded
Metadata Cliente TUS
Param-formato-tipo Descripción
filename-alfanumérico-String Nombre de archivo (Obligatorio)
filetype-alfanumérico-String Tipo de archivo (Obligatorio)
perTributario-alfanumérico-String Periodo tributario (Obligatorio)
codOrigenEnvio-alfanumérico- Código de origen de envío: 2 Servicio web
String (Obligatorio)
codProceso-alfanumérico-String Código del indicador de carga masiva: 4. Importa
CP - Preliminar (Ver Anexo I: Indicador de carga
masiva) (Obligatorio)
codTipoCorrelativo-alfanumérico- Tipo de correlativo: 01: Tipo envíos masivos (Ver
String Anexo II: Tipo de correlativo) (Obligatorio)
nomArchivoImportacion- Nombre del archivo utilizado para la importación o
alfanumérico-String nombre de archivo generado, definido en la tabla 6
del Anexo N° 1 de la Resolución de
Superintendencia 112-2021/SUNAT, estructuras e
información del registro electrónico - RVIE, la
estructura es la siguiente:
LERRRRRRRRRRRAAAAMM0014040002OIM2.txt.
(Obligatorio)
codLibro-alfanumérico-String Código de libro: 140000 RVIE (Obligatorio)
Parámetros[salida] Parámetros de
Descripción Formato Tipo dato
Salida
Número de ticket de envío
[AAAA99999999]
numTicket AAAA: Año alfanumerico String
99: Tipo de correlativo
99999999: Número correlativo de envío
Evidencias URL
https://api-
sire.sunat.gob.pe/v1/contribuyente/migeigv/libros/rvierce/receptorpreliminar/web/prelimin
ar/upload
Headers (metadata)
filename TEUyMDEwMDE3NjQ1MDIwMjMwMjAwMTQwNDAwMDIwMTEyLnppcA==,filetype
YXBwbGljYXRpb24vemlw,numRuc MjAxMDAxNzY0NTA=,perTributario
MjAyMzAy,codOrigenEnvio MQ==,codProceso NA==,codTipoCorrelativo
MQ==,nomArchivoImportacion
TEUyMDEwMDE3NjQ1MDIwMjMwMjAwMTQwNDAwMDIwMTEyLnppcA==,codLibro
MTQwMDAw
Body
(No aplica)
Result OK

Result Fail

27
 { "cod":"500", "msg":"Internal Server Error - Se presento una condicion inesperada que
impidio completar el Request", "exc":"java.lang.NullPointerException at ..." }
Mensaje Error { "cod":"422", "msg":"Unprocessable Entity - Se presentaron errores de validacion que
impidieron completar el Request", "errors":[ { "cod":"1001", "msg":"El campo “numRuc” no
enviado o es vacío" }] }
Lista de errores:
● 1001 - El campo “numRuc” no enviado o es vacío
● 1002 - Solo se permite dato numérico de 11 dígitos para el número de RUC.
● 1003 - El RUC ingresado no existe o no es válido
● 1005 - El campo ‘perTributario’ no enviado o es vacio
● 1006 - Formato de perTributario no cumple con el formato ‘yyyymm’
● 1007 - El perTributario de búsqueda no debe ser mayor a la fecha actual
● 1028 - El campo “codOrigenEnvio” no enviado o es vacío
● 1029 - Código tipo de Origen de Envio no permitido o no valido
● 1030 - Solo se permite dato numérico de 1 dígito para el codOrigenEnvio
● 1025 - El campo “codProceso” no enviado o es vacío
● 1026 - Código Proceso no permitido o no valido
● 1027 - Solo se permite dato numérico para el codProceso
● 1138 - El campo "codProceso" es nulo o vacío
● 1139 - Código de Proceso no permitido o no valido
● 1048 - Solo se permite dato numérico de 1 dígito para el codTipoOrigen
● 1022 - nombre del archivo no enviado o es vacio.
● 1024 - El archivo <nombre del archivo txt> fue previamente enviado.
● 1044 - Error en la <<Posición - Descripción>> del nombre del archivo plano, favor de
corregir
● 1348 - La extensión del archivo es diferente a “.zip”, por favor corregir
● 1346 - El tamaño del archivo comprimido en formato “.zip” debe ser menor o igual
a 6GB.
● 1350 - El tamaño del archivo mayor a 0 Kb.
● 1351 - Se ha producido un error al realizar el envío del archivo, por favor volver a
intentar el envío
● 1048 - Solo se permite dato numérico de 2 dígitos para el codTipoCorrelativo
● 1049 - El campo “codTipoCorrelativo” no enviado o es vacio
● 1050 - Código tipo de Correlativo no permitido o no valido
● 1140 - El campo “codLibro” no enviado o es vacío
Tecnología Uso del protocolo TUS.IO (Ver ítem 6. Documentación TUS.IO)

5.6 Servicio Web Api importar ajustes posteriores

Nombre Web Services Servicio Web Api importar ajustes posteriores

Descripción Cargar ajustes posteriores SIRE
Url https://api-
sire.sunat.gob.pe/v1/contribuyente/migeigv/libros/rvierce/receptorajustesposteriores/we
b/ajustesposteriores/upload
Parámetros[body] No Aplica.
Parámetros[header] Descripción:
Content-type: tipo de contenido a enviar
Valores:
Content-type: application/x-www-form-urlencoded
Metadata Cliente TUS
Param-formato-tipo Descripción
filename-alfanumérico-String Nombre de archivo (Obligatorio)
filetype-alfanumérico-String Tipo de archivo (Obligatorio)
perTributario-alfanumérico-String Periodo tributario (Obligatorio)
codOrigenEnvio-alfanumérico- Código de origen de envío: 2 Servicio web
String (Obligatorio)
codProceso-alfanumérico-String Código del indicador de carga masiva: 6.Cargar
Ajuste posteriores del SIRE (Ver Anexo I:
Indicador de carga masiva) (Obligatorio)
codTipoCorrelativo-alfanumérico- Tipo de correlativo: 01: Tipo envíos masivos (Ver
String Anexo II: Tipo de correlativo) (Obligatorio)

28
 nomArchivoImportacion- Nombre del archivo utilizado para la importación
alfanumérico-String o nombre de archivo generado, definido en la
tabla 6 del Anexo N° 1 de la Resolución de
Superintendencia 112-2021/SUNAT, estructuras
e información del registro electrónico - RVIE, la
estructura dependerá de la descripción
consignada. (Obligatorio)
codLibro-alfanumérico-String Código de libro: 140000 RVIE (Obligatorio)
Parámetros[salida] Parámetros Tipo
Descripción Formato
de Salida dato
Número de ticket de envío [AAAA99999999]
AAAA: Año
numTicket alfanumerico String
99: Tipo de correlativo
99999999: Número correlativo de envío
Evidencias URL
https://api-
sire.sunat.gob.pe/v1/contribuyente/migeigv/libros/rvierce/receptorajustesposteriores/we
b/ajustesposteriores/upload
Headers (metadata)
filename
TEUyMDEwMDE3NjQ1MDIwMjMwMjAwMTQwNDAwMDMxMTEwMi56aXA=,filetype
YXBwbGljYXRpb24vemlw,numRuc MjAxMDAxNzY0NTA=,perTributario
MjAyMzAy,codOrigenEnvio MQ==,codProceso ODc=,codTipoCorrelativo
MQ==,nomArchivoImportacion
TEUyMDEwMDE3NjQ1MDIwMjMwMjAwMTQwNDAwMDMxMTEwMi56aXA=,codLibro
MTQwMDAw
Body
(No aplica)
Result OK

Result Fail
{ "cod":"500", "msg":"Internal Server Error - Se presento una condicion inesperada que
impidio completar el Request", "exc":"java.lang.NullPointerException at ..." }
Mensaje Error { "cod":"422", "msg":"Unprocessable Entity - Se presentaron errores de validacion que
impidieron completar el Request", "errors":[ { "cod":"1001", "msg":"El campo “numRuc” no
enviado o es vacío" }] }
Lista de errores 422:
● 1001 - El campo “numRuc” no enviado o es vacío
● 1002 - Solo se permite dato numérico de 11 dígitos para el número de RUC.
● 1003 - El RUC ingresado no existe o no es válido
● 1005 - El campo ‘perTributario’ no enviado o es vacio
● 1006 - Formato de perTributario no cumple con el formato ‘yyyymm’
● 1007 - El perTributario de búsqueda no debe ser mayor a la fecha actual
● 1028 - El campo “codOrigenEnvio” no enviado o es vacío
● 1029 - Código tipo de Origen de Envio no permitido o no valido
● 1030 - Solo se permite dato numérico de 1 dígito para el codOrigenEnvio
● 1025 - El campo “codProceso” no enviado o es vacío
● 1026 - Código Proceso no permitido o no valido
● 1027 - Solo se permite dato numérico para el codProceso
● 1138 - El campo "codProceso" es nulo o vacío
● 1139 - Código de Proceso no permitido o no valido
● 1048 - Solo se permite dato numérico de 1 dígito para el codTipoOrigen
● 1022 - nombre del archivo no enviado o es vacio.
● 1024 - El archivo <nombre del archivo txt> fue previamente enviado.
● 1044 - Error en la <<Posición - Descripción>> del nombre del archivo plano, favor
de corregir
● 1348 - La extensión del archivo es diferente a “.zip”, por favor corregir

29
 ● 1346 - El tamaño del archivo comprimido en formato “.zip” debe ser menor o
igual a 6GB.
● 1350 - El tamaño del archivo mayor a 0 Kb.
● 1351 - Se ha producido un error al realizar el envío del archivo, por favor volver a
intentar el envío
● 1048 - Solo se permite dato numérico de 2 dígitos para el codTipoCorrelativo
● 1049 - El campo “codTipoCorrelativo” no enviado o es vacio
● 1050 - Código tipo de Correlativo no permitido o no valido
● 1140 - El campo “codLibro” no enviado o es vacío
Tecnología Uso del protocolo TUS.IO (Ver ítem 6. Documentación TUS.IO)

5.7 Servicio Web Api importar ajustes posteriores de periodos

anteriores

Nombre Web Services Servicio Web Api importar ajustes posteriores de periodos anteriores
Descripción Cargar Ajustes posteriores anteriores de periodos anteriores al SIRE
Url https://api-
sire.sunat.gob.pe/v1/contribuyente/migeigv/libros/rvierce/receptorajustesposteriores/web
/ajustesposteriores/upload
Parámetros[body] No Aplica.
Parámetros[header] Descripción:
Content-type: tipo de contenido a enviar
Valores:
Content-type: application/x-www-form-urlencoded
Metadata Cliente TUS
Param-formato-tipo Descripción
filename-alfanumérico-String Nombre de archivo (Obligatorio)
filetype-alfanumérico-String Tipo de archivo (Obligatorio)
perTributario-alfanumérico-String Periodo tributario (Obligatorio)
codOrigenEnvio-alfanumérico- Código de origen de envío: 2 Servicio web
String (Obligatorio)
codProceso-alfanumérico-String Código del indicador de carga masiva: 7. Cargar
Ajuste posteriores anteriores a la vigencia (Ver
Anexo I: Indicador de carga masiva) (Obligatorio)
codTipoCorrelativo-alfanumérico- Tipo de correlativo: 01: Tipo envíos masivos (Ver
String Anexo II: Tipo de correlativo) (Obligatorio)
nomArchivoImportacion- Nombre del archivo utilizado para la importación o
alfanumérico-String nombre de archivo generado, definido en la tabla 6
del Anexo N° 1 de la Resolución de
Superintendencia 112-2021/SUNAT, estructuras e
información del registro electrónico - RVIE, la
estructura dependerá de la descripción
consignada.
(Obligatorio)
codLibro-alfanumérico-String Código de libro: 140000 RVIE (Obligatorio)
Parámetros[salida] Parámetros Tipo
Descripción Formato
de Salida dato
Número de ticket de envío [AAAA99999999]
AAAA: Año
numTicket alfanumerico String
99: Tipo de correlativo
99999999: Número correlativo de envío
Evidencias URL
https://api-
sire.sunat.gob.pe/v1/contribuyente/migeigv/libros/rvierce/receptorajustesposteriores/web
/ajustesposteriores/upload
Headers (metadata)
filename
TEUyMDEwMDE3NjQ1MDIwMjMwMzAwMTQwNDAwMDQxMTEyMDIuemlw,filetype
YXBwbGljYXRpb24vemlw,numRuc MjAxMDAxNzY0NTA=,perTributario
MjAyMzAz,codOrigenEnvio MQ==,codProceso ODg=,codTipoCorrelativo

30
 MQ==,nomArchivoImportacion
TEUyMDEwMDE3NjQ1MDIwMjMwMzAwMTQwNDAwMDQxMTEyMDIuemlw,codLibro
MTQwMDAw
Body
(No aplica)
Result OK

Result Fail
{ "cod":"500", "msg":"Internal Server Error - Se presento una condicion inesperada que
impidio completar el Request", "exc":"java.lang.NullPointerException at ..." }
Mensaje Error { "cod":"422", "msg":"Unprocessable Entity - Se presentaron errores de validacion que
impidieron completar el Request", "errors":[ { "cod":"1001", "msg":"El campo “numRuc” no
enviado o es vacío" }] }
Lista de errores 422:
● 1001 - El campo “numRuc” no enviado o es vacío
● 1002 - Solo se permite dato numérico de 11 dígitos para el número de RUC.
● 1003 - El RUC ingresado no existe o no es válido
● 1005 - El campo ‘perTributario’ no enviado o es vacio
● 1006 - Formato de perTributario no cumple con el formato ‘yyyymm’
● 1007 - El perTributario de búsqueda no debe ser mayor a la fecha actual
● 1028 - El campo “codOrigenEnvio” no enviado o es vacío
● 1029 - Código tipo de Origen de Envio no permitido o no valido
● 1030 - Solo se permite dato numérico de 1 dígito para el codOrigenEnvio
● 1025 - El campo “codProceso” no enviado o es vacío
● 1026 - Código Proceso no permitido o no valido
● 1027 - Solo se permite dato numérico para el codProceso
● 1138 - El campo "codProceso" es nulo o vacío
● 1139 - Código de Proceso no permitido o no valido
● 1048 - Solo se permite dato numérico de 1 dígito para el codTipoOrigen
● 1022 - nombre del archivo no enviado o es vacio.
● 1024 - El archivo <nombre del archivo txt> fue previamente enviado.
● 1044 - Error en la <<Posición - Descripción>> del nombre del archivo plano, favor
de corregir
● 1348 - La extensión del archivo es diferente a “.zip”, por favor corregir
● 1346 - El tamaño del archivo comprimido en formato “.zip” debe ser menor o
igual a 6GB.
● 1350 - El tamaño del archivo mayor a 0 Kb.
● 1351 - Se ha producido un error al realizar el envío del archivo, por favor volver a
intentar el envío
● 1048 - Solo se permite dato numérico de 2 dígitos para el codTipoCorrelativo
● 1049 - El campo “codTipoCorrelativo” no enviado o es vacio
● 1050 - Código tipo de Correlativo no permitido o no valido
● 1140 - El campo “codLibro” no enviado o es vacío
Tecnología Uso del protocolo TUS.IO (Ver ítem 6. Documentación TUS.IO)

5.8 Servicio Web Api aceptar propuesta del RVIE

Nombre Web Aceptar Propuesta

Services
Descripción Actualiza el estado del registro libro y Control de procesos para indicar que se está
registrando un preliminar a través de la propuesta aceptado

Url https://api-
sire.sunat.gob.pe/v1/contribuyente/migeigv/libros/rvie/propuesta/web/propuesta/{perTribu
tario}/aceptapropuesta
Parámetros[URL] Param-formato-tipo Descripción
perTributario-alfanumérico-String Periodo tributario (Obligatorio)

31
Parámetros[body] Descripción
No aplica
Parámetros[header] Descripción:
Content-type: tipo de contenido a enviar
Valores:
Parámetros Valor
Content-Type application/json
Accept application/json
Authorization Bearer token obtenido de la autenticación
Método: POST
Parámetros[salida] Parámetros
Descripcion Formato Tipo dato
de Salida
Número de ticket de envío [AAAA99999999]
AAAA: Año
numTicket alfanumerico String
99: Tipo de correlativo
99999999: Número correlativo de envío
Evidencias URL
https://api-
sire.sunat.gob.pe/v1/contribuyente/migeigv/libros/rvie/propuesta/web/propuesta/202301/
aceptapropuesta
Headers

Body
(No aplica)
Result OK

Result Fail
{ "cod":"500", "msg":"Internal Server Error - Se presento una condicion inesperada que
impidio completar el Request", "exc":"java.lang.NullPointerException at ..." }
Mensaje Error { "cod":"422", "msg":"Unprocessable Entity - Se presentaron errores de validacion que
impidieron completar el Request", "errors":[ { "cod":"1001", "msg":"El campo “numRuc” no
enviado o es vacío" }] }
Lista de errores 422:
• 1005 - El campo ‘perTributario’ no enviado o es vacio
• 1006 - Formato de perTributario no cumple con el formato ‘yyyymm’
• 1007 - El perTributario de búsqueda no debe ser mayor a la fecha actual

5.9 Servicio Web Api registrar preliminar

Nombre Web Servicio Web Api Registrar Preliminar

Services
Descripción Permite registrar los preliminares del registro de Ventas u ajustes posteriores y pueda
continuar con la Generación en el portal WEB de SUNAT.
Url https://api-sire.sunat.gob.pe
/v1/contribuyente/migeigv/libros/rvierce/gestionlibro/web/registroslibros/{perTributario}/re
gistrapreliminar
Parámetros[URL] Param-formato-tipo Descripción
perTributario-alfanumérico-String Periodo tributario (Obligatorio)
Parámetros[body] No aplica

32
Parámetros[header] Descripción:
Content-type: tipo de contenido a enviar
Valores:
Content-type: application/x-www-form-urlencoded
Parámetros valor
Content-Type application/json
Accept application/json
Authorization Bearer token obtenido de la autenticación
Método: POST
Parámetros[salida] Parámetros Valor
HTTP status 200
Content-Type application/json
Evidencias URL
https://api-
sire.sunat.gob.pe/v1/contribuyente/migeigv/libros/rvierce/gestionlibro/web/registroslibros/
202302/registrapreliminar
Headers

Body
(No aplica)
Result OK

Result Fail
{ "cod":"500", "msg":"Internal Server Error - Se presento una condicion inesperada que
impidio completar el Request", "exc":"java.lang.NullPointerException at ..." }
Mensaje Error { "cod":"422", "msg":"Unprocessable Entity - Se presentaron errores de validacion que
impidieron completar el Request", "errors":[ { "cod":"1001", "msg":"El campo “numRuc” no
enviado o es vacío" }] }
Lista de errores 422:
● 1006 - Formato de perTributario no cumple con el formato ‘yyyymm’
● 1007 - El perTributario de búsqueda no debe ser mayor a la fecha actual

5.10 Servicio Web Api exclusión definitiva de notas de crédito y facturas

Nombre Web Servicio Web Api exclusión definitiva de notas de crédito y facturas
Services
Descripción Permite la exclusión de las notas de crédito y facturas de manera definitiva e irreversible
Url https://api-
sire.sunat.gob.pe/v1/contribuyente/migeigv/libros/rvie/propuesta/web/propuesta/{perTribu
tario}/retiracomprobante?codCar={codCar}&codSituacion={codSituacion}
Parámetros[URL] Param-formato-tipo Descripción
perTributario-alfanumérico-String Periodo tributario (Obligatorio)
codCar-alfanumérico-String Código de Anotación de Registro (CAR SUNAT)
(Obligatorio)
codSituacion-alfanumérico-String Código de situación: 0 inactivo (Obligatorio)
Parámetros[body] No aplica.
Parámetros[header] Descripción:
Content-type: tipo de contenido a enviar
Valores:
Content-type: application/x-www-form-urlencoded
Parámetros valor

33
 Content-Type application/json
Accept application/json
Authorization Bearer token obtenido de la autenticación
Método: POST
Parámetros[salida] Parámetros valor
HTTP status 200
Content-Type application/json
Evidencias URL
https://api-
sire.sunat.gob.pe/v1/contribuyente/migeigv/libros/rvie/propuesta/web/propuesta/202302/r
etiracomprobante?codCar=2013729131301FD880000001007&codSituacion=0
Headers

Body
(No aplica)
Result OK

Result Fail
{ "cod":"500", "msg":"Internal Server Error - Se presento una condicion inesperada que
impidio completar el Request", "exc":"java.lang.NullPointerException at ..." }
Mensaje Error { "cod":"422", "msg":"Unprocessable Entity - Se presentaron errores de validacion que
impidieron completar el Request", "errors":[ { "cod":"1001", "msg":"El campo “numRuc” no
enviado o es vacío" }] }
Lista de errores:
• 1005 - El campo 'perTributario' no enviado o es vacio
• 1006 - Formato de perTributario no cumple con el formato 'yyyymm'
• 1135 - El campo “codCar” no enviado o es vacío
• 1136 - Solo se permite dato numérico de 27 dígitos para el Codigo CAR.
• 1120 - Solo se permite dato numérico de 1 dígito para el codSituacion

5.11 Servicio Web Api agregar tipo de cambio masivo

Nombre Web Servicio Web API agregar tipo de cambio masivo

Services
Descripción Permite actualizar masivamente todos los tipos de cambio de comprobantes que la
administración no encontró tipo de cambio propuesto, de la misma manera los montos
propuestos serán actualizados utilizando el o los tipos de cambio ingresados.
Url https://api-
sire.sunat.gob.pe/v1/contribuyente/migeigv/libros/rvie/propuesta/web/masivo/{perTributar
io}/guardacomplementomasivo
Parámetros[url] Param-formato-tipo Descripción
perTributario-alfanumérico-String Periodo tributario (Obligatorio)
Parámetros[body] Param-formato-tipo Descripción
Array Array - inicio
fecEmision-dd/mm/yyyy-String Fecha de emisión del documento (Obligatorio)
codMoneda-numérico-String Códigos de moneda (Obligatorio)
mtoTipoCambio-decimal-String Tipo de cambio de PEN (Soles) a USD (Dólares)
(Obligatorio)
mtoCambioMonedaExt- Tipo de cambio de moneda extranjera a PEN (Soles)

34
 decimal-String (Opcional)
Array Array - fin
Parámetros[header] Descripción:
Content-type: tipo de contenido a enviar
Valores:
Parámetros valor
Content-Type application/json
Accept application/json
Authorization Bearer token obtenido de la autenticación
Método: POST
Parámetros[salida] Parámetros Valor
HTTP status 200
Content-Type application/json
Evidencias URL
https://api-
sire.sunat.gob.pe/v1/contribuyente/migeigv/libros/rvie/propuesta/web/masivo/202301/gua
rdacomplementomasivo
Headers

Body

Result OK

Result Fail
{ "cod":"500", "msg":"Internal Server Error - Se presento una condicion inesperada que
impidio completar el Request", "exc":"java.lang.NullPointerException at ..." }
Mensaje Error { "cod":"422", "msg":"Unprocessable Entity - Se presentaron errores de validacion que
impidieron completar el Request", "errors":[ { "cod":"1001", "msg":"El campo “numRuc” no
enviado o es vacío" }] }
Lista de errores 422:
● 1005 - El campo ‘perTributario’ no enviado o es vacio
● 1006 - Formato de perTributario no cumple con el formato ‘yyyymm’
● 1007 - El perTributario de búsqueda no debe ser mayor a la fecha actual
● 1141 - Código tipo de moneda no permitido o no valido
● 1142 - No se permite el tipo de dato para codMoneda
● 1143 - El campo "codMoneda" es nulo o vacío
● 1144 - El campo "mtoTipoCambio" es nulo o vacío
● 1145 - Solo se permite dato numérico y decimal para el mtoTipoCambio

35