Przejdź do treści

Majątek (środki trwałe)

Podkatalog ESM zawiera model kanoniczny dla ewidencji środków trwałych i dokumentów ruchu majątku. Domena wykorzystuje wspólne zasoby Location, Party oraz DocumentReference, a zasoby majątkowe koncentrują się na kartotece, komponentach, przypisaniach wielowymiarowych, ośrodkach kosztów i dokumentach ruchu.

Model jest zgodny z założeniem Kamsoft.FAIR: dane podstawowe środka pozostają w kartotece, natomiast aktualny stan przypisań do lokalizacji, MPK i osób odpowiedzialnych utrzymywany jest w osobnym zasobie alokacji. Dzięki temu jeden model obsługuje księgowość, obieg dokumentów, raportowanie i innych konsumentów bez duplikowania struktur.

Zasoby

Zasób Opis
FixedAsset Kartoteka środka trwałego: identyfikatory, nazwa, status, typ, wartości bilansowe i podatkowe, amortyzacja, daty, cechy
AssetComponent Komponent środka trwałego powiązany z FixedAsset; własne wartości, status, daty i cechy
FixedAssetAllocation Przypisanie środka lub komponentu do wymiaru: lokalizacja, ośrodek kosztów, osoba odpowiedzialna; także powiązania miejsc z ośrodkami i osobami
CostCenter Słownik ośrodków kosztów (MPK) z hierarchią i okresem aktywności
FixedAssetDocument Dokument ruchu majątku: przyjęcie, sprzedaż, likwidacja, zmiana miejsca, zmiana wartości, zmiana osoby odpowiedzialnej

Relacje

  • FixedAsset przechowuje dane podstawowe środka i nie zawiera bezpośrednich pól lokalizacji, MPK ani osoby odpowiedzialnej.
  • AssetComponent wskazuje nadrzędny FixedAsset i korzysta z tego samego mechanizmu alokacji co środek główny.
  • FixedAssetAllocation łączy środek lub komponent (pola fixedAsset, assetComponent) z target odpowiednim dla wymiaru; przy osobie odpowiedzialnej miejsce użytkowania trafia do participant[].
  • FixedAssetDocument opisuje zdarzenie biznesowe; skutek w alokacjach powstaje w systemie dziedzinowym.

Reuse zasobów współdzielonych

  • Miejsce użytkowania: Location w profilu UsagePlace — category = usage-place (system https://api-erp.kamsoft.pl/vs/assets/location-category).
  • Ośrodek kosztów: CostCenter jako FixedAssetAllocation.target.
  • Osoba odpowiedzialna: Party reprezentująca pracownika lub kontrahenta.

Zakres operacyjny

Zasób Metody Uwagi
FixedAsset GET /v1/fixed-assets tylko odczyt
AssetComponent GET /v1/asset-components tylko odczyt
FixedAssetAllocation GET /v1/fixed-asset-allocations?category=… tylko odczyt; category wymagany
CostCenter GET /v1/cost-centers tylko odczyt
Location (UsagePlace) GET /v1/locations?profile=…/UsagePlace tylko odczyt
FixedAssetDocument GET, POST, PATCH /v1/fixed-asset-documents, GET /v1/fixed-asset-documents/$document-content zapis skanu i statusu obiegu; parametry w zapytaniu (identifier, owner, attribute, format)

Listy mają kopertę { "items": [...], "nextToken": null } i paginację count/offset; zapis odpowiada kodem 200.

Dokument majątkowy ma status wewnętrzny (status: open, closed, posted) dostępny tylko do odczytu. Dane obiegu zewnętrznego (workflow-status, workflow-link, workflow-system) są przekazywane jako attachment[].attribute[] — to one podlegają aktualizacji przez PATCH /v1/fixed-asset-documents?identifier=….

Odniesienia