0% encontró este documento útil (0 votos)
99 vistas5 páginas

Manual de Servicios Web API - SIRE - Compras v18 (46-50)

El documento detalla los parámetros y requisitos para el uso de varios servicios web API relacionados con la importación y gestión de comprobantes de pago en el sistema SUNAT. Incluye especificaciones sobre los campos obligatorios, códigos de error y mensajes de validación que pueden surgir durante el proceso. También se menciona el uso de la librería TUS.io para la implementación del cliente.

Cargado por

juan
Derechos de autor
© © All Rights Reserved
Nos tomamos en serio los derechos de los contenidos. Si sospechas que se trata de tu contenido, reclámalo aquí.
Formatos disponibles
Descarga como PDF, TXT o lee en línea desde Scribd
0% encontró este documento útil (0 votos)
99 vistas5 páginas

Manual de Servicios Web API - SIRE - Compras v18 (46-50)

El documento detalla los parámetros y requisitos para el uso de varios servicios web API relacionados con la importación y gestión de comprobantes de pago en el sistema SUNAT. Incluye especificaciones sobre los campos obligatorios, códigos de error y mensajes de validación que pueden surgir durante el proceso. También se menciona el uso de la librería TUS.io para la implementación del cliente.

Cargado por

juan
Derechos de autor
© © All Rights Reserved
Nos tomamos en serio los derechos de los contenidos. Si sospechas que se trata de tu contenido, reclámalo aquí.
Formatos disponibles
Descarga como PDF, TXT o lee en línea desde Scribd
Está en la página 1/ 5

filetype-alfanumérico-string Tipo de archivo (Obligatorio)

numRuc-alfanumérico-string Número de RUC del contribuyente (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 (Obligatorio)
codLibro-alfanumérico-String Código de libro: 080000 RCE (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/receptorpreliminar/web/prelimin
ar/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:
• 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 vacío
• 1006 - Formato de perTributario no cumple con el formato “yyyymm”
• 1007 - El perTributario de búsqueda no debe ser mayor a la fecha actual
• 1014 - Solo se permite dato numérico de 6 dígitos para el perTributario.
• 1064 - El periodo no debe ser mayor al periodo de la fecha actual
• 1093 - Formato de período no cumple con el formato “yyyymm”
• 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

46
• 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 de la librería TUS.io para cliente.

5.8 Servicio Web Api incluir-excluir comprobantes de la propuesta

Nombre Web Servicio Web Api incluir-excluir comprobantes de la propuesta


Services
Descripción Servicio web api que permite al generador incluir o excluir comprobantes que 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] 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)
numRuc-alfanumérico-string Número de RUC del contribuyente
(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: 55.
Carga Incluir Excluir (Ver Anexo I: Indicador de
carga masiva) (Obligatorio)
codTipoCorrelativo-alfanumérico-string Tipo de correlativo: 01: Tipo envíos masivos
(Ver Anexo II: Tipo de correlativo) (Obligatorio)
nomArchivoImportacion-alfanumérico- Nombre del archivo utilizado para la
String importación o nombre de archivo generado
(Obligatorio)
codLibro-alfanumérico-String Código de libro: 080000 RCE (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/propuest
a/upload

47
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 vacío
● 1006 - Formato de perTributario no cumple con el formato “yyyymm”
● 1007 - El perTributario de búsqueda no debe ser mayor a la fecha actual
● 1014 - Solo se permite dato numérico de 6 dígitos para el perTributario.
● 1064 - El periodo no debe ser mayor al periodo de la fecha actual
● 1093 - Formato de período no cumple con el formato “yyyymm”
● 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 de la librería TUS.io para cliente.

5.9 Servicio Web Api importar nuevos comprobantes de pago

Nombre Web Servicio Web Api importar nuevos comprobantes en propuesta


Services

48
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] 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)
numRuc-alfanumérico-string Número de RUC del contribuyente
(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 - Propuesta (Ver Anexo I:
Indicador de carga masiva) (Obligatorio)
codTipoCorrelativo-alfanumérico-string Tipo de correlativo: 01: Tipo envíos masivos
(Ver Anexo II: Tipo de correlativo) (Obligatorio)
nomArchivoImportacion-alfanumérico- Nombre del archivo utilizado para la
String importación o nombre de archivo generado
(Obligatorio)
codLibro-alfanumérico-String Código de libro: 080000 RCE (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/propuest
a/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

49
● 1005 - El campo “perTributario” no enviado o es vacío
● 1006 - Formato de perTributario no cumple con el formato “yyyymm”
● 1007 - El perTributario de búsqueda no debe ser mayor a la fecha actual
● 1014 - Solo se permite dato numérico de 6 dígitos para el perTributario.
● 1064 - El periodo no debe ser mayor al periodo de la fecha actual
● 1093 - Formato de período no cumple con el formato “yyyymm”
● 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 de la librería TUS.io para cliente.

5.10 Servicio Web Api importar tipo de cambio masivo

Nombre Web Servicio Web API importar 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/rce/propuesta/web/{perTributario}/{codL
ibro}/resumenfechatipocambio
Parámetros[url] Param-formato-tipo Descripción
perTributario-alfanumérico-String Periodo tributario (Obligatorio)
codLibro-alfanumérico-String Código de libro: 080000 RCE (Obligatorio)
Parámetros[body] Param-formato-tipo Descripción
archivo-multipart/form-data-formData archivo a procesar
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 de Salida Descripción
numRuc-alfanumérico-String Número de RUC del contribuyente
perTributario-alfanumérico-String Periodo tributario
numTicket-alfanumérico-String Número de ticket de envío [AAAA99999999]
AAAA: Año

50

También podría gustarte