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 [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

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"
  }

  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"
  }

TODOS

• Tests
• Better error handling
• Improve logging