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.
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:
El resultado del proceso de normalización de una dirección sera la estructura de datos detallada en el apartado «Atributos de salida»
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 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. |
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. |
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. |
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 Interactivo