Está en la página 1de 224

ID Nombre Servico o Nombre Recurso Descripción Proceso

Agrega existencias para la comunicacion,


S001 Agregar existencia
rectificatoria y fiscalización

Carga los datos para editar las existencias de la


S002 Editar existencia
comunicacion, rectificatoria y fiscalización

Actualiza existencias para la comunicacion,


S003 Actualizar
rectificatoria y fiscalización
Elimina existencias para la comunicacion,
S004 Eliminar existencia
rectificatoria y fiscalización
S005_1 Importación archivo Importar Archivo Plano (".txt")
S005_2 Importación archivo Importar Archivo Plano (".xls") o (".xlsx)
S005_3 Validar Archivo Masivo Plano Validar Archivo Masivo Plano (".txt")

S005_4 Validar Archivo Masivo Excel Validar Archivo Masivo Plano (".xls") o (".xlsx)

Generar un archivo plano (.txt) en donde


S005_5 Genera Archivo de Inconsistencias aparecen las inconsistencia al ser recorrido el
archivo de importación
exporta existencias de la comunicacion y la
S006 Exportar Existencias
rectificatoria
S007 Validar existencia documento identidad
S008 Consultar datos del documento identidad
S009 Validar documento identidad no habido
Consulta las existencias en la coleccion
S010 Generar preliminar
registrosDesmedro
Genera la constancia recepción de la
S011 Generar constancia recepción comunicación, rectificatoria, baja, carga de
documento y carga de informe
Envia correo a buzon SOL sobre la
S012 Enviar correo buzón Sol comunicación, rectificatoria, baja, carga de
documento y carga de informe

Envia correo a buzon del contribuyente sobre la


S013 Enviar correo la comunicación, rectificatoria, baja, carga de
documento y carga de informe

Filtra las comunicaciones según diversos


S014 Buscar comunicación SOL XXXXXXXXXX
criterios de búsqueda
S015 Exportar consulta
S016 Descargar informe documento
S017 Ver detalle comunicación
S018 Descargar detalle comunicación
S019 Historial rectificatoria
S020 Ver detalle rectificatoria
S021 Dar de baja
S022 Rectificar
S023 Grabar baja comunicación
S025 Grabar comunicación rectificada

S026 Seleccionar archivo de informe o documento

S027 Vista previa de archivo de carga o informe


S028 Validar archivo de carga o informe
S029 Cargar informe o documento

Filtra las comunicaciones según diversos


S030 Buscar comunicación en Intranet
criterios de búsqueda que realiza el fiscalizador

S031 Ver fiscalización Accesar resultado desde el Link


S031 Aceptar fiscalización Aceptar preliminar
S032 Consulta Presenciar Fiscalizacion Consulta Presenciar Fiscalizacion
B0XX
(1) Tipos de Servicio:
A. Entidad e
B. Tarea t
C. Utilitario u
(1)Operación
Nombre propuesto de la operación. En caso de servicios REST es opcional colocar el Metodo HTTP (GET, POST,PUT, DELETE). El metodo HTTP se define obligarot
(1) Acción a tomar:
A. Conformidad para su diseño e implementación. (creación). 
B. Usar servicio existente para responder requerimientos de servicio candidato (reutilización).
C. Actualizar servicio existente para responder requerimientos de servicio candidato (mantenimiento).
D. Observado por no cumplir con los criterios establecidos en el presente procedimiento. (observado)
E. Desestimado para su diseño e implementación por no cumplir con los criterios establecidos en el presente procedimiento. (desestimado)
Listado de Servicios Candidatos
Tarea
Sub-Proceso Operacion MICROSERVICIO Tipo
(opcional)

agregarExistencia

consultarExistencia

actualizarExistencia

eliminarExistencia

CargaArchivoMasivoPlano
CargaArchivoMasivoExcel
ValidaArchivoMasivoPlano

ValidaArchivoMasivoExcel

reporteInconsistencias

GeneraConstancia
YYYYYYY consultarComunicaciones XXXXXXXXXXXXX-consultacomunicacion-backend A - Entidad -
HTTP se define obligarotiamente en el formato de "Especificacion de Servicio REST"
Dominio Acción a tomar (1) Analista

Jonatan

Jonatan

Jonatan

Jonatan

Marko
Marko
Marko

Marko

Pedro

Jonatan
Jonatan
Jonatan

Marko

Marko
Marko

Marko

A. Conformidad para su diseño e


auditoria.tributaria Jonatan
implementación. (Creación).
Jonatan
Pedro
Jonatan
Jonatan
Jonatan
Jonatan
Pedro
Pedro
Pedro
Pedro

Pedro

Pedro
Pedro
Pedro

Jonatan

Marko
Marko
ID. Servicio
Dominio
Recurso
Descripción del Recurso/tarea

Modelo Conce

Operación
Método HTTP
URI privada
URI pública

SLA
Propiedad
tiempoRes
disponibilidad

Request URI
Parámetros de   Entrada
Request Header
Parámetros
Content-Type
Accept
numRuc
Bearer
codUsuario

Request Body
Parámetros de   Entrada
numRuc

fecAcceso

indActividad

numCorrelativo

codTipoAccionFisica

desTipoAccionFisica

codTipoAccionDocumental

desTipoAccionDocumental

codResulRevisionFisica

desResulRevisionFisica
codResulRevisionDocumental

desResulRevisionDocumental

IndSinCodigoUNSPC

codExistenciaUNSPC

DescripcionUNSPC
codCatalogPropio

codMotivoDestruccion

desMotivoDestruccion
codUnidadMedida

cantExistencia
costoUnitarioExistencia
costoComputableExistencia
ObservacionItemExistencias
Ejemplo Request

JSON en el body
{
"numRUC": "20100070970",
"fecAcceso": "2021-06-12T00:00:00Z",
"indActividad": "01",
"numCorrelativo": 2,
"CodTipoAccionFisica":"001",
"DesTipoAccionFisica":" Resultado de presenciar la destrucción del desmedro de existencias por parte de un p
"codTipoAccionDocumental":"",
"DesTipoAccionDocumental":"",
"codResulRevisionFisica":"001",
"desResulRevisionFisica":"CONFORME",
"codResulRevisionDocumental":"",
"desResulRevisionDocumental":"",
"IndSinCodigoUNSPC":"01",
"codExistenciaUNSPC": "11141601 - Desecho o desperdicio textil",
"DescripcionUNSPC":"",
"codCatalogPropio": "5555HHHH3333KKKK2222KKKK",
"codMotivoDestruccion": "001",
"desMotivoDestruccion": "Existencias vencidas",
"codUnidadMedida": "MMM",
"cantExistencia": 2.45,
"costoUnitarioExistencia": 10,
"costoComputableExistencia": 24.5,
"codResulRevisionDocumental":"",
"desResulRevisionDocumental":"",
"IndSinCodigoUNSPC":"01",
"codExistenciaUNSPC": "11141601 - Desecho o desperdicio textil",
"DescripcionUNSPC":"",
"codCatalogPropio": "5555HHHH3333KKKK2222KKKK",
"codMotivoDestruccion": "001",
"desMotivoDestruccion": "Existencias vencidas",
"codUnidadMedida": "MMM",
"cantExistencia": 2.45,
"costoUnitarioExistencia": 10,
"costoComputableExistencia": 24.5,
"ObservacionItemExistencias":""
Response Header
}
Parámetros
HTTP status
Content-Type

Response Body
Parámetros de Salida
paginacion

Ejemplo JSON Response Body

ANEXO Datos Complejos


Lista de Pasajeros
Propiedad

Formato de mensaje de ERROR 500

Response Header
Parámetros
HTTP status
Content-Type

Response Body
Parámetros de Salida
cod
msg
exc

Ejemplo de Response
{
"cod":"500",
"msg":"Internal Server Error - Se presento una condicion inesperada que impidio completar el Request",
"exc":"java.lang.NullPointerException at ..."
}

Formato de mensaje de ERROR 422

Response Header
Parámetros
HTTP status
Content-Type

Response Body
Parámetros de Salida
cod
msg
exc
errors

Ejemplo de Response
{
"cod": "422",
"msg": "Unprocessable Entity - Se presentaron errores de validacion que impidieron completar el Request",
"exc": null,
"errors": [
{
"success": false,
"codError": "1058",
"desError": "No hay información para el rango de periodo seleccionado debido a que ha superado el plazo
}
]
}

numRuc
fecAcceso
fecAcceso
codExistenciaUNSPC
codCatalogPropio
codCatalogPropio
codMotivoDestruccion
codMotivoDestruccion
desMotivoDestruccion
codUnidadMedida
codUnidadMedida
cantExistencia
cantExistencia
costoUnitarioExistencia
costoUnitarioExistencia
costoComputableExistencia
costoComputableExistencia
numCorrelativo
numCorrelativo
indActividad
indActividad
IndSinCodigoUNSPC
IndSinCodigoUNSPC
DescripcionUNSPC
ObservacionItemExistencias
FORMATO DE ESPECIFICACION DE SERVICIO REST

S001-agregarExistencia
XXXXXXXX
YYYYYYYYY
Agrega existencias para la comunicacion, rectificatoria y fiscalización

Modelo Conceptual

consultarNoIncluidos
GET
http://sunatgvi.k8s.sunat.peru/v1/auditoria/tributaria/operativo/e/desmedro/{numRuc}/agregarExistencia
https://api.sunat.gob.pe/v1/auditoria/tributaria/operativo/desmedro/{numRuc}/agregarExistencia

SLA
Descripción
Tiempo de respuesta
disponibilidad

REQUEST

Descripcion
valor
application/json
application/json
número de ruc, recuperado del token (Solo para la URI Privada)
token obtenido de la autenticación (Solo para la URI Publica)
String - (Solo para la URI Privada)

Descripcion
RUC del contribuyente que registra la comunicación de destrucción de existencias por
desmedros
Fecha y hora en que se presenta la comunicacion

Indicador para saber si el registro temporal pertenece a una comunicacion, rectificatoria o


Fiscalización
-01 Comunicacion
-02 Rectificatoria
-03 Fiscalizacion

Número correlativo para poder identificar la existencia que se esta agregando


temporalmente.
Inicia en 1 hasta … n

Codigo del tipo de Acción


001 - Resultado de presenciar la destrucción del desmedro de existencias por parte de un
personal de la SUNAT.

Otro resultado
096 - No se permitió presenciar el acto de destrucción
097 - No se encontró el domicilio indicado para realizar el acto de destrucción
098 - No se concluyó el acto de destrucción
099 Otros

Descripción del tipo de accion Fisica


Codigo del tipo de Acción

002 - Resultado de la verificación de lo consignado en el Informe o el Documento


elaborado por el Notario o Juez de Paz que acredita la destrucción de las existencias

Descripción del tipo de accion Documental

Resultado de la revisión Fisica


001 - Conforme
002 - No conforme
005 - No presencia
Descripción del tipo de revisión Fisica
Resultado de la revisión Documental
003 - Conforme documental
004 - No conforme documental
Descripción del tipo de revisión Documental
Indicador que muestra si se ingresa una Descripcion en lugar del Codigo UNSPC
01 - Indica que se guardara el Código UNSPC
02 - Indica que no tiene Codigo UNSPC y se guardara una Descripción.

Código UNSPSC a 8 dígitos acompañado del nombre al que corresponde como bien a
destruir.
Descripción en lugar del Codigo UNSPC
Código de materia de destrucción de acuerdo al catálogo propio del contribuyente con una
longitud de hasta 24 dígitos.
Codigo del motivo de destrucción
001 - Existencias vencidas
002 - Existencias perecibles malogradas
003 - Existencias no aptas para consumo
004 - Existencias en desuso
005 - Existencias depreciadas
006 - Existencias en proceso que no pueden tener uso en otro proceso
099 - Otros

Descripcion del motivo de destrucción


Codigo de unidad de medida segun el estandar
XXX
YYY
ZZZ
Cantidad de la exitencia a destruir
Costo unitario de la exitencia a destruir
Costo computable de la exitencia a destruir
Descripción de alguna observación que tenga el bien a destruir.

enciar la destrucción del desmedro de existencias por parte de un personal de la SUNAT.",

cho o desperdicio textil",

K2222KKKK",

cidas",
cho o desperdicio textil",

K2222KKKK",

cidas",

RESPONSE

valor
200
application/json

Descripcion

Descripcion

valor
Revisar la tabla de codigos de Error
application/json

Descripcion
codigo de error(Revisar la tabla de codigos de Error)
mensaje de error para el usuario
traza del error
una condicion inesperada que impidio completar el Request",
."

valor
Revisar la tabla de codigos de Error
application/json

Descripcion
codigo de error(Revisar la tabla de codigos de Error)
mensaje de error para el usuario
traza del error
array de errores y descripcion del error

aron errores de validacion que impidieron completar el Request",

el rango de periodo seleccionado debido a que ha superado el plazo de los 6 años, para poder visualizar dicha información deberá solicita

Cuadro de
No existe el campo o es vacío
No existe el campo o es vacío
Formato permitido: dd/mm/aaaa hh:mm:ss
No existe el campo o es vacío
No existe el campo o es vacío
Formato no permitido
No existe el campo o es vacío
Formato no permitido
No existe el campo o es vacío
Formato no permitido
No existe el campo o es vacío
Formato no permitido
No existe el campo o es vacío
Formato no permitido
No existe el campo o es vacío
Formato no permitido
No existe el campo o es vacío
Formato no permitido
No existe el campo o es vacío
Formato no permitido
No existe el campo o es vacío
No existe el campo o es vacío
Formato no permitido
solo si IndSinCodigoUNSPC ="02"
solo si costoUnitarioExistencia = 0
ICACION DE SERVICIO REST

uc}/agregarExistencia
garExistencia

Valor
5 Seg
24x7

REQUEST

Formato
Formato
alfanumérico

GMT-05
ISO DATE ('yyyy-mm-ddThh:mm:ss.000-05:00')
Alfanumérico

numerico

alfanumérico

alfanumérico

alfanumérico

alfanumérico

alfanumérico

alfanumérico
alfanumérico

alfanumérico

alfanumérico

alfanumérico
alfanumérico

alfanumérico

alfanumérico
alfanumérico

Numerico
Numerico
Numerico
alfanumérico
RESPONSE

Formato

Tipo dato

Formato
Formato

zar dicha información deberá solicitarla a Administración Tributaria."

Cuadro de mensajes de Error


Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de forma
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de forma
Validaciones de obligatoriedad
Validaciones de forma
Validaciones de obligatoriedad
Validaciones de forma
Validaciones de obligatoriedad
Validaciones de forma
Validaciones de obligatoriedad
Validaciones de forma
Validaciones de obligatoriedad
Validaciones de forma
Validaciones de obligatoriedad
Validaciones de forma
Validaciones de obligatoriedad
Validaciones de forma
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de forma
solo si IndSinCodigoUNSPC ="02" Validacion de
obligatoriedad
solo si costoUnitarioExistencia = 0.00 validacion de
obligatoriedad
Tipo dato
Tipo dato
string

Date

String

int

string

string(250)

string

string(250)

string

string
string

string

string

string
string

string

string
string

decimal128
decimal128
decimal128
string
Tipo dato
Object

Tipo dato
String
String
String
Tipo dato
String
String
String
String

Tributaria."

r
42201 – El campo “numRuc” no enviado o es vacío
42202 – El campo “fecAcceso” no enviado o es vacío
42203 – Formato de "fecAcceso" no cumple con el formato “ dd/mm/aaaa hh:mm:ss”
42204 – El campo “codExistenciaUNSPC” no enviado o es vacío
42205 – El campo “codCatalogPropio” no enviado o es vacío
42206 – El campo “codCatalogPropio” debe estar conformado de 24 digitos sin espacios pero si
acepta
42207 –guion
El campo “codMotivoDestruccion” no enviado o es vacío
42208 – El campo “codMotivoDestruccion” debe estar conformado de 3 digitos
42209 – El campo “desMotivoDestruccion” no enviado o es vacío
42210 – El campo “codUnidadMedida” debe estar conformado de 3 digitos
42211 – El campo “codUnidadMedida” no enviado o es vacío
42212 – El campo “cantExistencia” debe estar conformado de un numero decimal
42213 – El campo “cantExistencia” no enviado o es vacío
42214 – El campo “costoUnitarioExistencia” debe estar conformado de un numero decimal
42215 – El campo “costoUnitarioExistencia” no enviado o es vacío
42216 – El campo “costoComputableExistencia” debe estar conformado de un numero decimal
42217 – El campo “costoComputableExistencia” no enviado o es vacío
42218 – El campo “numCorrelativo” debe estar conformado de un numero entero
42219 – El campo “numCorrelativo” no enviado o es vacío
42220 – El campo “indActividad” debe estar conformado por 2 digitos
42221 – El campo “indActividad” no enviado o es vacío
42245 – El campo “IndSinCodigoUNSPC” no enviado o es vacío
42246 – El campo “IndSinCodigoUNSPC” debe estar conformado por 2 digitos
42247 – El campo “DescripcionUNSPC” no enviado o es vacío
42248 – El campo “ObservacionItemExistencias” no enviado o es vacío
42201
42202
42203
42204
42205
42206
42207
42208
42209
42210
42211
42212
42213
42214
42215
42216
42217
42218
42219

42245
42246
42247
42248
ID. Servicio
Dominio
Recurso
Descripción del Recurso/tarea

Modelo Conce

Operación
Método HTTP
URI privada
URI pública

SLA
Propiedad
tiempoRes
disponibilidad

Request URI
Parámetros de   Entrada
Request Header
Parámetros
Content-Type
Accept
numRuc
Bearer
codUsuario

Request Body
Parámetros de   Entrada
numRuc

fecAcceso

indActividad

numCorrelativo

Ejemplo Request

JSON en el body
{
"numRUC": "20100070970",
"fecAcceso": "2021-06-12T00:00:00Z",
"indActividad": "01",
"numCorrelativo": 2
}

Response Header
Parámetros
HTTP status
Content-Type
Response Body
Parámetros de Salida
paginacion
indActividad

IndSinCodigoUNSPC

codExistenciaUNSPC
DescripcionUNSPC
codCatalogPropio
codMotivoDestruccion
desMotivoDestruccion
codUnidadMedida
cantExistencia
costoUnitarioExistencia
costoComputableExistencia
ObservacionItemExistencias

Ejemplo JSON Response Body


{
"indActividad": "01",
"IndSinCodigoUNSPC":"01",
"codExistenciaUNSPC": "11141601 - Desecho o desperdicio textil",
"DescripcionUNSPC":"",
"codCatalogPropio": "5555HHHH3333KKKK2222KKKK",
"codMotivoDestruccion": "001",
"desMotivoDestruccion": "Existencias vencidas",
"codUnidadMedida": "MMM",
"cantExistencia": 2.45,
"costoUnitarioExistencia": 10,
"costoComputableExistencia": 24.5,
"ObservacionItemExistencias":""
}

ANEXO Datos Complejos


Lista de Pasajeros
Propiedad
Formato de mensaje de ERROR 500

Response Header
Parámetros
HTTP status
Content-Type

Response Body
Parámetros de Salida
cod
msg
exc

Ejemplo de Response

{
"cod":"500",
"msg":"Internal Server Error - Se presento una condicion inesperada que impidio completar el Request",
"exc":"java.lang.NullPointerException at ..."
}

Formato de mensaje de ERROR 422

Response Header
Parámetros
HTTP status
Content-Type

Response Body
Parámetros de Salida
cod
msg
exc
errors

Ejemplo de Response
{
"cod": "422",
"msg": "Unprocessable Entity - Se presentaron errores de validacion que impidieron completar el Request",
"exc": null,
"errors": [
{
"success": false,
"codError": "1058",
"desError": "No hay información para el rango de periodo seleccionado debido a que ha superado el plazo
}
]
}

numRuc
fecAcceso
fecAcceso
numCorrelativo
numCorrelativo
indActividad
indActividad
IndSinCodigoUNSPC
IndSinCodigoUNSPC
DescripcionUNSPC
ObservacionItemExistencias
FORMATO DE ESPECIFICACION DE SERVICIO REST

S002-consultarExistencia
XXXXXXXX
YYYYYYYYY
Carga los datos para editar las existencias de la comunicacion, rectificatoria y fiscalización

Modelo Conceptual

consultarNoIncluidos
GET
http://sunatgvi.k8s.sunat.peru/v1/auditoria/tributaria/operativo/e/desmedro/{numRuc}/consultarExistencia
https://api.sunat.gob.pe/v1/auditoria/tributaria/operativo/desmedro/{numRuc}/consultarExistencia

SLA
Descripción
Tiempo de respuesta
disponibilidad

REQUEST

Descripcion
valor
application/json
application/json
número de ruc, recuperado del token (Solo para la URI Privada)
token obtenido de la autenticación (Solo para la URI Publica)
String - (Solo para la URI Privada)

Descripcion
RUC del contribuyente que registra la comunicación de destrucción de existencias por
desmedros
Fecha y hora en que se presenta la comunicacion

Indicador para saber si el registro temporal pertenece a una comunicacion, rectificatoria o


Fiscalización
-01 Comunicacion
-02 Rectificatoria
-03 Fiscalizacion

Número correlativo para poder identificar la existencia que se esta agregando


temporalmente.
Inicia en 1 hasta … n

RESPONSE

valor
200
application/json
Descripcion

Indicador para saber si el registro temporal pertenece a una comunicacion, rectificatoria o


Fiscalización
-01 Comunicacion
-02 Rectificatoria
-03 Fiscalizacion

Indicador que muestra si se ingresa una Descripcion en lugar del Codigo UNSPC
01 - Indica que se guardara el Código UNSPC
02 - Indica que no tiene Codigo UNSPC y se guardara una Descripción.

Código UNSPSC a 8 dígitos acompañado del nombre al que corresponde como bien a
destruir.
Descripción en lugar del Codigo UNSPC
Código de materia de destrucción de acuerdo al catálogo propio del contribuyente con una
longitud
Codigo delde motivo
hasta 24dedígitos.
destrucción
001 - Existencias vencidas
Descripcion del motivo de destrucción
002 - Existencias perecibles malogradas
Codigo de unidad no
003 - Existencias de aptas
medida segun
para el estandar
consumo
XXX
Cantidad de la exitencia a destruir
004 - Existencias en desuso
YYY
005 -
Costo Existencias depreciadas
ZZZ unitario de la exitencia a destruir
006 - Existencias
Costo computableen deproceso que anodestruir
la exitencia pueden tener uso en otro proceso
099 - Otros
Descripción de alguna observación que tenga el bien a destruir.

Desecho o desperdicio textil",

KKKK2222KKKK",

vencidas",

Descripcion
valor
Revisar la tabla de codigos de Error
application/json

Descripcion
codigo de error(Revisar la tabla de codigos de Error)
mensaje de error para el usuario
traza del error

una condicion inesperada que impidio completar el Request",


."

valor
Revisar la tabla de codigos de Error
application/json

Descripcion
codigo de error(Revisar la tabla de codigos de Error)
mensaje de error para el usuario
traza del error
array de errores y descripcion del error
aron errores de validacion que impidieron completar el Request",

el rango de periodo seleccionado debido a que ha superado el plazo de los 6 años, para poder visualizar dicha información deberá solicita

Cuadro de
No existe el campo o es vacío
No existe el campo o es vacío
Formato permitido: dd/mm/aaaa hh:mm:ss
Formato no permitido
No existe el campo o es vacío
Formato no permitido
No existe el campo o es vacío
No existe el campo o es vacío
Formato no permitido
solo si IndSinCodigoUNSPC ="02"
solo si costoUnitarioExistencia = 0
ICACION DE SERVICIO REST

uc}/consultarExistencia
ultarExistencia

Valor
5 Seg
24x7

REQUEST

Formato
Formato
alfanumérico

GMT-05
ISO DATE ('yyyy-mm-ddThh:mm:ss.000-05:00')
Alfanumérico

numerico

RESPONSE
Formato

Alfanumérico

alfanumérico

alfanumérico
alfanumérico
alfanumérico
alfanumérico
alfanumérico
alfanumérico
Numerico
Numerico
Numerico
alfanumérico

Tipo dato
Formato

Formato
zar dicha información deberá solicitarla a Administración Tributaria."

Cuadro de mensajes de Error


Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de forma
Validaciones de forma
Validaciones de obligatoriedad
Validaciones de forma
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de forma
solo si IndSinCodigoUNSPC ="02" Validacion de
obligatoriedad
solo si costoUnitarioExistencia = 0.00 validacion de
obligatoriedad
Tipo dato
Tipo dato
string

Date

String

int
Tipo dato
Object
String

string

string
string
string
string
string
string
decimal128
decimal128
decimal128
string
Tipo dato
String
String
String

Tipo dato
String
String
String
String
Tributaria."

r
42201 – El campo “numRuc” no enviado o es vacío
42202 – El campo “fecAcceso” no enviado o es vacío
42203 – Formato de "fecAcceso" no cumple con el formato “ dd/mm/aaaa hh:mm:ss”
42218 – El campo “numCorrelativo” debe estar conformado de un numero entero
42219 – El campo “numCorrelativo” no enviado o es vacío
42220 – El campo “indActividad” debe estar conformado por 2 digitos
42221 – El campo “indActividad” no enviado o es vacío
42245 – El campo “IndSinCodigoUNSPC” no enviado o es vacío
42246 – El campo “IndSinCodigoUNSPC” debe estar conformado por 2 digitos
42247 – El campo “DescripcionUNSPC” no enviado o es vacío
42248 – El campo “ObservacionItemExistencias” no enviado o es vacío
42201
42202
42203
42218
42219
42220
42221

42245
42246
42247
42248
ID. Servicio
Dominio
Recurso
Descripción del Recurso/tarea

Modelo Conce

Operación
Método HTTP
URI privada
URI pública

SLA
Propiedad
tiempoRes
disponibilidad

Request URI
Parámetros de   Entrada
Request Header
Parámetros
Content-Type
Accept
numRuc
Bearer
codUsuario

Request Body
Parámetros de   Entrada
numRuc

fecAcceso

indActividad

numCorrelativo

IndSinCodigoUNSPC

codExistenciaUNSPC

DescripcionUNSPC
codCatalogPropio

codMotivoDestruccion

desMotivoDestruccion
codUnidadMedida
cantExistencia
costoUnitarioExistencia
costoComputableExistencia
ObservacionItemExistencias

Ejemplo Request

JSON en el body
{
"numRUC": "20100070970",
"fecAcceso": "2021-06-12T00:00:00Z",
"indActividad": "01",
"numCorrelativo": 2,
"IndSinCodigoUNSPC":"01",
"codExistenciaUNSPC": "11141601 - Desecho o desperdicio textil",
"DescripcionUNSPC":"",
"codCatalogPropio": "5555HHHH3333KKKK2222KKKK",
"codMotivoDestruccion": "001",
"desMotivoDestruccion": "Existencias vencidas",
"codUnidadMedida": "MMM",
"cantExistencia": 2.45,
"costoUnitarioExistencia": 10,
"costoComputableExistencia": 24.5,
"ObservacionItemExistencias":""
}

Response Header
Parámetros
HTTP status
Content-Type

Response Body
Parámetros de Salida
paginacion

Ejemplo JSON Response Body

ANEXO Datos Complejos


Lista de Pasajeros
Propiedad
Formato de mensaje de ERROR 500

Response Header
Parámetros
HTTP status
Content-Type

Response Body
Parámetros de Salida
cod
msg
exc

Ejemplo de Response

{
"cod":"500",
"msg":"Internal Server Error - Se presento una condicion inesperada que impidio completar el Request",
"exc":"java.lang.NullPointerException at ..."
}

Formato de mensaje de ERROR 422

Response Header
Parámetros
HTTP status
Content-Type

Response Body
Parámetros de Salida
cod
msg
exc
errors

Ejemplo de Response
{
"cod": "422",
"msg": "Unprocessable Entity - Se presentaron errores de validacion que impidieron completar el Request",
"exc": null,
"errors": [
{
"success": false,
"codError": "1058",
"desError": "No hay información para el rango de periodo seleccionado debido a que ha superado el plazo
}
]
}

numRuc
fecAcceso
fecAcceso
codExistenciaUNSPC
codCatalogPropio
codCatalogPropio
codMotivoDestruccion
codMotivoDestruccion
desMotivoDestruccion
codUnidadMedida
codUnidadMedida
cantExistencia
cantExistencia
costoUnitarioExistencia
costoUnitarioExistencia
costoComputableExistencia
costoComputableExistencia
numCorrelativo
numCorrelativo
indActividad
indActividad
IndSinCodigoUNSPC
IndSinCodigoUNSPC

DescripcionUNSPC

ObservacionItemExistencias
FORMATO DE ESPECIFICACION DE SERVICIO REST

S003-actualizarExistencia
XXXXXXXX
YYYYYYYYY
Actualiza la existencia para la comunicacion, rectificatoria y fiscalización

Modelo Conceptual

consultarNoIncluidos
GET
http://sunatgvi.k8s.sunat.peru/v1/auditoria/tributaria/operativo/e/desmedro/{numRuc}/actualizarExistencia
https://api.sunat.gob.pe/v1/auditoria/tributaria/operativo/desmedro/{numRuc}/actualizarExistencia

SLA
Descripción
Tiempo de respuesta
disponibilidad

REQUEST

Descripcion
valor
application/json
application/json
número de ruc, recuperado del token (Solo para la URI Privada)
token obtenido de la autenticación (Solo para la URI Publica)
String - (Solo para la URI Privada)

Descripcion
RUC del contribuyente que registra la comunicación de destrucción de existencias por
desmedros
Fecha y hora en que se presenta la comunicacion

Indicador para saber si el registro temporal pertenece a una comunicacion, rectificatoria o


Fiscalización
-01 Comunicacion
-02 Rectificatoria
-03 Fiscalizacion

Número correlativo para poder identificar la existencia que se esta agregando


temporalmente.
Inicia en 1 hasta … n
Indicador que muestra si se ingresa una Descripcion en lugar del Codigo UNSPC
01 - Indica que se guardara el Código UNSPC
02 - Indica que no tiene Codigo UNSPC y se guardara una Descripción.

Código UNSPSC a 8 dígitos acompañado del nombre al que corresponde como bien a
destruir.
Descripción en lugar del Codigo UNSPC
Código de materia de destrucción de acuerdo al catálogo propio del contribuyente con una
longitud de hasta 24 dígitos.
Codigo del motivo de destrucción
001 - Existencias vencidas
002 - Existencias perecibles malogradas
003 - Existencias no aptas para consumo
004 - Existencias en desuso
005 - Existencias depreciadas
006 - Existencias en proceso que no pueden tener uso en otro proceso
099 - Otros

Descripcion del motivo de destrucción


Codigo de unidad de medida segun el estandar
XXX
YYY
ZZZ
Cantidad de la exitencia a destruir
Costo unitario de la exitencia a destruir
Costo computable de la exitencia a destruir
Descripción de alguna observación que tenga el bien a destruir.

cho o desperdicio textil",

K2222KKKK",

cidas",

RESPONSE

valor
200
application/json

Descripcion

Descripcion
valor
Revisar la tabla de codigos de Error
application/json

Descripcion
codigo de error(Revisar la tabla de codigos de Error)
mensaje de error para el usuario
traza del error

una condicion inesperada que impidio completar el Request",


."

valor
Revisar la tabla de codigos de Error
application/json

Descripcion
codigo de error(Revisar la tabla de codigos de Error)
mensaje de error para el usuario
traza del error
array de errores y descripcion del error
aron errores de validacion que impidieron completar el Request",

el rango de periodo seleccionado debido a que ha superado el plazo de los 6 años, para poder visualizar dicha información deberá solicita

Cuadro de
No existe el campo o es vacío
No existe el campo o es vacío
Formato permitido: dd/mm/aaaa hh:mm:ss
No existe el campo o es vacío
No existe el campo o es vacío
Formato no permitido
No existe el campo o es vacío
Formato no permitido
No existe el campo o es vacío
Formato no permitido
No existe el campo o es vacío
Formato no permitido
No existe el campo o es vacío
Formato no permitido
No existe el campo o es vacío
Formato no permitido
No existe el campo o es vacío
Formato no permitido
No existe el campo o es vacío
Formato no permitido
No existe el campo o es vacío
No existe el campo o es vacío
Formato no permitido

solo si IndSinCodigoUNSPC ="02"

solo si costoUnitarioExistencia = 0
ICACION DE SERVICIO REST

uc}/actualizarExistencia
alizarExistencia

Valor
5 Seg
24x7

REQUEST

Formato
Formato
alfanumérico

GMT-05
ISO DATE ('yyyy-mm-ddThh:mm:ss.000-05:00')
Alfanumérico

numerico

alfanumérico

alfanumérico

alfanumérico
alfanumérico

alfanumérico

alfanumérico
alfanumérico
Numerico
Numerico
Numerico
alfanumérico

RESPONSE

Formato

Tipo dato
Formato

Formato
zar dicha información deberá solicitarla a Administración Tributaria."

Cuadro de mensajes de Error


Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de forma
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de forma
Validaciones de obligatoriedad
Validaciones de forma
Validaciones de obligatoriedad
Validaciones de forma
Validaciones de obligatoriedad
Validaciones de forma
Validaciones de obligatoriedad
Validaciones de forma
Validaciones de obligatoriedad
Validaciones de forma
Validaciones de obligatoriedad
Validaciones de forma
Validaciones de obligatoriedad
Validaciones de forma
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de forma
solo si IndSinCodigoUNSPC ="02" Validacion de
obligatoriedad

solo si costoUnitarioExistencia = 0.00 validacion de


obligatoriedad
Tipo dato
Tipo dato
string

Date

String

int

string

string

string
string

string

string
string
decimal128
decimal128
decimal128
string

Tipo dato
Object
Tipo dato
String
String
String

Tipo dato
String
String
String
String
Tributaria."

r
42201 – El campo “numRuc” no enviado o es vacío
42202 – El campo “fecAcceso” no enviado o es vacío
42203 – Formato de "fecAcceso" no cumple con el formato “ dd/mm/aaaa hh:mm:ss”
42204 – El campo “codExistenciaUNSPC” no enviado o es vacío
42205 – El campo “codCatalogPropio” no enviado o es vacío
42206 – El campo “codCatalogPropio” debe estar conformado de 24 digitos sin espacios pero si
acepta
42207 –guion
El campo “codMotivoDestruccion” no enviado o es vacío
42208 – El campo “codMotivoDestruccion” debe estar conformado de 3 digitos
42209 – El campo “desMotivoDestruccion” no enviado o es vacío
42210 – El campo “codUnidadMedida” debe estar conformado de 3 digitos
42211 – El campo “codUnidadMedida” no enviado o es vacío
42212 – El campo “cantExistencia” debe estar conformado de un numero decimal
42213 – El campo “cantExistencia” no enviado o es vacío
42214 – El campo “costoUnitarioExistencia” debe estar conformado de un numero decimal
42215 – El campo “costoUnitarioExistencia” no enviado o es vacío
42216 – El campo “costoComputableExistencia” debe estar conformado de un numero decimal
42217 – El campo “costoComputableExistencia” no enviado o es vacío
42218 – El campo “numCorrelativo” debe estar conformado de un numero entero
42219 – El campo “numCorrelativo” no enviado o es vacío
42243 – El campo “indActividad” debe estar conformado por 2 digitos
42244 – El campo “indActividad” no enviado o es vacío
42245 – El campo “IndSinCodigoUNSPC” no enviado o es vacío
42246 – El campo “IndSinCodigoUNSPC” debe estar conformado por 2 digitos
42247 – El campo “DescripcionUNSPC” no enviado o es vacío

42248 – El campo “ObservacionItemExistencias” no enviado o es vacío


42201
42202
42203
42204
42205
42206
42207
42208
42209
42210
42211
42212
42213
42214
42215
42216
42217
42218
42219

42243
42244
42245
42246

42247

42248
ID. Servicio
Dominio
Recurso
Descripción del Recurso/tarea

Modelo Conce

Operación
Método HTTP
URI privada
URI pública

SLA
Propiedad
tiempoRes
disponibilidad

Request URI
Parámetros de   Entrada
Request Header
Parámetros
Content-Type
Accept
numRuc
Bearer
codUsuario

Request Body
Parámetros de   Entrada
numRuc

fecAcceso

indActividad

numCorrelativo

Ejemplo Request

JSON en el body
{
"numRUC": "20100070970",
"fecAcceso": "2021-06-12T00:00:00Z",
"indActividad": "01",
"numCorrelativo": 2
}

Response Header
Parámetros
HTTP status
Content-Type
Response Body
Parámetros de Salida
paginacion

Ejemplo JSON Response Body

ANEXO Datos Complejos


Lista de Pasajeros
Propiedad

Formato de mensaje de ERROR 500

Response Header
Parámetros
HTTP status
Content-Type

Response Body
Parámetros de Salida
cod
msg
exc

Ejemplo de Response

{
"cod":"500",
"msg":"Internal Server Error - Se presento una condicion inesperada que impidio completar el Request",
"exc":"java.lang.NullPointerException at ..."
}

Formato de mensaje de ERROR 422


Response Header
Parámetros
HTTP status
Content-Type

Response Body
Parámetros de Salida
cod
msg
exc
errors

Ejemplo de Response
{
"cod": "422",
"msg": "Unprocessable Entity - Se presentaron errores de validacion que impidieron completar el Request",
"exc": null,
"errors": [
{
"success": false,
"codError": "1058",
"desError": "No hay información para el rango de periodo seleccionado debido a que ha superado el plazo
}
]
}

numRuc
fecAcceso
fecAcceso
numCorrelativo
numCorrelativo
indActividad
indActividad
FORMATO DE ESPECIFICACION DE SERVICIO REST

S004-eliminarExistencia
XXXXXXXX
YYYYYYYYY
Elimina existencias para la comunicacion, rectificatoria y fiscalización

Modelo Conceptual

consultarNoIncluidos
GET
http://sunatgvi.k8s.sunat.peru/v1/auditoria/tributaria/operativo/e/desmedro/{numRuc}/eliminarExistencia
https://api.sunat.gob.pe/v1/auditoria/tributaria/operativo/desmedro/{numRuc}/eliminarExistencia

SLA
Descripción
Tiempo de respuesta
disponibilidad

REQUEST

Descripcion
valor
application/json
application/json
número de ruc, recuperado del token (Solo para la URI Privada)
token obtenido de la autenticación (Solo para la URI Publica)
String - (Solo para la URI Privada)

Descripcion
RUC del contribuyente que registra la comunicación de destrucción de existencias por
desmedros
Fecha y hora en que se presenta la comunicacion

Indicador para saber si el registro temporal pertenece a una comunicacion, rectificatoria o


Fiscalización
-01 Comunicacion
-02 Rectificatoria
-03 Fiscalizacion

Número correlativo para poder identificar la existencia que se esta agregando


temporalmente.
Inicia en 1 hasta … n

RESPONSE

valor
200
application/json
Descripcion

Descripcion

valor
Revisar la tabla de codigos de Error
application/json

Descripcion
codigo de error(Revisar la tabla de codigos de Error)
mensaje de error para el usuario
traza del error

una condicion inesperada que impidio completar el Request",


."
valor
Revisar la tabla de codigos de Error
application/json

Descripcion
codigo de error(Revisar la tabla de codigos de Error)
mensaje de error para el usuario
traza del error
array de errores y descripcion del error

aron errores de validacion que impidieron completar el Request",

el rango de periodo seleccionado debido a que ha superado el plazo de los 6 años, para poder visualizar dicha información deberá solicita

Cuadro de
No existe el campo o es vacío
No existe el campo o es vacío
Formato permitido: dd/mm/aaaa hh:mm:ss
Formato no permitido
No existe el campo o es vacío
Formato no permitido
No existe el campo o es vacío
ICACION DE SERVICIO REST

uc}/eliminarExistencia
narExistencia

Valor
5 Seg
24x7

REQUEST

Formato
Formato
alfanumérico

GMT-05
ISO DATE ('yyyy-mm-ddThh:mm:ss.000-05:00')
Alfanumérico

numerico

RESPONSE
Formato

Tipo dato

Formato
Formato

zar dicha información deberá solicitarla a Administración Tributaria."

Cuadro de mensajes de Error


Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de forma
Validaciones de forma
Validaciones de obligatoriedad
Validaciones de forma
Validaciones de obligatoriedad
Tipo dato
Tipo dato
string

Date

String

int
Tipo dato
Object

Tipo dato
String
String
String
Tipo dato
String
String
String
String

Tributaria."

r
42201 – El campo “numRuc” no enviado o es vacío
42202 – El campo “fecAcceso” no enviado o es vacío
42203 – Formato de "fecAcceso" no cumple con el formato “ dd/mm/aaaa hh:mm:ss”
42218 – El campo “numCorrelativo” debe estar conformado de un numero entero
42219 – El campo “numCorrelativo” no enviado o es vacío
42220 – El campo “indActividad” debe estar conformado por 2 digitos
42221 – El campo “indActividad” no enviado o es vacío
42201
42202
42203
42218
42219
42220
42221
FORMATO DE ESPECIFICACION DE SERVICIO REST

ID Servicio Candidato S005_1-CargaArchivoMasivoPlano


Dominio del servicio XXXXXXXX
Recurso YYYYYYYYY
Descripción del Recurso Permite Importar un archivo Plano ".txt"
Modelo Conceptual

Operación CargaArchivoMasivo
Descripción Permite cargar el archivo plano ".txt" con la ruta de archivoAdjunto
Método HTTP POST
URI PRIVADA http://sunattributos.k8s.sunat.peru/v1/auditoria/tributaria/analisis/e/desmedro
URI PÚBLICA https://sunattributos.k8s.sunat.peru/v1/auditoria/tributaria/analisis/e/desmed
SLA de Operación
Propiedad Descripción
numPeticiones Número de peticiones concurrentes
tiempoRespuesta Tiempo de respuesta
disponibilidad Disponibilidad del servicio

REQUEST

REQUEST URI
Parámetros de Entrada Descripcion Formato
numRuc Ruc del contribuyente alfanumérico
NomArchivoImportacion Ruta y nombre del archivo a Importar alfanumérico
REQUEST HEADER
Parámetro Valor
Content-Type application/json
Accept application/json
NumRuc Número de ruc, recuperado del token (Solo para la URL Privada)
Bearer Token obtenido de la autenticación (Solo para la URL Publica)
codUsuario String - (Solo para la URI Privada)
REQUEST BODY
Parámetros de Entrada Descripcion Formato
NumRuc Número de RUC del Contribuyente alfanumérico
arcContenido Archivo Contenido Binario
nomArchivoImportacion Nombre del archivo utilizado para la Importacion alfanumérico
EJEMPLO DE REQUEST
JSON en el body 1
"CodTpArchivo":
}
RESPONSE

RESPONSE HEADER
Parámetro Valor
HTTP status 200
Content-Type application/json
RESPONSE BODY
Parámetros de Salida Descripción Formato

Ejemplo JSON Response Body

Especificación de los mensajes de error para el Servicio REST

Formato de mensaje de ERROR

RESPONSE HEADER
Parámetro Valor
HTTP status Revisar la tabla de códigos de Error
Content-Type application/json

RESPONSE BODY
Parámetros de Entrada Descripción Formato
- - -

Estructura mensajes de error para validaciones


-

Cuadro de mensajes de Error


HTTP/1.1 401
Content-Type:
HTTP/1.1 500 application/json
HTTP/1.1 422 application/json
Content-Type:
Content-Type: application/json

Cuadro de mensajes de Error


numRuc El campo “numRuc” no Validaciones de 42201 - El campo “numRuc” no enviado o es vac
arcContenidoenviado
No existeo el
escampo
vacío o es obligatoriedad
Validaciones de obligatoried 42222 - No existe el campo o es vacío
arcContenidovacío
La cantidad de registros Validaciones de negocio 42223 - La cantidad de registros contenidos en e
nomArchivoImcontenidos
nombre del en el archivo
archivo no a Validaciones de archivo
42224 - anombre
importar
delnoarchivo
debe pasar de 300o registro
no enviado es vacio
nomArchivoImenviado o es vacio. obligatoriedad
El nombre del Archivo sólo Validaciones de 42225 - El nombre del Archivo sólo puede conten
nomArchivoImpuede
No contener
se debe datos
enviar un obligatoriedadde
Validaciones datos
42226alfanumericos.
- No se debe enviar un archivo duplicado c
nomArchivoImarchivo duplicado con
Extensión del archivo delel obligatoriedad
Validaciones de el mismo
42227 nombre. del archivo del nombre del
- Extensión
nombre del archivo plano es obligatoriedad archivo plano es diferente a ".TXT".
CIO REST

a de archivoAdjunto

toria/tributaria/analisis/e/desmedros/{numRuc}/importarexistencia?nomArchivoImportacion={nomArchivoImportacion}
ditoria/tributaria/analisis/e/desmedros/{numRuc}/importarexistencia?nomArchivoImportacion={nomArchivoImportacion}

Valor
40xs
2s
24x7

rmato Tipo de dato


anumérico String
anumérico String

rmato Descripción
anumérico String
nario Binary
anumérico string
rmato Tipo Dato

Servicio REST

rmato Tipo Dato


-

aciones

po “numRuc” no enviado o es vacío 42201


te el campo o es vacío 42222
idad de registros contenidos en el 42223
tar
delnoarchivo
debe pasar de 300o registros.
no enviado es vacio. 42224
bre del Archivo sólo puede contener 42225
ricos.enviar un archivo duplicado con
debe 42226
re.
ón del archivo del nombre del 42227
s diferente a ".TXT".
FORMATO DE ESPECIFICACION DE SERVICIO REST

ID Servicio Candidato S005_2-CargaArchivoMasivoExcel


Dominio del servicio XXXXXXXX
Recurso YYYYYYYYY
Descripción del Recurso Permite Importar un archivo Excel ".xls" ó "xlsx"
Modelo Conceptual

Operación CargaArchivoMasivoExcel
Descripción Permite cargar el archivo Excel ".xls" or ".xlsx" con la ruta de archivoA
Método HTTP POST
URI PRIVADA http://sunattributos.k8s.sunat.peru/v1/auditoria/tributaria/analisi
URI PÚBLICA https://sunattributos.k8s.sunat.peru/v1/auditoria/tributaria/analis
SLA de Operación
Propiedad Descripción
numPeticiones Número de peticiones concurrentes
tiempoRespuesta Tiempo de respuesta
disponibilidad Disponibilidad del servicio

REQUEST

REQUEST URI
Parámetros de Entrada Descripcion
numRuc Ruc del contribuyente
NomArchivoImportacion Ruta y nombre del archivo a Importar
REQUEST HEADER
Parámetro Valor
Content-Type application/json
Accept application/json
NumRuc Número de ruc, recuperado del token (Solo para la URL Privada)
Bearer Token obtenido de la autenticación (Solo para la URL Publica)
codUsuario String - (Solo para la URI Privada)
REQUEST BODY
Parámetros de Entrada Descripcion
NumRuc Número de RUC del Contribuyente
arcContenido Archivo Contenido
nomArchivoImportacion Nombre del archivo utilizado para la Importacion
EJEMPLO1 DE REQUEST
JSON en el body 2
"CodTpArchivo":
}
EJEMPLO2 DE REQUEST
JSON en el body
"CodTpArchivo": 3
}
RESPONSE

RESPONSE HEADER
Parámetro Valor
HTTP status 200
Content-Type application/json
RESPONSE BODY
Parámetros de Salida Descripción

Ejemplo JSON Response Body

Especificación de los mensajes de error para el Servicio REST

Formato de mensaje de ERROR

RESPONSE HEADER
Parámetro Valor
HTTP status Revisar la tabla de códigos de Error
Content-Type application/json

RESPONSE BODY
Parámetros de Entrada Descripción
- -

Estructura mensajes de error para validaciones


-

Cuadro de mensajes de Error


HTTP/1.1 401
Content-Type:
HTTP/1.1 500 application/json
HTTP/1.1 422 application/json
Content-Type:
Content-Type: application/json

Cuadro de mensajes de Error


numRuc El campo “numRuc” no 42201 - El campo “numRuc” no
Validaciones de obligatoriedad
arcContenido enviado
No existeo el
escampo
vacío o es 42222 - No existe el campo o e
Validaciones de obligatoriedad
arcContenido vacío
La cantidad de registros Validaciones de negocio 42223 - La cantidad de registro
nomArchivoImportacion contenidos
nombre del en el archivo
archivo no a archivo
42224 - anombre
Validaciones de obligatoriedad importar
delnoarchivo
debe pasa
no
nomArchivoImportacion enviado
El nombreo es
delvacio.
Archivo sólo 42225 - El nombre del Archivo s
Validaciones de obligatoriedad
nomArchivoImportacion puede contener
No se debe enviar datos
un datos alfanumericos.
42226
Validaciones de obligatoriedad - No se debe enviar un a
nomArchivoImportacion archivo duplicado con
Extensión del archivo delel el
Validaciones de obligatoriedadmismo nombre. del archivo d
42228 - Extensión
nombre del archivo plano es archivo plano es diferente a ".xl
ERVICIO REST

cel

".xls" ó "xlsx"

or ".xlsx" con la ruta de archivoAdjunto

/v1/auditoria/tributaria/analisis/e/desmedros/{numRuc}/importarexistencia?nomArchivoImportacion={nomArchivoImportacion}
u/v1/auditoria/tributaria/analisis/e/desmedros/{numRuc}/importarexistencia?nomArchivoImportacion={nomArchivoImportacion}

Valor
40xs
2s
24x7

Formato Tipo de dato


alfanumérico String
alfanumérico String

Privada)
blica)

Formato Descripción
alfanumérico String
Binario Binary
alfanumérico string
Formato Tipo Dato

ody

ra el Servicio REST

ROR

Formato Tipo Dato


- -

validaciones

ror

rror
201 - El campo “numRuc” no enviado o es vacío 42201
222 - No existe el campo o es vacío 42222
223 - La cantidad de registros contenidos en el 42223
chivo
224 - anombre
importar
delnoarchivo
debe pasar de 300o registros.
no enviado es vacio. 42224
225 - El nombre del Archivo sólo puede contener 42225
tos alfanumericos.
226 - No se debe enviar un archivo duplicado con 42226
mismo nombre. del archivo del nombre del
228 - Extensión 42228
chivo plano es diferente a ".xls" o ".xlsx".
FORMATO DE ESPECIFICACION DE SERVICIO REST

ID Servicio Candidato S005_3-ValidaArchivoMasivoPlano


Dominio del servicio XXXXXXXX
Recurso YYYYYYYYY
Descripción del Recurso Permite Validar un archivo Plano ".txt"
Modelo Conceptual

Operación ValidaArchivoMasivo
Descripción Permite cargar el archivo ".txt" con la ruta de archivoAdjunto
Método HTTP POST
URI PRIVADA http://sunattributos.k8s.sunat.peru/v1/auditoria/tributaria/analisis/e/desmedro
URI PÚBLICA http://sunattributos.k8s.sunat.peru/v1/auditoria/tributaria/analisis/desmedros

SLA de Operación
Propiedad Descripción
numPeticiones Número de peticiones concurrentes
tiempoRespuesta Tiempo de respuesta
disponibilidad Disponibilidad del servicio

REQUEST

REQUEST URI
Parámetros de Entrada Descripcion Formato
numRuc Ruc del contribuyente alfanumérico
NomArchivoImportacion Ruta y nombre del archivo a Importar alfanumérico
REQUEST HEADER
Parámetro Valor
Content-Type application/json
Accept application/json
NumRuc Número de ruc, recuperado del token (Solo para la URL Privada)
Bearer Token obtenido de la autenticación (Solo para la URL Publica)
codUsuario String - (Solo para la URI Privada)
REQUEST BODY
Parámetros de Entrada Descripcion Formato
NumRuc Número de RUC del Contribuyente alfanumérico
arcContenido Archivo Contenido Binario
nomArchivoImportacion Nombre del archivo utilizado para la Importacion alfanumérico
EJEMPLO DE REQUEST
JSON en el body 3
"CodTpArchivo":
}

RESPONSE
RESPONSE HEADER
Parámetro Valor
HTTP status 200
Content-Type application/json
RESPONSE BODY
Parámetros de Salida Descripción Formato

Ejemplo JSON Response Body

Especificación de los mensajes de error para el Servicio REST

Formato de mensaje de ERROR

RESPONSE HEADER
Parámetro Valor
HTTP status Revisar la tabla de códigos de Error
Content-Type application/json

RESPONSE BODY
Parámetros de Entrada Descripción Formato
- - -

Estructura mensajes de error para validaciones


-

Cuadro de mensajes de Error


HTTP/1.1 401
Content-Type:
HTTP/1.1 500 application/json
Content-Type:
HTTP/1.1 422 application/json
Content-Type: application/json

Cuadro de mensajes de Error


posicion del El Código producto de Validaciones de 42228 - El Código producto de SUNAT no es váli
1 al 8 SUNAT no es válido obligatoriedad
posicion del Debe consignar Validaciones de 42229 - Debe consignar obligatoriamente Codigo
1 al 8 obligatoriamente Codigo de obligatoriedad producto SUNAT
posicion del producto
El CodigoSUNAT
de producto Validaciones de 42229 - El Codigo de producto SUNAT UNSPSC
1 al 8 SUNAT UNSPSC debe obligatoriedad debe tener una longuitud de 8 posiciones
posicion del tener una
El dato longuitud
ingresado de 8
como Validaciones de 42230 - El dato ingresado como codigo de produ
10 al 33 codigo de producto no obligatoriedad no cumple con el formato establecido.
posicion del cumple
Es con el indicar
obligatorio formatoel Validaciones de 42231 - Es obligatorio indicar el motivo de la
35 al 38 motivo de la destrucción del obligatoriedad destrucción del ítem
posicion del ítem
El motivo de la destrucción Validaciones de 42232 - El motivo de la destrucción no es válido
35 al 38 no es válido obligatoriedad
posicion del Es obligatorio indicar la Validaciones de 42233 - Es obligatorio indicar la unidad de medid
39 al 42 unidad de medida del ítem obligatoriedad del ítem
posicion del El dato ingresado como Validaciones de 42234 - El dato ingresado como unidad de medid
39 al 42 unidad de medida no obligatoriedad no corresponde al valor esperado
posicion del corresponde al valor
El dato ingresado como Validaciones de 42235 - El dato ingresado como unidad de medid
39 al 42 unidad de medida no puede obligatoriedad no puede ser mayor a 3 posiciones.
posicion del ser
No semayor a 3cantidad
incluyó posiciones.
en el Validaciones de 42236 - No se incluyó cantidad en el detalle de lo
43 al 66 detalle de los Items o es obligatoriedad Items o es cero (0)
posicion del cero (0)
El dato ingresado no cumple Validaciones de 42237 - El dato ingresado no cumple con el
43 al 66 con el estandar obligatoriedad estandar
posicion del La dato ingresado como Validaciones de 42238 - La dato ingresado como cantidad no pue
43 al 66 cantidad no puede ser obligatoriedad ser Alfanumérico
posicion del Alfanumérico
No se consignó dato Validaciones de 42239 - No se consignó dato
67 al 90 obligatoriedad
posicion del El dato ingresado como Validaciones de 42240 - El dato ingresado como costo unitario po
67 al 90 costo unitario por item no obligatoriedad item no cumple con el formato establecido
posicion del cumple
La dato con el formato
ingresado como Validaciones de 42241 - La dato ingresado como costo unitario n
67 al 90 costo unitario no puede ser obligatoriedad puede ser Alfanumérico
posicion del Alfanumérico
El costo computable por Validaciones de 42242 - El costo computable por item resultado d
67 al 90 item resultado de la obligatoriedad la Cantidad
Cantidad
CIO REST

rchivoAdjunto

toria/tributaria/analisis/e/desmedros/{numRuc}/ValidaPlano?nomArchivoImportacion={nomArchivoImportacion}
toria/tributaria/analisis/desmedros/{numRuc}/ValidaPlano?nomArchivoImportacion={nomArchivoImportacion}

Valor
40xs
2s
24x7

rmato Tipo de dato


anumérico String
anumérico String

rmato Descripción
anumérico String
nario Binary
anumérico string
rmato Tipo Dato

Servicio REST

rmato Tipo Dato


-

aciones

go producto de SUNAT no es válido 42228

onsignar obligatoriamente Codigo de 42229


T
go de producto SUNAT UNSPSC 42229
longuitud de 8 posiciones
ingresado como codigo de producto 42230
el formato establecido.
gatorio indicar el motivo de la 42231
ítem
vo de la destrucción no es válido 42232
gatorio indicar la unidad de medida 42233

ingresado como unidad de medida 42234


al valor esperado
ingresado como unidad de medida 42235
mayor a 3 posiciones.
ncluyó cantidad en el detalle de los 42236
(0)
ingresado no cumple con el 42237

ingresado como cantidad no puede 42238


o
onsignó dato 42239

ingresado como costo unitario por 42240


con el formato establecido
ingresado como costo unitario no 42241
umérico
o computable por item resultado de 42242
FORMATO DE ESPECIFICACION DE SERVICIO REST

ID Servicio Candidato S005_4-ValidaArchivoMasivoExcel


Dominio del servicio XXXXXXXX
Recurso YYYYYYYYY
Descripción del Recurso Permite Validar un archivo Excel ".xls" o ".xlsx"
Modelo Conceptual

Operación ValidaArchivoMasivo
Descripción Permite cargar el archivo ".xls" or ".xlsx" con la ruta de archivoAdjunto
Método HTTP POST
URI PRIVADA http://sunattributos.k8s.sunat.peru/v1/auditoria/tributaria/analisis/e/desmedro
URI PÚBLICA http://sunattributos.k8s.sunat.peru/v1/auditoria/tributaria/analisis/desmedros

SLA de Operación
Propiedad Descripción
numPeticiones Número de peticiones concurrentes
tiempoRespuesta Tiempo de respuesta
disponibilidad Disponibilidad del servicio

REQUEST

REQUEST URI
Parámetros de Entrada Descripcion Formato
numRuc Ruc del contribuyente alfanumérico
NomArchivoImportacion Ruta y nombre del archivo a Importar alfanumérico
REQUEST HEADER
Parámetro Valor
Content-Type application/json
Accept application/json
NumRuc Número de ruc, recuperado del token (Solo para la URL Privada)
Bearer Token obtenido de la autenticación (Solo para la URL Publica)
codUsuario String - (Solo para la URI Privada)
REQUEST BODY
Parámetros de Entrada Descripcion Formato
NumRuc Número de RUC del Contribuyente alfanumérico
arcContenido Archivo Contenido Binario
nomArchivoImportacion Nombre del archivo utilizado para la Importacion alfanumérico
EJEMPLO DE REQUEST
JSON en el body 3
"CodTpArchivo":
}

RESPONSE
RESPONSE HEADER
Parámetro Valor
HTTP status 200
Content-Type application/json
RESPONSE BODY
Parámetros de Salida Descripción Formato

Ejemplo JSON Response Body

Especificación de los mensajes de error para el Servicio REST

Formato de mensaje de ERROR

RESPONSE HEADER
Parámetro Valor
HTTP status Revisar la tabla de códigos de Error
Content-Type application/json

RESPONSE BODY
Parámetros de Entrada Descripción Formato
- - -

Estructura mensajes de error para validaciones


-

Cuadro de mensajes de Error


HTTP/1.1 401
Content-Type:
HTTP/1.1 500 application/json
Content-Type:
HTTP/1.1 422 application/json
Content-Type: application/json

Cuadro de mensajes de Error


A1 El Código producto de Validaciones de 42228 - El Código producto de SUNAT no es váli
A1 SUNAT
Debe no es válido
consignar obligatoriedadde
Validaciones 42229 - Debe consignar obligatoriamente Codigo
A1 obligatoriamente Codigo de obligatoriedad
El Codigo de producto Validaciones de producto
42229 - ElSUNAT
Codigo de producto SUNAT UNSPSC
B1 SUNAT
El UNSPSC como
dato ingresado debe obligatoriedadde
Validaciones debe tener una longuitud
42230 - El dato ingresadode 8 posiciones
como codigo de produ
C1 codigo de producto no
Es obligatorio indicar el obligatoriedad
Validaciones de no cumple
42231 - Es con el formato
obligatorio establecido.
indicar el motivo de la
C1 motivo de de
El motivo la destrucción del obligatoriedad
la destrucción Validaciones de destrucción del ítem
42232 - El motivo de la destrucción no es válido
D1 no es válido
Es obligatorio indicar la obligatoriedad
Validaciones de 42233 - Es obligatorio indicar la unidad de medid
D1 unidad
El dato de medida como
ingresado del ítem obligatoriedad
Validaciones de del ítem
42234 - El dato ingresado como unidad de medid
D1 unidad de medida no
El dato ingresado como obligatoriedad
Validaciones de no corresponde
42235 al valor esperado
- El dato ingresado como unidad de medid
E1 unidad de medida no puede obligatoriedad
No se incluyó cantidad en el Validaciones de no puede
42236 - Noser
se mayor
incluyóacantidad
3 posiciones.
en el detalle de lo
E1 detalle
El dato de los Items
ingresado noocumple
es obligatoriedadde
Validaciones Items o es cero (0)
42237 - El dato ingresado no cumple con el
con el estandar obligatoriedad estandar
E1 La dato ingresado como Validaciones de 42238 - La dato ingresado como cantidad no pue
F1 cantidad no puede
No se consignó datoser obligatoriedad
Validaciones de ser Alfanumérico
42239 - No se consignó dato
F1 El dato ingresado como obligatoriedad
Validaciones de 42240 - El dato ingresado como costo unitario po
F1 costo unitario
La dato por item
ingresado comono obligatoriedad
Validaciones de item no- cumple
42241 La dato con el formato
ingresado comoestablecido
costo unitario n
F1 costo unitario
El costo no puede
computable por ser obligatoriedad
Validaciones de puede ser Alfanumérico
42242 - El costo computable por item resultado d
item resultado de la obligatoriedad la Cantidad
CIO REST

xlsx"

ruta de archivoAdjunto

toria/tributaria/analisis/e/desmedros/{numRuc}/ValidaExcel?nomArchivoImportacion={nomArchivoImportacion}
toria/tributaria/analisis/desmedros/{numRuc}/ValidaExcel?nomArchivoImportacion={nomArchivoImportacion}

Valor
40xs
2s
24x7

rmato Tipo de dato


anumérico String
anumérico String

rmato Descripción
anumérico String
nario Binary
anumérico string
rmato Tipo Dato

Servicio REST

rmato Tipo Dato


-

aciones

go producto de SUNAT no es válido 42228


onsignar obligatoriamente Codigo de 42229
To de producto SUNAT UNSPSC
g 42229
longuitud
ingresadode 8 posiciones
como codigo de producto 42230
el formato
gatorio establecido.
indicar el motivo de la 42231
ítem
vo de la destrucción no es válido 42232
gatorio indicar la unidad de medida 42233
ingresado como unidad de medida 42234
al valor esperado
ingresado como unidad de medida 42235
mayor
ncluyóacantidad
3 posiciones.
en el detalle de los 42236
(0)
ingresado no cumple con el 42237
ingresado como cantidad no puede 42238
oonsignó dato 42239
ingresado como costo unitario por 42240
con el formato
ingresado comoestablecido
costo unitario no 42241
umérico
o computable por item resultado de 42242
FORMATO DE ESPECIFICACION DE SERVICIO

ID. Servicio S005_5-reporteInconsistencias


Dominio XXXXXXXX
Recurso YYYYYYYYY
Descripción del RecursGenera el reporte con las inconsistencias .

Modelo Conceptual

Operación reporteInconsistencias
Método HTTP GET
URI privada http://sunattributos.k8s.sunat.peru/v1/auditoria/tributaria/analisis/e/desmedros/{numRuc}/Re
URI pública https://sunattributos.k8s.sunat.peru/v1/auditoria/tributaria/analisis/desmedros/{numRuc}/Re

SLA
Propiedad Descripción
tiempoRes Tiempo de respuesta
disponibilidad disponibilidad
concurrencia concurrencia
codUsuario String - (Solo para la URI Privada)
REQUEST

Request URI
Parámetros de Entrad Descripcion
CodigoExistencias Código de Existencias UNSPSC
CodigoExistenciasPropiCódigo de Existencias Propias

Codigo del motivo de destrucción


001 - Existencias vencidas
002 - Existencias perecibles malogradas
003 - Existencias no aptas para consumo
codMotivoDestruccion 004 - Existencias en desuso
005 - Existencias depreciadas
006 - Existencias en proceso que no pueden
tener uso en otro proceso
099 - Otros

codUnidadMedida Codigo de unidad de medida segun el


estandar
XXX
YYY
ZZZ
cantExistencia Cantidad de la exitencia a destruir

costoUnitarioExistencia Costo unitario de la exitencia a destruir

Request Header
Parámetros valor
Content-Type application/json
Accept application/json
numRuc número de ruc, recuperado del token (Solo para la URI Privada)
Bearer token obtenido de la autenticación (Solo para la URI Publica)
codUsuario String - (Solo para la URI Privada)
Request Body
Parámetros de Entrad Descripcion

Ejemplo Request
JSON en el body
(Anexo 3) entonces responderá el siguiente json:
{
"data" : {
"archivo": "
REPORTE DE INCONSISTENCIAS DEL REGISTRO DE EXISTENCIAS
Cantidad Registros Leidos : 100
RESPONSE

Response Header
Parámetros valor
HTTP status 200
Content-Type text/plain
Content-Disposition archivo binario codificado en binario

El sistema descarga el archivo con el siguiente formato :inconsistencias_<<ddmmyyyy>>_<<correlati

Response Body
Parámetros de Salida Descripcion
Body texto

Formato de mensaje de ERROR 500

Response Header
Parámetros valor
HTTP status Revisar la tabla de codigos de Error
Content-Type application/json

Response Body
Parámetros de Salida Descripcion
cod codigo de error (Revisar la tabla de codigos de Error)
msg mensaje de error para el usuario
exc traza del error

Ejemplo de Response
{
"cod":"500",
Formato de mensaje de ERROR 422

Response Header
Parámetros valor
HTTP status Revisar la tabla de codigos de Error
Content-Type application/json

Response Body
Parámetros de Salida Descripcion
cod codigo de error (Revisar la tabla de codigos de Error)
msg mensaje de error para el usuario
exc traza del error
errors array de errores y descripcion del error

Ejemplo de Response
{
"cod":"422",
FORMATO DE ESPECIFICACION DE SERVICIO REST

as

onsistencias .

Modelo Conceptual

at.peru/v1/auditoria/tributaria/analisis/e/desmedros/{numRuc}/ReporteInconsistencia?CodigoExistencias={Codig
nat.peru/v1/auditoria/tributaria/analisis/desmedros/{numRuc}/ReporteInconsistencia?CodigoExistencias={Codigo

SLA
Valor
2 Seg
24x7
30 x min

REQUEST

Formato
alfanumérico
alfanumérico

alfanumérico

alfanumérico

Numerico

Numerico
el token (Solo para la URI Privada)
ación (Solo para la URI Publica)
ada)

Formato

ISTENCIAS

binario

o con el siguiente formato :inconsistencias_<<ddmmyyyy>>_<<correlativo>>.txt

Formato
text/plain

Error

Formato
bla de codigos de Error)
Error

Formato
bla de codigos de Error)
Tipo dato
String
String

string

string

decimal128

decimal128
Tipo dato

Tipo dato
texto

Tipo dato
String
String
String
Tipo dato
String
String
String
String
FORMATO DE ESPECIFICACION DE SERVICIO REST

ID. Servicio S0010-GenerarPreliminar


Dominio XXXXXXXX
Recurso YYYYYYYYY
Descripción del Recurso Carga la información con los datos de la comunicación de existencias para generar u

Modelo Conceptual

Operación GeneraPreliminar
Método HTTP GET
URI privada http://sunattributos.k8s.sunat.peru/v1/auditoria/tributaria/analisis/e/desmedros/{
URI pública https://sunattributos.k8s.sunat.peru/v1/auditoria/tributaria/analisis/desmedros/{n

SLA
Propiedad Descripción
tiempoRes Tiempo de respuesta
disponibilidad disponibilidad
concurrencia concurrencia
codUsuario String - (Solo para la URI Privada)
REQUEST

Request URI
Parámetros de Entrada Descripcion

Indica si se visualiza un preliminar o se


grabar la información
"1" - Muestra un Preliminar de la
comunicación de existencias de
desmedros
" 2" - Gragar información de la
comunicación de existencias de
desmedros
Indgrabar
Request Header
Parámetros valor
Content-Type application/json
Accept application/json
numRuc número de ruc, recuperado del token (Solo para la URI Privada)
Bearer token obtenido de la autenticación (Solo para la URI Publica)

Request Body
Parámetros de Entrada Descripcion
numRuc RUC del Contrinuyente
fecAcceso Fecha y hora en que se
presenta la comunicacion

Apellidos y nombres, denominación o


nomRazonSocial razón social del Contribuyente
Descripcion del Departamento donde
se llevará a cabo la destrucción de
DescripcionDepartamento exietncias
Descripcion de la Provincia donde se
llevará a cabo la destrucción de
DescripcionProvincia exietncias
Descripcion del Distrito donde se
llevará a cabo la destrucción de
DescripcionDistrito exietncias
Numero de ubigeo donde se llevará a
cabo la destrucción de exietncias (se
compone de Departamento, provincia y
codUbigeo distrito)
Dirección exacta donde se llavará a
cabo la destrucción de existencias por
dirDestruccion desmedro
Fecha y hora programada para la
destrucción de existencias por
fecDestruccion desmedros
01 Si será realizado por un tercero
indDestruccionTercero 02 No será realizado por un tercero
RUC del prestador de servicios de
numRucTercero
destruccion de existencias

Nombre o Razon social del tercero que


desRucTercero
realizará la destruccion de existencias

-01 Mediante informe


indTipoComunicacion
-02 Sustento de notario o Juez de paz

RUC del notario que sustentará la


numRucNotario destruccion de exietncias por
desmedros
desRucNotario Nombre o Razon social del Notario
numCorrelativo Número correlativo para poder
identificar la existencia que se
esta Consultando
temporalmente.
Inicia en 1 hasta … n

codExistenciaUNSPC Código UNSPSC a 8 dígitos


acompañado del nombre al que
corresponde como bien a
destruir.
codCatalogPropio Código de materia de
destrucción de acuerdo al
catálogo propio del
contribuyente con una longitud
de hasta 24 dígitos.
| Codigo del motivo de
destrucción
001 - Existencias vencidas
002 - Existencias perecibles
malogradas
003 - Existencias no aptas para
consumo
004 - Existencias en desuso
005 - Existencias depreciadas
006 - Existencias en proceso
que no pueden tener uso en
otro proceso
099 - Otros

desMotivoDestruccion Descripcion del motivo de


destrucción
codUnidadMedida Codigo de unidad de medida
segun el estandar
XXX
YYY
ZZZ

cantExistencia Cantidad de la exitencia a


destruir
costoUnitarioExistencia Costo unitario de la exitencia a
destruir
costoComputableExistencia Costo computable de la
exitencia a destruir
CantidadRegistros Cantidad de registros de Existencias

Costo computable Total de las


CostoComputableTotal
exitencia a destruir
Ejemplo Request
JSON en el body
{
"numRUC": "2018999998888",
"nomRazonSocial": "EMPRENDEDORES S.A.C.",
"DescripcionDepartamento": "Lima",
"DescripcionProvincia": "Lima",

RESPONSE

Response Header
Parámetros valor
HTTP status 200
Content-Type application/json

Response Body
Parámetros de Salida Descripcion
paginacion

registros
documentoMod

Ejemplo JSON Response Body

ANEXO Datos Complejos


Lista de Pasajeros
Propiedad Descripcion

Formato de mensaje de ERROR 500

Response Header
Parámetros valor
HTTP status Revisar la tabla de codigos de Error
Content-Type application/json

Response Body
Parámetros de Salida Descripcion
cod codigo de error(Revisar la tabla de codigos de Error)
msg mensaje de error para el usuario
exc traza del error

Ejemplo de Response
{
"cod":"500",

Formato de mensaje de ERROR 422

Response Header
Parámetros valor
HTTP status Revisar la tabla de codigos de Error
Content-Type application/json

Response Body
Parámetros de Salida Descripcion
cod codigo de error(Revisar la tabla de codigos de Error)
msg mensaje de error para el usuario
exc traza del error
errors array de errores y descripcion del error

Ejemplo de Response
{
"cod":"422",
Cuadro de mensajes de Error
numRuc No existe el campo o es vacío
fecAcceso No existe el campo o es vacío
fecAcceso Formato permitido: dd/mm/aaaa
hh:mm:ss
codExistenciaUNSPC No existe el campo o es vacío
codCatalogPropio No existe el campo o es vacío
codCatalogPropio Formato no permitido

codMotivoDestruccion No existe el campo o es vacío

codMotivoDestruccion Formato no permitido

desMotivoDestruccion No existe el campo o es vacío

codUnidadMedida Formato no permitido

codUnidadMedida No existe el campo o es vacío

cantExistencia Formato no permitido

cantExistencia No existe el campo o es vacío


costoUnitarioExistencia Formato no permitido

costoUnitarioExistencia No existe el campo o es vacío

costoComputableExistencia Formato no permitido

costoComputableExistencia No existe el campo o es vacío

numCorrelativo Formato no permitido

numCorrelativo No existe el campo o es vacío

indActividad Formato no permitido


indActividad No existe el campo o es vacío

Numero de ubigeo donde se llevará a


cabo la destrucción de exietncias (se
compone de Departamento, provincia y
codUbigeo distrito)
Dirección exacta donde se llavará a
cabo la destrucción de existencias por
dirDestruccion desmedro
Fecha y hora programada para la
destrucción de existencias por
fecDestruccion desmedros

01 Si será realizado por un tercero


indDestruccionTercero 02 No será realizado por un tercero
RUC del prestador de servicios de
numRucTercero
destruccion de existencias

Nombre o Razon social del tercero que


desRucTercero
realizará la destruccion de existencias

-01 Mediante informe


indTipoComunicacion
-02 Sustento de notario o Juez de paz

RUC del notario que sustentará la


numRucNotario destruccion de exietncias por
desmedros
desRucNotario Nombre o Razon social del Notario

Indica si se visualiza un preliminar o se


grabar la información
"1" - Muestra un Preliminar de la
comunicación de existencias de
desmedros
" 2" - Gragar información de la
comunicación de existencias de
desmedros
Indgrabar
FORMATO DE ESPECIFICACION DE SERVICIO REST

con los datos de la comunicación de existencias para generar un Preliminar

Modelo Conceptual

os.k8s.sunat.peru/v1/auditoria/tributaria/analisis/e/desmedros/{numRuc}/GeneraPreliminar?Indgragar={Indgrabar}
utos.k8s.sunat.peru/v1/auditoria/tributaria/analisis/desmedros/{numRuc}/GeneraPreliminar?Indgragar={Indgrabar}

Valor
2 Seg
24x7
30 x min
I Privada)
REQUEST

Formato

alfanumérico

erado del token (Solo para la URI Privada)


autenticación (Solo para la URI Publica)

Formato
alfanumérico
GMT-05
ISO DATE ('yyyy-mm-ddThh:mm:ss.000-
05:00')

alfanumerico

alfanumerico

alfanumerico

alfanumerico

alfanumerico

alfanumerico

GMT-05
ISO DATE ('yyyy-mm-ddThh:mm:ss.000-05:00')

Alfanumérico

alfanumérico

Alfanumérico

Alfanumérico

alfanumérico

Alfanumérico
numerico

alfanumérico

alfanumérico
alfanumérico

alfanumérico

alfanumérico

Numerico

Numerico

Numerico

Numerico

Numerico

RESPONSE

Formato
Tipo dato

digos de Error

Formato
la tabla de codigos de Error)

digos de Error

Formato
la tabla de codigos de Error)
ipcion del error

Cuadro de mensajes de Error


Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de forma

Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de forma

Validaciones de obligatoriedad

Validaciones de forma

Validaciones de obligatoriedad

Validaciones de forma

Validaciones de obligatoriedad

Validaciones de forma

Validaciones de obligatoriedad
Validaciones de forma

Validaciones de obligatoriedad

Validaciones de forma

Validaciones de obligatoriedad

Validaciones de forma

Validaciones de obligatoriedad

Validaciones de forma
Validaciones de obligatoriedad

Validaciones de obligatoriedad

Validaciones de obligatoriedad

Validaciones de obligatoriedad

Validaciones de obligatoriedad

Validaciones de obligatoriedad

Validaciones de obligatoriedad

Validaciones de obligatoriedad

Validaciones de obligatoriedad

Validaciones de obligatoriedad
Validaciones de obligatoriedad
RVICIO REST

para generar un Preliminar

/e/desmedros/{numRuc}/GeneraPreliminar?Indgragar={Indgrabar}
s/desmedros/{numRuc}/GeneraPreliminar?Indgragar={Indgrabar}

Valor

Tipo dato

string

Tipo dato
string
Date

String

String

String

String

String

String

Date

String

string

String

String

string

String
int

string

string
string

string

string

decimal128

decimal128

decimal128

decimal128

decimal128

Tipo dato
array
Object

Tipo dato
String
String
String

Tipo dato
String
String
String
String

e Error
42201 – El campo “numRuc” no enviado o es vacío 42201

42202 – El campo “fecAcceso” no enviado o es vacío 42202

42203 – Formato de "fecAcceso" no cumple con el formato “ 42203


dd/mm/aaaa hh:mm:ss”
42204 – El campo “codExistenciaUNSPC” no enviado o es vacío 42204

42205 – El campo “codCatalogPropio” no enviado o es vacío 42205

42206 – El campo “codCatalogPropio” debe estar conformado de 42206


24 digitos sin espacios pero si acepta guion
42207 – El campo “codMotivoDestruccion” no enviado o es vacío 42207

42208 – El campo “codMotivoDestruccion” debe estar 42208


conformado de 3 digitos

42209 – El campo “desMotivoDestruccion” no enviado o es vacío 42209

42210 – El campo “codUnidadMedida” debe estar conformado 42210


de 3 digitos

42211 – El campo “codUnidadMedida” no enviado o es vacío 42211

42212 – El campo “cantExistencia” debe estar conformado de un 42212


numero decimal
42213 – El campo “cantExistencia” no enviado o es vacío 42213

42214 – El campo “costoUnitarioExistencia” debe estar 42214


conformado de un numero decimal
42215 – El campo “costoUnitarioExistencia” no enviado o es 42215
vacío
42216 – El campo “costoComputableExistencia” debe estar 42216
conformado de un numero decimal

42217 – El campo “costoComputableExistencia” no enviado o es 42217


vacío
42218 – El campo “numCorrelativo” debe estar conformado de 42218
un numero entero
42219 – El campo “numCorrelativo” no enviado o es vacío 42219

42243 – El campo “indActividad” debe estar conformado por 2


digitos
42243
42244 – El campo “indActividad” no enviado o es vacío
42244

42245 - El campo "CodUbigeo" no enviado o es vacío


42245

42246 - El campo "dirDestruccion" no enviado o es vacío 42246


42247 – Formato de "fecAcceso" no cumple con el formato “
dd/mm/aaaa hh:mm:ss”
42247
42248 – El campo “indDestruccionTercero” no enviado o es vacío
42248
42249 – El campo “numRucTercero” no enviado o es vacío
42249

42250 - El campo "desRucTercero" no enviado o es vacío 42250

42251 - El campo "indTipoComunicacion" no enviado o es vacío 42251


42252 – El campo “numRucNotario” no enviado o es vacío

42252
42253 - El campo "desRucNotario" no enviado o es vacío 42253

42254 - El campo "Indgrabar" no enviado o es vacío 42254


FORMATO DE ESPECIFICA

ID. Servicio S0011.- GeneraConstancia


Dominio contribuyente
Recurso YYYYYYYYY
Descripción del Recurso Carga la información con los datos de la comunicación de existencias para generar

Modelo C

Operación GeneraConstancia
Método HTTP GET
URI privada http://sunattributos.k8s.sunat.peru/v1/auditoria/tributaria/analisis/e/desmedros/{num
URI pública https://sunattributos.k8s.sunat.peru/v1/auditoria/tributaria/analisis/desmedros/{numR

SLA
Propiedad Descripción
tiempoRes Tiempo de respuesta
disponibilidad disponibilidad
concurrencia concurrencia
codUsuario String - (Solo para la URI Privada)
REQ

Request URI
Parámetros de Entrada Descripcion
Número de RUC del contribuyente
numRuc Obligatorio

Request Header
Parámetros valor
Content-Type application/json
Accept application/json
numRuc número de ruc, recuperado del token (Solo para la URI Privada)
Bearer token obtenido de la autenticación (Solo para la URI Publica)

Request Body
Parámetros de Entrada Descripcion

Tipo de Constancia
01 - Generacion de la comunicacion
02 - Baja de la Comunicación
03 - Rectificación de la Comunicación
04 - Carga del informe
CodTipoConstancia 05 - Carga del Documento
numRuc RUC del Contrinuyente
nomRazonSocial Apellidos y nombres, denominación o razón social del Contribuyente
Numero de ubigeo donde se llevará a cabo la destrucción de exietncias (se
codUbigeo compone de Departamento, provincia y distrito)
Dirección exacta donde se llavará a cabo la destrucción de existencias por
dirDestruccion desmedro
fecDestruccion Fecha y hora programada para la destrucción de existencias por desmedros
01 Si será realizado por un tercero
indDestruccionTercero 02 No será realizado por un tercero
numRucTercero RUC del prestador de servicios de destruccion de existencias
desRucTercero Nombre o Razon social del tercero que realizará la destruccion de existencias
-01 Mediante informe
indTipoComunicacion
-02 Sustento de notario o Juez de paz

Tipo de Documento de Identidad del Juez de Paz

Los códigos de tipo de documento del cliente podrán ser:

0 Doc.trib.no.dom.sin.ruc
1 Doc. Nacional de identidad
4 Carnet de extranjería
codTipoDocIdentidadJP 6 Registro Único de contribuyentes
7 Pasaporte
A Ced. Diplomática de identidad
B Documento identidad país residencia-no.d
C Tax Identificación Number - TIN – Doc Trib PP.NN
D Identification Number - IN – Doc Trib PP. JJ
E TAM- Tarjeta Andina de Migración
F PTP-Permiso Temporal de Permanencia

numRucNotario RUC del notario que sustentará la destruccion de exietncias por desmedros
desRucNotario Nombre o Razon social del Notario
Indicador para saber si la existencia corresponde a una rectificatoria
indRectificatoria -01 Si - es parte de una rectificatoria
-02 No - pertenece a la comunicacion original
Fecha y hora en que se presenta la comunicacion
fecAcceso

Número correlativo para poder identificar la existencia que se esta


numCorrelativo agregando temporalmente.
Inicia en 1 hasta … n
codExistenciaUNSPC Código UNSPSC a 8 dígitos acompañado del nombre al que corresponde como bien
a destruir.
codCatalogPropio Código de materia de destrucción de acuerdo al catálogo propio del contribuyente
con una longitud de hasta 24 dígitos.
codMotivoDestruccion Codigo del motivo de destrucción
001 - Existencias vencidas
002 - Existencias perecibles malogradas
003 - Existencias no aptas para consumo
004 - Existencias en desuso
005 - Existencias depreciadas
006 - Existencias en proceso que no pueden tener uso en otro proceso
099 - Otros

desMotivoDestruccion Descripcion del motivo de destrucción


codUnidadMedida Codigo de unidad de medida segun el estandar
XXX
YYY
ZZZ
cantExistencia Cantidad de la exitencia a destruir
costoUnitarioExistencia Costo unitario de la exitencia a destruir
costoComputableExistencia Costo computable de la exitencia a destruir
Ejemplo Request
JSON en el body
{ "codTipoConstancia": "01",
"numRUC": "2018999998888",
"nomRazonSocial": "EMPRENDEDORES S.A.C.",
"codUbigeo": "87382",
"codUbigeo": "87382",
"dirDestruccion": "Alisos 123",
RESP
Response Header
Parámetros valor
HTTP status 200
Content-Type application/json

Response Body

Response Body
Parámetros de Salida Descripcion
registros

Codigo que identifica a la comunicacion


Si fue con informe: CI-<yyyy>-<xxxx>-<rrrrrrrrrrr>-<ccc>
Si fue mediante documento: CD-<yyyy>-<xxxx>-<rrrrrrrrrrr>-<ccc>

Donde:
-yyyy: año
-xxxx: dependencia
-rrrrrrrrrrr: RUC
codIdentificacion -ccc: correlativo

Codigo que identifica a la baja de la comunicacion


Si fue con informe: BCI-<yyyy>-<xxxx>-<rrrrrrrrrrr>-<ccc>
Si fue mediante documento: BCD-<yyyy>-<xxxx>-<rrrrrrrrrrr>-<ccc>

codBaja Donde:
-yyyy: año
-xxxx: dependencia
-rrrrrrrrrrr: RUC
-ccc: correlativo

Codigo que identifica a la rectificatoria de la comunicacion


Si fue con informe: RCI-<yyyy>-<xxxx>-<rrrrrrrrrrr>-<ccc>
Si fue mediante documento: RCD-<yyyy>-<xxxx>-<rrrrrrrrrrr>-<ccc>

codRectificatoria Donde:
-yyyy: año
-xxxx: dependencia
-rrrrrrrrrrr: RUC
-ccc: correlativo

Tipo de sustento
indTipoSustento 01 - Carga de informe
02 - Carga de documento de notario o juez de paz

Codigo que identifica a la rectificatoria de la comunicacion


Si fue con informe: INF-<yyyy>-<xxxx>-<rrrrrrrrrrr>-<ccc>
Si fue mediante documento: DOC-<yyyy>-<xxxx>-<rrrrrrrrrrr>-<ccc>

codSustento Donde:
-yyyy: año
-xxxx: dependencia
-rrrrrrrrrrr: RUC
-ccc: correlativo
Número de operación de la constancia del sustento
Si fue con informe: INF-<yyyy>-<ccc>
Si fue mediante documento: DOC-<yyyy>-<ccc>
codConstanciaSustento
Donde:
-yyyy: año
-ccc: correlativo

DescripcionDepartamento Descripcion del Departamento donde se llevará a cabo la destrucción de exietncias

DescripcionProvincia Descripcion de la Provincia donde se llevará a cabo la destrucción de exietncias


DescripcionDistrito Descripcion del Distrito donde se llevará a cabo la destrucción de exietncias
cantRegistros Cantidad Total de registros de existencias para Destrucción.
Valor del costo computable total en soles, resulta de la sumatoria de todos los
mtoCostoCompTotal
costos computables de los items registrados para destrucción
rectificatorias.mtoCostoCompTota Valor del costo computable total en soles de la rectificatoria de la comunicación
lRect original

fecPresentacion Fecha y hora en que se presenta la comunicacion

rectificatorias.fecPresentacionRec
Fecha en que se está presentando la rectificatoria de la comunicacion
t

Número de operación de la constancia de recepción de la comunicación


Si fue con informe: CI-<yyyy>-<ccc>
Si fue mediante documento: CD-<yyyy>-<ccc>
codConstancia
Donde:
-yyyy: año
-ccc: correlativo

Número de operación de la constancia de recepción de la comunicación


Si fue con informe: RCI-<yyyy>-<ccc>
Si fue mediante documento: RCD-<yyyy>-<ccc>
rectificatorias.codConstanciaRect
Donde:
-yyyy: año
-ccc: correlativo

Número de operación de la constancia de recepción de la comunicación


Si fue con informe: BCI-<yyyy>-<ccc>
Si fue mediante documento: BCD-<yyyy>-<ccc>
codConstanciaBaja
Donde:
-yyyy: año
-ccc: correlativo

Código ECM de la constancia. Util para cuando se requeria enviar la constancia a


codEcmConstancia
correo SOL o correo del contribuyente
Código ECM de la constancia de baja. Util para cuando se requeria enviar la
codEcmConstanciaBaja constancia a correo SOL o correo del contribuyente
rectificatorias.codEcmConstancia Código ECM de la constancia. Util para cuando se requeria enviar la constancia a
Rect correo SOL o correo del contribuyente
CantidadRegistros Cantidad de registros de Existencias
CostoComputableTotal Costo computable Total de las exitencia a destruir
constancias.files._id id de la colección
constancias.files.filename nombre de constancia
documentoMod

Ejemplo1 JSON Response Body


SI codTipoConstancia ="01" (Generación de la comunicación)
{
"Titulo1": "Generación de la comunicación de destrucción de existencias",
"Titulo2":
Ejemplo2 "Código
JSON de laBody
Response comunicación:",
"indTipoSustento":"",
SI "codIdentificacion":"CD-2021-XXXXX-YYYYYYYYYYY-ZZ10",
codTipoConstancia ="02" (Baja de la comunicación)
{ "numRuc": "10896523429",
"Titulo1": "Baja de la"EMPRENDEDORES
"nomRazonSocial": comunicación de destrucción S.A.C.", de existencias",
"Titulo2": "Código de baja:", :"Lima",
"DescripcionDepartamento"
"indTipoSustento":"",
Ejemplo3 JSON Response Body
"DescripcionProvincia" :"Lima",
"codBaja":"BCD-2021-XXXXX-YYYYYYYYYYY-ZZ10",
"DescripcionDistrito" :"Comas",
SI codTipoConstancia ="03" ( Rectificación de la Comunicación)
"numRuc": "10896523429",
{ "codUbigeo" :"87382",
"nomRazonSocial":
"dirDestruccion": "EMPRENDEDORES
"Alisos 123", S.A.C.",
"Titulo1": "Rectificatoria de la comunicación de destrucción de existencias",
"codIdentificacion":"CD-2021-XXXXX-YYYYYYYYYYY-ZZ10",
"fecDestruccion":
"Titulo2": "Código "2021-01-20T:16:30Z",
de rectificatoria:",
"DescripcionDepartamento"
"indDestruccionTercero":"01", :"Lima",
"indTipoSustento":"",
Ejemplo4 JSON Response Body
"DescripcionProvincia" :"Lima",
"numRucTercero": "01919181723",
SI "rectificatorias.codRectificatoria":"RCD-2021-XXXXX-YYYYYYYYYYY-ZZ10",
codTipoConstancia "Desechos
"DescripcionDistrito"
"desRucTercero": ="04" ( CargaAndres
:"Comas", de informe relacionado a la comunicación)
S.A.C.",
"numRuc": "10896523429",
"codUbigeo" :"87382",
{ "indTipoComunicacion":"02",
"nomRazonSocial": "EMPRENDEDORES S.A.C.",
"dirDestruccion":
"Titulo1": "Alisos
"Carga de informe
"codTipoDocIdentidadJP":"RUC", 123", relacionado a la comunicación de destrucción de existencias",
"codIdentificacion":"CD-2021-XXXX-23231212452",
"fecDestruccion":
"Titulo2": "Código "2021-01-20T:16:30Z",
de
"numRucNotario":"18182355",la carga del informe:",
"DescripcionDepartamento" :"Lima",
"indDestruccionTercero":"01",
Ejemplo5
"indTipoSustento":"01",
JSON Response
"desRucNotario":"Raúl Body
Quispe
"DescripcionProvincia" :"Lima",Montoya",
"numRucTercero": 5,
SI "DescripcionDistrito"
codTipoConstancia ="05""01919181723",
"codSustento":"INF-2021-XXXXX-YYYYYYYYYYY-ZZ10",
"cantRegistros": (Carga de documento relacionado a la comunicación )
:"Comas",
"desRucTercero":
"numRuc": "Desechos
"10896523429",
"mtoCostoCompTotal": Andres S.A.C.",
12,100.00,
"codUbigeo" :"87382",
{ "indTipoComunicacion":"01",
"nomRazonSocial":
"fecAcceso":
"Titulo1": "EMPRENDEDORES
"2021-01-19T14:57:00Z",
"dirDestruccion": "Alisos
"Carga de 123", relacionado
documento S.A.C.",
a la comunicación de destrucción de existencias",
"codTipoDocIdentidadJP":"RUC",
"DescripcionDepartamento"
"codConstancia":"CD-2021-00000001" :"",
"fecDestruccion":
"Titulo2": Código "2021-01-20T:16:30Z",
de la carga del documento:",
"desRucNotario": "Desechos
"DescripcionProvincia"
} :"", Andres S.A.C.",
"indDestruccionTercero":"01",
"indTipoSustento":"02",
"numRucNotario":"18182355",
"DescripcionDistrito" :"",
"numRucTercero":
Header:"", "01919181723",
"codDocumento":"DOC-2021-XXXXX-YYYYYYYYYYY-ZZ10",
Response
"desRucNotario":"Raúl
"codUbigeo" Quispe Montoya",
"desRucTercero":
"numRuc": "Desechos Andres S.A.C.",
"10896523429",
"cantRegistros":
Parámetros
"dirDestruccion": 5, valor
"", "EMPRENDEDORES
"indTipoComunicacion":"01",
"nomRazonSocial": S.A.C.",
HTTP"mtoCostoCompTotal":
status 12,100.00,
"codIdentificacion":"CD-2021-XXXX-23231212452",
Revisar la tabla de codigos de Error
"codTipoDocIdentidadJP":"RUC",
"DescripcionDepartamento" :"",
"fecAcceso": "2021-01-19T14:57:00Z",
"fecDestruccion": "2021-01-20T:16:30Z",
Content-Type
"desRucNotario": "Desechos
"DescripcionProvincia" :"",application/json
Andres S.A.C.",
"codConstanciaBaja":"BCD-2021-00000001"
"indDestruccionTercero":"02",
"numRucNotario":"18182355",
"DescripcionDistrito" :"",
}
"numRucTercero": "",
"desRucNotario":"Raúl
Body :"", "", Quispe Montoya",
"codUbigeo"
Response
"desRucTercero":
"cantRegistros": 5,
"dirDestruccion": "",
"indTipoComunicacion":"01",
Parámetros de Salida
"mtoCostoCompTotal": Descripcion
12,100.00,
"codIdentificacion":"CD-2021-XXXX-23231212452",
"codTipoDocIdentidadJP":"RUC",
cod"fecAcceso": codigo de error(Revisar la tabla de codigos de Error)
"2021-01-19T14:57:00Z",
"fecDestruccion": "2021-01-20T:16:30Z",
msg "desRucNotario": "Desechos Andres
mensaje S.A.C.",
de error para el usuario
"rectificatorias.codConstanciaRect":"RCD-2021-00000001"
"indDestruccionTercero":"02",
"numRucNotario":"18182355",
}
exc"numRucTercero": "", traza del error
"desRucNotario":"Raúl
"desRucTercero": "", Quispe Montoya",
"cantRegistros": 5,
"indTipoComunicacion":"01",
"mtoCostoCompTotal":
Ejemplo de Response
"codTipoDocIdentidadJP":"RUC",12,100.00,
{ "fecAcceso": "2021-01-19T14:57:00Z",
"desRucNotario": "Desechos Andres S.A.C.",
"codConstanciaSustento":"INF-2021-00000001"
"cod":"500",
"numRucNotario":"18182355",
}
"desRucNotario":"Raúl Quispe Montoya",
"cantRegistros": 5,
Formato de mensaje de ERROR
"mtoCostoCompTotal": 422
12,100.00,
"fecAcceso": "2021-01-19T14:57:00Z",
Response
"codConstanciaSustento":"DOC-2021-00000001"
Header
}
Parámetros valor
HTTP status Revisar la tabla de codigos de Error
Content-Type application/json

Response Body
Parámetros de Salida Descripcion
cod codigo de error(Revisar la tabla de codigos de Error)
msg mensaje de error para el usuario
exc traza del error
errors array de errores y descripcion del error

Ejemplo de Response
{
"cod":"422",
Cuadro d
CodTipoConstancia No existe el campo o es vacío
numRuc No existe el campo o es vacío
nomRazonSocial No existe el campo o es vacío
codUbigeo No existe el campo o es vacío
dirDestruccion No existe el campo o es vacío
fecDestruccion no cumple con el formato “ dd/mm/aaaa hh:mm:ss”
indDestruccionTercero No existe el campo o es vacío
numRucTercero No existe el campo o es vacío
desRucTercero No existe el campo o es vacío
indTipoComunicacion No existe el campo o es vacío
codTipoDocIdentidadJP No existe el campo o es vacío
numRucNotario No existe el campo o es vacío
desRucNotario No existe el campo o es vacío
indRectificatoria No existe el campo o es vacío
fecAcceso no cumple con el formato “ dd/mm/aaaa hh:mm:ss”
fecAcceso no cumple con el formato “ dd/mm/aaaa hh:mm:ss”
numCorrelativo No existe el campo o es vacío
numCorrelativo No existe el campo o es vacío
codExistenciaUNSPC No existe el campo o es vacío
codCatalogPropio No existe el campo o es vacío
codMotivoDestruccion No existe el campo o es vacío
desMotivoDestruccion No existe el campo o es vacío
codUnidadMedida No existe el campo o es vacío
cantExistencia No existe el campo o es vacío
costoUnitarioExistencia No existe el campo o es vacío
costoComputableExistencia No existe el campo o es vacío
RMATO DE ESPECIFICACION DE SERVICIO REST

existencias para generar la constancia

Modelo Conceptual

alisis/e/desmedros/{numRuc}/GeneraConstancia
nalisis/desmedros/{numRuc}/GeneraConstancia

Valor
2 Seg
24x7
30 x min

REQUEST

Formato

n11

Formato

alfanumerico
alfanumérico
alfanumerico

alfanumerico

alfanumerico
GMT-05
ISO DATE ('yyyy-mm-ddThh:mm:ss.000-05:00')

Alfanumérico

alfanumérico
Alfanumérico

Alfanumérico

Alfanumérico

alfanumérico
Alfanumérico

Alfanumérico

GMT-05
ISO DATE ('yyyy-mm-ddThh:mm:ss.000-05:00')
numerico

alfanumérico

alfanumérico

alfanumérico

alfanumérico
alfanumérico

Numerico
Numerico
Numerico
RESPONSE

Formato

alfanumérico

alfanumérico

alfanumérico

Alfanumérico

alfanumérico
alfanumérico

alfanumerico

alfanumerico
alfanumerico
Numerico

Numerico

Numerico

GMT-05
ISO DATE ('yyyy-mm-ddThh:mm:ss.000-05:00')
GMT-05
ISO DATE ('yyyy-mm-ddThh:mm:ss.000-05:00')

alfanumérico

alfanumérico

alfanumérico

Alfanumérico

Alfanumérico
Alfanumérico

Numerico
Numerico
serial
binary
cias",

stencias",

Formato

Formato
Cuadro de mensajes de Error
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de forma
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de forma
Validaciones de forma
Validaciones de forma
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de obligatoriedad
REST

ia
a

Valor

Tipo dato

string

Tipo dato

String
string
String

String

String
Date

String

string
String

String

String

string
String

String

Date

int

string

string

string

string
string

decimal128
decimal128
decimal128
Tipo dato
array

string

string

string

String

string
string

String

String
String
decimal128

decimal128

decimal128

Date

Date

string

string

string

String

String
String

decimal128
decimal128
ObjectId
string
Object
Tipo dato
String
String
String

Tipo dato
String
String
String
String

422060 - El Campo 'CodTipoConstancia' No existe el campo o es vacío 422060


422061 - El Campo 'numRuc' No existe el campo o es vacío 422061
422062 - El Campo 'nomRazonSocial' No existe el campo o es vacío 422062
422063 - El Campo 'codUbigeo' No existe el campo o es vacío 422063
422064 - El Campo 'dirDestruccion' No existe el campo o es vacío 422064
422065 - El Campo 'fecDestruccion' no cumple con el formato “ dd/mm/aaaa hh:mm:ss” 422065
422066 - El Campo 'indDestruccionTercero' No existe el campo o es vacío 422066
422067 - El Campo 'numRucTercero' No existe el campo o es vacío 422067
422068 - El Campo 'desRucTercero' No existe el campo o es vacío 422068
422069 - El Campo 'indTipoComunicacion' No existe el campo o es vacío 422069
422070 - El Campo 'codTipoDocIdentidadJP' No existe el campo o es vacío 422070
422071 - El Campo 'numRucNotario' No existe el campo o es vacío 422071
422072 - El Campo 'desRucNotario' No existe el campo o es vacío 422072
422073 - El Campo 'indRectificatoria' No existe el campo o es vacío 422073
422074 - El Campo 'fecAcceso' no cumple con el formato “ dd/mm/aaaa hh:mm:ss” 422074
422075 - El Campo 'fecAcceso' no cumple con el formato “ dd/mm/aaaa hh:mm:ss” 422075
422076 - El Campo 'numCorrelativo' No existe el campo o es vacío 422076
422077 - El Campo 'numCorrelativo' No existe el campo o es vacío 422077
422078 - El Campo 'codExistenciaUNSPC' No existe el campo o es vacío 422078
422079 - El Campo 'codCatalogPropio' No existe el campo o es vacío 422079
422080 - El Campo 'codMotivoDestruccion' No existe el campo o es vacío 422080
422081 - El Campo 'desMotivoDestruccion' No existe el campo o es vacío 422081
422082 - El Campo 'codUnidadMedida' No existe el campo o es vacío 422082
422083 - El Campo 'cantExistencia' No existe el campo o es vacío 422083
422084 - El Campo 'costoUnitarioExistencia' No existe el campo o es vacío 422084
422085 - El Campo 'costoComputableExistencia' No existe el campo o es vacío 422085
FORMATO DE ESPECIFICACION DE SERVICIO REST

ID. Servicio S0012-registrarCorreosGeneracion


Dominio XXXXXXXX
Recurso YYYYYYYYY
4 de carga del Informe
Descripción del Recurso/t 5 de Carga del Documento

Modelo Conceptual

Operación registrarCorreosGeneracion
Método HTTP PUT
URI privada http://sunatgvi.k8s.sunat.peru/v1/auditoria/tributaria/operativo/e/desmedro/{numRuc}/reg
URI pública https://api.sunat.gob.pe/v1/auditoria/tributaria/operativo/desmedro/{numRuc}/registracor

SLA
Propiedad Descripción Valor
tiempoRes Tiempo de respuesta 30 Seg
disponibilidad disponibilidad 24x7

REQUEST

Request URI
Parámetros de Entrada Descripcion Formato
numRuc RUC del Generador o del sujeto obligado a llevar el Registro alfanumérico
perPeriodoTributario Periodo tributario alfanumerico
desCorreoOpcional Descripcion de direccion de correo personal por generacion dealfanumerico

Tipo de Constancia
01 - Generacion de la comunicacion
TipoConstancia 02 - Baja de la Comunicación
03 - Rectificación de la Comunicación
04 - Carga del informe
05 - Carga del Documento alfanumerico

Request Header
Parámetros valor
Content-Type application/json
Accept application/json
numRuc número de ruc, recuperado del token (Solo para la URI Privada)
Bearer token obtenido de la autenticación (Solo para la URI Publica)

Request Body
Parámetros de Entrada Descripcion Formato

Ejemplo Request
JSON en el body

RESPONSE

Response Header
Parámetros valor
HTTP status 200
Content-Type application/json

Response Body
Parámetros de Salida Descripcion Formato

Ejemplo JSON Response Body

ANEXO Datos Complejos


Lista de Pasajeros
Propiedad Descripcion Tipo dato

Formato de mensaje de ERROR 500

Response Header
Parámetros valor
HTTP status Revisar la tabla de codigos de Error
Content-Type application/json

Response Body
Parámetros de Salida Descripcion Formato
cod codigo de error(Revisar la tabla de codigos de Error)
msg mensaje de error para el usuario
exc traza del error
Ejemplo de Response
{
"cod":"500",

Formato de mensaje de ERROR 422

Response Header
Parámetros valor
HTTP status Revisar la tabla de codigos de Error
Content-Type application/json

Response Body
Parámetros de Salida Descripcion Formato
cod codigo de error(Revisar la tabla de codigos de Error)
msg mensaje de error para el usuario
exc traza del error
errors array de errores y descripcion del error

Ejemplo de Response
{
"cod": "422",

Cuadro de mensajes de Error


Campo Validación Ámbito
numRuc No existe el campo o es vacío Validaciones de oblig
numRuc Es diferente a numérico de 11 dígitos Validaciones de form
numRuc No existe el RUC o no es valido Validaciones de form
numRuc El Ruc enviado en el Header debe ser igual al Ruc Validaciones de oblig
perPeriodoTributario No existe el campo o es vacío Validaciones de oblig
perPeriodoTributario Formato permitido: yyyymm Validaciones de form
perPeriodoTributario El PeriodoTributario no debe ser posterior al yyyy Validaciones de nego
desCorreoOpcional No existe el campo o es vacío Validaciones de oblig
SERVICIO REST

e/desmedro/{numRuc}/registracorreos?desCorreoOpcional= {desCorreoOpcional}?TipoConstancia= {TipoConstancia}


edro/{numRuc}/registracorreos?desCorreoOpcional

S012

Tipo dato
string
String
String

String

Tipo dato
Tipo dato

Tipo dato
String
String
String
Tipo dato
String
String
String
String

de Error
Código – Mensaje de error Código
42201 – El campo “numRuc” no enviado o es vacío 42201
42243 – Solo se permite dato numérico de 11 dígit 42243
42244 - El RUC ingresado no existe o no es válido 42244
42244 - El campo “numRuc” enviado en el Header de 42245
42246 – El campo “perPeriodoTributario” no enviado 42246
42247 – Formato de perPeriodoTributario no cumple 42247
42248– El perPeriodoTributario de búsqueda no debe 42248
42249– El campo “desCorreoOpcional” no enviado o 42249
FORMATO DE ESPECIFIC

ID. Servicio
Dominio
Recurso
Descripción del Recurso/tarea

Modelo Conceptual

Operación
Método HTTP
URI privada
URI pública
SLA
Propiedad
tiempoRes
disponibilidad

Request URI
Parámetros de   Entrada
numRuc

codIdentificacion

fecPresentacionDesde
fecPresentacionHasta

codEstado

page
perPage

Request Header
Parámetros
Content-Type
Accept
numRuc
Bearer
codUsuario

Request Body
Parámetros de   Entrada

Ejemplo Request

JSON en el body

Response Header
Parámetros
HTTP status
Content-Type

Response Body
Parámetros de Salida
paginacion
paginacion.page
paginacion.perPage
paginacion.totalRegistros
registros

codIdentificacion

fecPresentacion
fecDestruccion
dirDestrucciom

codUbigeo

mtoCostoCompTotal

codEstado

Ejemplo JSON Response Body


{
"paginacion": {
"page": 1,
"perPage": 10,
"totalRegistros": 20
},
"registros": [
{
"codIdentificacion": "CI-2020-XXXXX-YYYYYYYYYYY-ZZ01",
"fecPresentacion": "2021-11-25 10T23:11:22",
"fecDestruccion": "2021-11-29 10T23:11:22",
"dirDestrucciom": "Alisos 123",
"codUbigeo": "010301",
"mtoCostoCompTotal": 12000.00,
"codEstado": "1"
},
{
"codIdentificacion": "CI-2020-XXXXX-YYYYYYYYYYY-ZZ02",
"fecPresentacion": "2021-11-20 10T23:11:22",
"fecDestruccion": "2021-11-25 10T23:11:22",
"dirDestrucciom": "Alisos 345",
"codUbigeo": "010304",
"mtoCostoCompTotal": 18000.00,
"codEstado": "2"
}
ANEXO Datos Complejos
]
Lista
} de Pasajeros
Propiedad

Formato de mensaje de ERROR 500

Response Header
Parámetros
HTTP status
Content-Type

Response Body
Parámetros de Salida
cod
msg
exc

Ejemplo de Response

{
"cod":"500",
"msg":"Internal Server Error - Se presento una condicion inesperada que impidio completar el Request",
"exc":"java.lang.NullPointerException at ..."
}

Formato de mensaje de ERROR 422

Response Header
Parámetros
HTTP status
Content-Type

Response Body
Parámetros de Salida
cod
msg
exc
errors

Ejemplo de Response
{
"cod": "422",
"msg": "Unprocessable Entity - Se presentaron errores de validacion que impidieron completar el Request",
"exc": null,
"errors": [
{
"success": false,
"codError": "1058",
"desError": "No hay información para el rango de periodo seleccionado debido a que ha superado el plazo de los 6 años, para poder visualizar dich
}
]
}

Campo
FORMATO DE ESPECIFICACION DE SERVICIO REST

S014-consultarComunicaciones
XXXXXXXX
YYYYYYYYY
Filtra las comunicaciones según diversos criterios de búsqueda

Modelo Conceptual

consultarComunicaciones
GET
http://sunatgvi.k8s.sunat.peru/v1/auditoria/tributaria/operativo/e/desmedro/{numRuc}/consulta?codIdentificacion={codIdentificacion}&fecPresentacionDes
https://api.sunat.gob.pe/v1/auditoria/tributaria/operativo/comunicacion/{numRuc}/consulta?
codIdentificacion={codIdentificacion}&fecPresentacionDesde={fecPresentacionDesde}&fecPresentacionHasta={fecPresentacionHasta}&codEstado={cod
tado}&page={page}&perPage={perPage}
SLA
Descripción
Tiempo de respuesta
disponibilidad

REQUEST

Descripcion
RUC del contribuyente que registra la comunicación de destrucción de existencias por desmedros

Codigo que identifica a la comunicacion


Si fue con informe: CI-<yyyy>-<xxxx>-<rrrrrrrrrrr>-<ccc>
Si fue mediante documento: CD-<yyyy>-<xxxx>-<rrrrrrrrrrr>-<ccc>

Donde:
-yyyy: año
-xxxx: dependencia
-rrrrrrrrrrr: RUC
-ccc: correlativo

Fecha y hora en que se presenta la comunicacion


Fecha y hora en que se presenta la comunicacion
01 - Pendiente: Las informadas y que no tengan carga de informe o DENJP.
02 - Concluida: Las informadas que tengan carga de informe o DENJP.
03 - Dada de baja: Las informadas que fueron dadas de baja por el contribuyente.
Número de pagina
Número de registros que nos devuelve cada pagina

valor
application/json
application/json
número de ruc, recuperado del token (Solo para la URI Privada)
token obtenido de la autenticación (Solo para la URI Publica)
String - (Solo para la URI Privada)

Descripcion

RESPONSE

valor
200
application/json

Descripcion
Array de la Propuesta de no incluidos

Codigo que identifica a la comunicacion


Si fue con informe: CI-<yyyy>-<xxxx>-<rrrrrrrrrrr>-<ccc>
Si fue mediante documento: CD-<yyyy>-<xxxx>-<rrrrrrrrrrr>-<ccc>

Donde:
-yyyy: año
-xxxx: dependencia
-rrrrrrrrrrr: RUC
-ccc: correlativo

Fecha y hora en que se presenta la comunicacion


Fecha y hora programada para la destrucción de existencias por desmedros
Dirección exacta donde se llavará a cabo la destrucción de existencias por desmedro
Numero de ubigeo donde se llevará a cabo la destrucción de exietncias (se compone de
Departamento, provincia y distrito)
Valor del costo computable total en soles, resulta de la sumatoria de todos los costos computables de
los items registrados para destrucción
01 - Pendiente: Las informadas y que no tengan carga de informe o DENJP.
02 - Concluida: Las informadas que tengan carga de informe o DENJP.
03 - Dada de baja: Las informadas que fueron dadas de baja por el contribuyente.
XXX-YYYYYYYYYYY-ZZ01",
0T23:11:22",
T23:11:22",

XXX-YYYYYYYYYYY-ZZ02",
0T23:11:22",
T23:11:22",

Descripcion

valor
Revisar la tabla de codigos de Error
application/json
Descripcion
codigo de error(Revisar la tabla de codigos de Error)
mensaje de error para el usuario
traza del error

una condicion inesperada que impidio completar el Request",


."

valor
Revisar la tabla de codigos de Error
application/json

Descripcion
codigo de error(Revisar la tabla de codigos de Error)
mensaje de error para el usuario
traza del error
array de errores y descripcion del error
aron errores de validacion que impidieron completar el Request",

el rango de periodo seleccionado debido a que ha superado el plazo de los 6 años, para poder visualizar dicha información deberá solicitarla a Administración Tributaria."

Cuadro de mensajes de Error


Validación
ION DE SERVICIO REST

a?codIdentificacion={codIdentificacion}&fecPresentacionDesde={fecPresentacionDesde}&fecPresentacionHasta={fecPresentacionHasta}&codEstado={codEstado}&
resentacionHasta={fecPresentacionHasta}&codEstado={codEs
Valor
5 Seg
24x7

EQUEST

Formato Tipo dato


alfanumérico string

alfanumérico string

GMT-05
Date
ISO DATE ('yyyy-mm-ddThh:mm:ss.000-05:00')
GMT-05
Date
ISO DATE ('yyyy-mm-ddThh:mm:ss.000-05:00')

alfanumérico string

n..9999 integer
n..9999 integer
Formato Tipo dato

ESPONSE

Formato Tipo dato


Object
numérico Integer
numérico Integer
numérico Integer
array array

alfanumérico string

GMT-05
Date
ISO DATE ('yyyy-mm-ddThh:mm:ss.000-05:00')
GMT-05
Date
ISO DATE ('yyyy-mm-ddThh:mm:ss.000-05:00')
alfanumerico String

alfanumerico String

Numerico decimal128

alfanumérico string
Tipo dato
Formato Tipo dato
String
String
String

Formato Tipo dato


String
String
String
String
formación deberá solicitarla a Administración Tributaria."

Cuadro de mensajes de Error


Ámbito Código
Código – Mensaje de error
FORMATO DE ESPECIFICACION DE

ID. Servicio S0031-VerFiscalizacion


Dominio XXXXXXXX
Recurso YYYYYYYYY
Descripción del Recurso visualizar el preliminar de registrar el resultado de presenciar la destrucción de existe

Modelo Conceptual

Operación GeneraPreliminar
Método HTTP GET
URI privada http://sunattributos.k8s.sunat.peru/v1/auditoria/tributaria/analisis/e/desmedros/{numR
URI pública https://sunattributos.k8s.sunat.peru/v1/auditoria/tributaria/analisis/desmedros/{numR

SLA
Propiedad Descripción
tiempoRes Tiempo de respuesta
disponibilidad disponibilidad
concurrencia concurrencia
codUsuario String - (Solo para la URI Privada)
REQUEST

Request URI
Parámetros de Entrada Descripcion

Codigo que identifica a la


comunicacion
Si fue con informe: CI-<yyyy>-<xxxx>-
<rrrrrrrrrrr>-<ccc>
Si fue mediante documento: CD-
<yyyy>-<xxxx>-<rrrrrrrrrrr>-<ccc>

Donde:
-yyyy: año
-xxxx: dependencia
-rrrrrrrrrrr: RUC
codIdentificacion -ccc: correlativo

Indica si se visualiza un preliminar o se


grabar la información
"1" - Muestra un Preliminar de la
comunicación de existencias de
desmedros
" 2" - Gragar información de la
comunicación de existencias de
desmedros
Indgrabar
Request Header
Parámetros valor
Content-Type application/json
Accept application/json
numRuc número de ruc, recuperado del token (Solo para la URI Privada)
Bearer token obtenido de la autenticación (Solo para la URI Publica)

Request Body
Parámetros de Entrada Descripcion
numRuc RUC del Contrinuyente
codCatalogPropio Código de materia de
destrucción de acuerdo al
catálogo propio del
contribuyente con una longitud
de hasta 24 dígitos.

Ejemplo Request
JSON en el body
{
"numRUC": "2018999998888",
"codIdentificacion": "CD-2021-XXXX-23232312121-001",
"Indgrabar":"1"
}

RESPONSE

Response Header
Parámetros valor
HTTP status 200
Content-Type application/json

Response Body
Parámetros de Salida Descripcion
paginacion
numRuc RUC del Contrinuyente

Apellidos y nombres, denominación o


nomRazonSocial razón social del Contribuyente
Descripcion del Departamento donde
se llevará a cabo la destrucción de
DescripcionDepartamento exietncias
Descripcion de la Provincia donde se
llevará a cabo la destrucción de
DescripcionProvincia exietncias
Descripcion del Distrito donde se
llevará a cabo la destrucción de
DescripcionDistrito exietncias
Numero de ubigeo donde se llevará a
cabo la destrucción de exietncias (se
compone de Departamento, provincia y
codUbigeo distrito)
Dirección exacta donde se llavará a
cabo la destrucción de existencias por
dirDestruccion desmedro
Fecha y hora programada para la
destrucción de existencias por
fecDestruccion desmedros
01 Si será realizado por un tercero
indDestruccionTercero 02 No será realizado por un tercero
RUC del prestador de servicios de
numRucTercero
destruccion de existencias

Nombre o Razon social del tercero que


desRucTercero
realizará la destruccion de existencias

-01 Mediante informe


indTipoComunicacion
-02 Sustento de notario o Juez de paz

RUC del notario que sustentará la


numRucNotario destruccion de exietncias por
desmedros
desRucNotario Nombre o Razon social del Notario
numCorrelativo Número correlativo para poder
identificar la existencia que se
esta Consultando
temporalmente.
Inicia en 1 hasta … n

Indicador que muestra si se ingresa


una Descripcion en lugar del Codigo
UNSPC
01 - Indica que se guardara el Código
IndSinCodigoUNSPC UNSPC
02 - Indica que no tiene Codigo
UNSPC y se guardara una
Descripción.

codExistenciaUNSPC Código UNSPSC a 8 dígitos


acompañado del nombre al que
corresponde como bien a
destruir.
Descripción en lugar del Codigo
DescripcionUNSPC
UNSPC
codCatalogPropio Código de materia de
destrucción de acuerdo al
catálogo propio del
contribuyente con una longitud
de hasta 24 dígitos.
codMotivoDestruccion Codigo del motivo de
destrucción
001 - Existencias vencidas
002 - Existencias perecibles
malogradas
003 - Existencias no aptas para
consumo
004 - Existencias en desuso
005 - Existencias depreciadas
006 - Existencias en proceso
que no pueden tener uso en
otro proceso
099 - Otros

desMotivoDestruccion Descripcion del motivo de


destrucción
Descripción de alguna observación
ObservacionItemExistencias
que tenga el bien a destruir.
codUnidadMedida Codigo de unidad de medida
segun el estandar
XXX
YYY
ZZZ

cantExistencia Cantidad de la exitencia a


destruir
costoUnitarioExistencia Costo unitario de la exitencia a
destruir
costoComputableExistencia Costo computable de la
exitencia a destruir
CantidadRegistros Cantidad de registros de Existencias

Costo computable Total de las


CostoComputableTotal
exitencia a destruir
registros
documentoMod

Ejemplo JSON Response Body


{
"numRUC": "2018999998888",
"nomRazonSocial": "EMPRENDEDORES S.A.C.",
"DescripcionDepartamento": "Lima",
ANEXO Datos Complejos
"DescripcionProvincia": "Lima",
Lista de Pasajeros
"DescripcionDistrito": "Comas",
Propiedad
"codUbigeo": "87382", Descripcion
"dirDestruccion": "Alisos 123",
"fecDestruccion": "2021-01-20T:16:30Z",
"indDestruccionTercero":"01",
"numRucTercero": "01919181723",
"indTipoComunicacion":"02",
"codTipoDocIdentidadJP":"RUC",
Formato de mensaje de ERROR 500
"numRucNotario":"18182355",
"desRucNotario":"Raúl Quispe Montoya",
"registros": [
{
"numCorrelativo": 1,
Response Header
Parámetros valor
HTTP status Revisar la tabla de codigos de Error
Content-Type application/json

Response Body
Parámetros de Salida Descripcion
cod codigo de error(Revisar la tabla de codigos de Error)
msg mensaje de error para el usuario
exc traza del error

Ejemplo de Response
{
"cod":"500",

Formato de mensaje de ERROR 422

Response Header
Parámetros valor
HTTP status Revisar la tabla de codigos de Error
Content-Type application/json

Response Body
Parámetros de Salida Descripcion
cod codigo de error(Revisar la tabla de codigos de Error)
msg mensaje de error para el usuario
exc traza del error
errors array de errores y descripcion del error

Ejemplo de Response
{
"cod":"422",
Cuadro de mensaje
numRuc No existe el campo o es vacío
nomRazonSocial No existe el campo o es vacío
codUbigeo No existe el campo o es vacío
dirDestruccion No existe el campo o es vacío
no cumple con el formato “
fecDestruccion dd/mm/aaaa hh:mm:ss”
indDestruccionTercero No existe el campo o es vacío
numRucTercero No existe el campo o es vacío
desRucTercero No existe el campo o es vacío
indTipoComunicacion No existe el campo o es vacío
codTipoDocIdentidadJP No existe el campo o es vacío
numRucNotario No existe el campo o es vacío
desRucNotario No existe el campo o es vacío
indRectificatoria No existe el campo o es vacío
no cumple con el formato “
fecAcceso dd/mm/aaaa hh:mm:ss”
fecAcceso no cumple con el formato “
dd/mm/aaaa hh:mm:ss”
numCorrelativo No existe el campo o es vacío
numCorrelativo No existe el campo o es vacío
codExistenciaUNSPC No existe el campo o es vacío
codCatalogPropio No existe el campo o es vacío
codMotivoDestruccion No existe el campo o es vacío
desMotivoDestruccion No existe el campo o es vacío
codUnidadMedida No existe el campo o es vacío
cantExistencia No existe el campo o es vacío
costoUnitarioExistencia No existe el campo o es vacío
costoComputableExistencia No existe el campo o es vacío
IndSinCodigoUNSPC No existe el campo o es vacío
DescripcionUNSPC No existe el campo o es vacío
ObservacionItemExistencias No existe el campo o es vacío
Indgrabar No existe el campo o es vacío
FORMATO DE ESPECIFICACION DE SERVICIO REST

r de registrar el resultado de presenciar la destrucción de existencias por Parte del agente Fiscalizador

Modelo Conceptual

s.sunat.peru/v1/auditoria/tributaria/analisis/e/desmedros/{numRuc}/Fiscalizador?codIdentificacion ={codIdentificacion}? Indgrag


8s.sunat.peru/v1/auditoria/tributaria/analisis/desmedros/{numRuc}/Fiscalizador?codIdentificacion ={codIdentificacion}? Indgrag

Valor
2 Seg
24x7
30 x min
I Privada)
REQUEST

Formato

alfanumérico

alfanumérico
erado del token (Solo para la URI Privada)
autenticación (Solo para la URI Publica)

Formato
alfanumérico
alfanumérico

1",

RESPONSE

Formato

alfanumérico

alfanumerico

alfanumerico

alfanumerico

alfanumerico

alfanumerico
alfanumerico

GMT-05
ISO DATE ('yyyy-mm-ddThh:mm:ss.000-05:00')

Alfanumérico

alfanumérico

Alfanumérico

Alfanumérico

alfanumérico

Alfanumérico
numerico

alfanumérico

alfanumérico

alfanumérico

alfanumérico
alfanumérico

alfanumérico

alfanumérico

alfanumérico

Numerico

Numerico

Numerico

Numerico

Numerico

Tipo dato
digos de Error

Formato
la tabla de codigos de Error)

digos de Error

Formato
la tabla de codigos de Error)

ipcion del error

Cuadro de mensajes de Error


Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de forma

Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de forma

Validaciones de forma

Validaciones de forma
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de obligatoriedad
Validaciones de obligatoriedad
FICACION DE SERVICIO REST

ucción de existencias por Parte del agente Fiscalizador

lo Conceptual

smedros/{numRuc}/Fiscalizador?codIdentificacion ={codIdentificacion}? Indgragar={Indgrabar}


medros/{numRuc}/Fiscalizador?codIdentificacion ={codIdentificacion}? Indgragar={Indgrabar}

Valor

REQUEST

Tipo dato

string

string
Tipo dato
string
string

RESPONSE

Tipo dato

string

String

String

String

String

String
String

Date

String

string

String

String

string

String
int

string

string

string

string
string

string

string

string

decimal128

decimal128

decimal128

decimal128

decimal128

array
Object
Tipo dato
String
String
String

Tipo dato
String
String
String
String

dro de mensajes de Error


422061 - El Campo 'numRuc' No existe el campo o es vacío
422062 - El Campo 'nomRazonSocial' No existe el campo o es vacío
422063 - El Campo 'codUbigeo' No existe el campo o es vacío
422064 - El Campo 'dirDestruccion' No existe el campo o es vacío
422065 - El Campo 'fecDestruccion' no cumple con el formato “ dd/mm/aaaa hh:mm:ss”

422066 - El Campo 'indDestruccionTercero' No existe el campo o es vacío


422067 - El Campo 'numRucTercero' No existe el campo o es vacío
422068 - El Campo 'desRucTercero' No existe el campo o es vacío
422069 - El Campo 'indTipoComunicacion' No existe el campo o es vacío
422070 - El Campo 'codTipoDocIdentidadJP' No existe el campo o es vacío
422071 - El Campo 'numRucNotario' No existe el campo o es vacío
422072 - El Campo 'desRucNotario' No existe el campo o es vacío
422073 - El Campo 'indRectificatoria' No existe el campo o es vacío
422074 - El Campo 'fecAcceso' no cumple con el formato “ dd/mm/aaaa hh:mm:ss”

422075 - El Campo 'fecAcceso' no cumple con el formato “ dd/mm/aaaa hh:mm:ss”

422076 - El Campo 'numCorrelativo' No existe el campo o es vacío


422077 - El Campo 'numCorrelativo' No existe el campo o es vacío
422078 - El Campo 'codExistenciaUNSPC' No existe el campo o es vacío
422079 - El Campo 'codCatalogPropio' No existe el campo o es vacío
422080 - El Campo 'codMotivoDestruccion' No existe el campo o es vacío
422081 - El Campo 'desMotivoDestruccion' No existe el campo o es vacío
422082 - El Campo 'codUnidadMedida' No existe el campo o es vacío
422083 - El Campo 'cantExistencia' No existe el campo o es vacío
422084 - El Campo 'costoUnitarioExistencia' No existe el campo o es vacío
422085 - El Campo 'costoComputableExistencia' No existe el campo o es vacío
422086 - El Campo 'IndSinCodigoUNSPC' No existe el campo o es vacío
422087 - El Campo 'DescripcionUNSPC' No existe el campo o es vacío
422088 - El Campo 'ObservacionItemExistencias' No existe el campo o es vacío
422089 - El Campo 'Indgrabar' No existe el campo o es vacío
422061
422062
422063
422064

422065
422066
422067
422068
422069
422070
422071
422072
422073
422074

422075

422076
422077
422078
422079
422080
422081
422082
422083
422084
422085
422086
422087
422088
422089
ID. Servicio
Dominio
Recurso
Descripción del Recurso/tarea

Mode

Operación
Método HTTP
URI privada
URI pública

Propiedad
tiempoRes
disponibilidad

Parámetros de   Entrada
numRuc

codIdentificacion

fecPresentacionDesde
fecPresentacionHasta
page
perPage

Request Header
Parámetros
Content-Type
Accept
numRuc
Bearer
codUsuario

Parámetros de   Entrada

Response Header
Parámetros
HTTP status
Content-Type

Response Body
Parámetros de Salida
paginacion
paginacion.page
paginacion.perPage
paginacion.totalRegistros
registros
{
"paginacion": {
"page": 1,
codIdentificacion
"perPage": 50,
"totalRegistros": 6
},
"registros": [
{
"codIdentificacion": "CI-2021-XXXX-23232312121-003",
"rectificatorias.codRectificatoria": "RCI-2021-XXXX-23232312121-003",
"numRuc":"2034567892",
"desRuc":"Modulo de Prueba",
"codEstado":"02",
rectificatorias.codRectificatoria
"fecDestruccion": "12/02/2021 10T23:11:22",
"mtoCostoCompTotal": 1,000.00,
"codResulRevisionFisica": "001",
"codResulRevisionDocumental":""
numRuc },
{
desRuc
"codIdentificacion": "CI-2021-XXXX-23232312121-002",
"rectificatorias.codRectificatoria": "",
codEstado "numRuc":"2034567892",
"desRuc":"Modulo de Prueba",
"codEstado":"03",
fecDestruccion
"fecDestruccion": "12/02/2021 10T23:11:22",
"mtoCostoCompTotal": 1,000.00,
mtoCostoCompTotal
"codResulRevisionFisica": "",
"codResulRevisionDocumental":""
},
codResulRevisionFisica
{
"codIdentificacion": "CD-2021-XXXX-23232312121-001",
"rectificatorias.codRectificatoria": "RCD-2021-XXXX-23232312121-001",
"numRuc":"2034567892",
"desRuc":"Modulo de Prueba",
codResulRevisionDocumental
"codEstado":"02",
"fecDestruccion": "13/02/2021 10T23:11:22",
Ejemplo JSON Response Body
"mtoCostoCompTotal": 1,000.00,
"codResulRevisionFisica": "002",
"codResulRevisionDocumental":"004"
},
{
ANEXO"codIdentificacion":
Datos Complejos "CD-2021-XXXX-23232312121-001",
Lista de"rectificatorias.codRectificatoria":
Pasajeros "RCD-2021-XXXX-23232312121-001",
Propiedad "numRuc":"2034567892",
"desRuc":"Modulo de Prueba",
"codEstado":"02",
"fecDestruccion": "13/02/2021 10T23:11:22",
"mtoCostoCompTotal": 1,000.00,
"codResulRevisionFisica": "001",
"codResulRevisionDocumental":"004"
},
Formato
{ de mensaje de ERROR 500
"codIdentificacion": "CD-2021-XXXX-23232312121-001",
"rectificatorias.codRectificatoria": "RCD-2021-XXXX-23232312121-001",
"numRuc":"2034567892",
"desRuc":"Modulo de Prueba",
"codEstado":"02",
"fecDestruccion": "13/02/2021 10T23:11:22",
Response Header
Parámetros
HTTP status
Content-Type

Response Body
Parámetros de Salida
cod
msg
exc

Formato de mensaje de ERROR 422

Response Header
Parámetros
HTTP status
Content-Type

Response Body
Parámetros de Salida
cod
msg
exc
errors

Campo
S033-consultarPrecenciarFiscalizacion
XXXXXXXX
YYYYYYYYY
Filtra el Resultado de Presenciar las comunicaciones según diversos criterios de búsqueda

Modelo Conceptual

consultarComunicaciones
GET
http://sunatgvi.k8s.sunat.peru/v1/auditoria/tributaria/operativo/e/desmedro/{numRuc}/consultaPresenciar?
codIdentificacion={codIdentificacion}&fecPresentacionDesde={fecPresentacionDesde}&fecPresentacionHasta={fecP
https://api.sunat.gob.pe/v1/auditoria/tributaria/operativo/comunicacion/{numRuc}/consultaPresenciar?
age={page}&perPage={perPage}
codIdentificacion={codIdentificacion}&fecPresentacionDesde={fecPresentacionDesde}&fecPresentacionHasta={fecP
age={page}&perPage={perPage}

SLA
Descripción
Tiempo de respuesta
disponibilidad

Descripcion
RUC del contribuyente que registra la comunicación de destrucción de existencias por desmedros

Codigo que identifica a la comunicacion


Si fue con informe: CI-<yyyy>-<xxxx>-<rrrrrrrrrrr>-<ccc>
Si fue mediante documento: CD-<yyyy>-<xxxx>-<rrrrrrrrrrr>-<ccc>

Donde:
-yyyy: año
-xxxx: dependencia
-rrrrrrrrrrr: RUC
-ccc: correlativo

Fecha y hora en que se presenta la comunicacion


Fecha y hora en que se presenta la comunicacion
Número de pagina
Número de registros que nos devuelve cada pagina

valor
application/json
application/json
número de ruc, recuperado del token (Solo para la URI Privada)
token obtenido de la autenticación (Solo para la URI Publica)
String - (Solo para la URI Privada)

Descripcion

valor
200
application/json

Descripcion

Array de la Propuesta de no incluidos


Codigo que identifica a la comunicacion
Si fue con informe: CI-<yyyy>-<xxxx>-<rrrrrrrrrrr>-<ccc>
Si fue mediante documento: CD-<yyyy>-<xxxx>-<rrrrrrrrrrr>-<ccc>

Donde:
-yyyy: año
-xxxx: dependencia
-rrrrrrrrrrr: RUC
-ccc: correlativo
XX-23232312121-003",
"RCI-2021-XXXX-23232312121-003",
Codigo que identifica a la rectificatoria de la comunicacion
Si fue con informe: RCI-<yyyy>-<xxxx>-<rrrrrrrrrrr>-<ccc>
Si fue mediante documento: RCD-<yyyy>-<xxxx>-<rrrrrrrrrrr>-<ccc>

Donde:
T23:11:22",-yyyy: año
-xxxx: dependencia
-rrrrrrrrrrr: RUC
-ccc: correlativo
"
RUC del contribuyente que registra la comunicación de destrucción de existencias por desmedros
Nombre o Razon social del contribuyente
XX-23232312121-002",
"", 01 - Pendiente: Las informadas y que no tengan carga de informe o DENJP.
02 - Concluida: Las informadas que tengan carga de informe o DENJP.
03 - Dada de baja: Las informadas que fueron dadas de baja por el contribuyente.
Fecha y hora programada para la destrucción de existencias por desmedros
T23:11:22",
Valor del costo computable total en soles, resulta de la sumatoria de todos los costos computables de
los items registrados para destrucción
"
Resultado de la revisión Fisica
001 - Conforme
002 - No conforme
XX-23232312121-001",
005 - No presencia
"RCD-2021-XXXX-23232312121-001",
Resultado de la revisión Documental
003 - Conforme documental
004 - No conforme documental
T23:11:22",

004"

XX-23232312121-001",
"RCD-2021-XXXX-23232312121-001",
Descripcion

T23:11:22",

004"

XX-23232312121-001",
"RCD-2021-XXXX-23232312121-001",

T23:11:22",
valor
Revisar la tabla de codigos de Error
application/json

Descripcion
codigo de error(Revisar la tabla de codigos de Error)
mensaje de error para el usuario
traza del error

valor
Revisar la tabla de codigos de Error
application/json

Descripcion
codigo de error(Revisar la tabla de codigos de Error)
mensaje de error para el usuario
traza del error
array de errores y descripcion del error

Validación
aPresenciar?
resentacionHasta={fecPresentacionHasta}&codEstado={codEstado}&p
esenciar?
resentacionHasta={fecPresentacionHasta}&codEstado={codEstado}&p

Valor
5 Seg
24x7

Formato
alfanumérico

alfanumérico

GMT-05
ISO DATE ('yyyy-mm-ddThh:mm:ss.000-05:00')
GMT-05
ISO DATE ('yyyy-mm-ddThh:mm:ss.000-05:00')
n..9999
n..9999

Formato

Formato

numérico
numérico
numérico
array
alfanumérico

string

alfanumérico string

alfanumérico string
Alfanumérico String

alfanumérico string

GMT-05 date
ISO DATE ('yyyy-mm-ddThh:mm:ss.000-05:00')
Numerico decimal128

alfanumérico string

alfanumérico string

Tipo dato
Formato

Formato

Ámbito

También podría gustarte