Ubicaciones

Puntos de despacho

Utiliza los siguientes recursos para obtener los puntos de despacho disponibles cerca de una ubicación determinada, por medio de “city” y “state” o “lat” (latitud) y “lng” (longitud).

Ten en cuenta que no todos los puntos admiten todos los envíos. Según el punto puede que solo se acepten envíos de un transporte determinado, y que el tamaño o peso de los paquetes esté restringido por cuestiones de espacio u operacionales.

Listado de puntos de despacho

GET /v2/locations

En ésta búsqueda simple se puede indicar una ubicación, distancia, y restricciones. Al indicar la ubicación se debe hacer con city-state o bien latitud-longitud (no ambas).

Query Parameters

Name	Type	Description
city*	string	Requerido si está state Nombre de la ciudad AR: localidad (ej. Avellaneda CL: comuna (ej. Las Condes) MX: municipio (ej. Alvaro Obregón)
state*	string	Requerido si está city Nombre del Estado del domicilio del destinatario. AR: provincia (ej. Buenos Aires) CL: región (ej. RM) MX: estado (ej. Distrito Federal)
lat*	decimal	Requerido si está lng Latitud de la región o zona a buscar
lng*	decimal	Requerido si está lng Longitud de la región o zona a buscar
radius	int	Radio de la zona de búsqueda para filtrado (en metros)
carrier_id	int	id del transporte a filtrar
total_weight	int	Peso total en gramos que acepte los carrier para el filtrado
total_volume	int	Volumen total en centímetros cúbicos que acepte el carrier para el filtrado
package_count	int	Cantidad de paquetes del envío para el filtrado

200: OK Listado de ubicaciones

GET /v2/locations?lat=-34.4728044&lng=-58.513802&radius=20000

[
	{
		"name": "Agente Oficial - Canga Mariano",
		"carrier": {
			"id": 208,
			"name": "OCA"
		},
		"default_logistic_type": "carrier_dropoff",
		"address": {
			"street": "Centenario",
			"street_number": "189",
			"street_extras": null,
			"city": "San Isidro",
			"state": "Buenos Aires",
			"geolocation": {
				"lat": -34.472654,
				"lng": -58.514024
			}
		},
		"restrictions": {
			"max_shipment_volume": null,
			"max_shipment_weight": 25000,
			"max_package_volume": null,
			"max_package_weight": 25000,
			"max_package_dimension_sum": 250,
			"max_package_dimension": 150,
			"max_package_count": 1
		}
	},
	{
		"name": "Correo Argentino - S Isidro Labrador Turismo",
		"carrier": {
			"id": 233,
			"name": "Correo Argentino"
		},
		"default_logistic_type": "carrier_dropoff",
		"address": {
			"street": "Av Centenario",
			"street_number": "189",
			"street_extras": null,
			"city": "San Isidro",
			"state": "Buenos Aires",
			"geolocation": {
				"lat": -34.4726539,
				"lng": -58.5140243
			}
		},
		"restrictions": {
			"max_shipment_volume": null,
			"max_shipment_weight": 25000,
			"max_package_volume": null,
			"max_package_weight": 25000,
			"max_package_dimension_sum": 250,
			"max_package_dimension": 150,
			"max_package_count": 1
		}
	}
]

Búsqueda de puntos de despacho

POST /v2/locations/search

En ésta búsqueda avanzada se puede indicar una ubicación, distancia, y restricciones, con mayor nivel de detalle. Al indicar la ubicación se debe hacer con city-state o bien latitud-longitud (no ambas).

Request Body

Name	Type	Description
city*	string	Requerido si está state Nombre de la ciudad AR: localidad (ej. Avellaneda CL: comuna (ej. Las Condes) MX: municipio (ej. Alvaro Obregón)
state*	string	Requerido si está city Nombre del Estado del domicilio del destinatario. AR: provincia (ej. Buenos Aires) CL: región (ej. RM) MX: estado (ej. Distrito Federal)
lat*	decimal	Requerido si está lng Latitud de la región o zona a buscar
lng*	decimal	Requerido si está lng Longitud de la región o zona a buscar
radius	int	Radio de la zona de búsqueda para filtrado (en metros)
carrier_id	int	ID del transporte a filtrar
packages*	array	Array de packages. Mínimo un package
packages.*.width*	int	Ancho del paquete, en cm.
packages.*.weight*	int	Peso del paquete, en gramos
packages.*.length*	int	Largo del paquete, en cm.
packages.*.height*	int	Alto del paquete, en cm.

200: OK Listado de ubicaciones

curl --request POST \
  --url http://api.zippin.com.ar/v2/locations/search \
  --header 'Content-Type: application/json' \
  --data '{
	"lat": -34.466666666667,
	"lng": -58.516666666667,
	"radius": 25000,
	"packages": [
		{
			"weight": 50000,
			"height": 20,
			"length": 20,
			"width": 20
		}
	]
}'

[
	{
		"name": "Agente Oficial - Canga Mariano",
		"carrier": {
			"id": 208,
			"name": "OCA"
		},
		"default_logistic_type": "carrier_dropoff",
		"address": {
			"street": "Centenario",
			"street_number": "189",
			"street_extras": null,
			"city": "San Isidro",
			"state": "Buenos Aires",
			"geolocation": {
				"lat": -34.472654,
				"lng": -58.514024
			}
		},
		"restrictions": {
			"max_shipment_volume": null,
			"max_shipment_weight": 25000,
			"max_package_volume": null,
			"max_package_weight": 25000,
			"max_package_dimension_sum": 250,
			"max_package_dimension": 150,
			"max_package_count": 1
		}
	},
	{
		"name": "Correo Argentino - S Isidro Labrador Turismo",
		"carrier": {
			"id": 233,
			"name": "Correo Argentino"
		},
		"default_logistic_type": "carrier_dropoff",
		"address": {
			"street": "Av Centenario",
			"street_number": "189",
			"street_extras": null,
			"city": "San Isidro",
			"state": "Buenos Aires",
			"geolocation": {
				"lat": -34.4726539,
				"lng": -58.5140243
			}
		},
		"restrictions": {
			"max_shipment_volume": null,
			"max_shipment_weight": 25000,
			"max_package_volume": null,
			"max_package_weight": 25000,
			"max_package_dimension_sum": 250,
			"max_package_dimension": 150,
			"max_package_count": 1
		}
	}
]