FedEx - Obtener Tarifas

Descripción

Este modulo consulta las tarifas de envío disponibles en FedEx para un paquete dado. Recibe las direcciones de remitente y destinatario en formato JSON simplificado (código postal y pais), peso, dimensiones opcionales y tipo de servicio opcional. Realiza una petición POST al endpoint /rate/v1/rates/quotes y procesa la respuesta para extraer el tipo de servicio, nombre, precio, moneda, fecha de entrega estimada y dias de transito. Identifica automáticamente la tarifa mas economica.

Configuración

Parámetro	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Credencial FedEx (provider: fedex)
shipper	textarea	Si	Dirección del remitente en JSON (postalCode, countryCode)
recipient	textarea	Si	Dirección del destinatario en JSON (postalCode, countryCode)
package_weight	text	Si	Peso del paquete en kilogramos
package_dimensions	textarea	No	Dimensiones en JSON (length, width, height)
service_type	select	No	Filtrar por tipo de servicio especifico o dejar vacío para todos

Credenciales

Se requiere una credencial de tipo fedex con los siguientes campos:

client_id: Client ID de la API de FedEx
client_secret: Client Secret de la API de FedEx
account_number: Número de cuenta de FedEx

Salida

{
  "success": true,
  "rates": [
    {
      "service_type": "FEDEX_INTERNATIONAL_PRIORITY",
      "service_name": "FedEx International Priority",
      "price": "52.30",
      "currency": "EUR",
      "delivery_timestamp": "2026-03-25",
      "transit_days": "2"
    }
  ],
  "rates_count": 5,
  "cheapest": {
    "service_type": "FEDEX_GROUND",
    "service_name": "FedEx Ground",
    "price": "15.20",
    "currency": "EUR"
  },
  "message": "5 tarifas FedEx obtenidas"
}

Ejemplo de Uso

Caso básico

{
  "credentials_id": "mi_credencial_fedex",
  "shipper": "{\"postalCode\":\"28001\",\"countryCode\":\"ES\"}",
  "recipient": "{\"postalCode\":\"08001\",\"countryCode\":\"ES\"}",
  "package_weight": "2.0"
}

API Utilizada

Endpoint: POST /rate/v1/rates/quotes
Base: FedEx API (via helper _fedexHelper)
Documentación: https://developer.fedex.com/api/en-us/catalog.html

Notas

Si no se especifica tipo de servicio, se devuelven todas las opciones disponibles
El tipo de recogida se configura como DROPOFF_AT_FEDEX_LOCATION
Las dimensiones son opcionales y se expresan en centimetros
El campo cheapest identifica automáticamente la tarifa mas barata