Diese API befindet sich noch in Entwicklung. Änderungen vorbehalten.

Übersicht

Über diese eventbasierte API können vom Labor markierte Aufträge aus Condent abgefragt werden. Dadurch können in Ihrem System beispielsweise Kostenvoranschläge, Rechnungen oder andere Leistungen erstellt werden.

Zusätzlich können in Ihrem System erzeugte Leistungen (z.B. Rechnungen oder Kostenvoranschläge) wieder nach Condent zurückgespielt werden. Dabei können auch Dateien (z.B. PDF, XML usw.) übertragen werden.

Authentifizierung (Sign V2)

Siehe hier.

Wichtig: Alle Endpunkte in dieser API verwenden Sign V2 für die Authentifizierung.

Der sign String wird nach folgendem Schema aufgebaut (durch \n getrennt):

apiKey
method (uppercase)
scheme (lowercase)
host (lowercase)
path (lowercase)
querystring (original case)
timestamp
body

Scheme, host und path müssen in Kleinbuchstaben sein! Method ist in Grossbuchstaben. Querystring bleibt in Original-Schreibweise.

Auch leere Strings (z.B. bei fehlendem querystring oder body) müssen im sign String enthalten sein.

Details und Beispiele finden Sie in der Authentifizierungs-Dokumentation.

Konzept

Das Event-System arbeitet mit einem Cursor-Prinzip, siehe Konzeptbeschreibung.

Exportierte Aufträge abfragen

Endpunkt

GET /v2/billing/export-events

Parameter

Parameter	Typ	Pflicht	Beschreibung
cursor	string	Nein	Zuletzt empfangener nextCursor. Ohne diesen Parameter werden die ersten verfügbaren Events gemäss limit zurückgegeben.
limit	int	Nein	Maximale Anzahl Events pro Anfrage (Standard: 50, Maximum: 200).

Antwortstruktur

{
  "events": [
    {
      "eventId": 67890,
      "timestamp": "2026-01-23T11:00:00Z",
      "data": {
        "key": "770e8400-e29b-41d4-a716-446655440000",
        "customer": {
            "id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
            "reference": "1234567"
        },
        "patient": {
            "id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
            "reference": "1234567",
            "salutation": null,
            "firstName": "John",
            "lastName": "Doe",
            "birthday": "1990-01-01",
            "streetName": "Zürichstrasse",
            "buildingNumber": "123",
            "city": "Zürich",
            "zipCode": "8000",
            "countryCode": "CH",
            "phoneNumber": null,
            "email": "john.doe@condent.ch"
        },
        "customerEmployee": {
            "salutation": null,
            "firstName": "John",
            "lastName": "Doe"
        },
        "title": "OK/UK Drahtklammerprothesen",
        "description": "OK Drahtklammerimmediatsprothese zum Ersatz von 16,14,22,24-26",
        "color": "B1",
        "type": "DeliveryBill",
        "url": "https://my.condent.ch/redirect/billing-export/770e8400-e29b-41d4-a716-446655440000",
        "patientUrl": "https://my.condent.ch/redirect/patient/456",
        "createDate": "2026-01-20T09:00:00Z"
      }
    }
  ],
  "nextCursor": "abc123==",
  "hasMore": false
}

Property	Beschreibung
key	Interne Condent-ID um dem Auftrag dann eine Leistung o.Ä. zuzuweisen
customer.id	Interne Condent-ID des Kunden
customer.reference	Code z.B. aus einem ERP-System
patient.id	Interne Condent-ID des Patienten
patient.reference	Pat Nr. z.B. aus einem ERP-System
patient.salutation	Anrede des Patienten (kann leer sein), mögliche Werte siehe unten
customerEmployee	Behandler (kann leer sein)
customerEmployee.salutation	Anrede des Behandlers (kann leer sein), mögliche Werte siehe unten
type	Typ der erwarteten Leistung (z.B. Kostenvoranschlag oder Rechnung; optional)

Mögliche Werte für patient.salutation und customerEmployee.salutation

Wert	Beschreibung
mr	Herr
ms	Frau
mrmeddent	Herr med. dent.
msmeddent	Frau med. dent.
dresmeddent	Dres. med. dent.
mrdrmeddent	Herr Dr. med. dent.
msdrmeddent	Frau Dr. med. dent.
mrdrdrmeddent	Herr Dr. Dr. med. dent.
msdrdrmeddent	Frau Dr. Dr. med. dent.
mrprofdrmeddent	Herr Prof. Dr. med. dent.
msprofdrmeddent	Frau Prof. Dr. med. dent.
mrprofdrdrmeddent	Herr Prof. Dr. Dr. med. dent.
msprofdrdrmeddent	Frau Prof. Dr. Dr. med. dent.

Leistungen importieren bzw. erstellen (Kostenvoranschlag, Rechnung usw.)

Endpunkt

POST /api/billing/import

Request-Parameter

Parameter	Pflicht	Typ	Kommentar
key	Ja	string	Interne Condent-ID aus /v2/billing/export-events
title	Nein	string	Der Titel der Leistung
color	Nein	string	Farbe, z.B. für Krone oder Schiene
description	Nein	string	Beschreibung der Leistung
type	Ja	string	Typ der Leistung (z.B. Kostenvoranschlag oder Rechnung)
date	Ja	string	Datum der Leistung (z.B. Rechnungsdatum)

---

Response-Parameter

Parameter	Typ	Kommentar
url	string	URL der Leistung auf Condent
uploadToken	string	Token um Dateien zu hochzuladen
warnings	string array	Die Warnungen sind für Entwickler:innen gedacht. Sie weisen beispielsweise darauf hin, dass bestimmte Textfelder zu lang sind. Die Leistung kann trotz dieser Warnungen erfasst werden.

Dateien hochladen

Um Dateien hochzuladen, muss zuerst eine Leistung erstellt werden. Den benötigten uploadToken erhalten Sie in der Response des Import-Requests.

Aktuell gelten folgende Beschränkungen:

• Maximale Dateigrösse: 100 MB
• Alle Dateiformate werden akzeptiert (z.B. JPG, PNG, ZIP, PDF, STL, 3OX usw.)

Sofern möglich, werden bestimmte Dateien (z.B. Bilder) serverseitig komprimiert.

Dateien müssen einzeln übertragen werden, um Timeouts zu vermeiden (z.B. bei vielen oder grossen Dateien). Wir empfehlen parallele Requests.

Eein Beispiel in C# finden Sie hier.

Alternativ können mehrere Dateien gesammelt als ZIP-Datei übertragen werden.

Eine Leistung wird in Condent auch dann erstellt, wenn einzelne Dateien nicht erfolgreich übertragen wurden. Das Labor kann Dateien anschliessend manuell hochladen oder entfernen.

Details zu Request und Response finden Sie hier.