# 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).

{% hint style="info" %}
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.
{% endhint %}

## Obtener puntos de entrega cercanos

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

```json
{"openapi":"3.0.0","info":{"title":"Zipnova Shipping API V2","version":"2.0.0"},"tags":[{"name":"Ubicaciones de transportes","description":"Búsqueda de ubicaciones de transportes"}],"servers":[{"url":"https://api.zipnova.com.ar/v2","description":"v2 API - Argentina (AR)"},{"url":"https://api.zipnova.cl/v2","description":"v2 API - Chile (CL)"},{"url":"https://api.zipnova.com.mx/v2","description":"v2 API - México (MX)"}],"security":[{"basicAuth":[]},{"bearerAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"type":"http","description":"Autenticación básica HTTP utilizando token como nombre de usuario y secret como contraseña","scheme":"basic"},"bearerAuth":{"type":"http","description":"Token de autenticación Bearer OAuth para API V2","bearerFormat":"OAuth","scheme":"bearer"}}},"paths":{"/locations":{"get":{"tags":["Ubicaciones de transportes"],"summary":"Obtener puntos de entrega cercanos","description":"Obtiene los puntos de entrega/drop-off disponibles para una ubicación dada. Se puede buscar por (estado + ciudad) o por (latitud + longitud).","operationId":"895c78bd22897de1e3989b428733d34a","parameters":[{"name":"state","in":"query","description":"Nombre de la provincia/estado","required":false,"schema":{"type":"string"}},{"name":"city","in":"query","description":"Nombre de la ciudad (requerido con state)","required":false,"schema":{"type":"string"}},{"name":"lat","in":"query","description":"Latitud (requerida con lng)","required":false,"schema":{"type":"number","format":"float"}},{"name":"lng","in":"query","description":"Longitud (requerida con lat)","required":false,"schema":{"type":"number","format":"float"}},{"name":"radius","in":"query","description":"Radio de búsqueda en metros (máx 200000)","required":false,"schema":{"type":"integer"}},{"name":"carrier_id","in":"query","description":"Filtrar por transportista","required":false,"schema":{"type":"integer"}},{"name":"total_weight","in":"query","description":"Peso total del envío","required":false,"schema":{"type":"number"}},{"name":"total_volume","in":"query","description":"Volumen total del envío","required":false,"schema":{"type":"number"}},{"name":"package_count","in":"query","description":"Número de paquetes","required":false,"schema":{"type":"integer"}},{"name":"limit","in":"query","description":"Número máximo de resultados (máx 50)","required":false,"schema":{"type":"integer","default":50}}],"responses":{"200":{"description":"Lista de puntos de entrega"},"400":{"description":"Datos inválidos"},"404":{"description":"No se encontraron puntos de entrega para la ubicación dada"}}}}}}
```

## Buscar puntos de entrega con paquetes

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

```json
{"openapi":"3.0.0","info":{"title":"Zipnova Shipping API V2","version":"2.0.0"},"tags":[{"name":"Ubicaciones de transportes","description":"Búsqueda de ubicaciones de transportes"}],"servers":[{"url":"https://api.zipnova.com.ar/v2","description":"v2 API - Argentina (AR)"},{"url":"https://api.zipnova.cl/v2","description":"v2 API - Chile (CL)"},{"url":"https://api.zipnova.com.mx/v2","description":"v2 API - México (MX)"}],"security":[{"basicAuth":[]},{"bearerAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"type":"http","description":"Autenticación básica HTTP utilizando token como nombre de usuario y secret como contraseña","scheme":"basic"},"bearerAuth":{"type":"http","description":"Token de autenticación Bearer OAuth para API V2","bearerFormat":"OAuth","scheme":"bearer"}}},"paths":{"/locations/search":{"post":{"tags":["Ubicaciones de transportes"],"summary":"Buscar puntos de entrega con paquetes","description":"Busca puntos de entrega compatibles con los paquetes especificados. Acepta (estado + ciudad) o (latitud + longitud).","operationId":"fc23cc6d6712e2667d2a7c046fda1333","requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"state":{"description":"Nombre de la provincia/estado","type":"string"},"city":{"description":"Nombre de la ciudad","type":"string"},"lat":{"description":"Latitud","type":"number","format":"float"},"lng":{"description":"Longitud","type":"number","format":"float"},"radius":{"description":"Radio en metros (máx 200000)","type":"integer"},"carrier_id":{"description":"ID del transportista","type":"integer"},"packages":{"description":"Lista de paquetes","type":"array","items":{"properties":{"weight":{"type":"number"},"height":{"type":"number"},"width":{"type":"number"},"length":{"type":"number"}},"type":"object"}},"limit":{"description":"Máximo de resultados (máx 50)","type":"integer"}},"type":"object"}}}},"responses":{"200":{"description":"Lista de puntos de entrega compatibles"},"400":{"description":"Datos inválidos"},"404":{"description":"No se encontraron puntos de entrega para la ubicación dada"}}}}}}
```

## Puntos de entrega disponibles

> 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.

```json
{"openapi":"3.0.0","info":{"title":"Zipnova Shipping API V2","version":"2.0.0"},"tags":[{"name":"Envíos","description":"Gestión de envíos y tracking"}],"servers":[{"url":"https://api.zipnova.com.ar/v2","description":"v2 API - Argentina (AR)"},{"url":"https://api.zipnova.cl/v2","description":"v2 API - Chile (CL)"},{"url":"https://api.zipnova.com.mx/v2","description":"v2 API - México (MX)"}],"security":[{"basicAuth":[]},{"bearerAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"type":"http","description":"Autenticación básica HTTP utilizando token como nombre de usuario y secret como contraseña","scheme":"basic"},"bearerAuth":{"type":"http","description":"Token de autenticación Bearer OAuth para API V2","bearerFormat":"OAuth","scheme":"bearer"}}},"paths":{"/shipments/{shipment}/dropoff_locations":{"get":{"tags":["Envíos"],"summary":"Puntos de entrega disponibles","description":"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.","operationId":"aa248dc7b6c83e2b37464ae6df710a7a","parameters":[{"name":"shipment","in":"path","description":"ID del envío","required":true,"schema":{"type":"integer"}},{"name":"zipcode","in":"query","description":"Código postal para buscar sucursales cercanas. No usar junto con city/state","required":false,"schema":{"type":"string"}},{"name":"city","in":"query","description":"Ciudad para buscar sucursales. Usar junto con state","required":false,"schema":{"type":"string"}},{"name":"state","in":"query","description":"Provincia o estado para buscar sucursales. Usar junto con city","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Lista de puntos de entrega disponibles","content":{"application/json":{"schema":{"properties":{"data":{"type":"array","items":{"properties":{"id":{"description":"ID del punto de entrega","type":"integer"},"name":{"description":"Nombre de la sucursal","type":"string"},"address":{"description":"Dirección de la sucursal","type":"string"},"city":{"description":"Ciudad","type":"string"},"state":{"description":"Provincia o estado","type":"string"},"zipcode":{"description":"Código postal","type":"string","nullable":true},"lat":{"description":"Latitud geográfica","type":"number","format":"float","nullable":true},"lng":{"description":"Longitud geográfica","type":"number","format":"float","nullable":true}},"type":"object"}}},"type":"object"}}}},"400":{"description":"El envío no tiene logística de tipo carrier_dropoff o xd_dropoff"},"403":{"description":"Sin acceso a este envío"},"404":{"description":"Envío no encontrado"}}}}}}
```