Obtener tarifas
Devuelve las tarifas de envío disponibles para un envío de varios transportistas, ordenadas por precio.
Parámetros
Cuerpo de la solicitud
from_address
object
Obligatorio
Dirección de origen (ID u object en línea)
to_address
object
Obligatorio
Dirección de destino (ID u object en línea)
parcel
object
Obligatorio
Dimensiones y peso del paquete. Obligatorio para un cálculo preciso de la tarifa.
Puede ser un ID de parcel existente o un object en línea con las dimensiones.
carrier_account_ids
array
Filtrar las tarifas por IDs de cuentas de transportista específicas (recomendado).
Tiene prioridad sobre el parámetro `carriers`.
Use esto para elegir entre las cuentas del sistema y sus cuentas BYOCA.
Obtenga las cuentas disponibles con `GET /v1/carrier-accounts`.
carriers
array
Filtrar las tarifas por nombre de transportista (por ejemplo, USPS, FEDEX).
Se ignora si se proporciona `carrier_account_ids`.
Nota: Si tiene varias cuentas del mismo transportista (sistema + BYOCA),
use `carrier_account_ids` para un control preciso.
services
array
Filtrar las tarifas por servicio. Se aceptan ambos formatos:
- Nombres de servicio: "Priority Mail", "UPS Ground"
- Códigos de servicio: "usps_priority", "ups_ground"
options
object
ship_date
string
Fecha de envío,
YYYY-MM-DD o una marca de tiempo ISO 8601 con desplazamiento horario (2026-09-12T09:00:00-07:00; con T pero sin desplazamiento se rechaza). Las tarifas que dependen del día de la semana (por ejemplo, entrega en sábado) se calculan sobre ella. Al comprar hay que enviar el mismo valor a POST /v1/labels; la cotización no lo arrastra. Si no necesitas una fecha futura, omite este campo.Devuelve
200
Tarifas calculadas correctamente
400
Datos de la solicitud no válidos
401
Autenticación requerida
404
Dirección no encontrada
Relacionado
Labels
POST/api/v1/rates