Przejdź do treści

🔗 Integracje

Ten przewodnik pomoże Ci skonfigurować integracje zewnętrzne: REGON API, Biała Lista VAT, Email, Transactional Email i inne.

🎯 Dostępne integracje

Integracje rządowe

  • REGON API - Automatyczne pobieranie danych firm z GUS
  • Biała Lista VAT - Weryfikacja kontrahentów na Białej Liście VAT
  • KSeF - Integracja z Krajowym Systemem e-Faktur (planowane)

Integracje email

  • SMTP - Wysyłanie emaili przez SMTP
  • IMAP - Odbieranie emaili przez IMAP
  • OAuth2 - Gmail i Outlook 365
  • Transactional Email - SendGrid, Mailtrap, Mailgun, Postmark, AWS SES

Inne integracje

  • Stripe - Płatności i subskrypcje
  • OpenAI - AI features (GPT-4)
  • n8n/Zapier - Automatyzacje (webhooks)

📋 REGON API

Konfiguracja

  1. Przejdź do Ustawienia → Integracje → REGON
  2. Wprowadź API Key REGON
  3. Kliknij "Test połączenia"
  4. Jeśli test się powiedzie, kliknij "Zapisz"

Funkcje

  • Auto-wypełnianie danych - Automatyczne pobieranie danych firm
  • Weryfikacja NIP - Weryfikacja numeru NIP
  • Cache - Cache danych (24h TTL) dla szybkości

Użycie

System automatycznie używa REGON API przy: - Dodawaniu klienta (wprowadzenie NIP) - Dodawaniu kontrahenta (wprowadzenie NIP) - Weryfikacji danych firmy

📋 Biała Lista VAT

Konfiguracja

  1. Przejdź do Ustawienia → Integracje → VAT
  2. Włącz "Automatyczna weryfikacja"
  3. Skonfiguruj powiadomienia (email gdy kontrahent zostanie usunięty)
  4. Kliknij "Zapisz"

Funkcje

  • Automatyczna weryfikacja - Codzienne sprawdzanie o 6:00
  • Status VAT - ACTIVE, REMOVED, EXEMPT, ERROR
  • Weryfikacja kont bankowych - Sprawdzanie każdego konta osobno
  • Powiadomienia - Email gdy kontrahent zostanie usunięty

Użycie

System automatycznie weryfikuje: - Kontrahentów przy dodawaniu - Kontrahentów codziennie o 6:00 - Konta bankowe kontrahentów

📧 Email (SMTP/IMAP)

Konfiguracja SMTP

  1. Przejdź do Ustawienia → Integracje → Email → SMTP
  2. Wprowadź dane:
  3. Host SMTP - smtp.example.com
  4. Port - 587 (TLS) lub 465 (SSL)
  5. Użytkownik - Twój email
  6. Hasło - Hasło do emaila
  7. Szyfrowanie - TLS lub SSL
  8. Kliknij "Test połączenia"
  9. Jeśli test się powiedzie, kliknij "Zapisz"

Konfiguracja IMAP

  1. Przejdź do Ustawienia → Integracje → Email → IMAP
  2. Wprowadź dane:
  3. Host IMAP - imap.example.com
  4. Port - 993 (SSL) lub 143 (TLS)
  5. Użytkownik - Twój email
  6. Hasło - Hasło do emaila
  7. Szyfrowanie - SSL lub TLS
  8. Kliknij "Test połączenia"
  9. Jeśli test się powiedzie, kliknij "Zapisz"

OAuth2 (Gmail/Outlook)

  1. Przejdź do Ustawienia → Integracje → Email → OAuth2
  2. Wybierz dostawcę (Gmail lub Outlook 365)
  3. Kliknij "Autoryzuj"
  4. Zaloguj się do konta Google/Microsoft
  5. Zaakceptuj uprawnienia
  6. System automatycznie zapisze tokeny

Synchronizacja

  • Częstotliwość - Co 5 minut (domyślnie)
  • Foldery - Automatyczne tworzenie folderów
  • Threading - Automatyczne grupowanie wątków

📧 Transactional Email

Konfiguracja SendGrid

  1. Przejdź do Ustawienia → Integracje → Transactional Email
  2. Wybierz SendGrid
  3. Wprowadź API Key SendGrid
  4. Kliknij "Test połączenia"
  5. Jeśli test się powiedzie, kliknij "Zapisz"

Konfiguracja Mailtrap

  1. Przejdź do Ustawienia → Integracje → Transactional Email
  2. Wybierz Mailtrap
  3. Wprowadź API Key Mailtrap
  4. Kliknij "Test połączenia"
  5. Jeśli test się powiedzie, kliknij "Zapisz"

Inne providery

  • Mailgun - Konfiguracja podobna do SendGrid
  • Postmark - Konfiguracja podobna do SendGrid
  • AWS SES - Konfiguracja z AWS credentials

Funkcje

  • Smart Fallback - Automatyczne przełączanie między providerami
  • Custom FROM Name - Własna nazwa nadawcy per zespół
  • Reply-To routing - Inteligentne przekierowanie odpowiedzi
  • Attachments - Pełne wsparcie załączników

💳 Stripe

Konfiguracja

  1. Przejdź do Ustawienia → Integracje → Stripe
  2. Wprowadź API Key Stripe
  3. Wprowadź Secret Key Stripe
  4. Kliknij "Test połączenia"
  5. Jeśli test się powiedzie, kliknij "Zapisz"

Funkcje

  • Subskrypcje - Zarządzanie subskrypcjami
  • Płatności - Przetwarzanie płatności
  • Webhooks - Automatyczne aktualizacje statusu

🤖 OpenAI (GPT-4)

Konfiguracja

  1. Przejdź do Ustawienia → Integracje → OpenAI
  2. Wprowadź API Key OpenAI
  3. Kliknij "Test połączenia"
  4. Jeśli test się powiedzie, kliknij "Zapisz"

Funkcje

  • AI Auto-Reply - Automatyczne odpowiedzi na emaile
  • AI Task Creation - Automatyczne tworzenie zadań
  • Smart Reply - Sugestie odpowiedzi
  • Summarization - Podsumowania emaili

🔗 Webhooks (n8n/Zapier)

Konfiguracja

  1. Przejdź do Ustawienia → Integracje → Webhooks
  2. Kliknij "Dodaj webhook"
  3. Wprowadź dane:
  4. URL - URL webhooka
  5. Eventy - Wybierz eventy do wysłania
  6. Secret - Secret do weryfikacji (opcjonalnie)
  7. Kliknij "Zapisz"

Eventy

  • Klient utworzony - Gdy nowy klient zostanie dodany
  • Faktura wystawiona - Gdy faktura zostanie wystawiona
  • Zadanie utworzone - Gdy zadanie zostanie utworzone
  • Email otrzymany - Gdy email zostanie otrzymany

💡 Najlepsze praktyki

Bezpieczeństwo

  • API keys - Bezpiecznie przechowuj API keys
  • Rotacja kluczy - Regularnie rotuj API keys
  • Ograniczenia - Używaj ograniczeń rate limiting

Monitorowanie

  • Status - Regularnie sprawdzaj status integracji
  • Logi - Przeglądaj logi integracji
  • Alerty - Konfiguruj alerty przy błędach

Testowanie

  • Test połączenia - Zawsze testuj połączenia przed zapisaniem
  • Test funkcji - Testuj funkcje po konfiguracji
  • Fallback - Sprawdzaj fallback mechanisms

🆘 Rozwiązywanie problemów

Problem: Integracja nie działa

Rozwiązanie: - Sprawdź czy API keys są poprawne - Sprawdź czy integracja jest włączona - Sprawdź logi w ustawieniach - Przetestuj połączenie - Skontaktuj się z supportem

Problem: Email nie synchronizuje się

Rozwiązanie: - Sprawdź czy IMAP jest poprawnie skonfigurowany - Sprawdź czy synchronizacja jest włączona - Sprawdź logi synchronizacji - Sprawdź czy porty nie są zablokowane

📚 Więcej informacji

Ostatnia aktualizacja: 2025-11-29
Wersja dokumentacji: 1.0