Przejdź do treści

FixedAsset

FixedAsset (kartoteka środka trwałego) reprezentuje podstawowy rekord majątku w API.ERP: identyfikatory biznesowe, nazwę, status, typ, wartości bilansowe i podatkowe, parametry amortyzacji, daty cyklu życia oraz cechy opisowe. Zasób nie przechowuje bezpośrednio lokalizacji, MPK ani osoby odpowiedzialnej; te informacje są modelowane przez FixedAssetAllocation. Wzorowany na SAP FI-AA, Oracle Fixed Assets i Microsoft Dynamics 365 Asset Management.

Rozszerza DomainResource.

1. Zakres i zastosowanie

FixedAsset jest kanoniczną kartoteką środka trwałego lub wyposażenia. Zasób służy do:

  • prowadzenia ewidencji środków trwałych i wyposażenia,
  • identyfikacji środka w systemach ERP i integracjach zewnętrznych,
  • przechowywania wartości początkowych, umorzenia, wartości księgowej i ustawień amortyzacji,
  • łączenia środka z dokumentami ruchu majątku i komponentami,
  • przechowywania cech rozszerzających w attribute[].

Model rozdziela dane podstawowe środka od danych operacyjnych o rozmieszczeniu i odpowiedzialności. Dzięki temu jeden środek może mieć wiele aktywnych przypisań do lokalizacji, MPK lub osób bez zmiany struktury kartoteki.

2. Zawartość (struktura)

Oprócz elementów DomainResource (id, resourceType, meta, owner, comment, category, status, type, contained, attribute):

Nazwa Kard. Typ Opis
identifier 0..* Identifier Identyfikatory środka (§2a)
name 0..1 string Nazwa środka trwałego
text 0..1 string Dodatkowy opis tekstowy; API zwraca tu klasyfikację KŚT
quantity 0..1 Quantity Łączna liczba sztuk w kartotece (value; jednostka nie jest dziś wypełniana)
acquisitionDate 0..1 date Data nabycia
acceptanceDate 0..1 date Data przyjęcia do użytkowania
liquidationDate 0..1 date Data likwidacji lub wycofania
initialValueBalance 0..1 Money Wartość początkowa bilansowa
initialValueTax 0..1 Money Wartość początkowa podatkowa
accumulatedDepreciationBalance 0..1 Money Umorzenie bilansowe
accumulatedDepreciationTax 0..1 Money Umorzenie podatkowe
bookValueBalance 0..1 Money Wartość księgowa bilansowa
bookValueTax 0..1 Money Wartość księgowa podatkowa
depreciationRateBalance 0..1 number Stawka amortyzacji bilansowej
depreciationRateTax 0..1 number Stawka amortyzacji podatkowej
depreciationTypeBalance 0..1 CodeableConcept Rodzaj amortyzacji bilansowej
depreciationTypeTax 0..1 CodeableConcept Rodzaj amortyzacji podatkowej

Schemat nie wymaga żadnego pola. owner wskazuje firmę (Reference do Party z NIP, system https://gov.pl/nip). comment niesie opis środka ze źródła. status, type, attribute[] — §2b.

Uwaga: Aktualna lokalizacja, MPK i osoba odpowiedzialna nie są polami tego zasobu. Należą do FixedAssetAllocation. Środek nie ma pola nadrzędnego; składowe modeluje AssetComponent.

2a. Identyfikatory

Rodzaj identyfikatora niesie Identifier.system — przestrzeń instalacji urn:oid:1.2.616.1.113769.4.<instalacja>.<klucz> (osobny klucz dla każdej przestrzeni) publikowana jako NamingSystem — zob. Identyfikacja i parametry wdrożenia oraz Identifier.

Przestrzeń (klucz) Znaczenie Klucz referencyjny Skąd system
FixedAsset.Id Id kartoteki środka w ewidencji majątku tak NamingSystem
— (osobna przestrzeń) Numer inwentarzowy środka nie NamingSystem
— (osobna przestrzeń) Kod kreskowy (etykieta inwentaryzacyjna) nie NamingSystem

Numer seryjny i producent są modelowane jako cechy w attribute[], nie jako identyfikatory.

2b. Systemy kodowania (value sety)

Value sety pól kodowanych FixedAsset (rejestr: Systemy kodowania i value sety).

Pole Value set Kody
status fixed-asset-status investment, accepted, depreciated, sold, liquidated
type https://api-erp.kamsoft.pl/vs/assets/fixed-asset-type (adres w rejestrze, słownik nieopublikowany) API emituje fixed-asset, equipment, wnip; opublikowany słownik asset-type ma inne kody (fixed, equipment, intangible) i nie jest używany
category https://api-erp.kamsoft.pl/vs/assets/fixed-asset-category (adres w rejestrze, słownik nieopublikowany) nie jest dziś wypełniane
depreciationTypeBalance, depreciationTypeTax fixed-asset-deprecation-type linear, linear-accelerated, linear-decelerated, declining, one-time, none; model deklaruje osobne adresy …-balance / …-tax o tych samych kodach, API emituje wspólny
attribute[].code fixed-asset-attribute-type schema (valueString), price (valueMoney)

Kody nieznane słownikowi są przenoszone ze źródła bez zmian.

3. Operacje

Metoda Ścieżka Opis
GET /v1/fixed-assets Lista środków trwałych
Parametr Format Opis
identifier system\|value Id środka w przestrzeni urn:oid:…<klucz>
owner system\|value Firma: https://gov.pl/nip\|<NIP>
attribute code\|value (wiele) schema\|<schemat>
status system\|value system = https://api-erp.kamsoft.pl/vs/assets/fixed-asset-status
count, offset integer Paginacja (domyślnie 20 / 0)

Odpowiedź 200: { "items": [FixedAsset…], "nextToken": null }. Zapis nie jest dostępny.

4. Relacje i model operacyjny

  • AssetComponent może wskazywać nadrzędny FixedAsset.
  • FixedAssetAllocation przechowuje aktualne przypisania środka do lokalizacji, MPK i osób.
  • FixedAssetDocument opisuje zdarzenia biznesowe dotyczące środka: przyjęcie, likwidację, sprzedaż, zmianę miejsca, zmianę wartości.

5. Zgodność z systemami ERP

System Odpowiednik Uwagi
SAP FI-AA Asset Master Record Dane podstawowe, wartości, amortyzacja, numer środka
Oracle Fixed Assets Asset Kartoteka aktywa z wartościami, kategoriami i amortyzacją
D365 Asset Management Asset / Fixed asset Rejestr środków z finansami i statusem

6. Odniesienia