Scheda dell'endpoint

POST /1.0/shipments/transit-time

Carrier-neutral shipment transit time

Shipments Rates POST

Endpoint

Scegli l'ambiente e l'indirizzo cambia con lui.

http://173.249.30.252/spedireweb/api/1.0/shipments/transit-time

Richiesta

Quelli segnati come necessari non si possono omettere.

3
Nome Dove Tipo Serve Descrizione
Authorization header string Sì Bearer access token. Example: Bearer <TOKEN>.
Accept header string Sì Expected response format.
Content-Type header string No Request body format when a JSON body is sent.
Authorization Serve
header string

Bearer access token. Example: Bearer <TOKEN>.

Accept Serve
header string

Expected response format.

Content-Type
header string

Request body format when a JSON body is sent.

Esempio richiesta

Metti il tuo token dove c'è scritto TOKEN.

cURL 
curl -X POST "http://173.249.30.252/spedireweb/api/1.0/shipments/transit-time" \
     -H "Authorization: Bearer <TOKEN>" \
     -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -d '{\"carrier\":\"poste_italiane\",\"context\":{\"scope\":1,\"environment\":1,\"courier_service_id\":1},\"filters\":{\"start_date\":\"2026-09-22T12:00:00Z\",\"product_codes\":[\"PBS\"],\"acceptance_channel\":\"SDA\",\"origin_postal_code\":\"88833\",\"destination_postal_code\":\"64010\"}}'

Corpo richiesta

{
    "carrier": "poste_italiane",
    "context": {
        "scope": 1,
        "environment": 1,
        "courier_service_id": 1
    },
    "filters": {
        "start_date": "2026-09-22T12:00:00Z",
        "product_codes": [
            "PBS"
        ],
        "acceptance_channel": "SDA",
        "origin_postal_code": "88833",
        "destination_postal_code": "64010"
    }
}

Risposta

Un blocco per ogni risposta che l'endpoint può dare.

9 

{
    "kind": "transit_time",
    "count": 1,
    "results": [
        {
            "product_code": "PBS",
            "transit_days": 4,
            "origin_region": "CALABRIA",
            "destination_region": "ABRUZZO",
            "estimated_delivery_at": "2026-09-26T12:00:00+00:00",
            "estimated_shipping_at": "2026-09-22T12:00:00+00:00"
        }
    ],
    "success": true,
    "provider": "poste_pdb"
}

{
    "error": {
        "code": "REQUEST_1001",
        "message": "Invalid request."
    },
    "success": false,
    "request_id": "req_01k5example000000000000000"
}

{
    "error": {
        "code": "AUTH_1001",
        "message": "Authentication required."
    },
    "success": false,
    "request_id": "req_01k5example000000000000000"
}

{
    "error": {
        "code": "AUTH_1003",
        "message": "Permission denied."
    },
    "success": false,
    "request_id": "req_01k5example000000000000000"
}

{
    "error": {
        "code": "APP_1004",
        "message": "Resource not found."
    },
    "success": false,
    "request_id": "req_01k5example000000000000000"
}

{
    "error": {
        "code": "VALIDATION_1001",
        "message": "Validation failed."
    },
    "success": false,
    "request_id": "req_01k5example000000000000000"
}

{
    "error": {
        "code": "RATE_LIMIT_1001",
        "message": "Too many requests."
    },
    "success": false,
    "request_id": "req_01k5example000000000000000"
}

{
    "error": {
        "code": "SERVER_1001",
        "message": "Internal server error."
    },
    "success": false,
    "request_id": "req_01k5example000000000000000"
}

{
    "error": {
        "code": "SERVER_1001",
        "message": "The selected carrier does not implement transit-time estimation."
    },
    "success": false,
    "request_id": "req_01k5example000000000000000"
}

Da sapere

Returns normalized estimated transit/delivery timing through the selected carrier adapter. Requires rates.compare. When shipment_id or order_token is used, the shipment must belong to the authenticated API-key owner. Provider-specific request fields stay inside the courier adapter. Requires a Bearer access token.

N questa pagina

Endpoint Richiesta Esempio richiesta Risposta Da sapere