AssetComponent
AssetComponent (komponent majątku) reprezentuje składnik środka trwałego, który jest ewidencjonowany oddzielnie od kartoteki głównej, ale pozostaje z nią powiązany. Zasób służy do modelowania części składowych, zestawów i elementów o odrębnej wartości, statusie lub historii. Tak jak FixedAsset, nie przechowuje bezpośrednio lokalizacji ani osoby odpowiedzialnej; te dane są utrzymywane w FixedAssetAllocation.
Rozszerza DomainResource.
1. Zakres i zastosowanie
AssetComponent pozwala odwzorować komponenty powiązane z jednym środkiem, np. monitor, dysk, moduł, wyposażenie dodatkowe lub składowa inwestycji. Zasób służy do:
- ewidencji komponentów o odrębnej wartości lub identyfikacji,
- łączenia komponentu z kartoteką nadrzędnego środka,
- śledzenia statusu, dat i cech komponentu,
- przypisywania komponentu do lokalizacji i osób przez FixedAssetAllocation.
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 komponentu (§2a) |
| fixedAsset | 0..1 | Reference(FixedAsset) | Nadrzędny środek trwały |
| name | 0..1 | string | Nazwa komponentu |
| description | 0..1 | string | Opis komponentu |
| valueBalance | 0..1 | Money | Wartość bilansowa komponentu |
| valueTax | 0..1 | Money | Wartość podatkowa komponentu |
| acquisitionDate | 0..1 | date | Data nabycia lub dołączenia komponentu |
| retirementDate | 0..1 | date | Data wycofania komponentu |
Schemat nie wymaga żadnego pola. owner wskazuje firmę (Reference do Party z identyfikatorem NIP, system https://gov.pl/nip). status i attribute[] — §2b.
Uwaga: Jeśli komponent wymaga wielu jednoczesnych przypisań do lokalizacji lub osób, stosuje się FixedAssetAllocation z polem assetComponent wskazującym 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 |
|---|---|---|---|
AssetComponent.Id |
Id składnika majątku | tak | NamingSystem |
| — (osobna przestrzeń) | Numer składnika | nie | NamingSystem |
| — (osobna przestrzeń) | Kod kreskowy składnika | nie | NamingSystem |
2b. Systemy kodowania (value sety)
| Pole | Value set | Kody |
|---|---|---|
status |
asset-component-status |
active, inactive |
attribute[].code |
asset-component-attribute-type |
schema (schemat bazy danych źródła) |
3. Operacje
| Metoda | Ścieżka | Opis |
|---|---|---|
| GET | /v1/asset-components |
Lista komponentów |
| Parametr | Format | Opis |
|---|---|---|
identifier |
system\|value |
Id składnika 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/asset-component-status |
count, offset |
integer | Paginacja (domyślnie 20 / 0) |
Odpowiedź 200: { "items": [AssetComponent…], "nextToken": null }. Zapis nie jest dostępny.
4. Relacje
- Każdy AssetComponent wskazuje jeden nadrzędny FixedAsset.
- FixedAssetDocument może referować komponent na poziomie pozycji dokumentu.
- FixedAssetAllocation może przypisywać komponent do lokalizacji, ośrodków kosztów i osób.
5. Zgodność z systemami ERP
| System | Odpowiednik | Uwagi |
|---|---|---|
| SAP | Asset subnumber / component-like structures | Składowe i podnumery aktywa |
| Oracle Fixed Assets | Component Asset | Podział aktywa na składowe części |
| D365 | Asset component / related asset | Powiązany składnik o własnej identyfikacji |