Punti di consegna

GET /delivery-points cerca i punti presso cui il destinatario può ritirare il pacco: i punti BRT e i punti Poste (Punto Poste, Locker, Ufficio Postale).

Punti Poste

Richiede un contratto Poste Delivery Business Express o Standard.


curl "https://demo.spedisci.online/api/2026-09/delivery-points?carrier=poste&type=puntoposte&postalCode=00144" \
    -H "Authorization: Bearer <access_token>"

Parametro	Obbligatorio	Valori
`carrier`	Sì	`poste`
`type`	Sì	`puntoposte` (Punto Poste), `locker` (Punto Poste Locker), `ufficio` (Ufficio Postale)
`postalCode`	Sì	CAP attorno al quale cercare


{
  "data": [
    {
      "type": "puntoposte",
      "code": "API25",
      "name": "TABACCHERIA ROSSI",
      "address": "VIALE EUROPA 10",
      "postalCode": "00144",
      "city": "ROMA",
      "province": "RM",
      "lat": 41.8301,
      "lng": 12.4672,
      "hours": {
        "weekdays": { "open": "08:00", "close": "19:30" },
        "saturday": { "open": "08:00", "close": "13:00" }
      },
      "saturation": 20
    }
  ]
}

saturation è la percentuale di riempimento del punto, quando Poste la comunica.

Usare il punto nella spedizione

Passa il punto scelto in options.deliveryPoint di POST /shipments:


{
  "options": {
    "deliveryPoint": { "type": "puntoposte", "code": "API25", "postalCode": "00144" }
  }
}

Campo	Note
`type`	Lo stesso tipo usato nella ricerca
`code`	Il `code` del punto restituito dalla ricerca
`postalCode`	Il CAP usato nella ricerca; se omesso vale il CAP del destinatario

L’etichetta riporta l’indirizzo del punto; nome, telefono ed e-mail restano quelli del destinatario. La spedizione creata restituisce il punto nel campo deliveryPoint.

Limiti

Punto	Contrassegno	Più colli	Limiti del collo
Punto Poste	No	No	Entro 36×37×56 cm e 15 kg
Locker	No	No	Entro 36×37×56 cm e 15 kg
Ufficio Postale	Sì	Sì	Somma dei lati entro 150 cm, lato più lungo entro 100 cm, entro 30 kg

La consegna presso un punto è disponibile solo per l’Italia e non è compatibile con il servizio Andata & Ritorno. Le combinazioni non ammesse sono respinte prima di chiamare Poste, con 422.

Punti BRT


curl "https://demo.spedisci.online/api/2026-09/delivery-points?postalCode=20100&city=Milano&address=Via%20Roma%201" \
    -H "Authorization: Bearer <access_token>"

Parametro	Obbligatorio
`postalCode`	Sì
`city`	Sì
`address`	No
`carrier`	No: `brt` è il valore predefinito

Per BRT il campo data contiene la risposta del corriere così come viene ricevuta.

Errori

Risposta	Significato
`422 validation_failed`	Parametri mancanti o contratto non adatto
`502 carrier_error`	Il corriere non risponde