Przejdź do treści

Notification

Notification to kanoniczny zasób powiadamiający o zdarzeniu (utworzenie, zmiana, usunięcie) na innym zasobie w API.ERP. Nie niesie treści biznesowej zasobu, którego dotyczy — tylko fakt zdarzenia i odniesienie do zasobu źródłowego. Konsument, który chce poznać aktualny stan zasobu, wykonuje osobne zapytanie (np. GET /v1/parties/{id}) na podstawie reference.

Wzorowany na uproszczonym FHIR AuditEvent: operation odpowiada AuditEvent.action, date odpowiada AuditEvent.recorded, reference odpowiada AuditEvent.entity.what.

Rozszerza DomainResource.

1. Zakres i zastosowanie

Notification jest zasobem wysyłanym w warstwie rozgłoszeniowej API.ERP (zob. API rozgłoszeniowe) — reprezentuje pojedynczy wpis z kolejki eksportu (WSP_EXPORT) po przetworzeniu przez system dziedzinowy, w postaci ustandaryzowanej dla konsumenta zewnętrznego.

Aspekt Opis
Notification Powiadomienie o zdarzeniu na zasobie — co się stało i z jakim zasobem jest powiązane.
Zasób referencyjny Wskazany przez reference; nie jest osadzony w treści notyfikacji (brak contained).

2. Pola nagłówka

Poza polami z DomainResource (id, resourceType — tu zawsze "Notification", meta):

Nazwa Kard. Typ Opis
status 1..1 CodeableConcept Status przetworzenia notyfikacji (system: notification-status; np. completed, failed, pending).
operation 1..1 CodeableConcept Rodzaj operacji na zasobie źródłowym (system: notification-operation; kody created/updated/deleted, wzorowane na AuditEvent.action).
date 1..1 dateTime Znacznik czasu zdarzenia (kiedy operacja miała miejsce w systemie źródłowym).
reference 1..1 Reference Odniesienie do zasobu, którego dotyczy notyfikacja — type = typ zasobu (np. Party), identifier = identyfikator logiczny zasobu (gdy referencja logiczna, nie literalny URL).

id, odziedziczone z DomainResource, niesie identyfikator samej notyfikacji (nie zasobu, którego dotyczy) — w przykładzie "8ac2b4c8-18a7-4f94-810e-97c5d7d827e3".

3. Przykład

{
  "resourceType": "Notification",
  "id": "8ac2b4c8-18a7-4f94-810e-97c5d7d827e3",
  "status": {
    "coding": [{ "system": "https://api-erp.kamsoft.pl/vs/notification-status", "code": "completed", "display": "Zakończono" }]
  },
  "operation": {
    "coding": [{ "system": "https://api-erp.kamsoft.pl/vs/notification-operation", "code": "updated", "display": "Zaktualizowano" }]
  },
  "date": "2026-07-14T09:15:00Z",
  "reference": {
    "type": "Patient",
    "identifier": {
      "system": "https://api-erp.kamsoft.pl/vs/origin-id",
      "value": "123456"
    }
  }
}

4. Relacje

5. Odniesienia