Przejdź do głównej zawartości

Księga faktur

Moduł invoice_ledger zapewnia wspólne mechanizmy, z których korzysta każdy adapter systemu księgowego: wzajemne wykluczanie, dzięki któremu operator może mieć aktywnego tylko jednego dostawcę, ustawienia numeracji i trasowania KSeF, mapowania klientów i dokumentów, wysyłki oraz potwierdzenia webhooków.

Komunikację HTTP z dostawcą obsługują moduły adapterów poszczególnych dostawców. Ten moduł nie łączy się z żadnym dostawcą.

Dla operatora​

  • Księga faktur w sekcji Sprzedaż otwiera listę wysyłek (dostaw). Trasowanie jest zakładką na tym samym pasku.
  • Moduł adaptera dostawcy dodaje zakładkę połączenia, gdy adapter jest włączony.
  • Zmiana trasowania (numeracja Endory albo dostawcy, natywny KSeF albo KSeF dostawcy) wymaga potwierdzenia przed zapisem. Zapis, który zmienia zapisany tryb numeracji bez confirm: true, jest odrzucany z 400 INVOICE_LEDGER_NUMBERING_CHANGE_UNCONFIRMED (details.field: "confirm", from, to), a operator czyta komunikat we własnym języku. Dzieje się tak również wtedy, gdy inny operator zmienił tryb po wczytaniu strony. Do zgłoszenia #644 kodem odpowiedzi był 400 VALIDATION_FAILED.
  • Wyłączenie adaptera dostawcy ukrywa jego zakładkę. Historia wysyłek w tym module pozostaje.
  • Księgi faktur nie można wyłączyć na /platform/modules: moduł jest niewyłączalny, ponieważ to jego rejestr odrzuca włączenie drugiego adaptera dostawcy, gdy jeden jest już aktywny (INVOICE_LEDGER_VENDOR_ALREADY_ACTIVE). Aby zmienić dostawcę, najpierw wyłącz aktywny adapter.

Dla programisty​

Schemat danych należy do tego modułu. Adapter dostawcy nie dostarcza własnej migracji. Identyfikatory faktur w mapowaniach i wysyłkach to UUID bez klucza obcego do modułu invoices.