Integração Google Workspace em Portugal
Importações em massa do Google Sheets, complemento Gmail e biblioteca Apps Script — Portugal com IVA 23% via AT.
Arquitectura — Importações em massa do Google Sheets para Portugal
Instale o complemento Sheets da Corp-Merch a partir do Marketplace (instalação domain-wide suportada). Uma sidebar lê o intervalo activo, valida contra o catálogo Portugal (SKU, MOQ, moeda, IVA 23%) e submete num clique. Chaves de idempotência derivadas do UUID da linha. Erros realçam células más inline. Caso típico: HR exporta lista de novos colaboradores, o Sheet expande para encomendas de kits, o complemento submete à Corp-Merch e reescreve order ID e URL de tracking nas colunas adjacentes. Ship-to por omissão: hub Lisboa.
Como integrar — Complemento Gmail para aprovações
O complemento Gmail detecta links de encomendas Corp-Merch em emails recebidos, busca o estado actual e oferece acções Aprovar / Rejeitar e Responder-com-orçamento no painel direito. Disponível em Workspace Business Standard e superiores. Scopes OAuth limitados a gmail.addons.execute e à nossa API. O contexto do thread é enviado apenas para a Corp-Merch.
Operação e casos extremos — Biblioteca Apps Script
A biblioteca Apps Script envolve todos os endpoints REST com métodos tipados: CorpMerch.orders.create, .list, .cancel; CorpMerch.invoices.list filtrável por estado AT. Triggers temporais ou por evento — ideal para fecho de mês, relatórios e sincronização com Looker Studio. Exemplos e starter no GitHub. IDs de notificação Portal das Finanças (AT) expostos nos objectos de factura para reconciliação directa.
Perguntas frequentes
Instalação domain-wide?
Sim — admins podem instalar para todo o domínio a partir do Workspace Marketplace. Instalação per-user também funciona.
Que scopes OAuth?
spreadsheets, gmail.addons.execute, script.external_request — o mínimo. Nunca pedimos drive.readonly ou outros scopes amplos.
Apps Script — onde está a documentação?
Script id, referência e starter project no github.com/corp-merch/apps-script-starter.
Looker Studio?
O nosso connector lê encomendas, facturas e envios. Liga com a tua chave API existente ou via OAuth.
Aplica o IVA 23% automaticamente?
Sim — Sheets e Apps Script enviam country='Portugal' e a Corp-Merch aplica o IVA 23% encaminhando a facturação via AT.