Especificaciones de Servicio Web 01-03-2018

Descargar como pdf o txt
Descargar como pdf o txt
Está en la página 1de 12

ESPECIFICACIONES DEL

DEL SERVICIO WEB


INTEROPERABILIDAD: CENTROS DE INSPECCIÓN TÉCNICA
VEHICULAR

Especificación Técnica
01/03/2018

Lima, 2018

DGTT – OTI 1
ESPECIFICACIONES DEL
DEL SERVICIOS WEB

INTEROPERABILIDAD: CENTROS DE INSPECCIÓN TÉCNICA VEHICULAR

1. INTRODUCCIÓN

El proyecto de interoperabilidad con los Centros de Inspección Técnica Vehicular es un


Sistema Diseñado para interactuar con los CITV facilitando información de las características
de los vehículos, verificar la última revisión efectuada y generar y facilitar el número del
certificado de inspección o informe generado.

1.1. PROPÓ
PROPÓSITO

El propósito de este documento, es definir y establecer la estructura de datos para


el intercambio de información en las diversas operaciones disponibles en el servicio
web expuestos por el MTC para el proyecto Interoperabilidad CITV.

1.2. ALCANCE

Especificar la estructura de datos de las operaciones disponibles a proveer y consumir


entre el MTC y los Centros de Inspección Vehicular.

1.3. DEFINICIONES, ABREVIATURAS Y ACRÓNIMOS

2. CONSIDERACIONES GENERALES
• El formato de codificación de caracteres a usar tanto en el envió y respuesta
del mensaje es UTF-8.
• Hay algunos caracteres que no pueden estar contenidos en un elemento
XML ya que al momento de realizar el parseo ocasiona errores, para estos
casos se debe usar uno de los siguientes formatos:
o Utilizar entidades de tipo carácter:

<element>&lt;text&gt;&lt;content&gt;</element>

Referencia de entidad Significado


&lt; < (menor que)
&gt; > (mayor que)
&amp; & (símbolo de Y comercial)
&apos; ' (apóstrofe o comilla simple)
&quot; " (comilla doble)

o Para que los CITV’s se interconecten con él MTC, estos deben de enviar
sus IP’s públicas para ser registrados en los dispositivos de seguridad que
controlan los accesos al servicio web del MTC.

DGTT – OTI 2
3. MÉTODOS DE OPERACIÓ
OPERACIÓN

3.1. Autentificación de inicio de operaciones diarias

Método de Operación autentificaInicioOperacion


Descripción Permite a los CITV’s autorizados por el MTC
aperturar el inicio de operaciones diarias, así como al
MTC validar la autorización y días autorizados a
laborar.
Servicio WSinteroperabilidadCITV
Proveedor de servicio Ministerio de Transportes y Comunicaciones
Elementos de entrada
Ítem Etiqueta Tipo Descripción Referencia
1 CODENTIDA string Código de entidad. Ejm: EC000025
2 CODLOCAL string Código de local. Ejm: L000036
3 CODIV string Código Identificador de Ejm:
validación asignado por el XYL54ENGMKA49FG21
MTC a cada CITV.
Elementos de salida
Ítem Etiqueta Tipo Descripción Referencia
1 CODIGO string Código de inicio de Ejm:
operaciones diaria. ABCDEF+ddmmaaaa+XYZ
2 MENSAJE String Código de mensaje. Ejm: MSJ01

3.2. Generando el número de ficha por vehículo

Método de Operación valVehiculoPoliza


Descripción Permite a los CITV’s validar la placas del vehículo en el
servicio del MTC así como también registrar la póliza
de seguro y por último obtener los datos de las
características de los vehículos desde el MTC.
Servicio WSinteroperabilidadCITV
Proveedor de servicio Ministerio de Transportes y Comunicaciones
Elementos de entrada
Ítem Etiqueta Tipo Descripción Referencia
1 CIOD_CITV string Código de inicio de Ejm:
operaciones diaria. ABCDEF+ddmmaaaa+XYZ
2 PLACA string Número de matrícula Ejm: XYZ098
del vehículo.
3 CATEGORIA Int Tipo de categoría del
vehículo.
Se coloca el código de
la tabla CATEGORÍA
VEHICULAR
4 TIPSERVICIO Int Tipo de servicio Ejm: 1
determinado para el
vehículo.
Se coloca el código de
la tabla TIPO SERVICIO.

DGTT – OTI 3
5 TIPAMBITO Int Tipo de ámbito Ejm: 2
que prestaría el
servicio.
Se coloca el código
de la tabla TIPO
AMBITO.
6 TIPINSPECCION int Tipo de inspección Ejm: 1
técnica
determinado para
el vehículo.
Se coloca el código
de la tabla TIPO DE
INSPECCIÓN.
Elementos de salida — vehículo
Ítem Etiqueta Tipo Descripción Referencia
1 NUM_FICHA string Código generado Ejm:
por cada consulta Placa+hhmm+00001
de placa realizada
al MTC y se
utilizara en toda la
transacción.
2 PLACA Número de Ejm: ABE751
matrícula del
vehículo.
3 CATEGORIA string Categoría del Ejm: M3
vehículo.
4 MARCA string Descripción de la Ejm: HYUNDAI
Marca.
5 MODELO string Descripción del Ejm: COUNTY
Modelo de
acuerdo a la marca
del vehículo.
6 AÑOFAB string Año de Ejm: 2010
fabricación.
7 COMBUSTIBLE string Tipo de Ejm: DIESEL
Combustible.
8 VINSERCHA string VIN o Serie Chasis. Ejm:
KMJHD17LPBC048075
9 NUMEROMOTOR string Número de motor. D4ALA435645
10 CARROCERIA string Descripción de la Ejm: MINIBUS
carrocería.
11 NUMEROEJES string Número de ejes. Ejm: 2
12 NUMERORUEDAS string Número de ruedas. Ejm: 6
13 NUMEROASIENTOS string Número de Ejm: 28
asientos.
14 NUMEROPASAJEROS string Número de Ejm: 28
pasajeros.
15 LARGO string Dimensión larga. Ejm: 7.08
16 ANCHO string Dimensión ancha. Ejm: 2.03
17 ALTO string Dimensión alto. Ejm: 6.3
18 COLOR string Color del vehículo. Ejm: Crema Marron

DGTT – OTI 4
19 PESONETO string Peso neto. Ejm: 3800
20 PESOBRUTO string Peso bruto. Ejm: 6670
21 PESOUTIL string Peso útil. Ejm: 2870.0
22 NUMDOC_ULTREV string Número de Ejm:
documento de C-2018-011-017-0000001
I-2018-011-017-0000001
acuerdo al tipo de
documento.
23 FECDOC_ULTREV string Fecha de Formato: dd/mm/aaaa
documento. Ejm: 10/02/2018
24 RAZSOCCITV_ULTREV string Empresa de CITV. Ejm:
Empresa CITV S.A.C.
25 OBS_ULTREV Object[] Listado de Ejm: H.3.1.4
observaciones de la D.1.7
anterior revisión.
26 TPPOLIZA string Código del tipo de Ejm: SOAT
póliza.
Se coloca el código
de la tabla TIPO
POLIZA
27 NUMPOLIZA string Número de póliza Ejm: X45Y777444H55
28 FECINIPOLIZA string Fecha de inicio de Formato: dd/mm/aaaa
vigencia de póliza. Ejm: 10/02/2018
29 FECFINPOLIZA string Fecha de fin de Formato: dd/mm/aaaa
vigencia de póliza. Ejm: 10/02/2018
30 MENSAJE String Código de Ejm: MSJ01
mensaje.

3.3. Registro de Póliza

Método de Operación registraPoliza


Descripción Permite a los CITV’s registrar la póliza del vehículo en
el servicio del MTC.
Servicio WSinteroperabilidadCITV
Proveedor de servicio Ministerio de Transportes y Comunicaciones
Elementos de entrada
Ítem Etiqueta Tipo Descripción Referencia
1 CIOD_CITV string Código de inicio de Ejm:
operaciones diaria. ABCDEF+ddmmaaaa+XYZ
2 NUM_FICHA string Código generado por Ejm: XYZ098
cada consulta de placa
realizada al MTC y se
utilizara en toda la
transacción.
3 PLACA string Número de matrícula Ejm: XYZ098
del vehículo.
4 TPPOLIZA string Código del tipo de Ejm: SOAT
póliza.
Se coloca el código de
la tabla TIPO POLIZA.
5 NUMPOLIZA string Número de póliza. Ejm: X45Y777444H55

DGTT – OTI 5
6 FECINIPOLIZA string Fecha de inicio de Formato: dd/mm/aaaa
vigencia de póliza. Ejm: 10/02/2018
7 FECFINPOLIZA string Fecha de fin de Formato: dd/mm/aaaa
vigencia de póliza. Ejm: 10/02/2019
Elementos de salida
Ítem Etiqueta Tipo Descripción Referencia
1 RETVAL string Devuelve el valor 0 ó Ejm:
1 para determinar si 0: Registrado
se ha realizado el 1: No Registrado
registro de la póliza
de manera correcta.
2 MENSAJE String Código de mensaje. Ejm: MSJ13

3.4. Generando el número de certificado o informe

Método de Operación valRevisionAprobada


Descripción Permite a los CITV’s remitir los datos de aprobación
o desaprobación de la revisión técnica.
Servicio WSinteroperabilidadCITV
Proveedor de servicio Ministerio de Transportes y Comunicaciones
Elementos de entrada
Ítem Etiqueta Tipo Descripción Referencia
1 CIOD_CITV string Código de inicio de Ejm:
operaciones diaria. ABCDEF+ddmmaaaa+XYZ
2 PLACA string Número de matrícula Ejm: ABE751
del vehículo.
3 NUM_FICHA string Código generado Ejm: XYZ098
por cada consulta de
placa realizada al
MTC y se utilizara en
toda la transacción.
4 ESTADOREV String Estado de la revisión Ejm: 1
realizada:
1: Desaprobado
2: Aprobado
5 FECINICITV string Fecha de inicio de Formato: dd/mm/aaaa
vigencia del Ejm: 10/02/2018
certificado.
6 FECFINCITV string Fecha de fin de Formato: dd/mm/aaaa
vigencia del Ejm: 10/08/2018
certificado.
7 OBSERVACIONES string Código de Ejm: H.3.1.4| D.1.10|
observación de CITV. J.19.1
Si no existe
observación
consignar: S/O
Elementos de salida
Ítem Etiqueta Tipo Descripción Referencia

DGTT – OTI 6
1 CODIGO string Se define si el Ejm: 1
documento será:
1: Informe
2: Certificado
2 RETVAL string Número del Ejm:
documento de C-2018-011-017-0000001
acuerdo al tipo de I-2018-011-017-0000001
documento. En donde:
C: si es un certificado.
I: si es un informe.
2018: es el año en curso.
011: tres últimos dígitos del
código de entidad.
017: tres últimos dígitos del
código del local, y
000001: número de
correlativo
3 MENSAJE String Código de mensaje. Ejm: MSJ01

3.5. Anulación de certificado

Método de Operación anulaCITV


Descripción Permite anular los CITV’s generados mediante el
servicio del MTC.
Servicio WSinteroperabilidadCITV
Proveedor de servicio Ministerio de Transportes y Comunicaciones
Elementos de entrada
Ítem Etiqueta Tipo Descripción Referencia
1 CIOD_CITV string Código de inicio de Ejm:
operaciones diaria. ABCDEF+ddmmaaaa+XYZ
2 PLACA string Número de Ejm: XYZ098
matrícula del
vehículo.
3 NUMDOC string Número del Ejm:
Certificado C-2018-011-017-0000001
generado.
4 MOTANU Int Se coloca el código Ejm: 2
de la tabla MOTIVO
ANULACION.
Elementos de salida
Ítem Etiqueta Tipo Descripción Referencia
1 RETVAL string Devuelve el valor 0 ó Ejm:
1 para determinar si 0: Registrado
se ha realizado el 1: No Registrado
registro de la
anulación de manera
correcta.
2 MENSAJE string Código de mensaje. Ejm: MSJ13

DGTT – OTI 7
3.6. Cierre de transmisión diaria

Método de Operación cierreOperaciones


Descripción Permite a los CITV’s realice el cierre de operaciones
diaria y reciba un consolidado de la información de las
transacciones realizadas.
Servicio WSinteroperabilidadCITV
Proveedor de servicio Ministerio de Transportes y Comunicaciones
Elementos de entrada
entrada
Ítem Etiqueta Tipo Descripción Referencia
1 CIOD_CITV string Código de inicio de Ejm:
operaciones diaria. ABCDEF+ddmmaaaa+XYZ
Elementos de salida
Ítem Etiqueta Tipo Descripción Referencia
1 NUMTRADIA string Número de Ejm: 131
transacciones exitosas
realizadas.
2 NUMCERTI string Número de certificados Ejm: 125
generados.
3 NUMINFOR string Número de informes Ejm: 6
generados.
4 NUMANUL string Número de anulaciones Ejm: 2
realizadas.

4. CÓDIGOS DE RESPUESTA

Ítem Código Descripción mensaje


1 MSJ01 Código de entidad no existe o no es correcto o está vacío,
no se puede continuar con el proceso
2 MSJ02 Código de local no existe o no es correcto o está vacío, no
se puede continuar con el proceso
3 MSJ03 Código identificador de validación está vacío o no existe o
no es correcto.
4 MSJ04 La autorización del CITV se encuentra vencida, por favor
coordine con el MTC (Fecha de vencimiento)
5 MSJ05 El CITV se encuentra sancionado con Resolución de la
SUTRAN.
6 MSJ06 El CITV tiene registrado el día de hoy como permiso de no
operación.
7 MSJ07 EL día de hoy no se encuentra autorizado para operar.
8 MSJ08 No se encuentra autorizado para operar en este horario.
9 MSJ09 No se cuenta con el código de inicio de operación diaria.
10 MSJ10 El vehículo de placa ABC123 no existe en el registro
vehicular
11 MSJ11 Tiene que enviar el tipo de póliza y el número de póliza,
no se puede continuar con el proceso

DGTT – OTI 8
12 MSJ12 La revisión no cuenta con el estado de aprobación o
desaprobación
13 MSJ13 Error de proceso, intente de nuevo si persiste el error
coordine con el MTC.
14 MSJ14 El tipo de servicio no existe.
15 MSJ15 El tipo de ámbito no existe.
16 MSJ16 El tipo de inspección no existe.
17 MSJ17 Código de inicio de operaciones diaria vacío.
18 MSJ18 Número de matrícula del vehículo vacío o no es correcto
19 MSJ19 Código del tipo de póliza vacío
20 MSJ20 Número de póliza vacío
21 MSJ21 Fecha de inicio de vigencia de póliza no debe ser mayor a
la actual.
22 MSJ22 Fecha de inicio de vigencia de póliza vacío o formato
incorrecto
23 MSJ23 Fecha de fin de vigencia de póliza vacío o formato
incorrecto
24 MSJ24 Tipo de servicio vacío o no es correcto
25 MSJ25 Tipo de ámbito vacío o no es correcto
26 MSJ26 Tipo de inspección técnica vacío o no es correcto
27 MSJ27 El código de observación de la revisión técnica no existe o
esta vacío.
28 MSJ28 El número de ficha vacío
29 MSJ29 La fecha inicio del certificado vacío
30 MSJ30 La fecha final del certificado vacío
31 MSJ31 La fecha final no puede ser igual o menor la fecha inicial
del certificado
32 MSJ32 La fecha inicio del certificado no puede ser diferente a la
fecha actual
33 MSJ33 El código de categoría no existe o está vacío.
34 MSJ34 El tipo de póliza no existe.
35 MSJ35 La fecha final de la póliza no debe ser menor que la fecha
inicio de la póliza.
36 MSJ36 El periodo de vigencia de la póliza debe ser de 1 año
37 MSJ37 La fecha final de la póliza no debe ser menor a la actual
38 MSJ38 El Código de inicio de operación diaria, el número de ficha
y/o placa vehicular no son correctos.
39 MSJ39 El número certificado no ha sido emitido en el día.
40 MSJ40 El número de certificado pertenece a un informe.
41 MSJ41 El número de certificado está vacío.
42 MSJ42 El motivo de anulación no es correcto o está vacío.
43 MSJ43 El certificado ya se encuentra anulado.
44 MSJ44 El número de ficha ya ha sido utilizada.
45 MSJ45 La placa no tiene póliza.
46 MSJ46 La póliza esta vencida
47 MSJ47 El número de póliza ya existe, pertenece a otra placa

DGTT – OTI 9
48 MSJ48 Tiene una póliza vigente.
49 MSJ49 El número de certificado no existe.
50 MSJ50 El tipo de ámbito, tipo de servicio y tipo de inspección no
son compatibles con la categoría del vehículo.
51 MSJ51 La categoría del vehículo no está autorizada para el
registro de la poliza.

5. TABLAS GENERALES

Tabla: TIPO POLIZA

Código Descripción
SOAT Seguro Obligatorio de Accidentes de Tránsito
Asociaciones de Fondos Regionales o Provinciales contra
AFOCAT
Accidentes de Tránsito

Tabla: TIPO SERVICIO

Código Descripción
0 Particular
1 Transporte Regular de Personas
2 Transporte Privado de Personas
3 Transporte Especial de Personas — Turístico
4 Transporte Especial de Personas —Trabajadores
5 Transporte Especial de Personas —Estudiantes
6 Transporte Especial de Personas —Social
7 Transporte Especial de Personas —Auto Colectivo
8 Transporte Especial de Personas —Taxi
9 Transporte de Mercancías en General Público
10 Transporte de Mercancías Privado
11 Transporte de Materiales y Residuos Peligrosos.
12 Servicio Especial Comunal de Transporte de Pasajeros por
Carretera.
13 Servicio de Transporte Publico Especial de Pasajeros de
Pasajeros en Vehículos Menores.
14 Servicio de Transporte Mixto.
15 Servicio de Transporte Internacional de Pasajeros por
Carretera de la Comunidad Andina.
16 Servicio de Transporte Internacional de Mercancías por
Carretera de la Comunidad Andina.
17 Servicio de Transporte de Pasajeros por Carretera entre Tacna
— Arica.

DGTT – OTI 10
18 Servicio de Transporte Transfronterizo de Pasajeros en
Ómnibus Entre Perú — Ecuador.

19 Servicio de Transporte Transfronterizo de Pasajeros en Taxi


Entre Perú — Ecuador.

20 Servicio de Transporte Transfronterizo Turístico entre Perú —


Ecuador.
21 Servicio de Transporte Transfronterizo de Mercancías entre
Perú — Ecuador.
22 Servicio de Transporte Internacional Terrestre de Pasajeros
por Carretera - ATIT (Cono Sur).
23 Servicio de Transporte Internacional Terrestre de Mercancías
por Carretera - ATIT (Cono Sur).

Tabla: TIPO ÁMBITO

Código Descripción
0 Ninguno
1 Ámbito Nacional
2 Ámbito Regional
3 Ámbito Provincial
4 Ámbito Internacional(Pasajeros)
5 Ámbito Distrital

Tabla: MOTIVO ANULACIÓN

Código Descripción
1 Error digitación u Omisión
2 Error de impresión de documento
3 Error de Operación
4 Pérdida o Robo

Tabla: TIPO DE INSPECCIÓN

Código Descripción
1 Ordinaria
2 Ordinaria y Complementaria
3 Extraordinaria
4 Incorporación
5 Complementaria

DGTT – OTI 11
Tabla: CATEGORÍA VEHICULAR

Código Descripción
1 M1
2 M2
3 M3
4 N1
5 N2
6 N3
7 O1
8 O2
9 O3
10 O4
11 L1
12 L2
13 L3
14 L4
15 L5

DGTT – OTI 12

También podría gustarte