Envia.com - Obtener Tarifas

Descripcion

Este modulo obtiene cotizaciones de envio de multiples 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 peticion 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 estimacion. Identifica automaticamente la tarifa mas economica.

Configuracion

Parametro	Tipo	Requerido	Descripcion
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 basico

{
  "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)
• Documentacion: 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 Envio / Etiqueta (enviaCreateShipment)
• Envia.com - Rastrear Envio (enviaGetTracking)
• Envia.com - Cancelar Envio (enviaCancelShipment)
• Envia.com - Listar Transportistas (enviaGetCarriers)