Ritiri e chiusura giornata

Prenotare un ritiro – `POST /pickups`


{
  "serviceType": "<contractCode ricevuto da /rates>",
  "pickupDate": "2026-10-05",
  "pickupTime": "AM",
  "instructions": "Citofonare magazzino",
  "warehouseId": 19,
  "packages": [
    {
      "weight": { "value": 5, "units": "KG" },
      "dimensions": { "length": 40, "width": 30, "height": 30, "units": "CM" }
    }
  ]
}

Campo	Obbligatorio	Note
`serviceType`	Sì	Il `contractCode` del contratto con cui prenotare
`pickupDate`	Sì	Data del ritiro (`AAAA-MM-GG`)
`packages[]`	Sì	I colli da ritirare
`pickupTime`	No	Fascia oraria, ad esempio `AM`, `PM`, `AMPM` (predefinita)
`warehouseId`	No	Punto di ritiro presso cui prenotare; se omesso vale quello predefinito
`shipper`	Solo senza `warehouseId`	Indirizzo presso cui ritirare
`shipmentId`	No	Numero di spedizione di riferimento
`instructions`	No	Note per il corriere

La risposta 201 è il ritiro registrato, con l’identificativo del corriere in pickupId e il costo in cost.

Un ritiro prenotato da un punto con ritiro gratuito approvato non viene addebitato: il costo è zero e nessun movimento compare nel credito.

Elenco e dettaglio dei ritiri

GET /pickups – i ritiri richiesti, degli ultimi 30 giorni se non indichi from e to.
GET /pickups/{id} – il dettaglio di un ritiro.

Chiusura giornata – `POST /manifests`

La chiusura giornata crea la distinta (borderò) da consegnare al corriere. Indica le spedizioni da includere per id oppure per numero di spedizione:


{ "trackingNumbers": ["3UW0WTQ069239", "3UW0WTQ069240"] }

oppure


{ "shipmentIds": [48210, 48211] }

Regole:

viene creata una distinta per contratto: spedizioni di contratti diversi finiscono in distinte diverse;
sono incluse solo le spedizioni del tuo account non ancora in distinta.

Risposta 201:


{
  "data": [
    {
      "id": 183,
      "carrier": { "code": "poste", "name": "Poste Delivery Business" },
      "totalShipments": 2,
      "totalCost": 16.84,
      "createdAt": "2026-09-30T18:02:11+02:00",
      "pdf": "<base64>"
    }
  ]
}

Il PDF della distinta è in base64.

Una spedizione in distinta non può più essere annullata con DELETE /shipments/{ldv}.

Elenco e dettaglio delle distinte

GET /manifests – le distinte del periodo (from, to).
GET /manifests/{id} – il dettaglio; con ?pdf=1 include il PDF in base64.