Normalización de Domicilios

El cliente debe enviar una estructura de Archivo donde deberá completar al menos los campos:
  • calle: este campo puede contener tanto el nombre de la calle como la dirección completa (calle, número, piso, depto).
  • Estos campo NO deben ser completados si se ingreso la calle completa en el campo “calle”.
  • numero
  • piso
  • depto
  • localidad: la localidad puede no completarse si se informa el CP.
  • cp: el CP puede no completarse si se informa la localidad/provincia

Nombre de los archivos

En domicilios se respetará el siguiente formato de nombres en caso de éxito, a la izquierda los archivos que son ingresados en la carpeta de entrada y a la derecha son los archivos que dejará el proceso.

 

<nombreDelLote>_<identificadorServicio>.txt→<jobId>_<clienteSFTP>_<nombreDelLote>_<identificadorServicio>.txt
<nombreDelLote> string alfanumérico de vista, asignado por el cliente
<identificadorServicio>
el mismo referenciará el normalizador, entrada y salida y delimitador que se utilizara para ese lote. El valor por defecto para este caso es addressfilear en caso de que el cliente tenga mas de una configuración para ese servicio se le informará dicho valor.
<jobId>
retornará un valor numérico que identifica al lote.
<clienteSFTP>
nombre del usuario que ingreso el lote en el sftp

Diseño de Registro de Entrada

  • Archivo: Interfaz envío de domicilios a Merlín
  • Código : ISO-8859-1 o UTF8 (Por defecto configurado para UTF-8)
  • Formato: Con separador de datos “|” (Pipe)

Estructura de domicilios

Posición Nombre Tipo Comentario
1 ID Cliente Numérico Identificación del cliente
2 Calle Caracter Descripción Calle
3 Numero Numérico Altura de la Calle
4 Piso Caracter Piso de la dirección
5 Departamento Caracter Departamento
6 Barrio Caracter Descripción Barrio
7 Localidad Caracter Descripción Localidad
8 Partido Caracter Descripción Partido
9 Provincia Caracter Descripción Provincia
10 Código Postal Numérico Código Postal

Comentario: El diseño de archivo para envíos de domicilios a Merlín debe ser completo, no se permite tener campos de más, ni de menos.

Respuesta de Normalización de Domicilios

 

Estados para Direcciones

Atributo Significado Descripción
CO Corregido Merlín 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
ERR Error Error en los datos ingresados. El motivo del mismo es también, ERR.

Motivos para Direcciones

Motivos aplicados a Corregidos (CO)

Atributo Significado Descripción
SM Sin Motivo

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, Merlín informa el rango válido de alturas para la calle.
SD Sin Datos

Aplicados a Dudosos (DU)

Atributo Significado Descripción
DE Duda Estandar Dos o más calles, matchean de igual forma con la calle informada. Merlín 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 Merlín 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. Merlín 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. Merlín retorna cada una de las opciones encontradas.

Diseño de Registro de Salida

  • Archivo: Interfaz de domicilios recibidos de Merlín
  • Código : ISO-8859-1 o UTF8 (Por defecto configurado para UTF-8)
  • Formato: Con separador de datos “|” (Pipe)

El diseño que se detalla a continuación es el que utiliza Merlin para los archivos de domicilios normalizados.

Posición Nombre Tipo Comentario
1 idCliente Numerico Identificación del cliente
2 estado Caracter Resultado de normalización
3 motivo Caracter Motivo del estado
4 calle_out Caracter Descripción de la Calle
5 numero_out Numerico Número del domicilio
6 piso_out Caracter Piso del domicilio
7 depto_out Caracter Departamento del domicilio
8 barrio_out Caracter Descripción del Barrio
9 localidad_out Caracter Descripción de la Localidad
10 partido_out Caracter Descripción del Partido
11 provincia_out Caracter Descripción de la Provincia
12 cp_out Numerico Código postal
13 observaciones Caracter Información Adicional
14 x Caracter Coordenada X de geocodificación. Retornará en blanco cuando no exista valor.
15 y Caracter Coordenada Y de geocodificación. Retornará en blanco cuando no exista valor.
16 entreCalle1 Caracter Primera entre calle.
17 entreCalle2 Caracter Segunda entre calle.
18 tipoGeo Numerico Tipo de georeferenciación. Ver documento TipoGeo
19 cpa Alfanumerico Se retorna Código Postal Argentino para los casos donde se dispone
20 REFERENCIA Referencia Referencia en barrios cerrados para los casos donde se dispone
21 NISE Numerico Nivel Socio Economico
22 zonaRiesgo Caracter Zona peligrosa, valores posibles; S o N
23 puerta Caracter Indica si se valida existencia de puerta
El campo 1 será retornado tal cual en la entrada sin ningún procesamiento o manipulación.

Lote Test