Integrazione Google Workspace in Italia
Importazioni bulk da Google Sheets, add-on Gmail e libreria Apps Script per Italia con IVA 22% via SdI.
Architettura — Import di massa con Google Sheets per Italia
Installa l'add-on Sheets di Corp-Merch dal Marketplace (anche domain-wide). Una sidebar legge il range attivo, valida contro il catalogo Italia (SKU, MOQ, valuta, IVA 22%) e invia con un click. Idempotency key dal UUID di riga. Gli errori evidenziano celle non valide. Caso d'uso tipico: HR esporta la lista neoassunti, lo Sheet la espande in ordini di kit, l'add-on invia a Corp-Merch e riscrive order ID e tracking URL nelle colonne adiacenti. Ship-to di default sull'hub Milano.
Come integrarlo — Add-on Gmail per le approvazioni
L'add-on Gmail rileva i link a ordini Corp-Merch nelle mail in arrivo, recupera lo stato live e offre azioni Approva / Rifiuta e Rispondi-con-preventivo nel pannello laterale. Disponibile su Workspace Business Standard e superiori. Scope OAuth limitati a gmail.addons.execute e alla nostra API. Il contesto del thread viene inviato solo a Corp-Merch.
Operatività e casi limite — Libreria Apps Script
La libreria Apps Script avvolge tutti gli endpoint REST con metodi tipizzati: CorpMerch.orders.create, .list, .cancel; CorpMerch.invoices.list filtrabile per stato SdI. Trigger time-based o event-based, ideale per chiusura mese, reportistica e sync verso Looker Studio. Esempi e starter su GitHub. ID di notifica Sistema di Interscambio (SdI) esposti negli oggetti fattura per la riconciliazione diretta.
Domande frequenti
Installazione domain-wide?
Sì — gli admin possono installare a livello dominio da Workspace Marketplace. Anche install per singolo utente.
Quali scope OAuth?
spreadsheets, gmail.addons.execute, script.external_request — il minimo. Non chiediamo mai drive.readonly o scope ampi.
Documentazione Apps Script?
Script id, reference e starter project su github.com/corp-merch/apps-script-starter.
Looker Studio?
Il nostro connector legge ordini, fatture e spedizioni. Connessione con API key esistente o via OAuth.
Applica automaticamente l'IVA 22%?
Sì — Sheets e Apps Script inviano country='Italia' e Corp-Merch applica IVA 22% instradando la fatturazione via SdI.