Especificaciones de Servicio Web 01-03-2018
Especificaciones de Servicio Web 01-03-2018
Especificaciones de Servicio Web 01-03-2018
Especificación Técnica
01/03/2018
Lima, 2018
DGTT – OTI 1
ESPECIFICACIONES DEL
DEL SERVICIOS WEB
1. INTRODUCCIÓN
1.1. PROPÓ
PROPÓSITO
1.2. ALCANCE
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><text><content></element>
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
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.
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
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
DGTT – OTI 7
3.6. Cierre de transmisión diaria
4. CÓDIGOS DE RESPUESTA
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
Código Descripción
SOAT Seguro Obligatorio de Accidentes de Tránsito
Asociaciones de Fondos Regionales o Provinciales contra
AFOCAT
Accidentes de Tránsito
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.
Código Descripción
0 Ninguno
1 Ámbito Nacional
2 Ámbito Regional
3 Ámbito Provincial
4 Ámbito Internacional(Pasajeros)
5 Ámbito Distrital
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
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