Skip to main content

Invoice

FieldTypeRequiredDescription
 dateStringmandatoryDate of the invoice as YYYY-MM-DD format
 referenceStringmandatoryUnique invoice reference. From 4 to 12 chars
languageStringmandatoryLanguage of the invoice.
Could be: fr, de or it.
tiersModeStringmandatoryCould be: tg or tp
lawStringmandatoryCould be: kvg, vvg, uvg, ivg, mvg or org
treatmentReasonStringmandatoryCould be: disease, accident, maternity, prevention, birthdefect
diagnosisStringoptional
commentStringoptionalComment for the insurer
vatNumberStringoptionalAs CHE123456789 format
authorAuthormandatoryAuthor of the invoice
providerProvideroptionalProvider of the treatment. If not defined, author data are used
patientPatientmandatory
recipientRecipientoptionalCustom invoice repicipent. If not defined, patient data are used
prestations[Prestation]mandatoryList of Tarif 590 prestations

Exemple

Required fields only

{
"date": "2022-02-20",
"reference": "12345",
"language": "fr",
"tiersMode": "tg",
"law": "vvg",
"treatmentReason": "disease",
"author":{
"firstName": "firstName",
"lastName": "lastName",
"rccNumber": "A000001",
"address":{
"street": "Street 10",
"zip": "1000",
"city": "Lausanne",
"canton": "VD"
}
},
"patient":{
"firstName": "firstName",
"lastName": "lastName",
"birthdate": "1990-10-20",
"address":{
"street": "Street 30",
"zip": "1700",
"city": "Fribourg"
},
"gender": "male"
},
"prestations":[
{
"date": "2022-02-20",
"tarif": 590,
"code": 1004,
"quantity": 2,
"totalPrice": 40
}
]
}

All fields

{
"date": "2022-02-20",
"reference": "12345",
"language": "fr",
"tiersMode": "tg",
"law": "vvg",
"treatmentReason": "disease",
"diagnosis": "Diagnosis",
"comment": "Insurer comment",
"vatNumber": "CHE111222333",
"author":{
"firstName": "firstName",
"lastName": "lastName",
"rccNumber": "A000001",
"glnNumber": "1234567890123",
"address":{
"street": "Street 10",
"zip": "1000",
"city": "Lausanne"
}
},
"provider":{
"firstName": "firstName",
"lastName": "lastName",
"rccNumber": "B000002",
"glnNumber": "",
"address":{
"street": "Street 20",
"zip": "1000",
"city": "Lausanne",
"canton": "VD"
}
},
"patient":{
"firstName": "firstName",
"lastName": "lastName",
"birthdate": "1990-10-20",
"address":{
"street": "Street 30",
"zip": "75000",
"city": "Paris",
"countryCode": "FR"
},
"gender": "male"
},
"recipient":{
"title": "Monsieur",
"firstName": "firstName",
"lastName": "lastName",
"address":{
"street": "Street 30",
"zip": "1700",
"city": "Fribourg"
}
},
"prestations":[
{
"date": "2022-02-20",
"tarif": 590,
"code": 1004,
"vatRate": "2.5%",
"quantity": 2,
"totalPrice": 40
},
{
"date": "2022-02-20",
"tarif": 999,
"code": null,
"vatRate": "7.7%",
"quantity": 3,
"totalPrice": 44.55,
"serviceDescription": "Description"
}
]
}