Address
Address (adres) to typ danych oznaczający adres pocztowy lub lokalizacyjny – ulica, miasto, kod pocztowy, kraj. Wzorowany na FHIR Address. Używany w Party (siedziba, adres dostawy, rozliczeniowy), w dokumentach (miejsce dostawy, wystawienia).
1. Zakres i zastosowanie
Address służy do:
- Adresów stron – w Party: siedziba, adres do faktury, adres dostawy (type / use).
- Dokumentów – miejsce dostawy, miejsce wystawienia (np. w profilu FK/CRM).
- Lokalizacji – w rozszerzeniach: współrzędne, region.
Reguła: line jako lista elementów CodeableConcept (np. ulica, nr budynku, nr lokalu) + city + postalCode + country w typowych implementacjach; use (billing, delivery, home, work) i type (postal, physical) opcjonalnie.
2. Zawartość (struktura)
| Nazwa | Kard. | Typ | Opis |
|---|---|---|---|
| use | 0..1 | code | Przeznaczenie: home, work, billing, delivery, temp, old (rozszerzalne) |
| type | 0..1 | code | Typ: postal, physical, both (rozszerzalne) |
| line | 0..* | CodeableConcept | Typowana lista składników adresu (np. street, building-number, apartment-number) |
| city | 0..1 | string | Miasto |
| district | 0..1 | string | Dzielnica / powiat (opcjonalnie) |
| state | 0..1 | string | Województwo / region |
| postalCode | 0..1 | string | Kod pocztowy |
| country | 0..1 | string | Kraj (kod ISO 3166 lub nazwa) |
| period | 0..1 | Period | Okres ważności adresu (opcjonalnie) |
3. Zgodność z systemami ERP
| System | Odpowiednik | Uwagi |
|---|---|---|
| SAP | Business Address Service (BAS), BAPIADDR3 / adres w BAPICONTACT_ADDRESSDATA | Street, city, postal code, region, country; osobne struktury na adres BP i Contact Person; adresy powiązane z relacją (np. contact person address) |
| Oracle TCA | HZ_LOCATIONS (street1/2/3, city, postal_code, state, country) + HZ_PARTY_SITES (powiązanie Party–Location) | Adres = Location; Party ma wiele Party Sites, każdy wskazuje Location; use/type przez atrybuty strony |
| UBL 2.3 | Address (AddressLine, CityName, PostalZone, CountrySubentity, Country) | AddressLine 1..*; PostalAddress jako agregat; brak use/type w bazie – kontekst z elementu nadrzędnego |
| OAGIS | Address w PartyMaster / Location; elementy adresowe w BOD | Adresy w komponencie Party; wiele lokalizacji; Contact jako osobny komponent (komunikacja) |
| FHIR | Address (use, type, line, city, district, state, postalCode, country, period, text) | use: home | work | temp | old | billing; type: postal | physical | both; line 0..*; period na ważność |
Nasz model jest zbieżny z FHIR Address (use, type, line, city, district, state, postalCode, country, period). SAP i Oracle trzymają adres w osobnych tabelach/strukturach z linkiem do strony/kontaktu; UBL/OAGIS – w strukturze dokumentu lub Party.
4. Równoważność zestawu danych
Tak – ten sam zestaw danych da się zamodelować w Twoim rozwiązaniu i w systemach ERP.
| Aspekt | Twój model / FHIR | SAP / Oracle / UBL / OAGIS |
|---|---|---|
| Linie adresu | line 0..* (CodeableConcept) |
street1/2/3, AddressLine 1..* – równoważne semantycznie |
| Miasto, kod, kraj | city, postalCode, country | Wszędzie obecne |
| Region / województwo | state (+ district) | state, CountrySubentity, region – ten sam sens |
| Przeznaczenie (billing, delivery…) | use, type w adresie | Często w kontekście (np. „adres dostawy” = miejsce w strukturze) – dane te same |
| Okres ważności | period | Często w innych tabelach (valid_from/valid_to); dane przenoszalne |
| Adres jako tekst | Brak pola text |
FHIR ma Address.text; u Ciebie można złożyć z line + city + postalCode + country |
Różnice to reprezentacja (use/type w obiekcie vs kontekst), nie brak informacji. Mapowanie w obie strony jest możliwe.