Operar · PUDO
Busca puntos sin aprender el contrato de cada red.
El Conector normaliza identificadores, dirección, tipo, coordenadas y distancia, y devuelve las condiciones que tu aplicación debe respetar.
/v1/carrier-connections/{connection_id}/pudo-pointsBuscar puntos cercanos
Envía country_code y un postal_code, o bien coordenadas completas. radius_km admite hasta 50 ylimit entre 1 y 25.
curl --get \
--url "$API_BASE_URL/v1/carrier-connections/11111111-1111-4111-8111-111111111111/pudo-points" \
--header "Authorization: Bearer $SENDINGBAY_API_TOKEN" \
--data-urlencode "country_code=ES" \
--data-urlencode "postal_code=28001" \
--data-urlencode "radius_km=10" \
--data-urlencode "limit=20"{
"carrier_code": "gls",
"points": [{
"provider_id": "GLS_ES-280010001",
"name": "Punto GLS Centro",
"point_type": "service_point",
"address_line1": "Calle Mayor 10",
"city": "Madrid",
"postal_code": "28001",
"country_code": "ES",
"latitude": 40.42,
"longitude": -3.70,
"distance_km": 0.8
}],
"usage_conditions": [
"La disponibilidad, el horario y la admisión dependen del transportista y pueden cambiar."
]
}/v1/shipmentsSeleccionar el punto
Devuelve el provider_id elegido como pudo_point_id en la petición habitual. El Conector vuelve a buscarlo desde el destino inmediatamente antes del alta y congela una instantánea en la respuesta y el histórico del envío.
curl --request POST \
--url "$API_BASE_URL/v1/shipments" \
--header "Authorization: Bearer $SENDINGBAY_API_TOKEN" \
--header "Content-Type: application/json" \
--header "Idempotency-Key: pedido-1000-pudo" \
--data '{
"carrier_connection_id": "11111111-1111-4111-8111-111111111111",
"article_code": "24",
"pudo_point_id": "GLS_ES-280010001",
"sender": { "name": "Tienda", "address_line1": "Origen 1", "city": "Madrid", "postal_code": "28002", "country_code": "ES" },
"recipient": { "name": "Cliente", "address_line1": "Mayor 10", "city": "Madrid", "postal_code": "28001", "country_code": "ES" },
"packages": [{ "weight_kg": 1.25 }]
}'Restricciones por red
| Red | Condición del adaptador |
|---|---|
| GLS | Dirección o coordenadas. El radio debe ser un número entero entre 1 y 50 km. |
| MRW | Solo España y búsqueda por código postal mediante GetPointsByCP. |
| DHL Express | Location Finder con providerType=express, serviceType=express:pick-up y API key independiente. |
| DHL eCommerce | Location Finder con providerType=parcel, serviceType=parcel:pick-up-all y API key independiente. |
Consulta el catálogo de transportistas antes de mostrar PUDO: implemented_disabled significa que el código existe, pero la conexión todavía no puede utilizarlo. Cuando figure como habilitado, verifica también enabled_environments y la configuración de tu conexión.
Uso y responsabilidad
- Usa el punto pronto; el Conector lo revalida, pero disponibilidad y horarios pueden cambiar.
- No interpretes ni fabriques el provider_id.
- Decide por el código estable del error y conserva correlation_id.
- No almacenes ni modifiques datos de DHL Location Finder. Su alta PUDO permanecerá bloqueada hasta certificar una solución compatible con esas condiciones.