EasyPost - Obtener Tarifas

Descripcion

Este modulo obtiene tarifas de envio de multiples transportistas creando un Shipment en EasyPost. Recibe las direcciones de origen y destino en formato JSON junto con las especificaciones del paquete (dimensiones en pulgadas, peso en onzas). Realiza una peticion POST al endpoint /shipments y procesa la respuesta para extraer las tarifas disponibles con ID, transportista, servicio, precio, moneda, dias de entrega y fecha estimada. Identifica automaticamente la tarifa mas economica y la mas rapida.

Configuracion

Parametro	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Credencial EasyPost (provider: easypost)
from_address	textarea	Si	Direccion de origen en JSON (name, street1, city, state, zip, country)
to_address	textarea	Si	Direccion de destino en JSON (name, street1, city, state, zip, country)
parcel	textarea	Si	Paquete en JSON (length, width, height en pulgadas; weight en onzas)

Credenciales

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

api_key: API Key de EasyPost

Salida

{
  "success": true,
  "shipment_id": "shp_abc123",
  "rates": [
    {
      "rate_id": "rate_abc123",
      "carrier": "USPS",
      "service": "Priority",
      "rate": "7.58",
      "currency": "USD",
      "delivery_days": 2,
      "delivery_date": "2026-03-25",
      "est_delivery_days": 2
    }
  ],
  "rates_count": 8,
  "cheapest": {
    "rate_id": "rate_def456",
    "carrier": "USPS",
    "service": "First",
    "rate": "4.50",
    "currency": "USD"
  },
  "fastest": {
    "rate_id": "rate_ghi789",
    "carrier": "FedEx",
    "service": "FEDEX_2_DAY",
    "rate": "15.20",
    "delivery_days": 1
  },
  "message": "8 tarifas obtenidas"
}

Ejemplo de Uso

Caso basico

{
  "credentials_id": "mi_credencial_easypost",
  "from_address": "{\"name\":\"Mi Empresa\",\"street1\":\"123 Main St\",\"city\":\"San Francisco\",\"state\":\"CA\",\"zip\":\"94105\",\"country\":\"US\"}",
  "to_address": "{\"name\":\"Cliente\",\"street1\":\"456 Oak Ave\",\"city\":\"Los Angeles\",\"state\":\"CA\",\"zip\":\"90001\",\"country\":\"US\"}",
  "parcel": "{\"length\":10,\"width\":8,\"height\":4,\"weight\":16}"
}

API Utilizada

Endpoint: POST /shipments
Base: EasyPost API (via helper _easypostHelper)
Documentacion: https://www.easypost.com/docs/api

Notas

Las dimensiones del paquete se expresan en pulgadas y el peso en onzas
El shipment_id retornado es necesario para comprar una tarifa con el nodo Comprar Envio
EasyPost agrega transportistas conectados a tu cuenta, incluyendo USPS, FedEx, UPS y otros
Los campos cheapest y fastest se calculan automaticamente