Jak przenosić faktury z KSeF do Airtable?
Nie ma bezpośredniego konektora KSeF–Airtable. Najkrótsza ścieżka to most przez Google Sheets: KSeF Import pobiera faktury z API KSeF Twoim certyfikatem, parsuje XML w schemacie FA(3) i zapisuje dane do arkusza Google. Airtable natywnie synchronizuje tabele z Google Sheets – wystarczy wskazać arkusz i skonfigurować Sync. Faktury pojawiają się w Airtable automatycznie jako rekordy gotowe do widoków Grid, Kanban, Kalendarz i powiązań z innymi tabelami.
- Airtable nie ma natywnego konektora KSeF – Google Sheets jest wymaganym pośrednikiem.
- Ścieżka: KSeF → KSeF Import → Google Sheets → Airtable Sync. Konfiguracja raz, potem działa w tle.
- Faktury trafiają do Airtable jako rekordy z polami: numer KSeF, daty, NIP-y, netto/VAT/brutto, stawka, waluta, MPP.
- Eksport do Google Sheets dostępny już w planie Solo – wystarczy do pełnej integracji z Airtable.
- W Airtable zyskujesz widoki Kanban, Kalendarz, grupowanie, automatyzacje i powiązania z innymi bazami.
W tym artykule
Od problemu do efektu
PWEAirtable nie czyta XML-i FA(3) z KSeF. Ręczne przepisywanie danych faktury do bazy to błędy i godziny pracy przy każdym miesiącu rozliczeniowym.
KSeF Import obsługuje certyfikat .p12, szyfrowanie sesji, limity API i parsowanie FA(3) – a wyniki zapisuje do arkusza Google, który Airtable Sync czyta bez Twojego udziału.
Nowe faktury z KSeF trafiają do Airtable bez Twojej interwencji. Widoki Grid, Kanban i Kalendarz gotowe od razu – z pełnymi danymi z KSeF.
Dlaczego Google Sheets jest mostem, a nie opcją
Airtable jest potężną bazą danych, ale nie posiada natywnego konektora do KSeF. KSeF to polska specyfikacja regulowana przez Ministerstwo Finansów – wymaga certyfikatu .p12, podpisania sesji XAdES, szyfrowania zapytań i ścisłego respektowania limitów API. Żadne narzędzie No-Code (w tym Airtable, Make, Zapier) nie implementuje tego protokołu z pudełka.
Rozwiązaniem jest KSeF Import jako warstwa middleware: obsługuje całą złożoność techniczną po stronie KSeF i eksportuje czytelne dane do Google Sheets. Airtable natywnie synchronizuje tabele z arkuszami Google – dzięki temu łańcuch działa bez jednej linijki kodu.
KSeF (XML FA(3)) → KSeF Import (certyfikat, parsing, eksport) → Google Sheets (tabela z danymi) → Airtable Sync (automatyczny import rekordów)
Eksport do Google Sheets dostępny jest już w planie Solo – co oznacza, że każdy plan KSeF Import wystarczy do zbudowania tej integracji. Sprawdź szczegóły w cenniku.
Konfiguracja krok po kroku
Jednorazowa konfiguracja zajmuje ok. 15–20 minut. Potem całość działa w tle bez Twojego udziału.
-
1
Zarejestruj się i wgraj certyfikat
Utwórz konto i wgraj plik
.p12lub.pfxpobrany z portalu KSeF. Certyfikat szyfrujemy AES-256-GCM kluczem generowanym osobno dla każdego użytkownika. Dane przechowywane są na serwerach w Unii Europejskiej (OVH). -
2
Skonfiguruj eksport do Google Sheets
W panelu KSeF Import przejdź do Eksport → Google Sheets, wklej ID arkusza i przyznaj dostęp. Faktury z ostatnich 90 dni dociągną się automatycznie przy pierwszym pobraniu – potem nowe dokumenty dochodzą po każdej synchronizacji.
-
3
W Airtable: dodaj synchronizację z Google Sheets
W Twojej bazie Airtable wybierz Add a table → Sync data from an external source → Google Sheets. Zaloguj się tym samym kontem Google i wskaż arkusz z fakturami. Airtable automatycznie rozpozna kolumny.
-
4
Ustaw merge key i częstotliwość
W ustawieniach Sync wybierz Merge by field i wskaż kolumnę „Numer KSeF" jako klucz deduplikacji – zapobiega duplikatom przy kolejnych synchronizacjach. Częstotliwość: co 5 min (Airtable Pro) lub co godzinę (Free).
-
5
Skonfiguruj widoki i pola własne
Dodaj w Airtable pola nieobsługiwane przez Sync (np. „Status opłacenia" – single-select: Do zapłaty / Zapłacona / Przeterminowana). Pola własne Airtable nie są nadpisywane przez Sync ze źródła Google Sheets.
Przy pierwszym pobraniu historycznym (90 dni) API KSeF udostępnia ok. 60 faktur na godzinę dla jednego NIP. Przy dużym wolumenie zostaw synchronizację na noc – rano masz pełny zakres bez ręcznego ponawiania.
Zobacz, jak KSeF Import pobiera faktury kosztowe i układa je w gotowy arkusz.
Co zyskujesz: widoki i funkcje Airtable
Gdy faktury z KSeF trafiają do Airtable jako rekordy, możesz wykorzystać jego pełne możliwości – niedostępne w samym Google Sheets.
| Widok / funkcja | Zastosowanie dla faktur KSeF |
|---|---|
| Grid z grupowaniem | Faktury pogrupowane po kontrahencie lub miesiącu, suma netto w każdej grupie |
| Kanban (obieg akceptacji) | Kolumny Nowa / Do weryfikacji / Zatwierdzona / Opłacona – przeciągasz kartę, status się zmienia |
| Kalendarz płatności | Pole Termin płatności jako data – miesięczny widok co do zapłaty którego dnia |
| Powiązania z innymi tabelami | Linked record między fakturami a tabelą projektów lub klientów |
| Automatyzacje | Powiadomienie na Slacku lub e-mail, gdy faktura przekroczy zadaną kwotę |
| Interfejsy (dashboardy) | Wizualny dashboard kosztowy bez pisania kodu |
Synchronizacja Google Sheets → Airtable jest jednokierunkowa. Zmiany robione w Airtable (statusy, kategorie, notatki) nie wracają do arkusza. To intencjonalne: KSeF jest źródłem faktów, Airtable – warstwą operacyjną.
Dla kogo ta integracja
Integracja KSeF → Google Sheets → Airtable sprawdza się w firmach i zespołach, które już używają Airtable do operacji i chcą dołączyć do nich faktury – bez tworzenia oddzielnego systemu.
- Agencje i konsultingi – faktury powiązane z tabelą projektów; widać od razu, które projekty generują koszty.
- Startupy i e-commerce – budżet w Airtable + faktury kosztowe w tej samej bazie; pełny obraz bez przełączania narzędzi.
- Firmy z obiegiem akceptacji – Kanban zamiast maili; każda faktura przechodzi przez kolumny zatwierdzenia. Więcej w artykule obieg akceptacji faktur w Airtable.
- Biura rachunkowe – oddzielna baza per klient, widoki raportowe, eksport do CSV. Alternatywą jest integracja przez Make/Zapier – patrz automatyzacja przez Make.com.
Limity i dobór planu
Eksport do Google Sheets (wymagany przez integrację z Airtable) dostępny jest w każdym planie KSeF Import – w tym Solo. Szczegółowe porównanie znajdziesz w cenniku.
Airtable ma własne limity rekordów per plan: plan Free do 1 000 rekordów na bazę (dla małego wolumenu faktur wystarczy na wiele miesięcy), plany płatne oferują większe pojemności. Sprawdź aktualne limity na stronie Airtable.
Pierwsze pobranie obejmuje ostatnie 90 dni. Starsze faktury pozostają w KSeF (MF przechowuje je 10 lat) i można je pobrać z portalu po numerze KSeF. Faktury zebrane w Airtable będą narastać od momentu aktywacji – im wcześniej zaczniesz, tym więcej historii.
Okres próbny KSeF Import trwa 7 dni z pełnym dostępem do limitów planu Biuro (20 NIP-ów, bez limitu faktur, synchronizacja co 15 minut) – to wystarczy, żeby sprawdzić całą integrację z Airtable od początku do końca.
Najczęstsze pytania
Krótkie, konkretne odpowiedzi na pytania, które zadają użytkownicy i wyszukiwarki.
Airtable nie obsługuje protokołu KSeF – wymagane jest certyfikat .p12, podpisanie sesji XAdES i parsowanie XML w schemacie FA(3). KSeF Import realizuje te kroki i eksportuje gotowe dane do Google Sheets, z którym Airtable synchronizuje się natywnie.
W planie Free Airtable synchronizuje raz dziennie, w planach płatnych co godzinę lub częściej (plan Pro co 5 minut). Czas ten jest niezależny od częstotliwości synchronizacji KSeF Import z arkuszem.
Pola własne dodane w Airtable (na przykład status opłacenia, kategoria kosztowa) nie są nadpisywane przez synchronizację ze źródła Google Sheets. Możesz swobodnie opisywać każdy rekord faktury bez ryzyka utraty danych.
Tak. Każdy NIP możesz eksportować do osobnej zakładki arkusza Google Sheets, a Airtable może synchronizować wiele zakładek do różnych tabel lub jednej połączonej bazy. Liczba obsługiwanych NIP-ów zależy od planu KSeF Import.
Tak. Make i Zapier potrafią czytać nowe wiersze z Google Sheets i tworzyć rekordy w Airtable. Daje to większą elastyczność – np. można mapować pola, filtrować faktury po kwocie lub uruchamiać dodatkowe akcje. Natywny Airtable Sync jest prostszy w konfiguracji, ale mniej konfigurowalny.
Eksport do Google Sheets dostępny jest we wszystkich planach: Solo, Firma, Grupa i Biuro. Siedmiodniowy okres próbny daje pełny dostęp do limitów planu Biuro, więc możesz przetestować całą integrację z Airtable od pierwszego dnia.
Inżynier integracji KSeF. Odpowiada za połączenia z API Krajowego Systemu e-Faktur, automatyzacje i parsowanie struktury logicznej FA(3).