Przejdź do treści

FixedAssetAllocation

FixedAssetAllocation (przypisanie środka trwałego) jest zasobem utrzymującym aktualny stan przypisań środka lub komponentu do wymiarów biznesowych: lokalizacji, ośrodka kosztów, osoby odpowiedzialnej. Zasób rozdziela stan ewidencyjny od kartoteki FixedAsset i AssetComponent, co pozwala modelować wiele jednoczesnych przypisań bez duplikowania danych głównego zasobu.

Rozszerza DomainResource.

1. Zakres i zastosowanie

FixedAssetAllocation jest uniwersalnym modelem przypisań majątku. Jeden rekord wskazuje:

  • fixedAsset lub assetComponent: środek trwały lub komponent,
  • dimension: rodzaj przypisania,
  • target: obiekt docelowy odpowiedni dla danego wymiaru,
  • participant: dodatkowe strony przypisania (np. miejsce użytkowania przy osobie odpowiedzialnej),
  • opcjonalne miary rozliczeniowe: quantity, weight, initialValue,
  • opcjonalny okres obowiązywania i dokument stanowiący podstawę przypisania.

Typowe scenariusze:

  • 50 krzeseł podzielonych między dwie lokalizacje,
  • rozliczenie środka na dwa MPK,
  • wskazanie kilku osób odpowiedzialnych,
  • powiązanie miejsca użytkowania z ośrodkiem kosztów lub osobą.

2. Granice i relacje

  • FixedAssetAllocation utrzymuje stan aktualny przypisań; dane podstawowe środka i komponentu pozostają w kartotece FixedAsset / AssetComponent, które nie zawierają bezpośrednich pól lokalizacji, MPK ani osoby odpowiedzialnej.
  • FixedAssetDocument opisuje ruchy i decyzje (np. przeniesienie sztuk między lokalizacjami); skutek w alokacjach powstaje w systemie dziedzinowym — zob. koncepcja integracji, §4 i §6.
  • Cel przypisania (target) jest zasobem właściwym dla wymiaru: Location, CostCenter, Party — zob. §4.

3. 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 przypisania; API nie nadaje dziś identyfikatorów alokacji
fixedAsset 0..1 Reference(FixedAsset) Środek trwały przypisywany
assetComponent 0..1 Reference(AssetComponent) Komponent środka przypisywany
dimension 0..1 CodeableConcept Wymiar przypisania (§4)
target 0..1 Reference Cel przypisania, zgodny z dimension (§4)
relatedTarget 0..1 Reference Powiązany wymiar (np. miejsce użytkowania przy powiązaniu miejsca z ośrodkiem kosztów)
participant 0..* Reference(Location / Party) Dodatkowe strony przypisania (§4)
quantity 0..1 Quantity Liczba sztuk przypisana do celu (value), wypełniana dla lokalizacji
weight 0..1 number Udział procentowy lub waga rozliczenia (MPK)
initialValue 0..1 Money Wartość początkowa przypisana do celu
agreement 0..1 Reference(DocumentReference) Dokument stanowiący podstawę przypisania
validFrom 0..1 date Data rozpoczęcia obowiązywania przypisania
validTo 0..1 date Data zakończenia obowiązywania przypisania

Schemat nie wymaga żadnego pola. owner wskazuje firmę (Reference do Party z NIP, system https://gov.pl/nip). category rozróżnia rodzaj przypisania (§4). Pola weight, initialValue, agreement, validFrom, validTo pozostają w kontrakcie, ale nie są dziś zasilane.

4. Rodzaje przypisań i systemy kodowania

Rodzaj przypisania wybiera parametr category (§5); odpowiedź niesie go w category oraz w dimension:

category (fixed-asset-allocation-category) dimension fixedAsset / assetComponent target relatedTarget participant quantity
fixed-asset-location location tak Location (miejsce użytkowania) — — tak
fixed-asset-cost-center cost-center fixedAsset CostCenter — — —
fixed-asset-party responsible-party tak Party (osoba odpowiedzialna) — Location (miejsce użytkowania) —
location-cost-center cost-center — CostCenter Location — —
location-party responsible-party — Location — Party (osoba odpowiedzialna) —

Słowniki:

Pole Value set Kody
category fixed-asset-allocation-category pięć kodów z tabeli wyżej
dimension fixed-asset-allocation-dimension location, responsible-party, cost-center. Uwaga: dla kategorii innych niż fixed-asset-cost-center API podaje dziś te kody w systemie https://api-erp.kamsoft.pl/vs/assets/allocation-dimension (adres w rejestrze, słownik nieopublikowany)
attribute[].code fixed-asset-allocation-attribute-type schema

Wymiary „źródło finansowania” i „wymiar biznesowy” nie występują w słowniku ani w odpowiedziach API.

5. Operacje

Metoda Ścieżka Opis
GET /v1/fixed-asset-allocations?category=… Lista przypisań wybranego rodzaju
Parametr Format Opis
category system\|value (wymagany) system = https://api-erp.kamsoft.pl/vs/assets/fixed-asset-allocation-category, value = jeden z kodów §4. Inna przestrzeń kończy się 400 z nazwą parametru (konwencje §8.1); kod nieznany w tej przestrzeni daje pustą listę
owner system\|value Firma: https://gov.pl/nip\|<NIP>
attribute code\|value (wiele) schema\|<schemat>
count, offset integer Paginacja (domyślnie 20 / 0)

Odpowiedź 200: { "items": [FixedAssetAllocation…], "nextToken": null }. Zapis (POST, PATCH) nie jest dostępny; nie ma filtrów po środku ani wymiarze — zawężenie wykonuje klient po fixedAsset.identifier / dimension.

6. Reguły spójności modelu

API udostępnia alokacje wyłącznie do odczytu i nie waliduje poniższych reguł; opisują one semantykę danych utrzymywanych przez system dziedzinowy.

ID Reguła
faa-1 Przypisanie środka wskazuje fixedAsset lub assetComponent; przypisania miejsc (location-*) nie wskazują żadnego
faa-2 dimension = location → target wskazuje Location
faa-3 dimension = cost-center → target wskazuje CostCenter
faa-4 dimension = responsible-party → target wskazuje Party (kategoria fixed-asset-party) albo Location z osobą w participant (kategoria location-party)
faa-5 Suma quantity aktywnych alokacji location dla środka nie przekracza FixedAsset.quantity
faa-6 Suma weight aktywnych alokacji cost-center dla środka nie przekracza 100

7. Wsparcie wdrożeniowe

Zakres faktycznie wspieranych kategorii, aktywnych value setów oraz przestrzenie identyfikatorów wynikają z zakresu uzgodnionego w umowie oraz z parametrów wdrożenia przekazanych przez KAMSOFT — zob. Identyfikacja i parametry wdrożenia.

8. Przykłady

Wszystkie przykłady JSON znajdują się w Majątek — przykłady:

  • sekcja 2.1 — podział sztuk jednego środka na dwie lokalizacje oraz wag na dwa MPK,
  • sekcja 2.2 — osoba odpowiedzialna z miejscem użytkowania w participant,
  • sekcja 5 — odczyt alokacji przez GET /v1/fixed-asset-allocations?category=….

9. Zgodność z systemami ERP

System Odpowiednik Uwagi
SAP CO / FI-AA Time-dependent assignments, cost center split Rozdzielenie aktywa na lokalizacje i MPK
Oracle Fixed Assets Asset assignments / distributions Przypisania do cost center
D365 Financial dimensions / asset associations Podział odpowiedzialności i lokalizacji

10. Odniesienia