Argentina
Cómo integrar Envíopack con Tiendli
Envíopack funciona como una capa multioperador: una sola cuenta puede devolver distintas empresas y servicios logísticos para que el comprador compare alternativas durante el checkout.
¿Qué permite hacer?
- Validar API Key y Secret Key de la cuenta Envíopack.
- Consultar tarifas reales de múltiples carriers durante el checkout.
- Mostrar por separado empresa, servicio, costo y plazo estimado.
- Revalidar server-side exactamente el mismo carrier/servicio al confirmar el pedido.
- Guardar en el pedido la alternativa logística que eligió el comprador.
- Crear Pedido + Envío con el carrier y servicio exactos del checkout.
- Imprimir la etiqueta PDF cuando Envíopack procese el envío.
- Sincronizar tracking automáticamente mediante webhook.
Antes de empezar
- Cuenta activa en Envíopack.
- API Key y Secret Key obtenidas desde Configuración → Integraciones.
- Provincia y código postal del comprador.
- Peso, ancho, alto y largo en los productos físicos.
- ID del depósito/dirección de Envíopack si elegís que el carrier retire en tu domicilio/deposito.
Cómo conectar la cuenta
- 1
Ingresá a Panel de Tiendli → Logística → Operadores logísticos.
- 2
Buscá Envíopack e ingresá API Key y Secret Key.
- 3
Si el carrier retirará los paquetes en tu depósito, ingresá el ID de ese depósito.
- 4
Elegí si el carrier retira los paquetes en tu depósito o si los llevás a una sucursal.
- 5
Guardá. Tiendli validará las credenciales y generará una URL de notificaciones.
- 6
Copiá esa URL en Envíopack y activá envio-procesado y envio-cambio-condicion.
Durante el checkout
Tiendli consulta al operador desde el servidor. El importe se vuelve a validar al crear el pedido para evitar que un precio modificado en el navegador sea aceptado.
- Tiendli envía provincia, código postal, peso y dimensiones a Envíopack.
- Una sola conexión puede devolver varias empresas y servicios. Cada alternativa aparece como una opción independiente.
- El checkout utiliza el precio para comprador configurado en Envíopack; el costo interno que paga el vendedor no se expone como tarifa al cliente.
- El precio mostrado nunca se toma como autoritativo desde el navegador.
- Al confirmar el pedido, Tiendli vuelve a cotizar y exige que siga existiendo exactamente la misma combinación de carrier, modalidad y servicio.
Preparar y despachar el pedido
- El pedido conserva el carrier, modalidad de despacho y servicio seleccionados por el comprador.
- Desde Pedidos, presioná “Crear envío Envíopack”. Tiendli crea primero el Pedido remoto y luego el Envío confirmado.
- Tiendli busca por id_externo antes de crear para adoptar una operación remota existente y evitar duplicados ante reintentos.
- Cuando el envío llega al estado Procesado (P), se habilita la etiqueta PDF.
- Las actualizaciones normales se reciben por webhook; la actualización manual queda disponible para una verificación puntual.
Etiquetas
- La etiqueta PDF se obtiene desde Envíopack únicamente cuando el envío está en estado Procesado (P).
- Si todavía figura En Proceso (E), esperá la notificación envio-procesado.
Seguimiento
- Envíopack notifica envio-cambio-condicion y Tiendli relee el envío/tracking desde la API.
- Tiendli no ejecuta un cron de tracking: Envíopack desaconseja consultar repetidamente el mismo seguimiento.
- Los eventos pueden avanzar el pedido a Enviado o Entregado cuando representan movimiento físico real.
Recomendaciones
Cargá peso, ancho, alto y largo en todos los productos físicos. Los operadores utilizan esos datos para calcular la tarifa y preparar el envío.
Antes de comenzar a vender con un operador nuevo, realizá un pedido de prueba completo: cotización, compra, creación del envío, etiqueta y tracking.
Preguntas frecuentes
¿Envíopack reemplaza a Andreani, OCA o Correo Argentino?
No necesariamente. Es un agregador que puede complementar los conectores directos. Podés mantener varias integraciones activas y ofrecer las alternativas disponibles.
¿Por qué veo varios transportistas debajo de Envíopack?
Porque la API devuelve distintas empresas y servicios habilitados para el origen, destino y paquete. Tiendli los presenta como opciones separadas.
¿Dónde consigo las credenciales?
En tu cuenta Envíopack, desde Configuración → Integraciones. Copiá la API Key y Secret Key y cargalas en Tiendli.
¿Cuándo puedo imprimir la etiqueta?
Cuando Envíopack marque el envío como Procesado (P). Antes de ese estado la etiqueta todavía no está disponible.