This project is a basic api around the excellent diga-api-client It supports validation and billing.
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
You can run the diga api service as a jar or inside a docker container.
Download the latest the release from github and make sure the required env variables are set.
# Run
java -jar diga-api-service-<version>.jar
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 [email protected]: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
-
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>00329500</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" }
Example response
{ "code": "77AAAAAAAAAAAAAX", "actionRequired": true, "transport": "POST", "xRechnung": "<?xml version=\"1.0\"..." } Example error response for billing requests with a 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" }
- Tests
- Better error handling
- Improve logging