A continuación se presenta la lógica de funcionamiento de los Web Services de carga de envíos presentado por Correo Uruguayo para su plataforma Ahíva, así como las herramientas para trabajar con esta interfaz y el servicio de consulta de trazabilidad de envíos de Ahiva. Se publica documentación adjunta a continuación.

El servicio de búsqueda de direcciones devuelve el conjunto de direcciones que cumplen los criterios de búsqueda. Estas direcciones están compuestas por el nombre de la calle, el número de puerta, manzana, solar, localidad, departamento, código postal, ubicación geográfica (punto en SRID 4326), entre otros.

El servicio de búsqueda de códigos postales retorna la calle bien escrita junto con su código postal para los filtros pasados por parámetro (calle, localidad y departamento).

El servicio de sugerencia de calles devuelve el conjunto de calles que cumple con el criterio de búsqueda (parámetro entrada), con el formato “calle, localidad, departamento” y ordenadas según la cantidad de direcciones asociadas a la calle de forma descendente. Este servicio es utilizado usualmente para el autocompletado de campos de dirección.

El servicio de de seguimiento de envíos devuelve el recorrido de un paquete internacional o nacional, desde la ciudad de origen a la de destino. Los datos los obtiene de Track & Trace e IPS.

El servicio de localidades devuelve la lista de localidades del departamento pasado por parámetro.

El servicio de direcciones buffer devuelve la lista de puntos, dado un par de coordenadas (x,y), el srs asociado y una distancia en metros (d), devuelve los puntos encontrados dentro del círculo de centro (x,y) y radio d.