Envia.com - Crear Envio / Etiqueta

Descripcion

Este modulo crea un envio en Envia.com y genera la guia/etiqueta correspondiente. Recibe los datos de origen y destino en formato JSON, los paquetes como array JSON, el nombre del transportista y el tipo de servicio. Realiza una peticion POST al endpoint /ship/generate/ y retorna el ID del envio, numero de seguimiento, URL de rastreo, URL de la etiqueta, transportista, servicio y estado. Envia.com es un agregador de envios enfocado en Latinoamerica.

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, phone, email)
destination	textarea	Si	Datos de destino en JSON
packages	textarea	Si	Array de paquetes en JSON con dimensiones y peso
carrier	text	Si	Nombre del transportista (ej: fedex, dhl, estafeta)
service	text	Si	Tipo de servicio del transportista

Credenciales

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

• api_key: API Key de Envia.com

Las credenciales se obtienen desde el panel de Envia.com (https://app.envia.com/).

Salida

{
  "success": true,
  "shipment_id": "12345",
  "tracking_number": "794644790138",
  "tracking_url": "https://envia.com/rastreo/794644790138",
  "label_url": "https://envia.com/labels/12345.pdf",
  "carrier": "fedex",
  "service": "express",
  "status": "created",
  "message": "Guia generada - Tracking: 794644790138"
}

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\",\"phone\":\"+525512345678\",\"email\":\"envios@miempresa.com\"}",
  "destination": "{\"name\":\"Cliente\",\"street\":\"Av Juarez 100\",\"city\":\"Guadalajara\",\"state\":\"JA\",\"zip\":\"44100\",\"country\":\"MX\",\"phone\":\"+525512345679\"}",
  "packages": "[{\"content\":\"Producto\",\"amount\":1,\"weight\":2,\"length\":25,\"width\":15,\"height\":10}]",
  "carrier": "fedex",
  "service": "express"
}

API Utilizada

• Endpoint: POST /ship/generate/
• Base: Envia.com API (via helper _enviaHelper)
• Documentacion: https://docs.envia.com/

Notas

• Los paquetes se envian siempre como array; si se pasa un objeto individual, se convierte automaticamente
• Envia.com soporta multiples transportistas en LATAM: FedEx, DHL, Estafeta, Redpack, etc.
• Los nombres de carrier y service deben coincidir con los disponibles en tu cuenta (usa el nodo Listar Transportistas)
• El peso se expresa en kilogramos y las dimensiones en centimetros

Nodos Relacionados

• Envia.com - Obtener Tarifas (enviaGetRates)
• Envia.com - Rastrear Envio (enviaGetTracking)
• Envia.com - Cancelar Envio (enviaCancelShipment)
• Envia.com - Listar Transportistas (enviaGetCarriers)