La normalización de una dirección postal consiste en el tratamiento de los datos postales validando la existencia de una dirección para un determinado alcance postal(localidad, provincia y/o CP), lo que permite identificar problemas de localidades, calles o alturas inexistentes o, formatos incompletos o incomprensibles de escritura. Por otro lado detecta distintas gramáticas de escritura de una dirección, permitiendo separar calle, número, piso, departamento y observaciones o comentarios informados. El resultado obtenido sera un domicilio estandarizado en su escritura y validado.

Además, a partir de la validación de existencia de la dirección, Merlin enriquece los datos postales faltantes : Código Postal, Barrio, Localidad, Partido y Provincia . La información se completa con la asignación de las entre calles correspondientes para brindar un localización más precisa.

El cliente debe enviar una estructura de Dirección según lo detallado en el apartado “Atributos de entrada” debiendo completar mínimamente los campos que se detallan a continuación:

  • street: este campo puede contener tanto el nombre de la calle como la dirección completa (street, houseNumber, floor, unit). Los campos houseNumber, floor, unit NO deben ser completados si se ingreso la calle completa en el campo “street”.
  • level4: puede no completarse si se informa el postalCode.
  • level2: puede no completarse si se informa el postalCode.
  • postalCode: puede no completarse si se informa la level4.
  • clientAccessCode: ID de acceso de cliente.

El resultado del proceso de normalización de una dirección sera la estructura de datos detallada en el apartado “Atributos de salida”

Motivos aplicados a Corregidos (CO)

Motivos de no resolución aplicados a No encontrados (NE)

Aplicados a Dudosos (DU)

(*) Siempre debe enviarse.

Atributo Longitud Máxima Descripción del atributo
clientAccessCode 64 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.
customAdapters 64 Adaptadores de respuesta/modificadores de comportamiento. Para más información ver “Adaptadores de respuesta”.
level1 64 Corresponde al primer nivel (País) administrativo de una dirección. Para más información ver “Niveles administrativos“.
level2 64 Corresponde al segundo nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Provincia. Para más información ver “Niveles administrativos“.
level3 64 Corresponde al tercer nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Partido. Para más información ver “Niveles administrativos“.
level4 64 Corresponde al cuarto nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Localidad. Para más información ver “Niveles administrativos“.
level5 64 Corresponde al quinto nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Barrio. Para más información ver “Niveles administrativos“.
street 64 Nombre de la calle o dirección completa. Puede incluir nombres de barrios cerrados, barrios zonales, rutas, alturas, piso, depto, referencias, nombres de puntos de interes, etc.
houseNumber 10 Número de la dirección.
floor 2 Piso de la dirección.
unit 3 Departamento, numero de casa, oficina, PH, local, entre otros elementos de la dirección.
postalCode 4 Código Postal de la dirección.
additionalData 64 Observaciones o datos adicionales de la calle.
betweenStreet1 64 Entre calles entrada para constatar dicha calle con esa altura.
betweenStreet2 64 Entre calles entrada para constatar dicha calle con esa altura.
 

Atributo

Longitud Máxima Observación
status 3 Indica el estado de normalización y/o validación. Para mas información ver el apartado “Estados y Motivos”.
statusReason 2 Indica la razón con referencia al estado de normalización y/o validación. Para mas información ver el apartado “Estados y Motivos”.
remainingCredits 16 Créditos restantes del usuario.
transactionId 10 Merlin asigna un id de transacción por consulta.
nAddress Son los datos de la dirección ya corregida. Si la dirección no pudo ser corregida, aquí se encontrarán los datos de la dirección original parseados de haber sido posible.
geoType 2 Tipo de georeferenciación, ver documento “Tipo de Georeferenciación”.
level1 64 Corresponde al primer nivel (País) administrativo de una dirección. Para más información ver “Niveles administrativos“.
level2 64 Corresponde al segundo nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Provincia. Para más información ver “Niveles administrativos“.
level3 64 Corresponde al tercer nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Partido. Para más información ver “Niveles administrativos“.
level4 64 Corresponde al cuarto nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Localidad. Para más información ver “Niveles administrativos“.
level5 64 Corresponde al quinto nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Barrio. Para más información ver “Niveles administrativos“.
streetType 12 Tipo de vialidad como ser avenida, calle,etc.
street 64 Nombre de la calle normalizada o estandarizada.
houseNumber 10 Numeración de la dirección.
floor 2 Piso de la dirección.
unit 3 Departamento, numero de casa, oficina, PH, local, entre otros elementos de la dirección.
latitude 10 Coordenada Y de georeferenciación.
longitude 10 Coordenada X de georeferenciación.
postalCode 4 Código postal de la dirección.
additionalPostalCode 8 Codigo postal adicional. Por ejemplo para Argentina, “Código Postal Argentino” (CPA).
fromStreetNumber 10 Altura inicial para la calle normalizada.
toStreetNumber 10 Altura final para la calle normalizada.
additionalData 64 Son datos extras encontrados en la dirección original que no corresponden a ningún campo.
betweenStreet1 64 Primera transversal del domicilio.
betweenStreet2 64 Segunda transversal del domicilio.
corner 64 Esquina de la dirección o denominación de la esquina a normalizar.
placeType 12 Tipo de punto de interés, lugar, etc.
place 64 Nombre del punto de interés, lugar, etc.
placeReference 64 Datos complementarios de como llegar al domicilio normalizado, es utilizado para los barrios cerrados. Para màs información ver “Resolución de POIS”
numberAlternativeAddresses 1 Cantidad de direcciones alternativas.
alternativeAddresses Si existe mas de una a la dirección posible para los datos ingresados, aquí se retornará N estructuras de respuesta de direcciones. El máximo posible de direcciones dudosas es de 5. Es decir, que es posible que la estructura se repita de 1 a 5 veces. Si no existieron direcciones alternativas, entonces el campo estará vacío.
level1 64 Corresponde al primer nivel (País) administrativo de una dirección. Para más información ver “Niveles administrativos“.
level2 64 Corresponde al segundo nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Provincia. Para más información ver “Niveles administrativos“.
level3 64 Corresponde al tercer nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Partido. Para más información ver “Niveles administrativos“.
level4 64 Corresponde al cuarto nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Localidad. Para más información ver “Niveles administrativos“.
level5 64 Corresponde al quinto nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Barrio. Para más información ver “Niveles administrativos“.
street 64 Nombre de la calle alternativa encontrada.
houseNumber 5 Numeración de la dirección.
geoType 2 Tipo de georeferenciación, ver documento “Tipo de Georeferenciación”.
latitude 10 Coordenada Y de georeferenciación.
longitude 10 Coordenada X de georeferenciación.
postalCode 4 Código postal de la dirección.
fromStreetNumber 5 Altura inicial para la calle normalizada.
toStreetNumber 5 Altura final para la calle normalizada.
merlinCustomValues Valores desarrollados por demanda del cliente o que se provee opcionalmente como el nivel socioeconómico.
addressLabel 100 Etiqueta de la dirección. Por ejemplo: “Av. Libertador 7270 2 A, (1429), Ciudad Autónoma de Buenos Aires, Argentina”
NISE 1 Nivel socioeconómico de la dirección. Para mas información ver “Nivel Socioeconómico
maqStatus 2 Indica si el domicilio se encuentra en MAQ asociado a un criterio definido por el cliente (Si o No).
maqConcept 16 Indica el concepto asignado en MAQ (Inhibido, Fraudulento).
maqValue Variable Valor asignado al agregar el domicilio a MAQ.(Valores Numéricos, escala para el concepto).
level4Longitude 10 Indica la longitud del centroide de la localidad.
level4Latitude 10 Indica la latitud del centroide de la localidad.
postalCertifiedAddress 1 Dirección Verificada a nivel de puerta. Para mas información ver “Validación de Puertas”.
merlinRiskArea 1 Indica si la dirección corresponde a una zona de riesgo o difícil acceso (S o N).
buildingType 10 Edificio, casa, terreno, etc.
clientCustomValues Valores desarrollados por demanda del cliente o que se provee opcionalmente.
 

Atributo

Longitud Máxima Observación
geoType 2 Tipo de georeferenciación, ver documento “Tipo de Georeferenciación”.
level1 64 Corresponde al primer nivel (País) administrativo de una dirección. Para más información ver “Niveles administrativos“.
level2 64 Corresponde al segundo nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Provincia. Para más información ver “Niveles administrativos“.
level3 64 Corresponde al tercer nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Partido. Para más información ver “Niveles administrativos“.
level4 64 Corresponde al cuarto nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Localidad. Para más información ver “Niveles administrativos“.
level5 64 Corresponde al quinto nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Barrio. Para más información ver “Niveles administrativos“.
street 64 Nombre de la calle normalizada o estandarizada. de vialidad como ser avenida, calle,etc.
houseNumber 10 Numeración de la dirección.
latitude 10 Coordenada Y de georeferenciación.
longitude 10 Coordenada X de georeferenciación.
postalCode 4 Código postal de la dirección.
fromStreetNumber 5 Altura inicial para la calle normalizada.
toStreetNumber 5 Altura final para la calle normalizada.

Para ver más detalles de los WebServices:

Formato de mensajería JSON

Formato de mensajería SOAP