# 🚚 Integrador de Paquetería y Envíos Nacionales en LATAM (Envia.com & Skydropx API)

> **Resumen para No Técnicos**: Permite que tu Inteligencia Artificial cotice al instante el envío de un paquete con las mejores transportadoras de tu país (Servientrega, Coordinadora, 99minutos, Estafeta, DHL, Chilexpress, etc.), elija la opción más económica o rápida, genere la guía de envío lista para imprimir y rastree el paquete hasta que llegue a manos del cliente.

| Metadato | Detalle |
|---|---|
| **Tipo** | API REST Oficial de Agregación Logística y Envíos |
| **Área Empresarial** | 05. Operaciones, Logística y Envíos Nacionales |
| **Nivel de Dificultad** | 🟡 Media |
| **Modelo de Costo** | Sin costo mensual fijo; tarifas preferenciales con descuento por guía generada |
| **Enlace Oficial** | [Envia.com Developers](https://api.envia.com/) / [Skydropx API](https://www.skydropx.com/developers) |

---

## 💡 ¿Para qué le sirve a tu empresa? (Valor Real)

Si vendes productos físicos por internet o teléfono a nivel nacional, cotizar cada envío entrando a la página de cada transportadora es una pérdida enorme de tiempo. Además, las tarifas de mostrador para personas individuales son mucho más caras que las tarifas de grandes empresas.

Con plataformas como **Envia.com** o **Skydropx**:
- Tu IA compara en 1 segundo los precios de 8 transportadoras para el peso y medidas de tu caja.
- Te muestra la más económica (para envíos estándar) y la más rápida (para entregas urgentes).
- Genera el PDF de la guía con código de barras listo para pegar en la caja con 1 solo clic.

---

## 🎁 ¿Qué valor aporta frente a soluciones tradicionales?

- **Descuentos de hasta el 40% en fletes**: Accedes a tarifas corporativas sin necesidad de tener contratos de miles de envíos mensuales.
- **Rastreo Automático para el Cliente**: La IA puede enviar el número de guía y el enlace de seguimiento por WhatsApp al cliente tan pronto se genera la etiqueta.
- **Cobertura Multipaís**: Opera en México, Colombia, Chile, Perú, Guatemala, Argentina y EE.UU.

---

## 🔑 ¿Qué necesitas para activarlo?

1. Una cuenta activa en [Envia.com](https://envia.com) o [Skydropx](https://skydropx.com).
2. Saldo prepagado o tarjeta configurada para el pago de las guías.
3. Tu clave de API (`API_KEY_ENVIA` o `SKYDROPX_TOKEN`).

---

## ⚙️ Configuración Paso a Paso

Variables de entorno para tu backend o flujos de automatización:

```env
# Variables de entorno (.env)
ENVIA_API_KEY=1234567890abcdefghijklmnopqrstuv
ENVIA_COUNTRY_CODE=CO # CO (Colombia), MX (México), CL (Chile), PE (Perú)
ORIGEN_DIRECCION=Calle 100 # 15-20, Bogotá
ORIGEN_CODIGO_POSTAL=110111
```

---

## 🤖 Consultor Interactivo (Prompt Guiado para tu IA)

Copia y pega este prompt en tu chat con la IA:

```markdown
Actúa como mi Asistente de Despachos y Logística Nacional con Envia.com / Skydropx.
Vamos a cotizar y generar una guía de paquetería para un envío a cliente.

Por favor, pregúntame:
1. ¿Cuál es la ciudad y código postal de destino?
2. ¿Cuáles son las dimensiones del paquete (Peso en kg, Alto, Ancho y Largo en cm)?
3. ¿Cuál es el valor declarado del contenido para el seguro?
4. ¿Prefieres la opción más económica o la más rápida?

Con tus datos, consultaré las opciones disponibles con las transportadoras aliadas, te mostraré el comparativo de tarifas y dejaré lista la guía para imprimir una vez confirmes.
```

---

## 🌎 Caso de Uso Real en América Latina

**Empresa**: "Botas & Cueros La Gaitana" (Calzado artesanal en Pasto, Colombia).
- **Problema**: Despachaban 150 pares de zapatos al mes a todo el país y el dueño tenía que ir a la oficina física de la transportadora a llenar las guías con bolígrafo, perdiendo 2 horas cada tarde.
- **Resultado con la API**: La IA genera las guías desde el taller, compara precios entre Servientrega e Interrapidísimo y programa la recolección en la puerta de la fábrica. Redujeron sus costos de flete en un 28% y ganaron 10 horas semanales de trabajo productivo.

---

## 🛡️ Consideraciones de Buenas Prácticas

- **Pesaje y Medición Exactos**: Pesa y mide la caja con precisión para evitar sobrecargos posteriores por diferencias de peso volumétrico.
- **Seguro de Carga**: Declara siempre el valor real de productos frágiles o de alto costo para protegerte ante pérdidas en carretera.