Diga Api Service

This project is a basic api around the excellent diga-api-client It supports validation and billing.

Prerequisites

You need to download the following things before running the api:

Secon keystore generator
Mapping file and follow the instructions https://github.com/alex-therapeutics/diga-api-client/wiki/Modifying-the-insurance-company-mapping-file-(Krankenkassenverzeichnis_DiGA.xml)
annahme-rsa4096.key

java -jar secon-keystore-generator.jar -k annahme-rsa4096.key -p my.prv.key.pem -c my.chain.p7c # This creates one keystore that contains the your private key and all the public insurance keys

Usage

You can run the diga api service as a jar or inside a docker container.

Jar

Download the latest the release from github and make sure the required env variables are set.

# Run
java -jar diga-api-service-<version>.jar

Docker

Please make sure you set the proper values in the .env file and mount the mapping file and keystores under the expected path.

# Build
git clone git@github.com:gtuk/diga-api-service.git
cd diga-api-service
docker build -t diga_api_service .

# Configuration
cp .env.local .env

# Run
docker run --env-file .env -p 5000:5000 -v /tmp/Krankenkassenverzeichnis_DiGA.xml:/tmp/Krankenkassenverzeichnis_DiGA.xml -v /tmp/keystore.p12:/tmp/keystore.p12 --name digaApiService diga_api_service

Endpoints

GET /validate/{CODE}

Example response

{
    "code": "77AAAAAAAAAAAAAX",
    "digavId": "00451000",
    "dayOfServiceProvision": "2021-06-02",
    "rawXmlResponse": "<Pruefung_Freischaltcode xmlns=\"http://www.gkv-datenaustausch.de/XML-Schema/EDFC0_Pruefung/2.0.0\" nachrichtentyp=\"ANT\" verfahrenskennung=\"TDFC0\" absender=\"123456789\" empfaenger=\"102114819\" version=\"002.000.000\" gueltigab=\"2020-07-01\"><Antwort><IK_DiGA_Hersteller>123456789</IK_DiGA_Hersteller><IK_Krankenkasse>102114819</IK_Krankenkasse><DiGAVEID>00329000</DiGAVEID><Freischaltcode>77AAAAAAAAAAAAAX</Freischaltcode><Tag_der_Leistungserbringung>2021-05-19</Tag_der_Leistungserbringung></Antwort></Pruefung_Freischaltcode>"
}

Example error response

{
    "timestamp": "2021-08-21T18:34:08.465+00:00",
    "status": 400,
    "error": "Bad Request",
    "message": "DigaCodeValidationResponseError(errorCode=REQUEST_OR_DATA_INVALID, errorText=Anfrage oder Datei ungültig)",
    "path": "/validate/77AAAAAAAAAAAGIS"
}

Example error response for diga test code when DISABLE_TESTCODES=true

{
    "timestamp": "2021-08-23T09:38:32.385+00:00",
    "status": 403,
    "error": "Forbidden",
    "message": "Testcodes are not allowed",
    "path": "/validate/77AAAAAAAAAAAAAX"
}

POST /bill

Example payload

{
    "invoiceNumber": "234",
    "code": "77AAAAAAAAAAAAAX",
    "digavId": "12345000",
    "dayOfServiceProvision": "2021-05-31"
}