Artykuły w tej sekcji

Rozwiązywanie problemów z integracją Zapier

Avatar
Jakub Chudarek
  • Zaktualizowano
Obserwuj

Ten artykuł pomoże Ci rozwiązać najczęstsze problemy z integracją inFakt + Zapier.

 

Błędy połączenia

Błąd "Invalid API Key" (401)

Ten błąd oznacza, że klucz API jest nieprawidłowy lub nieaktywny.

Możliwe przyczyny:

  • Klucz API został skopiowany nieprawidłowo (ze spacjami lub brakującymi znakami)
  • Wybrano złe środowisko (Produkcja zamiast Sandbox lub odwrotnie)
  • Klucz API został usunięty lub dezaktywowany w inFakt
  • Klucz API nie ma wymaganych uprawnień (scopes)

Rowiązanie:

  1. Przejdź do inFakt → Ustawienia → API
  2. Sprawdź czy klucz istnieje i jest aktywny
  3. Sprawdź czy klucz ma wymagane uprawnienia:
    • api:invoices:read - Odczyt danych
    • api:invoices:write - Zarządzanie danymi
    • api:account:read - Odczyt danych konta (wymagane do weryfikacji połączenia)
  4. Jeśli brakuje uprawnień, wygeneruj nowy klucz z właściwymi uprawnieniami
  5. Skopiuj klucz dokładnie (bez spacji)
  6. W Zapier wybierz prawidłowe środowisko:
    • Produkcja dla app.infakt.pl
    • Sandbox dla app.sandbox-infakt.pl

Błąd "Connection refused" lub timeout

Ten błąd oznacza problemy z połączeniem sieciowym.

Rowiązanie:

  1. Sprawdź czy inFakt działa (odwiedź app.infakt.pl)
  2. Poczekaj kilka minut i spróbuj ponownie
  3. Sprawdź status usługi inFakt na stronie statusowej
Wskazówka: Zapier automatycznie ponawia próby w przypadku tymczasowych błędów sieciowych.
 

Błędy tworzenia faktury

Błąd "At least one service is required"

Każda faktura musi mieć co najmniej jedną pozycję (usługę/produkt).

Rowiązanie:

  1. Upewnij się, że pole Service Name jest wypełnione
  2. Upewnij się, że pole Net Price ma wartość
  3. Jeśli używasz zmiennych z triggera, sprawdź czy mają wartości

Błąd "Invalid NIP format"

NIP musi mieć dokładnie 10 cyfr, bez myślników i spacji.

Nieprawidłowo Prawidłowo
521-360-91-20 5213609120
521 360 91 20 5213609120
PL5213609120 5213609120
 

Rowiązanie:

Użyj Formatter by Zapier → Text → Replace aby usunąć myślniki i spacje z NIP przed wysłaniem do inFakt.
 

Błąd "Invalid date format"

Daty muszą być w formacie YYYY-MM-DD (np. 2025-01-15).

Nieprawidłowo Prawidłowo
15/01/2025 2025-01-15
15.01.2025 2025-01-15
January 15, 2025 2025-01-15

Rowiązanie:

Użyj Formatter by Zapier → Date/Time → Format do konwersji daty na format YYYY-MM-DD.

Błąd "Invoice not found" (404)

Ten błąd występuje gdy próbujesz wykonać akcję na nieistniejącej fakturze.

Możliwe przyczyny:

  • Faktura została usunięta
  • UUID faktury jest nieprawidłowy
  • Faktura istnieje w innym środowisku (Sandbox vs Produkcja)

Rowiązanie:

  1. Sprawdź czy używasz prawidłowego UUID z poprzedniej akcji
  2. Upewnij się, że środowisko jest spójne w całym Zapie
  3. Sprawdź czy faktura istnieje w inFakt

Kwoty są nieprawidłowe (za wysokie/za niskie)

inFakt oczekuje kwot w PLN (złotych), nie w groszach.

Chcesz wpisać Prawidłowo Nieprawidłowo
100 złotych 100 10000
99,50 złotych 99.50 9950
Uwaga: Niektóre systemy (np. Stripe) podają kwoty w groszach/centach. Podziel przez 100 przed wysłaniem do inFakt.

Rozwiązanie:

Użyj Formatter by Zapier → Numbers → Perform Math Operation → Divide by 100.
 

Problemy z klientami

Błąd przy tworzeniu klienta zagranicznego z kodem pocztowym

inFakt wymaga polskiego formatu kodu pocztowego (XX-XXX). Dla klientów zagranicznych z innym formatem, wtyczka automatycznie pomija pole kodu pocztowego.

Rozwiązanie:

Klient zagraniczny zostanie utworzony bez pola postal_code. Walidacja jest teraz spójna między Create Client i Create Invoice (wspólna funkcja validatePostalCode).
 

Jak działa rozpoznawanie zagranicznych numerów VAT?

Wtyczka automatycznie rozpoznaje europejskie numery VAT (EU VAT ID) w formacie: 2 litery + 8-12 cyfr.

Przykład VAT ID Kraj Rozpoznany?
DE123456789 Niemcy ✅ Tak
HU8977521853 Węgry ✅ Tak
FR12345678901 Francja ✅ Tak
5213609120 Polska (NIP) ✅ Tak (polski NIP)
Funkcja find_client teraz poprawnie wyszukuje klientów po zagranicznych numerach VAT.
 

Jak uniknąć duplikatów klientów bez NIP?

Wtyczka rozszerzyła mechanizm wykrywania duplikatów. Cascade wyszukiwania:

  1. NIP - jeśli podany, szuka dokładnego dopasowania
  2. Email - jeśli brak NIP, szuka po emailu
  3. Imię + Nazwisko + Miasto - ostatnia deska ratunku (tylko jeśli znaleziony dokładnie 1 klient)
Uwaga: Dopasowanie po imieniu+nazwisku+mieście jest używane tylko gdy znaleziono dokładnie jednego klienta. Jeśli jest wielu klientów o tym samym imieniu i nazwisku w danym mieście, wtyczka utworzy nowego klienta (aby uniknąć pomyłek).
 

Jak działa automatyczne wykrywanie typu działalności klienta?

Pole business_activity_kind jest automatycznie wykrywane na podstawie danych klienta:

Dane klienta Wykryty typ
Nazwa firmy + imię i nazwisko self_employed (jednoosobowa działalność)
Tylko nazwa firmy other_business (inna firma)
Tylko imię i nazwisko private_person (osoba prywatna)
Możesz nadpisać automatyczną detekcję ustawiając pole Business Activity Kind ręcznie.
 

Błąd "Cannot send invoice via email: No valid email"

Ten błąd występuje gdy próbujesz wysłać fakturę emailem, ale nie ma dostępnego adresu email.

Rozwiązanie:

  1. Dodaj email w polu "Recipient Email" w akcji Send Invoice via Email
  2. Lub zaktualizuj email klienta w kartotece inFakt
Wtyczka automatycznie sprawdza email zarówno na fakturze jak i w kartotece klienta.
 

Jak sprawdzić czy klient został utworzony czy użyto istniejącego?

Dostępne są następujące pola w output:

  • was_created - true jeśli utworzono nowego klienta
  • action_taken - 'created', 'updated', 'used_existing', lub 'skipped'

Użyj tych pól w kolejnych krokach Zapa aby zróżnicować działania.

 

Problemy z triggerami

Trigger "New Invoice" nie wykrywa nowych faktur

Triggery inFakt działają w trybie polling (odpytywanie), nie w czasie rzeczywistym.

Wyjaśnienie:

  • Zapier sprawdza nowe faktury co 1-15 minut (zależnie od planu)
  • Darmowy plan: co 15 minut
  • Płatne plany: co 1-2 minuty

Rozwiązanie:

  1. Poczekaj do 15 minut na wykrycie nowej faktury
  2. Sprawdź czy Zap jest włączony (przełącznik ON)
  3. Sprawdź Task History w Zapier czy są jakieś błędy

Zap wykonuje się wielokrotnie dla tej samej faktury

To nie powinno się zdarzać - Zapier śledzi które faktury już przetworzył.

Rozwiązanie:

  1. Sprawdź czy nie masz duplikatów Zapów
  2. Sprawdź Task History - czy to różne faktury o podobnych danych?
  3. Skontaktuj się z supportem Zapier jeśli problem się powtarza

 

Polskie znaki i kodowanie

Polskie znaki wyświetlają się jako "krzaczki"

inFakt poprawnie obsługuje polskie znaki (UTF-8). Problem może być w źródle danych.

  1. Sprawdź czy źródło danych (np. arkusz) używa kodowania UTF-8
  2. W Google Sheets polskie znaki powinny działać automatycznie
  3. Jeśli importujesz z CSV, upewnij się że plik jest w UTF-8
Test: Wpisz polskie znaki ręcznie w teście Zapa. Jeśli działają, problem jest w źródle danych, nie w inFakt.
 

Jak debugować Zapy?

1. Sprawdź Task History

W Zapier przejdź do Zap History aby zobaczyć historię wykonań:

  • Zielone = sukces
  • Czerwone = błąd (kliknij aby zobaczyć szczegóły)
  • Żółte = filtr zatrzymał wykonanie

2. Sprawdź dane wejściowe i wyjściowe

Kliknij na wykonanie Zapa aby zobaczyć:

  • Input - dane wysłane do akcji
  • Output - dane zwrócone przez akcję

3. Przetestuj każdy krok osobno

W edytorze Zapa możesz przetestować każdy krok osobno przyciskiem "Test step".

 

Najczęściej zadawane pytania (FAQ)

Czy mogę używać inFakt Sandbox do testów?

Tak! Zalecamy najpierw testować na Sandbox:

  1. Załóż konto: konto.sandbox-infakt.pl
  2. Uzupełnij dane firmy (patrz pytanie poniżej)
  3. Wygeneruj klucz API w Sandbox
  4. W Zapier wybierz środowisko "Sandbox (Testowe)"

Błąd "Validation failed" na Sandbox - brak danych firmy/konta bankowego

Nowe konto Sandbox nie ma uzupełnionych danych firmy. Jeśli widzisz błąd:

{
  "bank_account": ["Proszę podać poprawny numer konta."],
  "bank_name": ["Proszę podać nazwę banku."],
  "base": ["Brak danych Twojej firmy..."]
}

 

Rozwiązanie:

Przejdź do app.sandbox-infakt.pl → Ustawienia → Dane firmy i uzupełnij:

  1. Dane firmy - NIP, nazwa, adres (mogą być fikcyjne, np. NIP: 5213609120)
  2. Numer konta bankowego - pełny 26-cyfrowy numer (może być fikcyjny, np. 11 1111 1111 1111 1111 1111 1111)
  3. Nazwa banku - dowolna nazwa (np. "Bank Testowy")
Dlaczego to jest wymagane? Faktury z metodą płatności "przelew" (transfer) wymagają danych konta bankowego sprzedawcy. Bez nich API inFakt odrzuci żądanie utworzenia faktury.
 

Czy mogę mieć połączone oba środowiska (Produkcja i Sandbox)?

Tak! W Zapier możesz mieć połączone wiele kont inFakt:

  1. Przy konfiguracji akcji kliknij "Connect a new account"
  2. Dodaj konto Sandbox z osobnym kluczem API
  3. Wybieraj odpowiednie konto dla każdego Zapa

Czy Zapier ma dostęp do moich danych w inFakt?

Zapier ma dostęp tylko do danych potrzebnych do wykonania akcji:

  • Tworzy/odczytuje faktury i klientów zgodnie z Twoimi Zapami
  • Nie przechowuje danych dłużej niż potrzeba
  • Możesz w każdej chwili odłączyć konto

Aby odłączyć: Zapier → Settings → Apps → inFakt → Disconnect

Jak zmienić klucz API w istniejącym połączeniu?

Musisz utworzyć nowe połączenie:

  1. W edytorze Zapa kliknij na akcję inFakt
  2. Kliknij dropdown z kontem
  3. Wybierz "Connect a new account"
  4. Wpisz nowy klucz API
  5. Opcjonalnie: usuń stare połączenie w Settings → Apps

Powiązane artykuły

Komentarze

Komentarze: 0

Zaloguj się, aby dodać komentarz.