Integracje

Jak zintegrować KSeF z Airtable?

Jak połączyć KSeF z Airtable przez KsefTools i szablon Make: token KSeF, synchronizacja z Google Sheets, mapowanie pól w Airtable i harmonogram importu faktur.

Aktualizacja: 3 min czytania
Otwórz jako Markdown
Spis treści

Czego potrzebujesz

  • dostępu do Aplikacji Podatnika KSeF,
  • konta w KsefTools,
  • konta w Make (wystarczy darmowy plan),
  • bazy w Airtable z gotową tabelą na faktury.

Masz dostęp do Airtable Automations? To automatyzacje wbudowane w Airtable, które mają integrację z Google Sheets. Możesz ich użyć zamiast Make, żeby przenosić faktury z arkusza KsefTools do Airtable.

Krok 1. Wygeneruj token w KSeF

  1. Zaloguj się do Aplikacji Podatnika KSeF.
  2. Otwórz zakładkę Tokeny i kliknij Generuj token.
  3. W nazwie tokena wpisz np. KsefTools.
  4. Zaznacz tylko uprawnienie Przeglądanie faktur. Pozostałe uprawnienia odznacz.
  5. Kliknij Generuj token i skopiuj go.

Krok 2. Dodaj firmę w KsefTools

  1. Wklej token w KsefTools.
  2. Podaj NIP firmy i nazwę połączenia.
  3. Kliknij Zapisz połączenie.

Krok 3. Ustaw synchronizację z Google Sheets

  1. Przejdź do zakładki Synchronizacja i kliknij Kontynuuj.
  2. Wybierz rodzaj faktur: kosztowe albo przychodowe.
  3. Ustaw datę, od której KsefTools ma pobierać faktury.
  4. Wybierz częstotliwość, np. codziennie.
  5. Kliknij Utwórz i aktywuj.

Po kilku sekundach arkusz będzie gotowy. Kliknij Otwórz Google Sheets i sprawdź dane: numer faktury, kwoty netto, VAT i brutto, walutę oraz NIP-y sprzedawcy i nabywcy.

Krok 4. Przygotuj tabelę w Airtable

Zanim połączysz Make, utwórz w Airtable tabelę, np. „Faktury kosztowe”. Dodaj w niej pola na dane z arkusza, np.:

  • numer faktury,
  • datę wystawienia,
  • nazwę sprzedawcy,
  • NIP sprzedawcy,
  • kwoty netto, VAT i brutto,
  • walutę.

Możesz też dodać własne pola, np. Kategoria albo Opis. Wypełnisz je ręcznie po imporcie.

Tabela faktur w Airtable z polami: numer faktury, data wystawienia, nazwa sprzedawcy, NIP nabywcy, numer KSeF i data zapisu w KSeF

Krok 5. Połącz Google Sheets z Airtable przez szablon Make

Skorzystaj z gotowego szablonu Make i podłącz do niego swoje konta.

  1. Otwórz szablon i skopiuj scenariusz na swoje konto Make. Jeśli nie masz konta, załóż darmowe.

  2. W module Google Sheets → Watch New Rows:

    • podłącz swoje konto Google,
    • w polu Spreadsheet ID wybierz arkusz z KsefTools,
    • na start ustaw Limit na 2, żeby sprawdzić, czy dane się pobierają,
    • przy pierwszym uruchomieniu wybierz start od wszystkich wierszy (All).
  3. W module Airtable → Create a Record:

    • podłącz swoje konto Airtable,
    • wybierz bazę i tabelę z fakturami,
    • sprawdź, czy każde pole Airtable ma przypisaną kolumnę z arkusza. Jeśli Twoje pola nazywają się inaczej, przypisz brakujące kolumny ręcznie,
    • przy kwotach netto, VAT i brutto użyj funkcji replace, żeby zamienić przecinek na kropkę, np. replace(Wartość netto; ","; "."). Airtable przyjmuje w liczbach tylko kropkę. Z przecinkiem kwota się nie zapisze.

    Moduł Airtable w Make: pola Wartość netto, Wartość VAT i Wartość Brutto z funkcją replace zamieniającą przecinek na kropkę

  4. Kliknij Save, a potem Run once.

  5. Otwórz Airtable i sprawdź, czy pojawiły się dwa nowe rekordy z poprawnymi danymi.

Krok 6. Ustaw harmonogram i zaimportuj starsze faktury

  1. W ustawieniach scenariusza wybierz częstotliwość, np. raz dziennie o 12:20 albo co kilka godzin.
  2. Zwiększ Limit w module Google Sheets, np. do 100-200 faktur.
  3. Jeśli chcesz od razu przenieść wszystkie faktury z arkusza, kliknij Save i Run once.
  4. Włącz harmonogram. Od tej pory nowe faktury z KSeF będą same trafiać do Airtable.

Każda faktura zużywa operacje (kredyty) w Make. Pamiętaj o tym przy dużym imporcie. Darmowy plan powinien Ci wystarczyć na około 800 faktur miesięcznie.

Nie znalazłeś odpowiedzi?

Napisz do nas - odpowiadamy w ciągu jednego dnia roboczego.