Folgende Tools/Umgebungen können bei Bedarf zur schnellen lokalen Entwicklung genutzt werden.

Umgebungen

Die Gematik stellt die Entwicklungsversion des DiPag Fachdienstes unter https://dev.digitale-patientenrechnung.de zur Verfügung. Um diesen Dienst nutzen zu können, benötigen Sie digitale Testidentitäten (SMC-B oder Gesundheits-ID), die Gematik auf Anfrage zur Verfügung stellt.

Die weiteren im Aufbau befindlichen Umgebungen sind:

• Referenzumgebung "RU": https://ref.digitale-patientenrechnung.de
• Testumgebung "TU": https://test.digitale-patientenrechnung.de
• Produktivumgebung "PU": https://digitale-patientenrechnung.de

ZETA Guard / ZETA Client

Der Zugriff auf den Fachdienst der Entwicklungs- Produktions- und Testumgebung wird vom so genannten "ZETA Guard" kontrolliert.

Die Gematik veröffentlicht einen Leitfaden für Implementierungsschritte, die notwendig sind, damit ein Client vom "ZETA Guard" für den Fachdienst berechtigt wird: https://gemspec.gematik.de/docs/gemILF/gemILF_ZETA_API/latest/

Darüber hinaus wird ein ZETA Client SDK veröffentlicht, welches für viele gängige Plattformen verfügbar ist. Das SDK vereinfacht die Anbindung an den Fachdienst indem darin die notwendigen Implementierungsschritte schon umgesetzt sind: https://github.com/gematik/zeta-sdk

OpenAPI - Accountverwaltung

Die Fachdienst-APIs für das Verwalten von Accounts und das Zugriffsrechtemanagement sind als OpenAPI-Dokumentation verfügbar:

⬇️ DOWNLOAD ⬇️ DiPag-OpenAPI_v0.3.1-0.json

Test-Collection

Eine Test Collection für den End-to-End-Test des DiPag Fachdienstes (Digitale Patientenrechnung) der gematik. Die Collection bildet einen Rechnungsworkflow zwischen Arztpraxis, Versicherter Person, Kostenträger und Abrechnungsdienstleister (ADL) ab.

⬇️ DOWNLOAD ⬇️ DiPag-Fachdienst-Test-Collection-v1.0-ru-dev-0.3.1.zip

Verfügbare Versionen

Die Collection ist in zwei verschiedenen Formaten verfügbar:

Beide Versionen enthalten denselben Test-Workflow und dieselben Requests.

Voraussetzungen

• Für Bruno: Bruno Desktop App
• Für Postman: Postman Desktop App
• DiPag-Fachdienst-Container ohne Zeta Guard

Schnellstart

Mit Bruno

1. Bruno öffnen → Open Collection → den Ordner bruno/ auswählen.
2. Oben rechts die Umgebung auswählen.
3. Nur bei Bedarf: Identifier anpassen, siehe unten (Testdaten anpassen)
4. Requests der Reihe nach ausführen.
   
   

Mit Postman

1. Postman öffnen → Import → DiPag-Fachdienst-Test-Collection-v1.0-ru-dev-0.3.1.json auswählen (aus postman/ Ordner).
2. Environment importieren (aus postman/ Ordner).
3. Die Umgebung oben rechts auswählen.
4. Nur bei Bedarf: Identifier anpassen, siehe unten (Testdaten anpassen)
5. Requests der Reihe nach ausführen.
   
   

Workflow-Übersicht

Die Requests sind in Gruppen organisiert und müssen in dieser Reihenfolge ausgeführt werden, da spätere Schritte Variablen verwenden, die von früheren Schritten gesetzt werden.

Gruppe 1 – Accounts anlegen

Gruppe 2 – Arztpraxis versendet Rechnung

Gruppe 3 – Versicherte Person ruft ab und entzieht Berechtigung

Gruppe 4 – Arztpraxis sendet Rechnung nach Entzug

Gruppe 5 – Kostenträger ruft Rechnung ab

Gruppe 6 – Versicherte Person löscht Rechnung

Gruppe 7 – Abrechnungsdienstleister sendet Massendaten

Der Abrechnungsdienstleister (ADL) reicht mehrere Rechnungen gebündelt in einem FHIR-Batch asynchron ein und fragt das Ergebnis per Polling ab.

Gruppe 99 – Accounts löschen

Testdaten anpassen

Alle Testparameter befinden sich in der Environment-Datei:

DiPag_RU-DEV_environment.bru (für Bruno)
DiPag_RU-DEV_environment.json (für Postman)

Für jeden neuen Testdurchlauf müssen diese Werte eindeutig sein:

ktr-telematikID

K202605261

praxis-telematikID

P202605261

adl-telematikID

A20270910

patient-kvnr

V202605261

rechnungsnummer

RE-202605261

befundid

B202606034

Weitere konfigurierbare Felder sind Patientendaten (Name, Geburtsdatum, Adresse), Arztdaten, Rechnungspositionen und die PDF-Anlagen (als Base64 in den Umgebungsvariablen KI-Reiseimpfung-Gelbfieber-b64 und KI-untersuchung-b64).

Für die 10 Rechnungen des Massendaten-Batches (Gruppe 7) werden Rechnungsnummern und Anhang-IDs automatisch im Pre-Request-Script generiert (RE-2026001–RE-2026010 bzw. B2026001–B2026010) und müssen nicht manuell gepflegt werden.

Fachdienst-Container

Um schnell gegen die fachlichen Schnittstellen des DiPag Fachdienstes (ohne ZETA) entwickeln zu können veröffentlicht die Gematik das jeweils aktuelle Release des DiPag Fachdienst auch als OCI Container:

⬇️ DOWNLOAD ⬇️ dipag-anwendungsdienst:0.2.0.0.tar.gz (Fachdienst-Docker-Image)

Der DiPag-Fachdienst-Container benötigt als externe Abhängigkeiten

• eine MariaDB Datenbank
• einen S3-kompatiblen Storage

Die Integration mit diesen Abhängigkeiten ist beispielhaft in folgender docker-compose-Konfiguration gezeigt.

name: dipag

services:

  DiPag-MariaDB:
    image: mariadb:latest
    container_name: mariadb
    command: --port=3306
    ports:
      - "3306:3306"
    environment:
      MARIADB_ROOT_PASSWORD: root
      MARIADB_DATABASE: dipag
    volumes:
      - dipag-mariadb-data:/var/lib/mysql
    healthcheck:
      test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
      start_period: 15s
      interval: 10s
      timeout: 5s
      retries: 5

  DiPag-S3:
    image: minio/minio:latest
    container_name: s3-minio
    command: server /data --console-address ":9101"
    ports:
      - "9100:9000"
      - "9101:9101"
    environment:
      MINIO_ROOT_USER: minioadmin
      MINIO_ROOT_PASSWORD: minioadmin
    volumes:
      -  dipag-s3-data:/data
    healthcheck:
      test: ["CMD", "mc", "ready", "local"]
      start_period: 10s
      interval: 10s
      timeout: 5s
      retries: 5

  DiPag-Fachdienst:
    image: dipag-anwendungsdienst:0.2.0.0
    container_name: DiPag-Fachdienst
    ports:
      - "8080:8080"
      - "8081:8081"
    environment:
      SPRING_DATASOURCE_URL: jdbc:mariadb://mariadb:3306/dipag
      SPRING_DATASOURCE_USERNAME: root
      SPRING_DATASOURCE_PASSWORD: root
      DIPAG_BLOB_URL: http://s3-minio:9000
      DIPAG_BLOB_ACCESS_KEY: minioadmin
      DIPAG_BLOB_SECRET_KEY: minioadmin
      DIPAG_BLOB_REGION: us-east-1
      DIPAG_BLOB_BUCKET: dipag
      DIPAG_BLOB_TEMP_DIR: /tmp/dipag
    depends_on:
      DiPag-MariaDB:
        condition: service_healthy
      DiPag-S3:
        condition: service_healthy

# named volumes
volumes:
  dipag-mariadb-data: 
  dipag-s3-data:

Auslesen von strukturierten Rechnungsdaten

Minimal-Beispiel eines Java-Programms zum Auslesen von strukturierten Rechnungsdaten aus einem angereicherten PDF der Digitalen Patientenrechnung.

⬇️ DOWNLOAD ⬇️ rechnunglesen.zip

Start mit dem Tool "maven":

$ mvn -q -Dexec.args="response.pdf"

Verfügbarkeit der Entwicklungs-Tools