feat/YD-101-KSeF - Init KSeF documentation: user guides and administrator guides

docs/2-user-guides/05-ksef/01-finvoice/README.md

@@ -0,0 +1,67 @@
+---
+title: Faktury Sprzedażowe
+description: Jak wystawiać faktury sprzedażowe w systemie YetiForce z integracją z KSeF.
+keywords:
+  - KSeF
+  - integracja
+  - Krajowy System e-Faktur
+  - faktury sprzedażowe
+tags:
+  - Faktury
+  - KSeF
+  - Integracje
+---
+
+Wystawienie faktury sprzedażowej z integracją z KSeF w systemie YetiForce jest proste i intuicyjne. Poniżej znajdziesz krok po kroku instrukcję, jak to zrobić:
+
+## 1. Utwórz nową fakturę sprzedażową w systemie YetiForce
+
+Stwórz nowy rekord Faktura Sprzedażowa klikając przycisk `Dodaj rekord` w module Faktury Sprzedażowe.
+
+## 2. Wypełnij wymagane pola
+
+Wypełnij odpowiednio pola rekordu. Pola posiadają domyślne mapowanie do swoich odpowiedników w KSeF, co ułatwia proces wystawiania faktury.
+
+![alt text](finvoice-01.png)
+
+Kluczowe pola do uzupełnienia to:
+
+- `Temat` - numer własny faktury
+- `Kontrahent` - wybierz kontrahenta z listy lub dodaj
+- `Data wystawienia` - data wystawienia faktury
+- `Data sprzedaży` - data sprzedaży towaru lub usługi
+- `Forma płatności` - wybierz z listy
+- `Status` - aby wysłać fakturę do KSeF to pole musi być ustawione na "Wystawiono".
+- Blok `Adres główny` - wypełnij dane adresowe kontrahenta, a także `Nazwa firmy` oraz `NIP` - będą to dane Podmiotu (odbiorca faktury) na fakturze ustrukturyzowanej
+- `Nie wysyłaj do KSeF` - zaznacz "Tak", jeśli faktura *nie ma być wysyłana* do KSeF.
+- `Organizacja` - wybierz powiązany podmiot z modułu Struktura Organizacji. Dane tego podmiotu zostaną użyte do uzupełnienia Podmiotu wystawiającego fakturę. Ważne jest również aby dla danej Organizacji został w panelu administracyjnym YetiForce skonfigurowany certyfikat KSeF, który będzie używany do uwierzytelniania wysyłki faktury do KSeF.
+- `Typ faktury` - w przypadku Faktury Sprzedażowej zwykłej należy wybrać opcję "Podstawowa".
+- Dodatkowe opcjonalne pola jak np. `Konto bankowe`, `Metoda kasowa`, `Podstawa zwolnienia z podatku`, `Treść podstawy zwolnienia` itp. można uzupełnić w zależności od potrzeb.
+
+![alt text](finvoice-03.png)
+
+- Blok zaawansowany zawiera informacje o pozycjach na fakturze. Wpisz pozycje wraz z kwotami netto oraz stawkami podatkowymi.
+
+![alt text](finvoice-02.png)
+
+## 3. Wyślij fakturę do KSeF
+
+Jeżeli na rekordzie faktury pola wypełnione są w sposób umożliwiający wysyłkę do KSeF na górnym pasku akcji pojawi się nowy przycisk `Wyślij do KSeF`. Kliknij ten przycisk, aby wysłać fakturę do KSeF.
+
+![alt text](finvoice-04.png)
+
+:::warning
+
+Uwaga - potwierdzenie operacji wysyłki faktury do KSeF spowoduje, że faktura zostanie wysłana do KSeF i operacji tej nie będzie można cofnąć. Upewnij się, że wszystkie dane na fakturze są poprawne przed potwierdzeniem wysyłki do KSeF.
+
+![alt text](finvoice-05.png)
+
+:::
+
+## 4. Poczekaj na potwierdzenie statusu z KSeF
+
+Po pewnym czasie od wysyłki faktury do KSeF informacja o statusie faktury zostanie przetworzona i na rekordzie automatycznie zaktualizowane zostaną pola:
+
+- `Status KSeF` - status wysyłki faktury do KSeF, np. "W trakcie wysyłki", "Wysłana", "Błąd" itp.
+- `Data wpływu do KSeF` - data wpływu otrzymana z KSeF
+- `Numer KSeF` - numer faktury nadany przez KSeF (tzw. "numer KSeF")

docs/2-user-guides/05-ksef/02-finvoice-advance/README.md

@@ -0,0 +1,36 @@
+---
+title: Faktury Zaliczki
+description: Jak wystawiać faktury zaliczkowe (sprzedażowe) w systemie YetiForce z integracją z KSeF.
+keywords:
+  - KSeF
+  - integracja
+  - Krajowy System e-Faktur
+  - faktury sprzedażowe
+  - faktury zaliczkowe
+  - zaliczka
+  - proforma
+tags:
+  - Faktury
+  - KSeF
+  - Integracje
+---
+
+:::info
+
+Faktury zaliczkowe w systemie YetiForce z integracją z KSeF są wystawiane na podobnej zasadzie jak standardowe faktury sprzedażowe. Zapoznaj się z instrukcją dotyczącą wystawiania **[Faktur Sprzedażowych](../01-finvoice/README.md)** w systemie YetiForce z integracją z KSeF.
+
+:::
+
+## Kluczowe różnice przy wystawianiu faktur zaliczkowych (względem faktur podstawowych)
+
+### 1. Utwórz Fakturę Proformę
+
+Faktura Proforma nie jest dokumentem księgowym wysyłanym do KSeF, ale służy do wystawienia oferty lub potwierdzenia zamówienia. W systemie YetiForce faktura proforma jest dokumentem bazowym, do którego będą odnosić się faktury zaliczkowe oraz rozliczeniowe dotyczące tej samej transakcji.
+
+### 2. Utwórz fakturę sprzedażową typu "Zaliczka"
+
+- W polu `Typ faktury` wybierz opcję "Zaliczkowa"
+- W polu `Proforma` wskaż rekord odpowiedniej faktury proformy
+- W polu `Kwota zaliczki` wpisz kwotę zaliczki, jaką obejmuje faktura zaliczkowa
+
+![alt text](finvoice-advance-01.png)

docs/2-user-guides/05-ksef/03-finvoice-settlement/README.md

@@ -0,0 +1,35 @@
+---
+title: Faktury Rozliczeniowe
+description: Jak wystawiać faktury rozliczeniowe (sprzedażowe) w systemie YetiForce z integracją z KSeF.
+keywords:
+  - KSeF
+  - integracja
+  - Krajowy System e-Faktur
+  - faktury sprzedażowe
+  - faktury rozliczeniowe
+tags:
+  - Faktury
+  - KSeF
+  - Integracje
+---
+
+:::info
+
+Faktury rozliczeniowe w systemie YetiForce z integracją z KSeF są wystawiane na podobnej zasadzie jak standardowe faktury sprzedażowe. Zapoznaj się z instrukcją dotyczącą wystawiania **[Faktur Sprzedażowych](../01-finvoice/README.md)** oraz **[Faktur Zaliczkowych](../02-finvoice-advance/README.md)** w systemie YetiForce z integracją z KSeF.
+
+:::
+
+## Kluczowe różnice przy wystawianiu faktur rozliczeniowych (względem faktur podstawowych)
+
+### 1. Znajdź odpowiednią Fakturę Proformę
+
+Faktura Proforma nie jest dokumentem księgowym wysyłanym do KSeF, ale służy do wystawienia oferty lub potwierdzenia zamówienia. W systemie YetiForce faktura proforma jest dokumentem bazowym, do którego będą odnosić się faktury zaliczkowe oraz rozliczeniowe dotyczące tej samej transakcji. Jako że faktura rozliczeniowa jest dokumentem końcowym, musi odnosić się do faktury proformy z której wynikają faktury zaliczkowe (patrz instrukcja dotycząca wystawiania **[Faktur Zaliczkowych](../02-finvoice-advance/README.md)**).
+
+### 2. Utwórz fakturę sprzedażową typu "Rozliczeniowa"
+
+- W polu `Typ faktury` wybierz opcję "Rozliczeniowa"
+- W polu `Proforma` wskaż rekord odpowiedniej faktury proformy
+
+Kwota rozliczenia zostanie automatycznie obliczona na podstawie faktury proformy i powiązanych faktur zaliczkowych.
+
+![alt text](finvoice-settlement-01.png)

docs/2-user-guides/05-ksef/04-fcorectinginvoice/README.md

@@ -0,0 +1,91 @@
+---
+title: Faktury Korekty
+description: Jak wystawiać faktury korygujące (sprzedażowe) w systemie YetiForce z integracją z KSeF.
+keywords:
+  - KSeF
+  - integracja
+  - Krajowy System e-Faktur
+  - faktury sprzedażowe
+  - faktury korygujące
+  - korekta
+tags:
+  - Faktury
+  - KSeF
+  - Integracje
+---
+
+## 1. Utwórz nową fakturę korygującą w systemie YetiForce
+
+Fakturę korygującą utworzysz w systemie YetiForce w module o nazwie "Faktury Korekty". Aby faktura korygująca mogła powstać, musi istnieć faktura sprzedażowa, do której będzie wystawiana korekta. Faktura korygująca jest powiązana z fakturą sprzedażową poprzez pole `Faktura`.
+
+## 2. Wypełnij wymagane pola
+
+Wypełnij odpowiednio pola rekordu. Pola posiadają domyślne mapowanie do swoich odpowiedników w KSeF, co ułatwia proces wystawiania faktury.
+
+![alt text](fcorectinginvoice-01.png)
+
+Kluczowe pola do uzupełnienia to:
+
+- `Faktura` - rekord powiązany z fakturą sprzedażową, do której wystawiana jest korekta. **Po wybraniu faktury sprzedażowej pola faktury korygującej zostaną automatycznie uzupełnione danymi z faktury sprzedażowej**.
+- `Temat` - numer własny faktury
+- `Kontrahent` - wybierz kontrahenta z listy lub dodaj
+- `Data wystawienia` - data wystawienia faktury
+- `Data sprzedaży` - data sprzedaży towaru lub usługi
+- `Forma płatności` - wybierz z listy
+- `Status` - aby wysłać fakturę do KSeF to pole musi być ustawione na "Wystawiono".
+- Blok `Adres główny` - wypełnij dane adresowe kontrahenta, a także `Nazwa firmy` oraz `NIP` - będą to dane Podmiotu (odbiorca faktury) na fakturze ustrukturyzowanej
+- `Nie wysyłaj do KSeF` - zaznacz "Tak", jeśli faktura *nie ma być wysyłana* do KSeF.
+- `Organizacja` - wybierz powiązany podmiot z modułu Struktura Organizacji. Dane tego podmiotu zostaną użyte do uzupełnienia Podmiotu wystawiającego fakturę. Ważne jest również aby dla danej Organizacji został w panelu administracyjnym YetiForce skonfigurowany certyfikat KSeF, który będzie używany do uwierzytelniania wysyłki faktury do KSeF.
+- `Typ faktury` - należy wybrać odpowiednią opcję z listy "Podstawowa", "Zaliczkowa", "Rozliczeniowa" w zależności od rodzaju faktury sprzedażowej, którą korygujemy.
+- Dodatkowe opcjonalne pola jak np. `Konto bankowe`, `Metoda kasowa`, `Podstawa zwolnienia z podatku`, `Treść podstawy zwolnienia` itp. można uzupełnić w zależności od potrzeb.
+
+- Blok zaawansowany zawiera informacje o pozycjach na fakturze. Dane przed korektą zostaną skopiowane z faktury źródłowej. Uzupełnij pozycje w bloku "Dane po korekcie" wraz z kwotami netto oraz stawkami podatkowymi.
+
+![alt text](fcorectinginvoice-02.png)
+
+## 3. Wyślij fakturę do KSeF
+
+Jeżeli na rekordzie faktury pola wypełnione są w sposób umożliwiający wysyłkę do KSeF, na górnym pasku akcji pojawi się nowy przycisk `Wyślij do KSeF`. Kliknij ten przycisk, aby wysłać fakturę do KSeF.
+
+![alt text](fcorectinginvoice-03.png)
+
+:::warning
+
+Uwaga - potwierdzenie operacji wysyłki faktury do KSeF spowoduje, że faktura zostanie wysłana do KSeF i operacji tej nie będzie można cofnąć. Upewnij się, że wszystkie dane na fakturze są poprawne przed potwierdzeniem wysyłki do KSeF.
+
+![alt text](fcorectinginvoice-04.png)
+
+:::
+
+## 4. Poczekaj na potwierdzenie statusu z KSeF
+
+Po pewnym czasie od wysyłki faktury do KSeF informacja o statusie faktury zostanie przetworzona i na rekordzie automatycznie zaktualizowane zostaną pola:
+
+- `Status KSeF` - status wysyłki faktury do KSeF, np. "W trakcie wysyłki", "Wysłana", "Błąd" itp.
+- `Data wpływu do KSeF` - data wpływu otrzymana z KSeF
+- `Numer KSeF` - numer faktury nadany przez KSeF (tzw. "numer KSeF")
+
+## 5. Faktury korygujące faktury zaliczkowe
+
+Podobnie jak w przypadku **[Faktur Zaliczkowych](../02-finvoice-advance/README.md)** na fakturze korygującej zaliczkę należy wskazać Fakturę Proforma. W systemie YetiForce faktura proforma jest dokumentem bazowym, do którego będą odnosić się faktury zaliczkowe oraz rozliczeniowe dotyczące tej samej transakcji.
+
+### Dodatkowe pola na rekordzie Faktury Korygującej typu "Zaliczka"
+
+- W polu `Typ faktury` wybierz opcję "Zaliczkowa"
+- W polu `Proforma` wskaż rekord odpowiedniej faktury proformy
+- W polu `Kwota zaliczki` wpisz kwotę zaliczki, jaką obejmuje korygowana faktura zaliczkowa
+
+![alt text](fcorectinginvoice-05.png)
+
+## 6. Faktury korygujące faktury rozliczeniowe
+
+Podobnie jak w przypadku **[Faktur Rozliczeniowych](../03-finvoice-settlement/README.md)** na fakturze korygującej rozliczeniową należy wskazać Fakturę Proforma. W systemie YetiForce faktura proforma jest dokumentem bazowym, do którego będą odnosić się faktury zaliczkowe oraz rozliczeniowe dotyczące tej samej transakcji.
+
+### Dodatkowe pola na rekordzie Faktury Korygującej typu "Rozliczeniowa"
+
+- W polu `Typ faktury` wybierz opcję "Rozliczeniowa"
+- W polu `Proforma` wskaż rekord odpowiedniej faktury proformy
+
+Kwota rozliczenia zostanie automatycznie obliczona na podstawie faktury proformy i powiązanych faktur zaliczkowych.
+
+![alt text](fcorectinginvoice-06.png)

docs/2-user-guides/05-ksef/05-finvoicecost/README.md

@@ -0,0 +1,29 @@
+---
+title: Faktury Kosztowe
+description: Jak obsługiwać faktury kosztowe w systemie YetiForce z integracją z KSeF.
+keywords:
+  - KSeF
+  - integracja
+  - Krajowy System e-Faktur
+  - faktury kosztowe
+tags:
+  - Faktury
+  - KSeF
+  - Integracje
+---
+
+## Pobieranie faktur kosztowych z KSeF
+
+Pobieranie faktur kosztowych z KSeF odbywa się w systemie YetiForce automatycznie. YetiForce cyklicznie odpytuje API KSeF o nowe faktury kosztowe i je pobiera. Po pobraniu faktury kosztowej z KSeF, zostanie ona przetworzona i utworzony zostanie rekord faktury w module "Faktury Kosztowe" z uzupełnionymi danymi z pobranej faktury ustrukturyzowanej.
+
+### Aby funkcjonalność importowania faktur kosztowych z KSeF działała poprawnie, należy upewnić się, że
+
+- w panelu administracyjnym systemu YetiForce została aktywowana integracja z KSeF
+- w konfiguracji integracji z KSeF istnieje aktywny Certyfikat KSeF - pobierane będą te faktury kosztowe, które zostały wystawione na podmiot powiązany z tym certyfikatem (NIP podmiotu)
+- włączony jest harmonogram pobierania (zadania CRON) - od częstotliwości harmonogramu zależy, jak szybko po wystawieniu faktury kosztowej w KSeF zostanie ona pobrana do YetiForce
+
+:::info
+
+Więcej informacji o konfiguracji integracji z KSeF, w tym o dodawaniu certyfikatów KSeF, znajdziesz w sekcji [Dokumentacja administratora: KSeF](../../../3-administrator-guides/15-integration/20-ksef/README.md).
+
+:::

docs/2-user-guides/05-ksef/README.md

@@ -0,0 +1,24 @@
+---
+title: KSeF (Faktury)
+description: Integracja z KSeF w systemie YetiForce
+keywords:
+  - KSeF
+  - integracja
+  - Krajowy System e-Faktur
+  - faktury
+tags:
+  - Faktury
+  - KSeF
+  - Integracje
+hide_table_of_contents: true
+---
+
+:::info
+
+Funkcjonalność integracji z KSeF musi zostać aktywowana przez administratora systemu. Proces aktywacji został opisany w sekcji [Dokumentacja administratora: KSeF](../../3-administrator-guides/15-integration/20-ksef/README.md).
+
+:::
+
+import DocCardList from '@theme/DocCardList';
+
+<DocCardList />

docs/3-administrator-guides/15-integration/20-ksef/00-changelog/README.md

@@ -0,0 +1,35 @@
+---
+title: Rejestr zmian
+description: Rejestr zmian wg. wersji systemu YetiForce.
+keywords:
+  - KSeF
+  - integracja
+  - Krajowy System e-Faktur
+  - konfiguracja
+  - faktury
+tags:
+  - Faktury
+  - KSeF
+  - Integracje
+---
+
+## Najważniejsze zmiany funkcjonalne z podziałem na wersje systemu YetiForce
+
+Obsługa API KSeF została dodana w wersji 7.1.0 systemu YetiForce. Zalecamy korzystanie z najnowszej wersji systemu YetiForce, aby mieć dostęp do najnowszych funkcjonalności i poprawek związanych z integracją z KSeF. Poniżej znajduje się lista najważniejszych zmian funkcjonalnych wprowadzonych w kolejnych wersjach systemu YetiForce związanych z integracją z KSeF.
+
+---
+
+### 7.1.1
+
+- rozszerzenie wysyłki faktur sprzedażowych z CRM do KSeF o rodzaje "faktura korekta" (KOR, KOR_ZAL, KOR_ROZ), "faktura zaliczkowa" (ZAL), "faktura rozliczeniowa" (ROZ)
+- rozszerzenie pobierania faktur z KSeF do CRM o rodzaje "faktura korekta" (KOR, KOR_ZAL, KOR_ROZ), "faktura zaliczkowa" (ZAL), "faktura rozliczeniowa" (ROZ)
+- obsługa faktur "uproszczonych" została usunięta
+
+---
+
+### 7.1.0
+
+- ***dodanie integracji z KSeF w systemie YetiForce***
+- autoryzacja do KSeF za pomocą certyfikatu KSeF
+- wysyłka faktur sprzedażowych z CRM do KSeF (rodzaj "faktura podstawowa", "faktura uproszczona")
+- pobieranie faktur z KSeF do CRM (rodzaj "faktura podstawowa")

docs/3-administrator-guides/15-integration/20-ksef/01-activation/README.md

@@ -0,0 +1,36 @@
+---
+title: Aktywacja
+description: Aktywacja integracji z KSeF w systemie YetiForce. Jak przeprowadzić pierwszą konfigurację.
+keywords:
+  - KSeF
+  - integracja
+  - Krajowy System e-Faktur
+  - konfiguracja
+  - faktury
+tags:
+  - Faktury
+  - KSeF
+  - Integracje
+---
+
+## Pierwsza aktywacja integracji z KSeF
+
+Integracja z KSeF w systemie YetiForce jest domyślnie wyłączona i wymaga przeprowadzenia procesu aktywacji, który umożliwi korzystanie z funkcjonalności związanych z Krajowym Systemem e-Faktur. Poniżej znajdziesz instrukcję krok po kroku, jak przeprowadzić pierwszą konfigurację integracji z KSeF.
+
+### 1. Przejdź do panelu administracyjnego systemu YetiForce (Konfiguracja systemu > Integracja > KSeF)
+
+![alt text](activation-01.png)
+
+### 2. Kliknij przycisk `Aktywuj`. Pojawi się komunikat potwierdzający. Przejście dalej spowoduje rekonfigurację systemu i włączenie funkcjonalności integracji z KSeF
+
+![alt text](activation-02.png)
+
+:::warning
+
+**Uwaga!**
+
+Aktywacja integracji z KSeF spowoduje zmiany w modułach faktur (Faktury Sprzedażowe, Faktury Kosztowe, Faktury Korekty, Faktury Proforma) oraz w ustawieniach dotyczących m.in. stawek podatkowych. Zalecamy wykonanie kopii zapasowej systemu oraz przeprowadzenie próbnej aktywacji na środowisku testowym przed przystąpieniem do aktywacji tej funkcjonalności.
+
+Proces ten może potrwać kilka minut, a w tym czasie system może być niedostępny.
+
+:::