Este endpoint te permite obtener rápidamente cotizaciones de tarifas de envío proporcionando from_address_data, to_address_data, package_data y la ship_date.
Cada llamada a la API puede incluir hasta 10 solicitudes de tarifa individuales.
Anteriormente, este endpoint solo devolvía tarifas para USPS Ground Advantage. Con la nueva actualización, puedes especificar opcionalmente transportistas y niveles de servicio adicionales mediante el campo shipment_rate_carrier_data. En el esquema de la solicitud encontrarás una explicación detallada sobre cómo utilizar este parámetro.
Si se omite
shipment_rate_carrier_data: El sistema devolverá tarifas solo para USPS Ground Advantage (comportamiento predeterminado).Si se proporciona
shipment_rate_carrier_data: El sistema devolverá tarifas únicamente para los proveedores y niveles de servicio especificados. Pueden enviarse varias combinaciones en una sola solicitud.
curl -i -X POST \
https://x-api.shipsaving.com/api/shipment/batch/quick_rate \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"rate_requests": [
{
"request_unique_id": "unique_uuid_001",
"from_address_data": {
"first_name": "Alice",
"last_name": "Green",
"company_name": "ShipSaving",
"phone": "1234567890",
"email": "it@shipsaving.com",
"street": "xxxx Olive Street",
"street2": "STE XXX",
"city": "Los Angeles",
"state": "CA",
"zip_code": "021XX",
"country": "US"
},
"to_address_data": {
"first_name": "Alice",
"last_name": "Green",
"company_name": "ShipSaving",
"phone": "1234567890",
"email": "it@shipsaving.com",
"street": "xxxx Olive Street",
"street2": "STE XXX",
"city": "Los Angeles",
"state": "CA",
"zip_code": "021XX",
"country": "US",
"address_type": "residential"
},
"package_data": {
"type": "my_package",
"length": 10,
"width": 10,
"height": 10,
"weight": 10,
"carrier_package_code": "USPS_SMALL_FLAT_RATE_BOX",
"dimension_unit": "in",
"weight_unit": "lb"
},
"option_data": {
"signature": "signature",
"custom_text_on_label_1": "Por favor, deja el paquete en el casillero.",
"custom_text_on_label_2": "Por favor, deja el paquete en el casillero.",
"hazardous_materials": true,
"is_lithium_battery": false,
"additional_handling": false,
"require_saturday_delivery": false
},
"ship_date": "2025-07-31T00:00:00+08:00",
"is_return_label": false,
"shipment_rate_carrier_data": [
{
"provider_id": "USPS_X",
"service_levels": [
"USPS_GROUND_ADVANTAGE"
]
}
]
}
]
}'