AccountingVariant
AccountingVariant (wariant dekretacji, grupa rozksięgowań) to zasób kanoniczny opisujący konfigurację wariantu księgowania w obrębie firmy. Służy do grupowania i rozróżniania reguł dekretacji dla dokumentów księgowych.
Rozszerza DomainResource.
1. Zakres i zastosowanie
AccountingVariant jest słownikowym zasobem konfiguracyjnym. Identyfikacja biznesowa opiera się na identifier[], a klasyfikacja na polach dziedziczonych z DomainResource.
Obiekt jest wykorzystywany w księgowości do wskazania, według jakiej grupy rozksięgowań ma być przetwarzany dokument — przez accountingVariant na nagłówku i pozycjach PostingInstruction oraz przez listy dopuszczonych wariantów w Register.
2. Zawartość (struktura)
Poza polami z DomainResource (id, resourceType, meta, owner[], comment, category[], status, type, contained[], attribute[]):
| Nazwa | Kard. | Typ | Opis |
|---|---|---|---|
| identifier | 0..* | Identifier | Identyfikatory wariantu |
| name | 0..1 | string | Nazwa wariantu dekretacji |
2a. Identyfikatory
| Przestrzeń (klucz) | Znaczenie | Klucz referencyjny | Skąd system |
|---|---|---|---|
AccountingVariant.Id |
Id wariantu księgowania | tak | NamingSystem; urn:oid:1.2.616.1.113769.4.<instalacja>.70 |
Prefiks <instalacja> przekazuje KAMSOFT w parametrach wdrożenia — zob. Identyfikacja i parametry wdrożenia. Rodzaj identyfikatora niesie Identifier.system.
3. Operacje
| Metoda | Ścieżka | Opis |
|---|---|---|
| GET | /v1/accounting-variants |
Wyszukiwanie wariantów dekretacji (tylko odczyt) |
Instalację księgowości wyznacza profil zasobu, a gdy podano przestrzeń identyfikatora — ta przestrzeń (zakres żądania). Odpowiedź: { "items": [...], "nextToken": null }; paginacja count (domyślnie 20) i offset (domyślnie 0).
| Parametr | Wymagany | Format | Opis |
|---|---|---|---|
identifier |
nie | system\|value |
Id wariantu w przestrzeni AccountingVariant.Id; podany — zwraca jeden element |
owner |
nie | system\|value |
Firma po NIP: https://gov.pl/nip\|<NIP> |
Błędny format parametru → 400 Problem Details (type = https://httpstatuses.com/400).