Normalización de Direcciones

Normalización de Direcciones

Descripción General

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 validado y estandarizado en su escritura.

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.

Consideraciones generales

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 ingresa la calle completa en el campo “street”.
  • level4: Corresponde al nivel de la localidad, puede no completarse si se informa el postalCode.
  • level2: Corresponde al nivel de la provincia, puede no completarse si se informa el postalCode.
  • postalCode: Corresponde al código postal, 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»

Estados para Direcciones

Estado  Significado Descripción
CO Corregido Merlin devuelve todos los datos normalizados. También informa las posibles contingencias que se hayan producido para obtener dicha resolución
NE No Encontrado Dirección no encontrada
DU Dudoso Merlin retorna más de una dirección con diferentes soluciones
SD Sin Datos No se provee de datos
NP No Parseado Direcciones que no pueden ser interpretadas por la gramática de direcciones

Motivos para Direcciones

Motivos aplicados a Corregidos (CO)

Motivo Significado
SM Sin Motivo
DP Domicilio Preconfirmado
BP Barrio Preconfirmado

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

Atributo Significado Descripción
LI Localidad Inválida No se puede identificar el ámbito de búsqueda de la dirección, ya sea por falta de información, o los datos son inconsistentes entre sí.
CI Calle Inválida La calle, no se puede localizar en la localidad informada.
AI Altura Inválida Localizada la calle, la altura informada no corresponde a una altura valida de la calle. En este caso, Merlin informa el rango válido de alturas para la calle.
SD Sin Datos

Motivos aplicados a Dudosos (DU)

Motivo Significado Descripción
DE Duda Estandar Dos o más calles, matchean de igual forma con la calle informada. Merlin devuelve cada una de las opciones encontradas
DA Duda por Altura La altura de la calle no es encontrada en la localidad informada, pero si en una localidad vecina, y Merlin no puede asegurar que una calle sea la continuación de la otra. En este caso se devuelve tanto la información correspondiente a la altura inválida en la localidad original, como la opción de resolución en la localidad vecina
DZ Duda por Barrio Zonal El barrio zonal informado no es encontrado o se encuentra un barrio o más que matchean de igual forma. Merlin retorna cada una de las opciones encontradas.
DC Duda por Barrio Cerrado El barrio cerrado informado no es encontrado o se encuentra un barrio o más que matchean de igual forma. Merlin retorna cada una de las opciones encontradas.

Custom Adapters

Valor Descripción
SAS_EXCLUDE_GCA Permite adaptar la salida de los customs, si no se envía en customAdapterKeys [] se mostrarán todos los customs que el usuario tenga asignados, si se envía se excluirán todos los custmos, ó,  se visualizarán los que se informen luego de este.
CA_GEO_AR Devuelve nivel normalizacion geo para Argentina.
CA_ENTRECALLE_ADDRESS Devuelve entrecalles.
CA_CPA_ADDRESS Devuelve CPA.
CA_NISE Devuelve Nivel Socioeconomico.
CA_ZP_AR Devuelve si es Zona Peligrosa Argentina.
CA_ADDRESS_POINT_AR Devuelve información de addresspoint Argentina.
CA_GEO_TYPE Devuelve tipoGeo.

Estructura de Dudas

Atributo Longitud  Descripció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.
Tabla de equivalencias con NSE
NISE NSE (AAM) Descripción
9 A Alto
9 B Alto
9 C1 Medio Alto
8 C2 Medio Medio
7 C3 Medio Bajo
6 D1 Bajo Superior
5-4 D2 Bajo Inferior
3-2-1 E Marginal
0 (*)

(*)En los casos en los que se retorna 0, es porque no se dispone de información NISE.

Para ver más detalles de los WebServices:

Modalidad API: Formato de mensajería JSON 2.5

Modalidad API: Formato de mensajería JSON 2.0

Modalidad API: Formato de mensajería SOAP

Modalidad Batch

Modalidad Interactivo