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.

Obtener puntos de entrega cercanos

get

/locations

Obtiene los puntos de entrega/drop-off disponibles para una ubicación dada. Se puede buscar por (estado + ciudad) o por (latitud + longitud).

Autorizaciones

AuthorizationstringRequerido

Autenticación básica HTTP utilizando token como nombre de usuario y secret como contraseña

Parámetros de consulta

statestringOpcional

Nombre de la provincia/estado

citystringOpcional

Nombre de la ciudad (requerido con state)

latnumber · floatOpcional

Latitud (requerida con lng)

lngnumber · floatOpcional

Longitud (requerida con lat)

radiusintegerOpcional

Radio de búsqueda en metros (máx 200000)

carrier_idintegerOpcional

Filtrar por transportista

total_weightnumberOpcional

Peso total del envío

total_volumenumberOpcional

Volumen total del envío

package_countintegerOpcional

Número de paquetes

limitintegerOpcional

Número máximo de resultados (máx 50)

Default: 50

Respuestas

200

Lista de puntos de entrega

Sin contenido

400

Datos inválidos

404

No se encontraron puntos de entrega para la ubicación dada

get/locations

GET /v2/locations HTTP/1.1
Host: api.zipnova.com.ar
Authorization: Basic username:password
Accept: */*

Sin contenido

Buscar puntos de entrega con paquetes

post

/locations/search

Busca puntos de entrega compatibles con los paquetes especificados. Acepta (estado + ciudad) o (latitud + longitud).

Autorizaciones

AuthorizationstringRequerido

Autenticación básica HTTP utilizando token como nombre de usuario y secret como contraseña

Cuerpo

statestringOpcional

Nombre de la provincia/estado

Example: Buenos Aires

citystringOpcional

Nombre de la ciudad

Example: La Plata

latnumber · floatOpcional

Latitud

Example: -34.6037

lngnumber · floatOpcional

Longitud

Example: -58.3816

radiusintegerOpcional

Radio en metros (máx 200000)

Example: 5000

carrier_idintegerOpcional

ID del transportista

Example: 1

limitintegerOpcional

Máximo de resultados (máx 50)

Example: 10

Respuestas

200

Lista de puntos de entrega compatibles

Sin contenido

400

Datos inválidos

404

No se encontraron puntos de entrega para la ubicación dada

post/locations/search

POST /v2/locations/search HTTP/1.1
Host: api.zipnova.com.ar
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 175

{
  "state": "Buenos Aires",
  "city": "La Plata",
  "lat": -34.6037,
  "lng": -58.3816,
  "radius": 5000,
  "carrier_id": 1,
  "packages": [
    {
      "weight": 500,
      "height": 10,
      "width": 10,
      "length": 15
    }
  ],
  "limit": 10
}

Sin contenido

Puntos de entrega disponibles

get

/shipments/{shipment}/dropoff_locations

Obtiene los puntos de entrega (dropoff) disponibles para un envío con logística carrier_dropoff o xd_dropoff. Se puede filtrar por código postal o por ciudad y provincia/estado. Sin filtros, retorna las sucursales más cercanas al origen del envío.

Autorizaciones

AuthorizationstringRequerido

Autenticación básica HTTP utilizando token como nombre de usuario y secret como contraseña

Parámetros de ruta

shipmentintegerRequerido

ID del envío

Example: 1042

Parámetros de consulta

zipcodestringOpcional

Código postal para buscar sucursales cercanas. No usar junto con city/state

Example: 1043

citystringOpcional

Ciudad para buscar sucursales. Usar junto con state

Example: Buenos Aires

statestringOpcional

Provincia o estado para buscar sucursales. Usar junto con city

Example: Buenos Aires

Respuestas

200

Lista de puntos de entrega disponibles

application/json

400

El envío no tiene logística de tipo carrier_dropoff o xd_dropoff

403

Sin acceso a este envío

404

Envío no encontrado

get/shipments/{shipment}/dropoff_locations

GET /v2/shipments/{shipment}/dropoff_locations HTTP/1.1
Host: api.zipnova.com.ar
Authorization: Basic username:password
Accept: */*

{
  "data": [
    {
      "id": 55,
      "name": "Sucursal Palermo",
      "address": "Av. Santa Fe 3000",
      "city": "Buenos Aires",
      "state": "Buenos Aires",
      "zipcode": "1425",
      "lat": -34.5907,
      "lng": -58.4239
    }
  ]
}