Envia.com - Obtener Tarifas

Descripción

Este modulo obtiene cotizaciones de envío de múltiples transportistas a traves de Envia.com. Recibe los datos de origen y destino en formato JSON y los paquetes como array JSON con peso en kg y dimensiones en cm. Realiza una petición POST al endpoint /ship/rate/ y procesa la respuesta para extraer las tarifas de cada transportista con carrier, servicio, ID de tarifa, precio, moneda, dias de entrega y estimación. Identifica automáticamente la tarifa mas economica.

Configuración

Parámetro	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Credencial Envia.com (provider: envia)
origin	textarea	Si	Datos de origen en JSON (name, street, city, state, zip, country)
destination	textarea	Si	Datos de destino en JSON
packages	textarea	Si	Array de paquetes en JSON (content, amount, weight, length, width, height)

Credenciales

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

• api_key: API Key de Envia.com

Salida

{
  "success": true,
  "rates": [
    {
      "carrier": "fedex",
      "service": "express",
      "rate_id": "rate_123",
      "price": "250.00",
      "currency": "MXN",
      "delivery_days": 2,
      "delivery_estimate": "2026-03-25"
    }
  ],
  "rates_count": 6,
  "cheapest": {
    "carrier": "estafeta",
    "service": "ground",
    "price": "120.00",
    "currency": "MXN"
  },
  "message": "6 cotizaciones obtenidas"
}

Ejemplo de Uso

Caso básico

{
  "credentials_id": "mi_credencial_envia",
  "origin": "{\"name\":\"Mi Empresa\",\"street\":\"Reforma 222\",\"city\":\"Ciudad de Mexico\",\"state\":\"DF\",\"zip\":\"06600\",\"country\":\"MX\"}",
  "destination": "{\"name\":\"Cliente\",\"street\":\"Av Juarez 100\",\"city\":\"Guadalajara\",\"state\":\"JA\",\"zip\":\"44100\",\"country\":\"MX\"}",
  "packages": "[{\"content\":\"Producto\",\"amount\":1,\"weight\":2,\"length\":25,\"width\":15,\"height\":10}]"
}

API Utilizada

• Endpoint: POST /ship/rate/
• Base: Envia.com API (via helper _enviaHelper)
• Documentación: https://docs.envia.com/

Notas

• Las cotizaciones incluyen todos los transportistas habilitados en tu cuenta de Envia.com
• La moneda por defecto es MXN (pesos mexicanos)
• El peso se expresa en kilogramos y las dimensiones en centimetros
• Los paquetes se envian siempre como array

Nodos Relacionados

• Envia.com - Crear Envío / Etiqueta (enviaCreateShipment)
• Envia.com - Rastrear Envío (enviaGetTracking)
• Envia.com - Cancelar Envío (enviaCancelShipment)
• Envia.com - Listar Transportistas (enviaGetCarriers)