Skip to main content
(Public API → Hojas de cálculo de Google) Conecte rápidamente su cuenta Alvys e importe datos operativos en vivo (Cargas, Viajes, Clientes, Conductores, Transportistas, Facturas y más) directamente a Hojas de cálculo de Google. No se requiere codificación ni exportaciones manuales.

​
⚙️ Paso 1. Descargue la API Alvys → Plantilla de importación de Hojas de cálculo de Google

Haga clic en el enlace a continuación para hacer su propia copia del archivo en Google Sheets:
<Anchor label="👉 **Make a Copy in Google Drive**" target="_blank" href="https://docs.google.com/spreadsheets/d/11HyDR1nf8U0MNahMPUp6_e5XpkDGeJIBXs7W5oBlVCA/copy">👉 Hacer una copia en Google Drive</Anchor>
  • Una vez que haga clic en “Hacer una copia”,
    • El archivo se agregará a su propio Google Drive.
    • También se copiará la funcionalidad de Apps Script adjunta.
    • Puede abrirlo inmediatamente y comenzar a usarlo en Google Sheets.
Haga una copia en Google Drive. La primera vez que lo abras, Google Sheets te pedirá que otorgues permisos. Haga clic en Continuar → Permitir todo; esto habilita la conexión segura a Alvys Public API. Es posible que deba volver a cargar el archivo una vez después de otorgar acceso.
  1. Después de otorgar acceso, vuelva a cargar el archivo una vez si se le solicita.
  2. Después de guardar, verá Welcome Sheet.
“Este archivo se conecta directamente al Alvys Public API. Úselo para importar datos operativos en vivo, incluidos Cargas, Viajes, Clientes, Conductores, Transportistas y más, directamente a Google Sheets”.

​
🔑 Paso 2. Obtenga sus credenciales de cliente

Sus credenciales están disponibles en su portal Alvys: 🔗 Alvys Portal → Página de acceso API Copia tu:
  • Client ID
  • Client Secret
  • Tenant ID
Importante: asegúrese de que las credenciales de su aplicación tengan todos los permisos de lectura requeridos. La falta de alcances de lectura dará como resultado importaciones incompletas o fallidas.
Luego en la hoja de Google:
  1. Ir a Alvys → Configure…
  2. Pegue sus credenciales y haga clic en Save
✅ Tus credenciales se almacenan de forma privada en tu archivo.
El Client Secret queda oculto a la vista después de guardarlo y se almacena de forma segura dentro de las propiedades del script de la hoja. Los colaboradores que usan el archivo pueden ver los datos importados, pero técnicamente solo el propietario del archivo o los editores con acceso a Apps Script pueden ver las credenciales almacenadas.

​
🔄 Paso 3. Importa tus datos

Utilice el menú Alvys en la barra de herramientas superior para comenzar a importar. <Table> acciónDescripción 📦 Importación completa (🧹 Reemplazo completo)Cargas todos los registros desde cero y reemplaza los datos existentes.🔁 Sincronización (actualización incremental)Importa solo los registros modificados desde la última sincronización (usando updatedAt y daysBack ). </Table> Cada conjunto de datos (Cargas, Viajes, Clientes, Conductores, Transportistas, etc.) aparece en su propia pestaña. Consulte la pestaña Registro para conocer el tiempo de importación, el estado y el recuento de registros.

​
🕒 Paso 4. (Opcional) Habilite la sincronización automática

Para mantener tus Cargas y Viajes actualizados automáticamente:
  1. Ir a Alvys → Configure Auto Sync…
  2. Elija la frecuencia con la que debe ejecutarse (por ejemplo, cada 6 horas).
  3. Un activador en segundo plano recuperará los registros actualizados en el pasado (Frecuencia + 1 hora).

​
💡 Consejos y notas

  • ✅ Usa Full Import la primera vez que te conectes.
  • ⚡ Luego cambie a Incremental Sync para obtener actualizaciones más rápidas.
  • 🔐 Tus credenciales permanecen privadas en tu propia hoja.
  • ⏳ La barra lateral puede tardar entre 2 y 6 segundos en abrirse; eso es normal.
  • ⚠️ Para importaciones de datos grandes, ejecute cada entidad (Cargas, Viajes, Clientes, etc.) manualmente y una a la vez; espere a que finalice cada una antes de comenzar otra.
  • ⚠️ Google Sheets tiene un límite de tiempo de ejecución fijo definido por Google. Si importa un gran volumen de datos, permita que cada importación se complete o divida el proceso en lotes más pequeños.