APIAERO no Google Sheets
Use =APIAERO(...) em qualquer célula. Tutorial passo-a-passo: /sheets/aprenda
📄
Modelo recomendado: Code.gs autônomo
Um arquivo único de ~700 linhas (APIAERO_CORE.gs) que vai no projeto Apps Script da sua planilha. Toda lógica num lugar só — zero dependência externa. Para atualizar, você edita o arquivo e propaga (manualmente ou via clasp se você já tem fluxo).
11 fórmulas disponíveis
| Fórmula | Retorna |
|---|---|
| Cotação | |
| =APIAERO(origem; destino; data; [ADT]; [CHD]; [INF]; [volta]; [hMin]; [hMax]) | Preço total CLIENTE (NET + markup) |
| =APIAERO_NET(...) | Preço NET (sem markup) — uso interno |
| =APIAERO_DETALHES(...) | Array 8 col: preço, NET, markup, cia IATA, cia nome, paradas, família, atualizado em |
| Janela de horário pré-definida | |
| =APIAERO_MADRUGADA(...) | Mais barato 00:00-05:59 |
| =APIAERO_MANHA(...) | 06:00-11:59 |
| =APIAERO_TARDE(...) | 12:00-17:59 |
| =APIAERO_NOITE(...) | 18:00-23:59 |
| Auto-descoberta (cola na planilha) | |
| =APIAERO_AJUDA() | Tabela com TODOS os parâmetros |
| =APIAERO_EXEMPLOS() | Tabela com receitas prontas |
| =APIAERO_PERIODOS() | Tabela com os 4 períodos do dia |
Code.gs (snippet)
// APIAERO_CORE.gs — arquivo único e autônomo
// Cole no Apps Script da planilha (ou propaga via clasp se você
// tem fluxo automatizado igual ao PRJ_FORNECEDORES da PODPAH)
const APIAERO_BASE_URL = 'https://apiaero.chargexdev.com.br/api/v1/sheets';
function APIAERO(origem, destino, dataIda, adultos, criancas, bebes, dataVolta, horaMin, horaMax) {
return APIAERO_cotar_(origem, destino, dataIda, adultos, criancas, bebes, dataVolta, horaMin, horaMax, 'client').price;
}
function APIAERO_NET(...) { return APIAERO_cotar_(...) }
function APIAERO_DETALHES(...) { ... }
function APIAERO_MANHA/_TARDE/_NOITE/_MADRUGADA(...) { ... }
function APIAERO_AJUDA/_EXEMPLOS/_PERIODOS() { ... }
function APIAERO_criarSubMenu_(ui) { ... } // anexar ao menu existente
function onOpen() { ... } // OU criar menu próprio
// ~700 linhas no total — código completo no repositórioArquivo completo em apps/sheets-addon/integracao-fornecedores/APIAERO_CORE.gs do repositório (~700 linhas). Cobre cotação + sidebar + aba Rotas + trigger temporal + busca de chave do Backend.
Setup numa planilha
- 1. Crie uma API key em /sheets/api-keys (mostrada uma única vez — copie agora).
- 2. Abra a planilha → Extensões → Apps Script
- 3. Cole APIAERO_CORE.gs em um arquivo novo (ou substitua o
Code.gspadrão). Também cole oSidebar.htmlcomo arquivo HTML. - 4. Salve (Ctrl+S), volte pra planilha, F5 para recarregar.
- 5. Configure a chave: menu APIAERO → Configurar API key → cole a chave.
- 6. Use: em qualquer célula vazia,
=APIAERO("CGH";"SDU";"2026-07-15";1)→ preço em ~2s.
?modo=apiAeroKey + rodar uma pipeline (tipo clasp push) pra propagar mudanças em batch. Exemplo completo na pasta apps/sheets-addon/integracao-fornecedores/ do repositório (caso PODPAH com 18 planilhas).