Przypadki użycia — Fakturowanie

UC-01 — Wystawienie i wysłanie faktury sprzedażowej

  • Aktor: Pracownik fakturowania
  • Warunek wstępny: użytkownik ma uprawnienia „Invoicing User” (account.group_account_invoice).
  • Przepływ główny:
    1. Użytkownik otwiera menu Fakturowanie → Faktury klientów.
    2. Użytkownik tworzy nową fakturę, wybiera klienta (rekord res.partner).
    3. Użytkownik dodaje linie faktury (produkty/usługi, ilości, ceny) — account.move.line.
    4. System automatycznie nalicza podatki (VAT) na podstawie stawek (account.tax).
    5. Użytkownik ustawia termin płatności (account.payment.term).
    6. Użytkownik klika Otwórz / Zaksięguj, a następnie Wyślij (e-mail/PDF).
  • Warunek końcowy: Faktura ma status Zaksięgowana, jest wysłana do klienta, a zapisy księgowe (należność, przychód, VAT) są automatycznie utworzone.

UC-02 — Rejestracja faktury zakupowej

  • Aktor: Pracownik fakturowania / Księgowy
  • Warunek wstępny: Istnieje dostawca w bazie.
  • Przepływ główny:
    1. Użytkownik otwiera Fakturowanie → Faktury dostawców.
    2. Użytkownik tworzy fakturę, wybiera dostawcę.
    3. Użytkownik dodaje linie (koszty, produkty) lub wkleja skan/PDF (cyfryzacja dokumentów).
    4. System nalicza podatki i przypisuje konta kosztowe.
    5. Użytkownik klika Zaksięguj.
  • Warunek końcowy: Faktura zakupu zaksięgowana; koszty odnotowane w planie kont; zobowiązanie wobec dostawcy utworzone.

UC-03 — Utworzenie noty korygującej

  • Aktor: Pracownik fakturowania
  • Warunek wstępny: Istnieje zaksięgowana faktura.
  • Przepływ główny:
    1. Użytkownik otwiera fakturę.
    2. Użytkownik klika Utwórz notę korygującą (typ out_refund / in_refund).
    3. Użytkownik wybiera zakres korekty (cała faktura lub wybrane linie).
    4. Użytkownik klika Zaksięguj i wysyła do klienta/dostawcy.
  • Warunek końcowy: Utworzona nota korygująca (kredytowa); korekta przychodu i VAT; dokument wysłany.

UC-04 — Przyjęcie płatności i uzgodnienie

  • Aktor: Pracownik fakturowania / Księgowy
  • Warunek wstępny: Istnieje zaksięgowana faktura.
  • Przepływ główny:
    1. Użytkownik otwiera Fakturowanie → Płatności.
    2. Użytkownik tworzy płatność, wybiera fakturę, metodę płatności i datę.
    3. Użytkownik wprowadza kwotę (pełną lub częściową).
    4. Użytkownik klika Zaksięguj.
    5. System uzgadnia płatność z pozycjami faktury (account.reconcile).
  • Warunek końcowy: Faktura zmienia status na Zapłacona (lub częściowo zapłacona); należność zamknięta.

UC-05 — Raport VAT

  • Aktor: Księgowy
  • Warunek wstępny: Istnieją zaksięgowane faktury w okresie.
  • Przepływ główny:
    1. Użytkownik otwiera Fakturowanie → Raporty → VAT.
    2. Użytkownik wybiera okres (miesiąc/kwartał).
    3. Użytkownik przegląda zestawienie: VAT naliczony, VAT należny, VAT do zapłaty.
    4. Użytkownik eksportuje do PDF/Excel.
  • Warunek końcowy: Gotowe zestawienie do rozliczenia z urzędem skarbowym.

UC-06 — Faktura cykliczna (abonament)

  • Aktor: Pracownik fakturowania
  • Warunek wstępny: Konfigurowalne cykliczne faktury.
  • Przepływ główny:
    1. Użytkownik otwiera Fakturowanie → Faktury klientów.
    2. Użytkownik tworzy fakturę i zaznacza Faktura cykliczna.
    3. Użytkownik ustawia częstotliwość (miesięcznie, kwartalnie, rocznie) i datę rozpoczęcia.
    4. Użytkownik zapisuje.
  • Warunek końcowy: System automatycznie generuje faktury w ustalonych odstępach czasu.

UC-07 — Przypomnienie o zaległej płatności (windykacja)

  • Aktor: Pracownik fakturowania + System (cron)
  • Warunek wstępny: Istnieją zaksięgowane faktury z minionym terminem płatności.
  • Przepływ główny:
    1. System automatycznie (cron) sprawdza zaksięgowane faktury z minionym terminem.
    2. System tworzy przypomnienie (follow-up) dla zaległych płatności.
    3. Pracownik generuje list windykacyjny z eskalacją (1., 2., 3. stopień).
  • Warunek końcowy: Pracownik widzi zaległe płatności jako zadania i może wysłać przypomnienie/windykację.

UC-08 — Wielowalutowość i pozycje fiskalne

  • Aktor: Księgowy
  • Warunek wstępny: Skonfigurowane waluty i pozycje fiskalne.
  • Przepływ główny:
    1. Użytkownik tworzy fakturę w walucie innej niż domyślna (np. EUR).
    2. System automatycznie przelicza kwoty po aktualnym kursie (res.currency).
    3. Użytkownik przypisuje pozycję fiskalną (account.fiscal.position) do konta.
    4. System mapuje podatki i konta zgodnie z pozycją fiskalną.
  • Warunek końcowy: Faktura w walucie obcej z automatycznym przelicznikiem i poprawnym mapowaniem podatków/kont.

Odwołane pliki

  • account/models/account_move.py — UC-01, UC-02, UC-03, UC-06 (cykl życia faktury, statusy, podwójny zapis)
  • account/models/account_move_line.py — UC-01, UC-02 (linie faktury, naliczanie podatków)
  • account/models/account_payment.py — UC-04 (płatności, uzgodnienie)
  • account/models/account_tax.py — UC-01, UC-02, UC-05 (podatki)
  • account/models/account_fiscal_position.py — UC-08 (pozycje fiskalne)
  • account/models/account_payment_term.py — UC-01 (terminy płatności)
  • account/models/account_reconcile.py — UC-04 (uzgodnienia)
  • account/models/account_followup.py — UC-07 (windykacja)
  • account/security/account_security.xml — role: Invoicing User / Accountant / Advisor
  • account/views/account_move_views.xml — widoki i przyciski faktur