Integracja Google Workspace w Polsce
Masowe importy z Google Sheets, dodatek Gmail i biblioteka Apps Script — Polska z VAT 23% przez KSeF.
Architektura — Masowe importy z Google Sheets dla Polska
Zainstaluj dodatek Corp-Merch dla Sheets z Marketplace (domain-wide). Panel boczny czyta aktywny zakres, waliduje go z katalogiem Polska (SKU, MOQ, waluta, VAT 23%) i wysyła jednym kliknięciem. Klucz idempotency z UUID wiersza. Błędy podświetlają błędne komórki inline. Typowy przypadek: HR eksportuje listę nowych pracowników, Sheet rozwija ją w zamówienia kitów, dodatek wysyła do Corp-Merch i wpisuje order ID i tracking URL w sąsiednich kolumnach. Domyślny ship-to: hub Warszawa.
Jak to zintegrować — Dodatek Gmail do zatwierdzeń
Dodatek Gmail wykrywa linki do zamówień Corp-Merch w przychodzących mailach, pobiera bieżący status i oferuje akcje Akceptuj / Odrzuć oraz Odpowiedz-z-wyceną w panelu bocznym. Dostępne w Workspace Business Standard i wyżej. Zakresy OAuth ograniczone do gmail.addons.execute i naszego API. Kontekst wątku idzie tylko do Corp-Merch.
Eksploatacja i przypadki brzegowe — Biblioteka Apps Script
Biblioteka Apps Script opakowuje endpoints REST typowanymi metodami: CorpMerch.orders.create, .list, .cancel; CorpMerch.invoices.list filtrowane po statusie KSeF. Wyzwalacze czasowe lub zdarzeniowe — idealne do zamknięcia miesiąca, raportowania i sync do Looker Studio. Przykłady i starter na GitHubie. ID potwierdzeń Krajowy System e-Faktur (KSeF) dostępne na obiektach faktur do bezpośredniej rekoncyliacji.
FAQ
Instalacja domain-wide?
Tak — administratorzy mogą zainstalować dla całej domeny z Workspace Marketplace. Per-user install też działa.
Jakie zakresy OAuth?
spreadsheets, gmail.addons.execute, script.external_request — minimum. Nigdy nie prosimy o drive.readonly ani inne szerokie scope.
Apps Script — dokumentacja?
Script id, referencja i starter project na github.com/corp-merch/apps-script-starter.
Looker Studio?
Nasz konektor czyta zamówienia, faktury i wysyłki. Połączenie z istniejącym API key lub przez OAuth.
Czy automatycznie aplikuje VAT 23%?
Tak — Sheets i Apps Script wysyłają country='Polska', a Corp-Merch aplikuje VAT 23% i kieruje fakturowanie przez KSeF.