iFirma WooCommerce

Opis

Integracja dla iFirma i WooCommerce łączy Twój sklep WooCommerce z systemem księgowym iFirma.

Generuj faktury z ekranu zamówienia, pobieraj PDF-y i pozwól klientom pobierać dokumenty z Moje konto. Wtyczka również obsługuje checkout WooCommerce Blocks i HPOS.

Główne funkcje (FREE)

• Ręczne generowanie faktur – Twórz faktury bezpośrednio z ekranu edycji zamówienia WooCommerce
• Synchronizacja klientów – Synchronizuj dane klientów z kontrahentami iFirma
• Obsługa pola NIP – Dodaj pole numeru NIP do checkout (kompatybilne z wtyczką nip-field-woocommerce)
• Obsługa WooCommerce Blocks – Kompatybilność z blokami checkout Gutenberg
• Zaawansowane mapowanie VAT – Mapuj klasy podatkowe WooCommerce na kody/stawki VAT iFirma (23%, 8%, 5%, zw, 0%)
• Obsługa ryczałtu – Ustaw stawkę ryczałtu do pozycji na fakturze
• Pobieranie faktur – Pobieraj PDF-y bezpośrednio z panelu WooCommerce
• Pobieranie przez klienta – Pozwól klientom pobierać faktury z Moje konto → Zobacz zamówienie
• Szczegółowe logowanie – Śledź komunikację API do debugowania
• Kompatybilność z HPOS – Pełna obsługa WooCommerce High-Performance Order Storage

Funkcje PRO

• Automatyczne generowanie faktur – Twórz faktury automatycznie przy zmianie statusu zamówienia
• Automatyczne proformy – Wystawiaj proformy automatycznie dla wybranych statusów
• Obsługa rachunków – Generuj dokumenty bez VAT (rachunki)
• E-mail z załącznikami PDF – Wysyłaj dokumenty do klientów jako załączniki PDF
• Operacje zbiorcze – Generuj dokumenty i pobieraj PDF-y dla wielu zamówień z śledzeniem postępu
• GTU / PKWiU / Jednostki – Pola na poziomie produktu + globalne domyślne w ustawieniach
• Globalne uwagi na fakturze – Definiuj globalne uwagi w ustawieniach (obsługa zmiennych)
• Priorytetowe wsparcie – Bezpośredni dostęp do zespołu wsparcia
• Automatyczne aktualizacje – Otrzymuj nowe funkcje i poprawki automatycznie

Sprawdź wersję PRO

Wymagania

• WordPress 5.8 lub wyższy
• WooCommerce 5.0 lub wyższa
• PHP 7.4 lub wyższa
• Aktywne konto iFirma z dostępem do API

Usługi zewnętrzne

Ta wtyczka łączy się z dwoma zewnętrznymi usługami: API iFirma (do fakturowania) i API NBP (do kursów wymiany).

Czym jest API iFirma?

iFirma to polski internetowy system księgowy świadczący usługi fakturowania i księgowości dla firm. Ta wtyczka wykorzystuje ich oficjalne API do:
* Tworzenia i zarządzania klientami (kontrahentami) na Twoim koncie iFirma.
* Generowania faktur (FREE).
* Generowania proform i rachunków (PRO).
* Pobierania dokumentów w formacie PDF.

Jakie dane są wysyłane i kiedy?

Wtyczka wysyła następujące dane do API iFirma (https://api.ifirma.pl/) w tych sytuacjach:

Gdy klikniesz „Utwórz fakturę” (lub gdy automatyzacja wyzwala generowanie dokumentu w wersji PRO):
* Dane rozliczeniowe klienta: imię, nazwisko, nazwa firmy, numer NIP, e-mail, numer telefonu, adres rozliczeniowy (ulica, miasto, kod pocztowy, kraj).
* Informacje o zamówieniu: pozycje zamówienia (nazwy produktów, ilości, ceny, stawki VAT), szczegóły dostawy, metoda płatności, data zamówienia, suma zamówienia.

Gdy wtyczka łączy się z API iFirma (przy ładowaniu strony ustawień lub gdy potrzeba):
* Twoje dane logowania API wprowadzone w ustawieniach wtyczki (do uwierzytelniania).
* Zapytania o pobranie danych wymaganych do wystawiania dokumentów (np. szablony/serie/ustawienia gdzie dotyczy).

Żadne dane nie są wysyłane automatycznie bez Twojej akcji w wersji FREE. Wtyczka komunikuje się z API iFirma gdy:
* Ręcznie tworzysz fakturę z ekranu zamówienia.
* Otwierasz stronę ustawień wtyczki (aby przetestować połączenie i załadować konfigurację).
* Włączysz automatyczne generowanie dokumentów w wersji PRO (jeśli zainstalowana).

Informacje o usłudze

• Nazwa usługi: API iFirma
• URL usługi: https://www.ifirma.pl/
• Dokumentacja API: https://api.ifirma.pl/
• Regulamin: https://pomoc.ifirma.pl/pomoc-kategoria/oferta-serwisu-ifirma/regulaminy/
• Polityka prywatności: https://www.ifirma.pl/rodo/polityka-prywatnosci-ifirma-pl/

Czym jest API NBP?

API NBP (Narodowy Bank Polski) to publiczne API polskiego banku centralnego udostępniające oficjalne kursy walut obcych. Ta wtyczka wykorzystuje je do uzyskania kursów wymiany przy generowaniu faktur w walutach obcych (np. EUR, USD) lub przy wystawianiu dokumentów WDT/OSS z kwotami nie w PLN. Kurs jest potrzebny do przeliczenia kwot na PLN dla iFirma zgodnie z polskimi przepisami księgowymi.

Jakie dane są wysyłane do NBP i kiedy?

Gdy tworzysz fakturę w walucie obcej (lub gdy automatyzacja wyzwala to w PRO):
* Wtyczka wysyła zapytanie GET do API NBP z kodem waluty (np. EUR, USD) i datą faktury/zamówienia w URL. Żadne dane osobowe, dane klienta ani szczegóły zamówienia nie są wysyłane.
* Przykładowy URL: https://api.nbp.pl/api/exchangerates/rates/A/EUR/2024-01-15/?format=json
* Odpowiedź (kurs wymiany) jest cache’owana przez 24 godziny, aby zmniejszyć liczbę zapytań.

Żadne dane nie są wysyłane do NBP bez tworzenia dokumentu wymagającego kursu waluty obcej. Zapytanie odbywa się tylko wtedy, gdy generowana jest faktura (lub proforma/rachunek w PRO) i waluta zamówienia nie jest PLN.

Informacje o usłudze NBP

• Nazwa usługi: API NBP (Narodowy Bank Polski)
• URL usługi: https://api.nbp.pl/
• Dokumentacja API: https://api.nbp.pl/
• Polityka prywatności: https://nbp.pl/o-nbp/kontakt/regulaminy/

Korzystając z tej wtyczki, potwierdzasz, że dane klientów i zamówień będą przekazywane do iFirma w celu generowania faktur oraz że kody walut i daty mogą być wysyłane do API NBP w celu uzyskania kursów wymiany. Jesteś odpowiedzialny za zapewnienie zgodności z obowiązującymi przepisami o ochronie danych (w tym RODO) oraz poinformowanie klientów o tym przetwarzaniu.