API de servicios

Tema Anterior
Próxima Lección

Enriquecimiento de Patentes

API de servicios Servicios JSON 2.5 Enriquecimiento de Patentes

Enriquecimiento de Patentes

 

Servicio de Enriquecimiento de Patentes (domain)

El cliente debe enviar una estructura de datos según lo detallado en el apartado Parámetros de Llamada» debiendo completar mínimamente los campos que se detallan a continuación:

  • domain: patente o dominio del vehículo a normalizar.
  • motor: numero de motor.
  • chassis: número de chasis.

Los siguientes campos son los Headers Obligatorios que deben informarse:

  • Authorization: Header con el ID de acceso de cliente (ClientAccessCode).
  • Content-Type: Header que se informa el tipo de contenido del mensaje, se debe informar application/json.

Método: POST

Endpoint: http://ws.merlindataquality.com/domain/normalize

Parámetros de llamada
Parámetro Descripción Longitud Tipo
Authorization Identificador único de usuarios. Este valor identifica y valida en cada invocación a un usuario determinado. Este valor tiene asociado los roles que le corresponden al usuario. 64 String
Content-Type Header que se informa el tipo de contenido del mensaje, se debe informar application/json. String
domain Patente del vehículo a estandarizar. 64 String
motor Código del motor del vehículo. 64 String
chassis Código del chasis del vehículo. 64 String
Mensaje JSON de petición
{
  "domain": "LLZ364",
  "motor": "",
  "chassis": ""
}
Respuesta
La respuesta está compuesta por una lista de elementos que tienen la siguiente estructura:
Parámetro Descripción Longitud Tipo
status Indica el estado de normalización y/o validación. Valores:
  • CO: Registro validado y enriquecido.
  • SD: Registro no Validado.
 2 String
statusReason Indica la razón con referencia al estado de normalización y/o validación. 2 String
transactionId Merlin asigna un id de transacción por consulta. 40 String
nVehicle Son los datos del vehículo enriquecido. – Object
domain Patente del automóvil. El campo se encuentra dentro del objeto nVehicle. 64 String
vehicleBrand Marca del automóvil. El campo se encuentra dentro del objeto nVehicle. 64 String
model Modelo del automóvil. El campo se encuentra dentro del objeto nVehicle. 64 String
motor Número de motor del automóvil. El campo se encuentra dentro del objeto nVehicle. 64 String
chasis Número de chasis del automóvil. El campo se encuentra dentro del objeto nVehicle. 64 String
fabricationPlace Lugar de fabricación o lugar de radicación. El campo se encuentra dentro del objeto nVehicle. 64 String
year Año de fabricación o ensamblado. El campo se encuentra dentro del objeto nVehicle. 10 String
merlinCustomValues Valores desarrollados por demanda del cliente o que se proveen opcionalmente. El campo se encuentra dentro del objeto nVehicle. – Object
Mensaje JSON de respuesta
{
    "status": "CO",
    "statusReason": "SM",
    "transactionId": "b499038b-0ba2-49b9-91d1-0ee8a7a24e2a",
    "nVehicle": {
        "domain": "LLZ364",
        "vehicleBrand": "VOLKSWAGEN",
        "model": "VOYAGE 1.6",
        "motor": "",
        "chassis": "",
        "fabricationPlace": "",
        "year": 2012,
        "merlinCustomValues": {}
    }
}
Tema Anterior
Volver a la Lección
Próxima Lección