Consulta de Maestros de Calles
Consulta de Maestros de Calles
Descripción General
Consideraciones generales
El cliente debe enviar una estructura de consulta de maestros según lo detallado en el apartado «Atributos de entrada» debiendo completar mínimamente los campos que se detallan a continuación:
- leve1
- level2
- level3
- level4
- postalCode
- stringSearch
- clientAccessCode
El resultado de este proceso será una estructura de datos detallada en el apartado «Atributos de salida»
Atributos de entrada
| Atributo | Longitud Máxima | Descripción |
| 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. |
| customAdaptersKeys | 64 | Adaptadores de respuesta. Para más información ver «Adaptadores de respuesta». |
| level1 | 64 | Corresponde al primer nivel (País) administrativo de una dirección (AR,CL,MX,EC,UY,ES,PE). 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». |
| listSegments | 4 | Flag booleano que habilita el detalle de segmentos que componen la calle. Por ejemplo: el valor true para habilitar el listado de tramos de la calle. |
| postalCode | 64 | Código postal de la dirección. Si se informa le level4 no es necesario ingresarlo y viceversa. |
| street | 64 | Corresponde a la calle, barrio zonal, barrio privado, lugar o punto de interés que se desea consultar. |
Atributos de salida
| Atributo | Longitud Máxima | Descripción |
| status | 3 | Indica el estado de normalización y/o validación. Para más información ver «Estados y Motivos». |
| statusReason | 2 | Indica la razón con referencia al estado de normalización y/o validación. Para más información ver «Estados y Motivos». |
| transactionId | 10 | Merlin asigna un id de transacción por consulta. |
| totalRecords | 16 | Créditos restantes del usuario. |
| mSuggest | – | Listado de calles con su respectivo parseo. |
| level1 | 64 | Corresponde al primer nivel (País) administrativo de una dirección. Para más información ver «Niveles administrativos». |
| level2 | 12 | 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 | 5 | 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 Zonal. Para más información ver «Niveles administrativos». |
| suggestedItem | 64 | Indica calle, barrio zonal, barrio privado, lugar o punto de interés que se sugiere. |
| postalCode | 64 | Código postal de la dirección informada. |
| streetNumberFrom | 64 | Altura inicial de la calle informada. |
| streetNumberTo | 64 | Altura final de la calle informada. |
|
synonymous
|
||
| segmentList | – | Retornará N-veces la lista de tramos correspondiente a la calle. |
| postalCode | 3 | Código postal del segmento encontrado. |
| latitude | 10 | Coordenada Y de georeferenciación. |
| longitude | 10 | Coordenada X de georeferenciación. |
| initialStreetSegment | 10 | Altura inicial del segmento informado |
| endStreetSegment | 10 | Altura final del segmento informado |
| merlinCustomValues | – | Parámetros opcionales indicados en customAdapterKeys [], proveídos por Merlin o desarrollados por demanda del cliente, como ser shortStreet. |
Para ver más detalles de los WebServices:
Formato de mensajería JSON
Formato de mensajería SOAP