zdavatz/scan2post

Scan a Swiss Health Insurance card and create a HTTP-Post request.

Scan2Post

• Use WebSockets with a Username to Push Information from the card to the server. No polling needed.
• Scan a Swiss Health Insurance card and create a HTTP(S)-Post request.
• Supported Scanner is PX-8935-919 from Xystec.
• Download from the macOS Store.

Features

1. Scan2Post has to be able to register in Start-Up Objects in the Settings.
2. Scan2Post has to startup when the computer is started. Scan2Post has no Gui only a preferences field.
3. If the User inserts a Swiss Insurance Card a HTTP-Post request is send to the URL according to the settings.
4. In the settings field you have to able to set

• HTTP(S) URL
• Username
• Password (optional)

5. All the Data from the card in a JSON File. See sample below.
6. Software has to be installed for the User.
7. Software starts when the User logs in.
8. The User has to be able to quit the application.
9. When you run the application the first time then the User is asked: "Do you want to add Scan2Post to startup automatically at login?"
10. If you click the Icon on the top bar, then you can close the Scan2Post application or access the settings, see 4.
11. Deployment Target is 10.12.
12. A Reference we used: WeatherBar
13. Copy and Pasting via Mouse.

JSON HTTP(S) Post-Request File

{
"username":"[email protected]",
"password":"Password_that_is_optional",
"insuranceCard":{
"identificationData":{"firstName":"65.80.50","lastName":"65.80.50","birthDate":65.82.8,"sex":65.84.1,"ssn":"65.83.13"},
"administrationData":{"insurance":{"id":"65.92.5","name":"65.91.50"},"cardNumber":"65.93.20","expiryDate":65.94.8}
}}

1. All dates set to UNIX timestamp and mmdd set to 0 (zero) and milliseconds also set to 0 (zero).
2. Swiss Insurance Card Reference.
3. HTTP Server useful for testing
4. Password can be used for Server-Side Authentication.

Use Case

The User's Browser with the Web-Application is open. The User inserts a card into the card reader. Scan2Post sends all the information from the card as a HTTP-Post request to the defined URL in a JSON File. The data is then processed by the API/Server and the Web-App can refresh with the Data that was sent via the HTTP-Post-Request.

License

GPLv3.0 See License.

Contact

Zeno Davatz
ywesee GmbH
zdavatz at ywesee dot com
[phone]

Copyright

©ywesee GmbH, all rights reserved.

scan2post's Issues

App does not have an Icon yet.

512 Icon still missing.

add 3 zeros for time stamp. Milli seconds are missing

The Unix timestamp also need three additional zeros for the milliseconds of the Unix Timestamp.

Error when starting app

Appears when starting the app without card reader plugged in

TarMed Tarif 590

Komplementäre Leistungen.

App Store issues

Archive Button is greyed out

Archive can not be build as Mac App Archive. See Mac App Archive

Server URL is not saved when you change it in the App.

1. Open Scan2Post
2. In settings change Server-URL to: https://elstage.pharmedsolutions.ch/api/1.0/insurance-card
3. Set-User to [email protected]
4. Login here: https://elstage.pharmedsolutions.ch/login
5. User same as under 3.
6. Password I will send you.
7. https://elstage.pharmedsolutions.ch/login
8. In the Browser got to: "Patienten" -> "Neuen Patienten erfassen"
9. Now the fields should be filled in.

Add Support for Helsana Card

This is Java-Code:

Admin Data EFAD:

SELECT:

val isHelsana = channel.getCard.getATR.getBytes.length == 20
val data = Array[Byte](0x2F, 0x07)
val cmd = if (isHelsana) new CommandAPDU(0x0,0xA4, 0x2,0x0, data, 0x2) else  new CommandAPDU(0x0,0xA4, 0x0,0x0, data)
 

READ:

val expectedLength = if (isHelsana) 53 else 84
val cmd = new CommandAPDU(0,0xB0, 0,0,expectedLength)
val response = channel.transmit(cmd)

Parsing is the same like with the previous Standard.

Identification Data EFID:

SELECT:

val data = Array[Byte](0x2F, 0x6)
val cmd = if (isHelsana) new CommandAPDU(0x0,0xA4, 0x2,0x0, data, 0x2) else  new CommandAPDU(0x0,0xA4, 0x0,0x0, data)
 
READ:
val expectedLength = if (isHelsana) 59 else 84
val cmd = new CommandAPDU(0,0xB0, 0,0,expectedLength)

Parser:
val hexString         = data.map("%02X" format _).mkString
val indexBirthDate     = hexString.indexOf("8208")/2

val lengthName        = Integer.parseInt(hexString.substring(18,20),16)
val lastName          = new String(data,10, lengthName, "UTF-8")
val firstName         = new String(data,10 + lengthName + 6, indexBirthDate - lengthName - 16, "UTF-8")

val birthDate         = new String(data, indexBirthDate + 2, 8, "UTF-8")

val ssn               = new String(data,hexString.indexOf("830D")/2 + 2, 13 , "UTF-8")
val sex               = Integer.parseInt(hexString.substring(hexString.indexOf("8401") + 4,hexString.indexOf("8401") + 6),16)

Inserting old insurance card breaks app

Inserting an old insurance card results in the app not responding anymore.
Error log below.

Make the Server URL field 1/3 longer please.

1. Make the Server URL field 1/3 longer please.
2. Add a Save and Cancel button for the settings page.
3. Clicking the Save Button will close the Preferences window.