Centro de ayudaGitHub

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