Download OpenAPI specification:
REST API für Akquinet zur Interaktion mit der Alberta Homecare Plattform.
Dokumentation erstellt am: 05.03.2026
fieldNurseId)proposedArticleLines als Vorlage für wiederkehrende Bestellungen.integratedCareIdViele Endpunkte unterstützen inkrementelle Synchronisation über zwei Parameter:
created, updated, archived, transmitted)GET /endpoint?status=created&updatedAfter=2025-12-10T00:00:00ZPATCH mit neuem Status aufrufenupdatedAfter auf den gemerkten Zeitstempel setzenÄnderungen, die über die API vorgenommen werden (z.B. PATCH/PUT), werden beim nächsten Abruf automatisch ignoriert. Alberta erkennt den API-Key und filtert diese Änderungen heraus. Das bedeutet: Wenn Sie einen Datensatz per API aktualisieren, erscheint er nicht erneut in Ihrer nächsten Synchronisationsabfrage.
Ausnahme bei Bestellungen: Bei SingleOrder, DirectOrder und IntegratedCare erfolgt
die Steuerung über den Status-Wechsel (z.B. von created zu transmitted). Sobald Sie den
Status per PATCH ändern, erscheint die Bestellung nicht mehr unter status=created.
primaryDoctorId am Patienten)| Endpunkt | Zweck | Methoden |
|---|---|---|
| /patient | Patientenstammdaten | GET, POST, PUT |
| /patient/customerMapping | Patient anhand Kundennummer finden | GET |
| /patientNote | Notizen zu Patienten | GET, POST, PATCH |
| /singleOrder | Bestellungen (im Rahmen einer Versorgung) | GET, PATCH |
| /directOrder | Einmalige Bestellungen ohne Bezug zu einer Dauerversorgung | GET, PATCH |
| /integratedCare | Dauerversorgungen | GET |
| /erpOrder | Lieferrückmeldungen vom ERP | GET, POST, PUT |
| /article | Artikelstammdaten | GET, POST, PUT |
| /doctor | Ärzte | GET |
| /payer | Kostenträger/Krankenkassen | GET |
| /hospital | Krankenhäuser | GET |
| /nursingHome | Pflegeheime | GET |
| /nursingService | Pflegedienste | GET |
| /pharmacy | Apotheken | GET |
| /region | Strukturelle Organisationseinheiten | GET |
| /users | Außendienstmitarbeiter | GET |
| /attachment | Dateien/Bilder | GET |
| /document | Ausgefüllte Formulare (PDF) | GET |
| /device | Medizinische Geräte | POST, PUT |
Die Authentifizierung erfolgt über einen API-Key, der im Header alberta-api-key übermittelt werden muss.
Der API-Key wird von Alberta bereitgestellt und ist mandantenspezifisch.
Aktuelle Informationen zur Systemverfügbarkeit und geplanten Wartungsarbeiten finden Sie auf unserer Status-Seite.
Ruft einen einzelnen Artikel anhand seiner ID ab.
Die ID kann entweder die Alberta-interne _id (UUID) oder die
ERP-spezifische customerNumber sein.
| id required | string Example: 550e8400-e29b-41d4-a716-446655440000 Artikel-ID. Kann entweder die Alberta |
{- "pcn": "string",
- "name": "string",
- "description": "string",
- "manufacturerNumber": "string",
- "customerNumber": "string",
- "medicalAidPositionNumber": "string",
- "ean": "string",
- "additionalDescription": "string",
- "manufacturer": "string",
- "size": "string",
- "assortmentType": 0,
- "status": 0,
- "productGroupId": "string",
- "therapyIds": [
- 0
], - "billableTherapies": [
- 0
], - "prescriptionType": 0,
- "packagingUnits": [
- {
- "_id": "string",
- "pcn": "string",
- "quantity": 0,
- "unit": "Stk",
- "archived": true
}
], - "pharmacyPrice": "string",
- "listPrice": "string",
- "insuranceFixedPrice": [
- {
- "payerId": "string",
- "contractId": "string",
- "price": "string"
}
], - "fixedPrice": "string",
- "purchaseRating": 0,
- "unavailableTo": "string",
- "unavailableFrom": "string",
- "delayedTo": "string",
- "inventoryType": 0,
- "stars": 0,
- "attributes": [
- {
- "attributeTemplateId": "string",
- "name": "string",
- "dataType": 0,
- "value": 0
}
], - "substituteArticleCustomerNumber": "string",
- "requiresSerialnumber": true,
- "requiresBatchnumber": true,
- "requiresValidToDate": true,
- "directOrder": true,
- "pharmacyOnly": true,
- "statusAnnotation": "string",
- "_id": "string",
- "timestamp": "string",
- "archived": true,
- "createdAt": "string",
- "createdBy": "string",
- "updatedAt": "string",
- "updatedBy": "string"
}Listet Artikel auf, die seit einem bestimmten Zeitpunkt geändert wurden.
Der Parameter updatedAfter ist für externe Abfragen Pflicht und filtert auf Artikel,
deren updatedAt größer als der angegebene Zeitstempel ist.
Dieser Endpunkt unterstützt auch eine interne Abfrage über customerNumber.
In diesem Fall ist updatedAfter nicht erforderlich.
| updatedAfter required | string <date-time> Example: updatedAfter=2025-05-14T04:25:35.000Z ISO 8601 Zeitstempel (z.B. |
[- {
- "pcn": "string",
- "name": "string",
- "description": "string",
- "manufacturerNumber": "string",
- "customerNumber": "string",
- "medicalAidPositionNumber": "string",
- "ean": "string",
- "additionalDescription": "string",
- "manufacturer": "string",
- "size": "string",
- "assortmentType": 0,
- "status": 0,
- "productGroupId": "string",
- "therapyIds": [
- 0
], - "billableTherapies": [
- 0
], - "prescriptionType": 0,
- "packagingUnits": [
- {
- "_id": "string",
- "pcn": "string",
- "quantity": 0,
- "unit": "Stk",
- "archived": true
}
], - "pharmacyPrice": "string",
- "listPrice": "string",
- "insuranceFixedPrice": [
- {
- "payerId": "string",
- "contractId": "string",
- "price": "string"
}
], - "fixedPrice": "string",
- "purchaseRating": 0,
- "unavailableTo": "string",
- "unavailableFrom": "string",
- "delayedTo": "string",
- "inventoryType": 0,
- "stars": 0,
- "attributes": [
- {
- "attributeTemplateId": "string",
- "name": "string",
- "dataType": 0,
- "value": 0
}
], - "substituteArticleCustomerNumber": "string",
- "requiresSerialnumber": true,
- "requiresBatchnumber": true,
- "requiresValidToDate": true,
- "directOrder": true,
- "pharmacyOnly": true,
- "statusAnnotation": "string",
- "_id": "string",
- "timestamp": "string",
- "archived": true,
- "createdAt": "string",
- "createdBy": "string",
- "updatedAt": "string",
- "updatedBy": "string"
}
]Erstellt einen neuen Artikel im System.
name: ArtikelnamecustomerNumber: ERP-spezifische Artikelnummer (muss eindeutig sein)packagingUnits: Mindestens eine VerpackungseinheitWenn prescriptionType als Zahl 6 übergeben wird, wird dieser Wert serverseitig auf 0 (Drug) gesetzt.
Beim Aufruf von POST sind keine Query-Parameter erlaubt.
| pcn | string Pharmazentralnummer (PZN). | ||||||||||||||||||||||||
| name | string Name des Artikels. | ||||||||||||||||||||||||
| description | string Beschreibung des Artikels. | ||||||||||||||||||||||||
| manufacturerNumber | string Herstellernummer. | ||||||||||||||||||||||||
| customerNumber | string ERP- bzw. kundenspezifische Nummer des Artikels. | ||||||||||||||||||||||||
| medicalAidPositionNumber | string Hilfsmittelpositionsnummer. Nummer aus dem Hilfsmittelverzeichnis der GKV. | ||||||||||||||||||||||||
| ean | string European Article Number (EAN/GTIN). | ||||||||||||||||||||||||
| additionalDescription | string Zusätzliche Beschreibung. | ||||||||||||||||||||||||
| manufacturer | string Name des Herstellers. | ||||||||||||||||||||||||
| size | string Größe/Abmessung des Artikels. | ||||||||||||||||||||||||
| assortmentType | number Sortimentstyp. Wert ist der Enum-Wert aus {@link ArticleAssortment } . | ||||||||||||||||||||||||
| status | number Status des Artikels. Wert ist der Enum-Wert aus {@link ArticleStatus } . | ||||||||||||||||||||||||
| productGroupId | string ID der Produktgruppe. | ||||||||||||||||||||||||
| therapyIds | Array of numbers Liste der Therapie-IDs, für die dieser Artikel verwendet werden kann. Werte sind Enum-Werte aus {@link Therapy } . | ||||||||||||||||||||||||
| billableTherapies | Array of numbers Liste der Therapie-IDs, für die dieser Artikel abrechenbar ist. Werte sind Enum-Werte aus {@link Therapy } . | ||||||||||||||||||||||||
| prescriptionType | number (PrescriptionType) Enum: 0 1 2 3 4 5 7 Typ einer Verordnung. Definiert die verschiedenen Verordnungsarten im Homecare-Bereich.
| ||||||||||||||||||||||||
Array of objects (IQuantityPerUnit) Verpackungseinheiten mit Mengenangaben. | |||||||||||||||||||||||||
| pharmacyPrice | string Apothekenverkaufspreis. | ||||||||||||||||||||||||
| listPrice | string Listenpreis. | ||||||||||||||||||||||||
Array of objects (IInsuranceFixedPrice) Pauschalen aus Krankenkassen-Verträgen. | |||||||||||||||||||||||||
| fixedPrice | string Pauschale. | ||||||||||||||||||||||||
| purchaseRating | number Verwendet für die Wirtschaftlichkeitsberechnung von Artikel beim Erstellen einer Bestellung. | ||||||||||||||||||||||||
| unavailableTo | string Nicht verfügbar bis (Enddatum). | ||||||||||||||||||||||||
| unavailableFrom | string Nicht verfügbar ab (Startdatum). | ||||||||||||||||||||||||
| delayedTo | string Lieferung verzögert bis. | ||||||||||||||||||||||||
| inventoryType | number (InventoryType) Enum: 0 1 2 Inventartyp für Lagerbestände von Artikeln. Unterscheidet zwischen Lager- und Bestellbeständen.
| ||||||||||||||||||||||||
| stars | number Bewertung (Sterne). Bestimmt die Sortierung der Artikel im Standardversorgungsvorschlag. Höhere Anzahl der Sterne bedeutet Sortierung an den Anfang der Artikel-Liste. Sterne können alternativ auch aus einer Wirtschaftlichkeitsberechnung heraus bestimmt werden. | ||||||||||||||||||||||||
Array of objects (IAttribute) Zusätzliche Attribute des Artikels. Werden in der UI im Artikel-Editor angezeigt. | |||||||||||||||||||||||||
| substituteArticleCustomerNumber | string ERP bzw. kundenseitige Nummer eines Ersatzartikels. | ||||||||||||||||||||||||
| requiresSerialnumber | boolean Gibt an, ob eine Seriennummer erforderlich ist. | ||||||||||||||||||||||||
| requiresBatchnumber | boolean Gibt an, ob eine Chargennummer erforderlich ist. | ||||||||||||||||||||||||
| requiresValidToDate | boolean Gibt an, ob ein Verfallsdatum erforderlich ist. | ||||||||||||||||||||||||
| directOrder | boolean Gibt an, ob der Artikel für Direktbestellungen verfügbar ist. | ||||||||||||||||||||||||
| pharmacyOnly | boolean Gibt an, ob der Artikel nur über Apotheken bezogen werden kann. | ||||||||||||||||||||||||
| statusAnnotation | string Anmerkung zum Status. | ||||||||||||||||||||||||
| _id | string Eindeutige ID der Entität (UUID v4 als String). Wird beim Erstellen automatisch generiert. | ||||||||||||||||||||||||
| timestamp | string Zeitstempel der letzten Änderung. Wird bei jeder Änderung automatisch aktualisiert. | ||||||||||||||||||||||||
| archived | boolean Markiert die Entität als archiviert (Soft-Delete). Archivierte Entitäten werden nicht physisch gelöscht, sondern nur als archiviert markiert. Sie erscheinen nicht mehr in Standard-Abfragen. | ||||||||||||||||||||||||
| createdAt | string Zeitpunkt der Erstellung. Wird beim Erstellen der Entität automatisch gesetzt. | ||||||||||||||||||||||||
| createdBy | string ID des Benutzers, der die Entität erstellt hat. Referenziert einen Benutzer im System. | ||||||||||||||||||||||||
| updatedAt | string Zeitpunkt der letzten Änderung. Wird bei jeder Änderung automatisch aktualisiert. | ||||||||||||||||||||||||
| updatedBy | string ID des Benutzers, der die letzte Änderung vorgenommen hat. Referenziert einen Benutzer im System. |
{- "pcn": "string",
- "name": "string",
- "description": "string",
- "manufacturerNumber": "string",
- "customerNumber": "string",
- "medicalAidPositionNumber": "string",
- "ean": "string",
- "additionalDescription": "string",
- "manufacturer": "string",
- "size": "string",
- "assortmentType": 0,
- "status": 0,
- "productGroupId": "string",
- "therapyIds": [
- 0
], - "billableTherapies": [
- 0
], - "prescriptionType": 0,
- "packagingUnits": [
- {
- "_id": "string",
- "pcn": "string",
- "quantity": 0,
- "unit": "Stk",
- "archived": true
}
], - "pharmacyPrice": "string",
- "listPrice": "string",
- "insuranceFixedPrice": [
- {
- "payerId": "string",
- "contractId": "string",
- "price": "string"
}
], - "fixedPrice": "string",
- "purchaseRating": 0,
- "unavailableTo": "string",
- "unavailableFrom": "string",
- "delayedTo": "string",
- "inventoryType": 0,
- "stars": 0,
- "attributes": [
- {
- "attributeTemplateId": "string",
- "name": "string",
- "dataType": 0,
- "value": 0
}
], - "substituteArticleCustomerNumber": "string",
- "requiresSerialnumber": true,
- "requiresBatchnumber": true,
- "requiresValidToDate": true,
- "directOrder": true,
- "pharmacyOnly": true,
- "statusAnnotation": "string",
- "_id": "string",
- "timestamp": "string",
- "archived": true,
- "createdAt": "string",
- "createdBy": "string",
- "updatedAt": "string",
- "updatedBy": "string"
}{- "pcn": "string",
- "name": "string",
- "description": "string",
- "manufacturerNumber": "string",
- "customerNumber": "string",
- "medicalAidPositionNumber": "string",
- "ean": "string",
- "additionalDescription": "string",
- "manufacturer": "string",
- "size": "string",
- "assortmentType": 0,
- "status": 0,
- "productGroupId": "string",
- "therapyIds": [
- 0
], - "billableTherapies": [
- 0
], - "prescriptionType": 0,
- "packagingUnits": [
- {
- "_id": "string",
- "pcn": "string",
- "quantity": 0,
- "unit": "Stk",
- "archived": true
}
], - "pharmacyPrice": "string",
- "listPrice": "string",
- "insuranceFixedPrice": [
- {
- "payerId": "string",
- "contractId": "string",
- "price": "string"
}
], - "fixedPrice": "string",
- "purchaseRating": 0,
- "unavailableTo": "string",
- "unavailableFrom": "string",
- "delayedTo": "string",
- "inventoryType": 0,
- "stars": 0,
- "attributes": [
- {
- "attributeTemplateId": "string",
- "name": "string",
- "dataType": 0,
- "value": 0
}
], - "substituteArticleCustomerNumber": "string",
- "requiresSerialnumber": true,
- "requiresBatchnumber": true,
- "requiresValidToDate": true,
- "directOrder": true,
- "pharmacyOnly": true,
- "statusAnnotation": "string",
- "_id": "string",
- "timestamp": "string",
- "archived": true,
- "createdAt": "string",
- "createdBy": "string",
- "updatedAt": "string",
- "updatedBy": "string"
}Aktualisiert einen bestehenden Artikel.
Der Pfadparameter customerNumber ist die ERP-spezifische Artikelnummer.
Beim Aufruf von PUT sind keine Query-Parameter erlaubt.
Wenn prescriptionType als Zahl 6 übergeben wird, wird dieser Wert serverseitig auf 0 (Drug) gesetzt.
| customerNumber required | string Example: 123456 ERP-spezifische Artikelnummer |
| pcn | string Pharmazentralnummer (PZN). | ||||||||||||||||||||||||
| name | string Name des Artikels. | ||||||||||||||||||||||||
| description | string Beschreibung des Artikels. | ||||||||||||||||||||||||
| manufacturerNumber | string Herstellernummer. | ||||||||||||||||||||||||
| customerNumber | string ERP- bzw. kundenspezifische Nummer des Artikels. | ||||||||||||||||||||||||
| medicalAidPositionNumber | string Hilfsmittelpositionsnummer. Nummer aus dem Hilfsmittelverzeichnis der GKV. | ||||||||||||||||||||||||
| ean | string European Article Number (EAN/GTIN). | ||||||||||||||||||||||||
| additionalDescription | string Zusätzliche Beschreibung. | ||||||||||||||||||||||||
| manufacturer | string Name des Herstellers. | ||||||||||||||||||||||||
| size | string Größe/Abmessung des Artikels. | ||||||||||||||||||||||||
| assortmentType | number Sortimentstyp. Wert ist der Enum-Wert aus {@link ArticleAssortment } . | ||||||||||||||||||||||||
| status | number Status des Artikels. Wert ist der Enum-Wert aus {@link ArticleStatus } . | ||||||||||||||||||||||||
| productGroupId | string ID der Produktgruppe. | ||||||||||||||||||||||||
| therapyIds | Array of numbers Liste der Therapie-IDs, für die dieser Artikel verwendet werden kann. Werte sind Enum-Werte aus {@link Therapy } . | ||||||||||||||||||||||||
| billableTherapies | Array of numbers Liste der Therapie-IDs, für die dieser Artikel abrechenbar ist. Werte sind Enum-Werte aus {@link Therapy } . | ||||||||||||||||||||||||
| prescriptionType | number (PrescriptionType) Enum: 0 1 2 3 4 5 7 Typ einer Verordnung. Definiert die verschiedenen Verordnungsarten im Homecare-Bereich.
| ||||||||||||||||||||||||
Array of objects (IQuantityPerUnit) Verpackungseinheiten mit Mengenangaben. | |||||||||||||||||||||||||
| pharmacyPrice | string Apothekenverkaufspreis. | ||||||||||||||||||||||||
| listPrice | string Listenpreis. | ||||||||||||||||||||||||
Array of objects (IInsuranceFixedPrice) Pauschalen aus Krankenkassen-Verträgen. | |||||||||||||||||||||||||
| fixedPrice | string Pauschale. | ||||||||||||||||||||||||
| purchaseRating | number Verwendet für die Wirtschaftlichkeitsberechnung von Artikel beim Erstellen einer Bestellung. | ||||||||||||||||||||||||
| unavailableTo | string Nicht verfügbar bis (Enddatum). | ||||||||||||||||||||||||
| unavailableFrom | string Nicht verfügbar ab (Startdatum). | ||||||||||||||||||||||||
| delayedTo | string Lieferung verzögert bis. | ||||||||||||||||||||||||
| inventoryType | number (InventoryType) Enum: 0 1 2 Inventartyp für Lagerbestände von Artikeln. Unterscheidet zwischen Lager- und Bestellbeständen.
| ||||||||||||||||||||||||
| stars | number Bewertung (Sterne). Bestimmt die Sortierung der Artikel im Standardversorgungsvorschlag. Höhere Anzahl der Sterne bedeutet Sortierung an den Anfang der Artikel-Liste. Sterne können alternativ auch aus einer Wirtschaftlichkeitsberechnung heraus bestimmt werden. | ||||||||||||||||||||||||
Array of objects (IAttribute) Zusätzliche Attribute des Artikels. Werden in der UI im Artikel-Editor angezeigt. | |||||||||||||||||||||||||
| substituteArticleCustomerNumber | string ERP bzw. kundenseitige Nummer eines Ersatzartikels. | ||||||||||||||||||||||||
| requiresSerialnumber | boolean Gibt an, ob eine Seriennummer erforderlich ist. | ||||||||||||||||||||||||
| requiresBatchnumber | boolean Gibt an, ob eine Chargennummer erforderlich ist. | ||||||||||||||||||||||||
| requiresValidToDate | boolean Gibt an, ob ein Verfallsdatum erforderlich ist. | ||||||||||||||||||||||||
| directOrder | boolean Gibt an, ob der Artikel für Direktbestellungen verfügbar ist. | ||||||||||||||||||||||||
| pharmacyOnly | boolean Gibt an, ob der Artikel nur über Apotheken bezogen werden kann. | ||||||||||||||||||||||||
| statusAnnotation | string Anmerkung zum Status. | ||||||||||||||||||||||||
| _id | string Eindeutige ID der Entität (UUID v4 als String). Wird beim Erstellen automatisch generiert. | ||||||||||||||||||||||||
| timestamp | string Zeitstempel der letzten Änderung. Wird bei jeder Änderung automatisch aktualisiert. | ||||||||||||||||||||||||
| archived | boolean Markiert die Entität als archiviert (Soft-Delete). Archivierte Entitäten werden nicht physisch gelöscht, sondern nur als archiviert markiert. Sie erscheinen nicht mehr in Standard-Abfragen. | ||||||||||||||||||||||||
| createdAt | string Zeitpunkt der Erstellung. Wird beim Erstellen der Entität automatisch gesetzt. | ||||||||||||||||||||||||
| createdBy | string ID des Benutzers, der die Entität erstellt hat. Referenziert einen Benutzer im System. | ||||||||||||||||||||||||
| updatedAt | string Zeitpunkt der letzten Änderung. Wird bei jeder Änderung automatisch aktualisiert. | ||||||||||||||||||||||||
| updatedBy | string ID des Benutzers, der die letzte Änderung vorgenommen hat. Referenziert einen Benutzer im System. |
{- "pcn": "string",
- "name": "string",
- "description": "string",
- "manufacturerNumber": "string",
- "customerNumber": "string",
- "medicalAidPositionNumber": "string",
- "ean": "string",
- "additionalDescription": "string",
- "manufacturer": "string",
- "size": "string",
- "assortmentType": 0,
- "status": 0,
- "productGroupId": "string",
- "therapyIds": [
- 0
], - "billableTherapies": [
- 0
], - "prescriptionType": 0,
- "packagingUnits": [
- {
- "_id": "string",
- "pcn": "string",
- "quantity": 0,
- "unit": "Stk",
- "archived": true
}
], - "pharmacyPrice": "string",
- "listPrice": "string",
- "insuranceFixedPrice": [
- {
- "payerId": "string",
- "contractId": "string",
- "price": "string"
}
], - "fixedPrice": "string",
- "purchaseRating": 0,
- "unavailableTo": "string",
- "unavailableFrom": "string",
- "delayedTo": "string",
- "inventoryType": 0,
- "stars": 0,
- "attributes": [
- {
- "attributeTemplateId": "string",
- "name": "string",
- "dataType": 0,
- "value": 0
}
], - "substituteArticleCustomerNumber": "string",
- "requiresSerialnumber": true,
- "requiresBatchnumber": true,
- "requiresValidToDate": true,
- "directOrder": true,
- "pharmacyOnly": true,
- "statusAnnotation": "string",
- "_id": "string",
- "timestamp": "string",
- "archived": true,
- "createdAt": "string",
- "createdBy": "string",
- "updatedAt": "string",
- "updatedBy": "string"
}{- "pcn": "string",
- "name": "string",
- "description": "string",
- "manufacturerNumber": "string",
- "customerNumber": "string",
- "medicalAidPositionNumber": "string",
- "ean": "string",
- "additionalDescription": "string",
- "manufacturer": "string",
- "size": "string",
- "assortmentType": 0,
- "status": 0,
- "productGroupId": "string",
- "therapyIds": [
- 0
], - "billableTherapies": [
- 0
], - "prescriptionType": 0,
- "packagingUnits": [
- {
- "_id": "string",
- "pcn": "string",
- "quantity": 0,
- "unit": "Stk",
- "archived": true
}
], - "pharmacyPrice": "string",
- "listPrice": "string",
- "insuranceFixedPrice": [
- {
- "payerId": "string",
- "contractId": "string",
- "price": "string"
}
], - "fixedPrice": "string",
- "purchaseRating": 0,
- "unavailableTo": "string",
- "unavailableFrom": "string",
- "delayedTo": "string",
- "inventoryType": 0,
- "stars": 0,
- "attributes": [
- {
- "attributeTemplateId": "string",
- "name": "string",
- "dataType": 0,
- "value": 0
}
], - "substituteArticleCustomerNumber": "string",
- "requiresSerialnumber": true,
- "requiresBatchnumber": true,
- "requiresValidToDate": true,
- "directOrder": true,
- "pharmacyOnly": true,
- "statusAnnotation": "string",
- "_id": "string",
- "timestamp": "string",
- "archived": true,
- "createdAt": "string",
- "createdBy": "string",
- "updatedAt": "string",
- "updatedBy": "string"
}Erstellt ein neues medizinisches Gerät für einen Patienten.
Geräte sind individuelle Instanzen von Artikeln mit einer Seriennummer, die einem Patienten zugeordnet sind.
patientId: ID des PatientenserialNumber: Seriennummer des Gerätsdescription: Beschreibung des GerätsregionId wird automatisch vom Patienten übernommen._id wird automatisch generiert und darf nicht übergeben werden.| patientId | string ID des Patienten, dem das Gerät zugeordnet ist. |
| regionId | string ID der Region. |
| articleId | string ID des zugrunde liegenden Artikels. |
| articleNumber | string ERP Artikelnummer des Geräts. |
| serialNumber | string Seriennummer des Geräts. |
| description | string Beschreibung des Geräts. |
| additionalDescription | string Zusätzliche Beschreibung. |
| locked | boolean Gibt an, ob das Gerät gesperrt ist. |
| commissioningDate | string Datum der Inbetriebnahme. |
| repairEstimateRequired | boolean Gibt an, ob ein Kostenvoranschlag für Reparaturen erforderlich ist. |
| repairEstimateLimit | string Kostengrenze für Kosenvoranschläge für Reparaturen. |
| lastBookingCode | string Letzter Buchungscode. |
| lastLocationCode | string Letzter Standortcode. |
| ownerName | string Name des Eigentümers. |
| deviceNumber | string Gerätenummer. |
| registerNumber | string Registrierungsnummer des Geräts. |
Array of objects (IDeviceMaintenanceLine) Wartungsdaten des Geräts. | |
Array of objects (IDeviceInformationLine) Zusätzliche Geräteinformationen. | |
| _id | string Eindeutige ID der Entität (UUID v4 als String). Wird beim Erstellen automatisch generiert. |
| timestamp | string Zeitstempel der letzten Änderung. Wird bei jeder Änderung automatisch aktualisiert. |
| archived | boolean Markiert die Entität als archiviert (Soft-Delete). Archivierte Entitäten werden nicht physisch gelöscht, sondern nur als archiviert markiert. Sie erscheinen nicht mehr in Standard-Abfragen. |
| createdAt | string Zeitpunkt der Erstellung. Wird beim Erstellen der Entität automatisch gesetzt. |
| createdBy | string ID des Benutzers, der die Entität erstellt hat. Referenziert einen Benutzer im System. |
| updatedAt | string Zeitpunkt der letzten Änderung. Wird bei jeder Änderung automatisch aktualisiert. |
| updatedBy | string ID des Benutzers, der die letzte Änderung vorgenommen hat. Referenziert einen Benutzer im System. |
{- "patientId": "string",
- "regionId": "string",
- "articleId": "string",
- "articleNumber": "string",
- "serialNumber": "string",
- "description": "string",
- "additionalDescription": "string",
- "locked": true,
- "commissioningDate": "string",
- "repairEstimateRequired": true,
- "repairEstimateLimit": "string",
- "lastBookingCode": "string",
- "lastLocationCode": "string",
- "ownerName": "string",
- "deviceNumber": "string",
- "registerNumber": "string",
- "maintenances": [
- {
- "maintenanceCode": "string",
- "maintenanceInterval": "string",
- "lastServiceDate": "string",
- "nextServiceDate": "string"
}
], - "deviceInformationLines": [
- {
- "articleDescription": "string",
- "articleNumber": "string",
- "batchNumber": "string",
- "technicalServiceCompletionDate": "string",
- "dueDate": "string",
- "name": "string",
- "additionalName": "string",
- "inspectionType": "string",
- "inspectionCompleted": true,
- "serialNumber": "string",
- "serviceOriginType": "string",
- "serviceDescription": "string",
- "serviceLocation": "string",
- "serviceCompleted": true,
- "deviceAppraisalLines": [
- {
- "description": "string",
- "additionalDescription": "string",
- "repairsReason": "string",
- "repairsResolution": "string"
}
], - "deviceSparepartLines": [
- {
- "postingDate": "string",
- "articleNumber": "string",
- "articleDescription": "string",
- "articleDescription2": "string"
}
], - "active": true,
- "archived": true
}
], - "_id": "string",
- "timestamp": "string",
- "archived": true,
- "createdAt": "string",
- "createdBy": "string",
- "updatedAt": "string",
- "updatedBy": "string"
}{- "_id": "string",
- "serialNumber": "string",
- "updated": "2019-08-24T14:15:22Z"
}Aktualisiert ein bestehendes medizinisches Gerät.
patientId: ID des PatientenserialNumber: Seriennummer des Gerätsdescription: Beschreibung des GerätsregionId wird automatisch vom Patienten übernommen.id übergeben werden.| id required | string Example: 550e8400-e29b-41d4-a716-446655440000 Die UUID des Geräts (Alberta |
| patientId | string ID des Patienten, dem das Gerät zugeordnet ist. |
| regionId | string ID der Region. |
| articleId | string ID des zugrunde liegenden Artikels. |
| articleNumber | string ERP Artikelnummer des Geräts. |
| serialNumber | string Seriennummer des Geräts. |
| description | string Beschreibung des Geräts. |
| additionalDescription | string Zusätzliche Beschreibung. |
| locked | boolean Gibt an, ob das Gerät gesperrt ist. |
| commissioningDate | string Datum der Inbetriebnahme. |
| repairEstimateRequired | boolean Gibt an, ob ein Kostenvoranschlag für Reparaturen erforderlich ist. |
| repairEstimateLimit | string Kostengrenze für Kosenvoranschläge für Reparaturen. |
| lastBookingCode | string Letzter Buchungscode. |
| lastLocationCode | string Letzter Standortcode. |
| ownerName | string Name des Eigentümers. |
| deviceNumber | string Gerätenummer. |
| registerNumber | string Registrierungsnummer des Geräts. |
Array of objects (IDeviceMaintenanceLine) Wartungsdaten des Geräts. | |
Array of objects (IDeviceInformationLine) Zusätzliche Geräteinformationen. | |
| _id | string Eindeutige ID der Entität (UUID v4 als String). Wird beim Erstellen automatisch generiert. |
| timestamp | string Zeitstempel der letzten Änderung. Wird bei jeder Änderung automatisch aktualisiert. |
| archived | boolean Markiert die Entität als archiviert (Soft-Delete). Archivierte Entitäten werden nicht physisch gelöscht, sondern nur als archiviert markiert. Sie erscheinen nicht mehr in Standard-Abfragen. |
| createdAt | string Zeitpunkt der Erstellung. Wird beim Erstellen der Entität automatisch gesetzt. |
| createdBy | string ID des Benutzers, der die Entität erstellt hat. Referenziert einen Benutzer im System. |
| updatedAt | string Zeitpunkt der letzten Änderung. Wird bei jeder Änderung automatisch aktualisiert. |
| updatedBy | string ID des Benutzers, der die letzte Änderung vorgenommen hat. Referenziert einen Benutzer im System. |
{- "patientId": "string",
- "regionId": "string",
- "articleId": "string",
- "articleNumber": "string",
- "serialNumber": "string",
- "description": "string",
- "additionalDescription": "string",
- "locked": true,
- "commissioningDate": "string",
- "repairEstimateRequired": true,
- "repairEstimateLimit": "string",
- "lastBookingCode": "string",
- "lastLocationCode": "string",
- "ownerName": "string",
- "deviceNumber": "string",
- "registerNumber": "string",
- "maintenances": [
- {
- "maintenanceCode": "string",
- "maintenanceInterval": "string",
- "lastServiceDate": "string",
- "nextServiceDate": "string"
}
], - "deviceInformationLines": [
- {
- "articleDescription": "string",
- "articleNumber": "string",
- "batchNumber": "string",
- "technicalServiceCompletionDate": "string",
- "dueDate": "string",
- "name": "string",
- "additionalName": "string",
- "inspectionType": "string",
- "inspectionCompleted": true,
- "serialNumber": "string",
- "serviceOriginType": "string",
- "serviceDescription": "string",
- "serviceLocation": "string",
- "serviceCompleted": true,
- "deviceAppraisalLines": [
- {
- "description": "string",
- "additionalDescription": "string",
- "repairsReason": "string",
- "repairsResolution": "string"
}
], - "deviceSparepartLines": [
- {
- "postingDate": "string",
- "articleNumber": "string",
- "articleDescription": "string",
- "articleDescription2": "string"
}
], - "active": true,
- "archived": true
}
], - "_id": "string",
- "timestamp": "string",
- "archived": true,
- "createdAt": "string",
- "createdBy": "string",
- "updatedAt": "string",
- "updatedBy": "string"
}{- "_id": "string",
- "serialNumber": "string",
- "updated": "2019-08-24T14:15:22Z"
}Ruft einen einzelnen Arzt anhand seiner ID ab.
Hinweis: Das Feld draft wird serverseitig entfernt und ist daher nicht Teil der externen API.
| id required | string Example: 550e8400-e29b-41d4-a716-446655440000 Die UUID des Arztes (Alberta |
{- "gender": 0,
- "titleShort": "string",
- "title": "string",
- "firstName": "string",
- "lastName": "string",
- "address": "string",
- "postalCode": "string",
- "city": "string",
- "phone": "string",
- "fax": "string",
- "email": "string",
- "emailPrescriptionRequest": "string",
- "faxPrescriptionRequest": "string",
- "website": "string",
- "institution": {
- "type": 0,
- "id": "string",
- "description": "string"
}, - "lifelongNumber": "string",
- "siteNumber": "string",
- "albertaConnect": true,
- "isKiwiUser": true,
- "_id": "string",
- "timestamp": "string",
- "archived": true
}Listet Ärzte auf, gefiltert nach ID oder Änderungszeitstempel.
Es muss mindestens einer der Parameter _id oder updatedAfter angegeben werden.
| _id | string UUID des Arztes. |
| updatedAfter | string <date-time> Example: updatedAfter=2025-01-01T00:00:00.000Z ISO 8601 Zeitstempel für inkrementelle Synchronisation. |
[- {
- "gender": 0,
- "titleShort": "string",
- "title": "string",
- "firstName": "string",
- "lastName": "string",
- "address": "string",
- "postalCode": "string",
- "city": "string",
- "phone": "string",
- "fax": "string",
- "email": "string",
- "emailPrescriptionRequest": "string",
- "faxPrescriptionRequest": "string",
- "website": "string",
- "institution": {
- "type": 0,
- "id": "string",
- "description": "string"
}, - "lifelongNumber": "string",
- "siteNumber": "string",
- "albertaConnect": true,
- "isKiwiUser": true,
- "_id": "string",
- "timestamp": "string",
- "archived": true
}
]{- "name": "string",
- "address": "string",
- "postalCode": "string",
- "city": "string",
- "phone": "string",
- "fax": "string",
- "email": "string",
- "website": "string",
- "albertaConnect": true,
- "_id": "string",
- "timestamp": "string",
- "archived": true
}| _id | string |
| updatedAfter | string <date-time> Example: updatedAfter=2025-01-01T00:00:00.000Z |
[- {
- "name": "string",
- "address": "string",
- "postalCode": "string",
- "city": "string",
- "phone": "string",
- "fax": "string",
- "email": "string",
- "website": "string",
- "albertaConnect": true,
- "_id": "string",
- "timestamp": "string",
- "archived": true
}
]{- "name": "string",
- "address": "string",
- "postalCode": "string",
- "city": "string",
- "phone": "string",
- "fax": "string",
- "email": "string",
- "website": "string",
- "albertaConnect": true,
- "_id": "string",
- "timestamp": "string",
- "archived": true
}| _id | string |
| updatedAfter | string <date-time> Example: updatedAfter=2025-01-01T00:00:00.000Z |
[- {
- "name": "string",
- "address": "string",
- "postalCode": "string",
- "city": "string",
- "phone": "string",
- "fax": "string",
- "email": "string",
- "website": "string",
- "albertaConnect": true,
- "_id": "string",
- "timestamp": "string",
- "archived": true
}
]{- "name": "string",
- "address": "string",
- "postalCode": "string",
- "city": "string",
- "phone": "string",
- "fax": "string",
- "email": "string",
- "website": "string",
- "albertaConnect": true,
- "_id": "string",
- "timestamp": "string",
- "archived": true
}| _id | string |
| updatedAfter | string <date-time> Example: updatedAfter=2025-01-01T00:00:00.000Z |
[- {
- "name": "string",
- "address": "string",
- "postalCode": "string",
- "city": "string",
- "phone": "string",
- "fax": "string",
- "email": "string",
- "website": "string",
- "albertaConnect": true,
- "_id": "string",
- "timestamp": "string",
- "archived": true
}
]| id required | string UUID des Kostenträgers. |
{- "type": 0,
- "name": "string",
- "phone": "string",
- "email": "string",
- "fax": "string",
- "website": "string",
- "ikNumber": "string",
- "address": "string",
- "postalCode": "string",
- "city": "string",
- "_id": "string",
- "timestamp": "string",
- "archived": true
}Listet Kostenträger auf, gefiltert nach _id oder updatedAfter.
| _id | string |
| updatedAfter | string <date-time> Example: updatedAfter=2025-01-01T00:00:00.000Z |
[- {
- "type": 0,
- "name": "string",
- "phone": "string",
- "email": "string",
- "fax": "string",
- "website": "string",
- "ikNumber": "string",
- "address": "string",
- "postalCode": "string",
- "city": "string",
- "_id": "string",
- "timestamp": "string",
- "archived": true
}
]Listet Postleitzahlen auf, gefiltert nach _id, updatedAfter oder postalCode.
| _id | string |
| updatedAfter | string <date-time> Example: updatedAfter=2025-01-01T00:00:00.000Z |
| postalCode | string Example: postalCode=12345 |
[- {
- "postalCode": "string",
- "city": "string",
- "_id": "string",
- "timestamp": "string",
- "archived": true
}
]{- "name": "string",
- "address": "string",
- "postalCode": "string",
- "city": "string",
- "phone": "string",
- "fax": "string",
- "email": "string",
- "website": "string",
- "albertaConnect": true,
- "_id": "string",
- "timestamp": "string",
- "archived": true
}| _id | string |
| updatedAfter | string <date-time> Example: updatedAfter=2025-01-01T00:00:00.000Z |
[- {
- "name": "string",
- "address": "string",
- "postalCode": "string",
- "city": "string",
- "phone": "string",
- "fax": "string",
- "email": "string",
- "website": "string",
- "albertaConnect": true,
- "_id": "string",
- "timestamp": "string",
- "archived": true
}
]Ruft eine einzelne Region anhand ihrer ID ab.
In der Antwort werden u.a. postalCodes sowie Audit-Felder entfernt.
| id required | string Example: 550e8400-e29b-41d4-a716-446655440000 Die UUID der Region (Alberta |
{- "label": "string",
- "parent": "string",
- "doNotChange": true,
- "_id": "string",
- "timestamp": "string",
- "archived": true
}Listet alle Regionen auf.
Regionen dienen der geografischen Strukturierung im Alberta Homecare-System. Sie steuern u.a. Sichtbarkeit und Synchronisation von Entitäten.
In der Antwort werden u.a. postalCodes sowie Audit-Felder entfernt.
[- {
- "label": "string",
- "parent": "string",
- "doNotChange": true,
- "_id": "string",
- "timestamp": "string",
- "archived": true
}
]Ruft einen einzelnen Benutzer anhand seiner ID ab.
Der Zugriff ist auf Benutzer der Organisation eingeschränkt, die zur API-Key Authentifizierung gehört. Sensible Felder werden serverseitig entfernt.
| id required | string Example: 550e8400-e29b-41d4-a716-446655440000 Die UUID des Benutzers (Alberta |
{- "active": true,
- "salesPersonId": "string",
- "name": "string",
- "department": "string",
- "firstName": "string",
- "lastName": "string",
- "address": "string",
- "postalCodeId": "string",
- "postalCode": "string",
- "city": "string",
- "phone": "string",
- "mobilePhone": "string",
- "email": "string",
- "fax": "string",
- "_id": "string",
- "timestamp": "string",
- "archived": true
}Listet Benutzer der Organisation auf, die zur API-Key Authentifizierung gehört.
updatedAfter ist Pflicht und wird zur inkrementellen Synchronisation verwendet.
status=active: Nicht archivierte Benutzerstatus=archived: Archivierte BenutzerSensible Felder werden serverseitig entfernt.
| status required | string Enum: "active" "archived" Example: status=active Filtert Benutzer nach Archivierungsstatus. |
| updatedAfter required | string <date-time> Example: updatedAfter=2025-05-14T04:25:35.000Z ISO 8601 Zeitstempel (z.B. |
[- {
- "active": true,
- "salesPersonId": "string",
- "name": "string",
- "department": "string",
- "firstName": "string",
- "lastName": "string",
- "address": "string",
- "postalCodeId": "string",
- "postalCode": "string",
- "city": "string",
- "phone": "string",
- "mobilePhone": "string",
- "email": "string",
- "fax": "string",
- "_id": "string",
- "timestamp": "string",
- "archived": true
}
]Listet Anlagen (Dateien) auf, die seit einem bestimmten Zeitpunkt erstellt wurden.
Der Parameter createdAfter kann verwendet werden, um die Liste inkrementell zu laden.
In der Response werden einige technische Felder entfernt:
chunkSize, md5, length, timestampmetadata.uniqueId, metadata.patientApp, metadata.auditId, metadata.auditNodeIdmetadata.regionId, metadata.templateId, metadata.templateNodeIdZusätzlich werden bestimmte interne Attachment-Typen gefiltert (z.B. Swodoc-Bilder).
| createdAfter | string <date-time> Example: createdAfter=2025-05-14T04:25:35.000Z ISO 8601 Zeitstempel (z.B. |
[- {
- "_id": "string",
- "filename": "string",
- "uploadDate": "string",
- "contentType": "string",
- "authorizedKiwiInstitutions": [
- {
- "id": "string",
- "parentInstitutionId": "string",
- "institutionType": 0
}
], - "createdByKiwi": true,
- "metadata": {
- "type": 0,
- "patientId": "string",
- "therapyId": 0,
- "therapyTypeId": 0,
- "woundLocation": "string",
- "createdAt": "string",
- "createdBy": "string",
- "updatedAt": "string",
- "updatedBy": "string",
- "archived": true,
- "signoPadPublicKey": "string",
- "storageFilename": "string",
- "isLinkedToInstitutionDocument": true,
- "relatedEntity": "patient"
}
}
]Listet Dokumente (Audits) auf, die seit einem bestimmten Zeitpunkt erstellt wurden.
Der Parameter createdAfter ist Pflicht und filtert auf Dokumente mit einem
updatedAt größer als der angegebene Zeitstempel.
Der Service liefert eine reduzierte Dokumentliste (z.B. mit name, patientId).
Die name wird serverseitig aus dem zugehörigen Template-Titel abgeleitet.
| createdAfter required | string <date-time> Example: createdAfter=2025-05-14T04:25:35.000Z ISO 8601 Zeitstempel (z.B. |
[- {
- "_id": "string",
- "name": "string",
- "patientId": "string",
- "therapyId": 0,
- "therapyTypeId": 0,
- "archived": true,
- "createdBy": "string",
- "updatedBy": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]Ermittelt die interne Patienten-ID (_id) anhand einer externen Kundennummer (customerId).
Der Endpoint liefert ein kleines Mapping-Objekt (kein vollständiges Patient-Objekt).
| customerId required | string Example: K-1000001 Externe Kundennummer. |
{- "_id": "string",
- "customerId": "string",
- "updatedAt": "string"
}Listet Patient-Notizen.
Es ist entweder updatedAfter oder patientId erlaubt.
| updatedAfter | string <date-time> Example: updatedAfter=2025-05-14T04:25:35.000Z ISO-Zeitstempel. Wenn gesetzt, werden Notizen zurückgegeben, die nach diesem Zeitpunkt aktualisiert wurden. |
| patientId | string Example: patientId=550e8400-e29b-41d4-a716-446655440000 Patienten-ID ( |
[- {
- "noteText": "string",
- "patientId": "string",
- "regionId": "string",
- "createdAt": "string",
- "updatedAt": "string",
- "createdBy": "string",
- "updatedBy": "string",
- "edited": true,
- "status": 1,
- "_id": "string",
- "timestamp": "string",
- "archived": true
}
]Legt eine neue Patient-Notiz an.
Pflichtfelder sind noteText, status und patientId.
| noteText | string Text der Notiz. | ||||||||||||
| patientId | string ID des Patienten. | ||||||||||||
| regionId | string ID der Region. | ||||||||||||
| createdAt | string Erstellungszeitpunkt. | ||||||||||||
| updatedAt | string Zeitpunkt der letzten Bearbeitung. | ||||||||||||
| createdBy | string ID des Erstellers. | ||||||||||||
| updatedBy | string ID des letzten Bearbeiters. | ||||||||||||
| edited | boolean Gibt an, ob die Notiz bearbeitet wurde. | ||||||||||||
| status | number (NoteType) Enum: 1 2 3 Typ einer Notiz. Definiert die verschiedenen Arten von Patientennotizen. Steuert, wie die Notiz im Patientenüberblick angezeigt wird.
| ||||||||||||
| _id | string Eindeutige ID der Entität (UUID v4 als String). Wird beim Erstellen automatisch generiert. | ||||||||||||
| timestamp | string Zeitstempel der letzten Änderung. Wird bei jeder Änderung automatisch aktualisiert. | ||||||||||||
| archived | boolean Markiert die Entität als archiviert (Soft-Delete). Archivierte Entitäten werden nicht physisch gelöscht, sondern nur als archiviert markiert. Sie erscheinen nicht mehr in Standard-Abfragen. |
{- "noteText": "string",
- "patientId": "string",
- "regionId": "string",
- "createdAt": "string",
- "updatedAt": "string",
- "createdBy": "string",
- "updatedBy": "string",
- "edited": true,
- "status": 1,
- "_id": "string",
- "timestamp": "string",
- "archived": true
}{- "noteText": "string",
- "patientId": "string",
- "regionId": "string",
- "createdAt": "string",
- "updatedAt": "string",
- "createdBy": "string",
- "updatedBy": "string",
- "edited": true,
- "status": 1,
- "_id": "string",
- "timestamp": "string",
- "archived": true
}Aktualisiert eine bestehende Patient-Notiz.
Hinweis: Query-Parameter sind bei diesem Endpoint nicht erlaubt.
| id required | string Example: 550e8400-e29b-41d4-a716-446655440000 ID der Patient-Notiz ( |
| noteText | string Text der Notiz. | ||||||||||||
| patientId | string ID des Patienten. | ||||||||||||
| regionId | string ID der Region. | ||||||||||||
| createdAt | string Erstellungszeitpunkt. | ||||||||||||
| updatedAt | string Zeitpunkt der letzten Bearbeitung. | ||||||||||||
| createdBy | string ID des Erstellers. | ||||||||||||
| updatedBy | string ID des letzten Bearbeiters. | ||||||||||||
| edited | boolean Gibt an, ob die Notiz bearbeitet wurde. | ||||||||||||
| status | number (NoteType) Enum: 1 2 3 Typ einer Notiz. Definiert die verschiedenen Arten von Patientennotizen. Steuert, wie die Notiz im Patientenüberblick angezeigt wird.
| ||||||||||||
| _id | string Eindeutige ID der Entität (UUID v4 als String). Wird beim Erstellen automatisch generiert. | ||||||||||||
| timestamp | string Zeitstempel der letzten Änderung. Wird bei jeder Änderung automatisch aktualisiert. | ||||||||||||
| archived | boolean Markiert die Entität als archiviert (Soft-Delete). Archivierte Entitäten werden nicht physisch gelöscht, sondern nur als archiviert markiert. Sie erscheinen nicht mehr in Standard-Abfragen. |
{- "noteText": "string",
- "patientId": "string",
- "regionId": "string",
- "createdAt": "string",
- "updatedAt": "string",
- "createdBy": "string",
- "updatedBy": "string",
- "edited": true,
- "status": 1,
- "_id": "string",
- "timestamp": "string",
- "archived": true
}{- "noteText": "string",
- "patientId": "string",
- "regionId": "string",
- "createdAt": "string",
- "updatedAt": "string",
- "createdBy": "string",
- "updatedBy": "string",
- "edited": true,
- "status": 1,
- "_id": "string",
- "timestamp": "string",
- "archived": true
}Ruft Patienten für Synchronisationszwecke ab.
Die Parameter status und updatedAfter sind Pflichtparameter.
In der Response werden einige interne Felder entfernt:
therapies, diagnosespostalCodeId (auch in careGivers)primaryDoctor, nursingHome, nursingService, pharmacyhospital.subunitId, hospital.contactIdZusätzlich werden diese Felder angereichert:
primaryDoctorInstitutionzec| status required | string Enum: "created" "updated" "archived" Example: status=updated Filtert nach Änderungsstatus:
|
| updatedAfter required | string <date-time> Example: updatedAfter=2025-05-14T04:25:35.000Z ISO 8601 Zeitstempel (z.B. |
[- {
- "city": "string",
- "postalCode": "string",
- "additionalAddress": "string",
- "additionalAddress2": "string",
- "gender": 0,
- "title": 0,
- "customerId": "string",
- "birthday": "string",
- "fieldNurseId": "string",
- "regionId": "string",
- "payerInstitutionCode": "string",
- "primaryDoctorId": "string",
- "nursingHomeId": "string",
- "nursingServiceId": "string",
- "deactivationReason": 0,
- "deactivationDate": "string",
- "deactivationComment": "string",
- "nextVisit": "string",
- "ivTherapy": true,
- "classification": "string",
- "pharmacyId": "string",
- "changeInSupplier": true,
- "billingAddress": {
- "gender": 0,
- "title": 0,
- "name": "string",
- "address": "string",
- "additionalAddress": "string",
- "additionalAddress2": "string",
- "postalCodeId": "string",
- "postalCode": "string",
- "city": "string",
- "account": "string"
}, - "deliveryAddress": {
- "gender": 0,
- "title": 0,
- "name": "string",
- "address": "string",
- "additionalAddress": "string",
- "additionalAddress2": "string",
- "postalCodeId": "string",
- "postalCode": "string",
- "city": "string"
}, - "comment": "string",
- "erpStatus": "Liefersperre",
- "deliveryInformation": {
- "startTime": "string",
- "deliveryInformation": "string",
- "deliveryNote": "string",
- "deliveryOption": "string"
}, - "additionalUserId": "string",
- "additionalUserIds": [
- "string"
], - "careDegree": 1,
- "calorieDemand": 0,
- "dashboardInfo": [
- "string"
], - "status": "string",
- "additionalAttributes": { },
- "calendarResourceId": "string",
- "referrer": {
- "type": 1,
- "id": "string",
- "description": "string"
}, - "specializedServiceProviderBranchId": "string",
- "firstName": "string",
- "lastName": "string",
- "address": "string",
- "phone": "string",
- "mobilePhone": "string",
- "email": "string",
- "fax": "string",
- "_id": "string",
- "timestamp": "string",
- "archived": true,
- "createdAt": "string",
- "createdBy": "string",
- "updatedAt": "string",
- "updatedBy": "string",
- "payer": {
- "payerId": "string",
- "otherPayer": "string",
- "payerType": 0,
- "numberOfInsured": "string",
- "hasCopayment": true,
- "copaymentFromDate": "string",
- "copaymentToDate": "string",
- "copaymentRequestedAt": "string",
- "copaymentRequestedBy": "string",
- "noCopaymentPhoto": true,
- "hasNoEGKImage": true,
- "hasNoCopaymentImage": true,
- "additionalInfo": "string",
- "_id": "string",
- "timestamp": "string",
- "archived": true
}, - "hospital": {
- "hospitalId": "string",
- "dischargeDate": "string",
- "surgeryDate": "string",
- "_id": "string",
- "timestamp": "string",
- "archived": true
}, - "primaryDoctor": {
- "contactId": "string",
- "_id": "string",
- "timestamp": "string",
- "archived": true
}, - "nursingHome": {
- "subunitId": "string",
- "contactId": "string",
- "_id": "string",
- "timestamp": "string",
- "archived": true
}, - "nursingService": {
- "subunitId": "string",
- "contactId": "string",
- "_id": "string",
- "timestamp": "string",
- "archived": true
}, - "pharmacy": {
- "subunitId": "string",
- "contactId": "string",
- "_id": "string",
- "timestamp": "string",
- "archived": true
}, - "careGivers": [
- {
- "gender": 0,
- "title": 0,
- "type": 0,
- "role": "string",
- "customerId": "string",
- "comment": "string",
- "firstName": "string",
- "lastName": "string",
- "address": "string",
- "postalCode": "string",
- "city": "string",
- "phone": "string",
- "mobilePhone": "string",
- "email": "string",
- "fax": "string",
- "_id": "string",
- "timestamp": "string",
- "archived": true
}
], - "primaryDoctorInstitution": {
- "institutionId": "string",
- "description": "string",
- "type": "string"
}, - "zec": "string"
}
]Ruft einen Patienten anhand seiner ID ab.
In der Response werden einige interne Felder entfernt und einige Felder angereichert.
Details siehe GET /patient.
| id required | string Example: 2c0a1b2a-3e17-4f09-9c2a-1f9f3b0c2a11 ID des Patienten ( |
{- "city": "string",
- "postalCode": "string",
- "additionalAddress": "string",
- "additionalAddress2": "string",
- "gender": 0,
- "title": 0,
- "customerId": "string",
- "birthday": "string",
- "fieldNurseId": "string",
- "regionId": "string",
- "payerInstitutionCode": "string",
- "primaryDoctorId": "string",
- "nursingHomeId": "string",
- "nursingServiceId": "string",
- "deactivationReason": 0,
- "deactivationDate": "string",
- "deactivationComment": "string",
- "nextVisit": "string",
- "ivTherapy": true,
- "classification": "string",
- "pharmacyId": "string",
- "changeInSupplier": true,
- "billingAddress": {
- "gender": 0,
- "title": 0,
- "name": "string",
- "address": "string",
- "additionalAddress": "string",
- "additionalAddress2": "string",
- "postalCodeId": "string",
- "postalCode": "string",
- "city": "string",
- "account": "string"
}, - "deliveryAddress": {
- "gender": 0,
- "title": 0,
- "name": "string",
- "address": "string",
- "additionalAddress": "string",
- "additionalAddress2": "string",
- "postalCodeId": "string",
- "postalCode": "string",
- "city": "string"
}, - "comment": "string",
- "erpStatus": "Liefersperre",
- "deliveryInformation": {
- "startTime": "string",
- "deliveryInformation": "string",
- "deliveryNote": "string",
- "deliveryOption": "string"
}, - "additionalUserId": "string",
- "additionalUserIds": [
- "string"
], - "careDegree": 1,
- "calorieDemand": 0,
- "dashboardInfo": [
- "string"
], - "status": "string",
- "additionalAttributes": { },
- "calendarResourceId": "string",
- "referrer": {
- "type": 1,
- "id": "string",
- "description": "string"
}, - "specializedServiceProviderBranchId": "string",
- "firstName": "string",
- "lastName": "string",
- "address": "string",
- "phone": "string",
- "mobilePhone": "string",
- "email": "string",
- "fax": "string",
- "_id": "string",
- "timestamp": "string",
- "archived": true,
- "createdAt": "string",
- "createdBy": "string",
- "updatedAt": "string",
- "updatedBy": "string",
- "payer": {
- "payerId": "string",
- "otherPayer": "string",
- "payerType": 0,
- "numberOfInsured": "string",
- "hasCopayment": true,
- "copaymentFromDate": "string",
- "copaymentToDate": "string",
- "copaymentRequestedAt": "string",
- "copaymentRequestedBy": "string",
- "noCopaymentPhoto": true,
- "hasNoEGKImage": true,
- "hasNoCopaymentImage": true,
- "additionalInfo": "string",
- "_id": "string",
- "timestamp": "string",
- "archived": true
}, - "hospital": {
- "hospitalId": "string",
- "dischargeDate": "string",
- "surgeryDate": "string",
- "_id": "string",
- "timestamp": "string",
- "archived": true
}, - "primaryDoctor": {
- "contactId": "string",
- "_id": "string",
- "timestamp": "string",
- "archived": true
}, - "nursingHome": {
- "subunitId": "string",
- "contactId": "string",
- "_id": "string",
- "timestamp": "string",
- "archived": true
}, - "nursingService": {
- "subunitId": "string",
- "contactId": "string",
- "_id": "string",
- "timestamp": "string",
- "archived": true
}, - "pharmacy": {
- "subunitId": "string",
- "contactId": "string",
- "_id": "string",
- "timestamp": "string",
- "archived": true
}, - "careGivers": [
- {
- "gender": 0,
- "title": 0,
- "type": 0,
- "role": "string",
- "customerId": "string",
- "comment": "string",
- "firstName": "string",
- "lastName": "string",
- "address": "string",
- "postalCode": "string",
- "city": "string",
- "phone": "string",
- "mobilePhone": "string",
- "email": "string",
- "fax": "string",
- "_id": "string",
- "timestamp": "string",
- "archived": true
}
], - "primaryDoctorInstitution": {
- "institutionId": "string",
- "description": "string",
- "type": "string"
}, - "zec": "string"
}Ruft Direktbestellungen (IDirectOrder) für Synchronisationszwecke ab.
Die Parameter status und updatedAfter sind Pflichtparameter.
In der Response werden therapyId und therapyTypeId durch einen Hook in Enum-Werte umgewandelt.
Dadurch können diese Felder als string (Enum-Name) zurückgegeben werden.
| status required | string Enum: "created" "transmitted" "updated" "archived" Example: status=updated Filtert nach Änderungsstatus:
|
| updatedAfter required | string <date-time> Example: updatedAfter=2025-05-14T04:25:35.000Z ISO 8601 Zeitstempel (z.B. |
[- {
- "regionId": "string",
- "salesId": "string",
- "patientId": "string",
- "creationDate": "string",
- "deliveryDate": "string",
- "deliveryAddress": {
- "gender": 0,
- "title": 0,
- "name": "string",
- "address": "string",
- "additionalAddress": "string",
- "additionalAddress2": "string",
- "postalCodeId": "string",
- "postalCode": "string",
- "city": "string"
}, - "deliveryInformation": "string",
- "status": -3,
- "annotation": "string",
- "orderType": 0,
- "transmittedAt": "string",
- "deliveryOption": "string",
- "_id": "string",
- "timestamp": "string",
- "archived": true,
- "createdAt": "string",
- "createdBy": "string",
- "updatedAt": "string",
- "updatedBy": "string",
- "orderedArticleLines": [
- {
- "_id": "string",
- "articleId": "string",
- "articleCustomerNumber": "string",
- "packagingUnitId": "string",
- "unit": "string",
- "quantity": 0,
- "deliveredQuantity": 0,
- "price": "string",
- "attributes": { },
- "timestamp": "string",
- "archived": true
}
], - "therapyId": 0,
- "therapyTypeId": 0
}
]Aktualisiert eine bestehende Direktbestellung via PATCH.
Beim Aufruf von PATCH sind keine Query-Parameter erlaubt.
| id required | string Example: 2c0a1b2a-3e17-4f09-9c2a-1f9f3b0c2a11 ID der Direktbestellung ( |
| regionId | string ID der Region, der der Auftrag zugeordnet ist. | |||||||||||||||||||||||||||||||||||||||||||||
| salesId | string Id des Auftrag im ERP-System des Kunden | |||||||||||||||||||||||||||||||||||||||||||||
| patientId | string ID des Patienten, für den der Auftrag erstellt wurde. | |||||||||||||||||||||||||||||||||||||||||||||
| creationDate | string Erstellungsdatum des Auftrags. | |||||||||||||||||||||||||||||||||||||||||||||
| deliveryDate | string Geplantes Lieferdatum. | |||||||||||||||||||||||||||||||||||||||||||||
object (IDeliveryAddress) Lieferadresse. Erweitert {@link IAddress } für Lieferadressen bei Bestellungen. | ||||||||||||||||||||||||||||||||||||||||||||||
| deliveryInformation | string Zusätzliche Lieferinformationen. | |||||||||||||||||||||||||||||||||||||||||||||
| status | number (OrderStatus) Enum: -3 -2 -1 0 1 2 3 4 5 6 7 8 9 10 Status einer Bestellung. Definiert den Lebenszyklus einer Bestellung von der Erstellung bis zur Lieferung. Nicht alle Statusänderungen sind erlaubt.
Erlaubte Statusübergänge: | Von Status | Erlaubte Zielstatus | |------------|---------------------| |
| |||||||||||||||||||||||||||||||||||||||||||||
| annotation | string Anmerkungen zum Auftrag. | |||||||||||||||||||||||||||||||||||||||||||||
| orderType | number (OrderType) Enum: 0 1 2 Typ einer Bestellung. Unterscheidet zwischen Erst-, Folge- und Mitarbeiterbestellungen.
| |||||||||||||||||||||||||||||||||||||||||||||
| transmittedAt | string Zeitpunkt der Verarbeitung durch das Backend. ISO-String-Datum, wann der Auftrag vom Order-Backend verarbeitet wurde. | |||||||||||||||||||||||||||||||||||||||||||||
| deliveryOption | string | |||||||||||||||||||||||||||||||||||||||||||||
| _id | string Eindeutige ID der Entität (UUID v4 als String). Wird beim Erstellen automatisch generiert. | |||||||||||||||||||||||||||||||||||||||||||||
| timestamp | string Zeitstempel der letzten Änderung. Wird bei jeder Änderung automatisch aktualisiert. | |||||||||||||||||||||||||||||||||||||||||||||
| archived | boolean Markiert die Entität als archiviert (Soft-Delete). Archivierte Entitäten werden nicht physisch gelöscht, sondern nur als archiviert markiert. Sie erscheinen nicht mehr in Standard-Abfragen. | |||||||||||||||||||||||||||||||||||||||||||||
| createdAt | string Zeitpunkt der Erstellung. Wird beim Erstellen der Entität automatisch gesetzt. | |||||||||||||||||||||||||||||||||||||||||||||
| createdBy | string ID des Benutzers, der die Entität erstellt hat. Referenziert einen Benutzer im System. | |||||||||||||||||||||||||||||||||||||||||||||
| updatedAt | string Zeitpunkt der letzten Änderung. Wird bei jeder Änderung automatisch aktualisiert. | |||||||||||||||||||||||||||||||||||||||||||||
| updatedBy | string ID des Benutzers, der die letzte Änderung vorgenommen hat. Referenziert einen Benutzer im System. | |||||||||||||||||||||||||||||||||||||||||||||
Array of objects (IDirectOrderedArticleLineExternal) | ||||||||||||||||||||||||||||||||||||||||||||||
| therapyId | number or string | |||||||||||||||||||||||||||||||||||||||||||||
| therapyTypeId | number or string |
{- "regionId": "string",
- "salesId": "string",
- "patientId": "string",
- "creationDate": "string",
- "deliveryDate": "string",
- "deliveryAddress": {
- "gender": 0,
- "title": 0,
- "name": "string",
- "address": "string",
- "additionalAddress": "string",
- "additionalAddress2": "string",
- "postalCodeId": "string",
- "postalCode": "string",
- "city": "string"
}, - "deliveryInformation": "string",
- "status": -3,
- "annotation": "string",
- "orderType": 0,
- "transmittedAt": "string",
- "deliveryOption": "string",
- "_id": "string",
- "timestamp": "string",
- "archived": true,
- "createdAt": "string",
- "createdBy": "string",
- "updatedAt": "string",
- "updatedBy": "string",
- "orderedArticleLines": [
- {
- "_id": "string",
- "articleId": "string",
- "articleCustomerNumber": "string",
- "packagingUnitId": "string",
- "unit": "string",
- "quantity": 0,
- "deliveredQuantity": 0,
- "price": "string",
- "attributes": { },
- "timestamp": "string",
- "archived": true
}
], - "therapyId": 0,
- "therapyTypeId": 0
}{- "regionId": "string",
- "salesId": "string",
- "patientId": "string",
- "creationDate": "string",
- "deliveryDate": "string",
- "deliveryAddress": {
- "gender": 0,
- "title": 0,
- "name": "string",
- "address": "string",
- "additionalAddress": "string",
- "additionalAddress2": "string",
- "postalCodeId": "string",
- "postalCode": "string",
- "city": "string"
}, - "deliveryInformation": "string",
- "status": -3,
- "annotation": "string",
- "orderType": 0,
- "transmittedAt": "string",
- "deliveryOption": "string",
- "_id": "string",
- "timestamp": "string",
- "archived": true,
- "createdAt": "string",
- "createdBy": "string",
- "updatedAt": "string",
- "updatedBy": "string",
- "orderedArticleLines": [
- {
- "_id": "string",
- "articleId": "string",
- "articleCustomerNumber": "string",
- "packagingUnitId": "string",
- "unit": "string",
- "quantity": 0,
- "deliveredQuantity": 0,
- "price": "string",
- "attributes": { },
- "timestamp": "string",
- "archived": true
}
], - "therapyId": 0,
- "therapyTypeId": 0
}Listet ERP-Aufträge basierend auf Query-Parametern.
Hinweis: Das Feld therapyId wird serverseitig ggf. in eine Zahl konvertiert.
| salesId | string Example: salesId=ERP-123456 Optionaler Filter nach |
[- {
- "therapyId": 0,
- "patientId": "string",
- "regionId": "string",
- "salesId": "string",
- "deliveryAddress": {
- "gender": 0,
- "title": 0,
- "name": "string",
- "address": "string",
- "additionalAddress": "string",
- "additionalAddress2": "string",
- "postalCodeId": "string",
- "postalCode": "string",
- "city": "string"
}, - "outboundDate": "string",
- "erpOrderedArticleLines": [
- {
- "articleId": "string",
- "articleDescription": "string",
- "articleAdditionalDescription": "string",
- "quantity": 0,
- "unit": "string",
- "deliveredQuantity": 0,
- "orderNumber": "string",
- "therapyId": 0,
- "integratedCareId": "string",
- "salesLineCaseId": "string",
- "salesLinePeriodCaseId": "string",
- "salesLinePeriod": "string",
- "serialNumber": "string",
- "batchNumber": "string",
- "archived": true
}
], - "annotation": "string",
- "prescriptionStatus": "string",
- "completed": true,
- "trackingLink": "string",
- "trackingInfo": [
- {
- "trackingLink": "string",
- "trackingCode": "string"
}
], - "_id": "string",
- "timestamp": "string",
- "archived": true
}
]Legt einen neuen ERP-Auftrag an.
Hinweis: Query-Parameter sind bei diesem Endpoint nicht erlaubt.
| therapyId required | number or string |
| patientId required | string ID des Patienten. |
| regionId required | string ID der Region. |
| salesId required | string Id des Auftrag im ERP-System des Kunden |
required | object (IDeliveryAddress) Lieferadresse. Erweitert {@link IAddress } für Lieferadressen bei Bestellungen. |
| outboundDate required | string Versanddatum. |
required | Array of objects (IErpOrderedArticleLine) Bestellte Artikelzeilen. |
| annotation required | string Anmerkung. |
| prescriptionStatus required | string Rezeptstatus. |
| completed required | boolean Gibt an, ob die Bestellung abgeschlossen ist. |
| trackingLink required | string Link zur Sendungsverfolgung. |
required | Array of objects (ITrackingInfo) Tracking-Informationen. |
| _id required | string Eindeutige ID der Entität (UUID v4 als String). Wird beim Erstellen automatisch generiert. |
| timestamp required | string Zeitstempel der letzten Änderung. Wird bei jeder Änderung automatisch aktualisiert. |
| archived required | boolean Markiert die Entität als archiviert (Soft-Delete). Archivierte Entitäten werden nicht physisch gelöscht, sondern nur als archiviert markiert. Sie erscheinen nicht mehr in Standard-Abfragen. |
{- "therapyId": 0,
- "patientId": "string",
- "regionId": "string",
- "salesId": "string",
- "deliveryAddress": {
- "gender": 0,
- "title": 0,
- "name": "string",
- "address": "string",
- "additionalAddress": "string",
- "additionalAddress2": "string",
- "postalCodeId": "string",
- "postalCode": "string",
- "city": "string"
}, - "outboundDate": "string",
- "erpOrderedArticleLines": [
- {
- "articleId": "string",
- "articleDescription": "string",
- "articleAdditionalDescription": "string",
- "quantity": 0,
- "unit": "string",
- "deliveredQuantity": 0,
- "orderNumber": "string",
- "therapyId": 0,
- "integratedCareId": "string",
- "salesLineCaseId": "string",
- "salesLinePeriodCaseId": "string",
- "salesLinePeriod": "string",
- "serialNumber": "string",
- "batchNumber": "string",
- "archived": true
}
], - "annotation": "string",
- "prescriptionStatus": "string",
- "completed": true,
- "trackingLink": "string",
- "trackingInfo": [
- {
- "trackingLink": "string",
- "trackingCode": "string"
}
], - "_id": "string",
- "timestamp": "string",
- "archived": true
}{- "therapyId": 0,
- "patientId": "string",
- "regionId": "string",
- "salesId": "string",
- "deliveryAddress": {
- "gender": 0,
- "title": 0,
- "name": "string",
- "address": "string",
- "additionalAddress": "string",
- "additionalAddress2": "string",
- "postalCodeId": "string",
- "postalCode": "string",
- "city": "string"
}, - "outboundDate": "string",
- "erpOrderedArticleLines": [
- {
- "articleId": "string",
- "articleDescription": "string",
- "articleAdditionalDescription": "string",
- "quantity": 0,
- "unit": "string",
- "deliveredQuantity": 0,
- "orderNumber": "string",
- "therapyId": 0,
- "integratedCareId": "string",
- "salesLineCaseId": "string",
- "salesLinePeriodCaseId": "string",
- "salesLinePeriod": "string",
- "serialNumber": "string",
- "batchNumber": "string",
- "archived": true
}
], - "annotation": "string",
- "prescriptionStatus": "string",
- "completed": true,
- "trackingLink": "string",
- "trackingInfo": [
- {
- "trackingLink": "string",
- "trackingCode": "string"
}
], - "_id": "string",
- "timestamp": "string",
- "archived": true
}Aktualisiert einen bestehenden ERP-Auftrag.
Als id wird die salesId verwendet. Intern wird dann die passende _id ermittelt.
| id required | string Example: ERP-123456 salesId des ERP-Auftrags. |
| therapyId required | number or string |
| patientId required | string ID des Patienten. |
| regionId required | string ID der Region. |
| salesId required | string Id des Auftrag im ERP-System des Kunden |
required | object (IDeliveryAddress) Lieferadresse. Erweitert {@link IAddress } für Lieferadressen bei Bestellungen. |
| outboundDate required | string Versanddatum. |
required | Array of objects (IErpOrderedArticleLine) Bestellte Artikelzeilen. |
| annotation required | string Anmerkung. |
| prescriptionStatus required | string Rezeptstatus. |
| completed required | boolean Gibt an, ob die Bestellung abgeschlossen ist. |
| trackingLink required | string Link zur Sendungsverfolgung. |
required | Array of objects (ITrackingInfo) Tracking-Informationen. |
| _id required | string Eindeutige ID der Entität (UUID v4 als String). Wird beim Erstellen automatisch generiert. |
| timestamp required | string Zeitstempel der letzten Änderung. Wird bei jeder Änderung automatisch aktualisiert. |
| archived required | boolean Markiert die Entität als archiviert (Soft-Delete). Archivierte Entitäten werden nicht physisch gelöscht, sondern nur als archiviert markiert. Sie erscheinen nicht mehr in Standard-Abfragen. |
{- "therapyId": 0,
- "patientId": "string",
- "regionId": "string",
- "salesId": "string",
- "deliveryAddress": {
- "gender": 0,
- "title": 0,
- "name": "string",
- "address": "string",
- "additionalAddress": "string",
- "additionalAddress2": "string",
- "postalCodeId": "string",
- "postalCode": "string",
- "city": "string"
}, - "outboundDate": "string",
- "erpOrderedArticleLines": [
- {
- "articleId": "string",
- "articleDescription": "string",
- "articleAdditionalDescription": "string",
- "quantity": 0,
- "unit": "string",
- "deliveredQuantity": 0,
- "orderNumber": "string",
- "therapyId": 0,
- "integratedCareId": "string",
- "salesLineCaseId": "string",
- "salesLinePeriodCaseId": "string",
- "salesLinePeriod": "string",
- "serialNumber": "string",
- "batchNumber": "string",
- "archived": true
}
], - "annotation": "string",
- "prescriptionStatus": "string",
- "completed": true,
- "trackingLink": "string",
- "trackingInfo": [
- {
- "trackingLink": "string",
- "trackingCode": "string"
}
], - "_id": "string",
- "timestamp": "string",
- "archived": true
}{- "therapyId": 0,
- "patientId": "string",
- "regionId": "string",
- "salesId": "string",
- "deliveryAddress": {
- "gender": 0,
- "title": 0,
- "name": "string",
- "address": "string",
- "additionalAddress": "string",
- "additionalAddress2": "string",
- "postalCodeId": "string",
- "postalCode": "string",
- "city": "string"
}, - "outboundDate": "string",
- "erpOrderedArticleLines": [
- {
- "articleId": "string",
- "articleDescription": "string",
- "articleAdditionalDescription": "string",
- "quantity": 0,
- "unit": "string",
- "deliveredQuantity": 0,
- "orderNumber": "string",
- "therapyId": 0,
- "integratedCareId": "string",
- "salesLineCaseId": "string",
- "salesLinePeriodCaseId": "string",
- "salesLinePeriod": "string",
- "serialNumber": "string",
- "batchNumber": "string",
- "archived": true
}
], - "annotation": "string",
- "prescriptionStatus": "string",
- "completed": true,
- "trackingLink": "string",
- "trackingInfo": [
- {
- "trackingLink": "string",
- "trackingCode": "string"
}
], - "_id": "string",
- "timestamp": "string",
- "archived": true
}Ruft Versorgungen (IIntegratedCare) für Synchronisationszwecke ab.
Die Parameter status und updatedAfter sind Pflichtparameter.
In der Response werden therapyId und therapyTypeId durch einen Hook in Enum-Werte umgewandelt.
Dadurch können diese Felder als string (Enum-Name) zurückgegeben werden.
| status required | string Enum: "created" "transmitted" "deactivated" "archived" Example: status=transmitted Filtert nach Änderungsstatus:
|
| updatedAfter required | string <date-time> Example: updatedAfter=2025-05-14T04:25:35.000Z ISO 8601 Zeitstempel (z.B. |
[- {
- "salesId": "string",
- "patientId": "string",
- "location": 0,
- "additionalLocations": [
- "string"
], - "doctorId": "string",
- "pharmacyId": "string",
- "isInitialCare": true,
- "isMonthlyOrderActivated": true,
- "standardCareProposalId": "string",
- "annotation": "string",
- "seriesStatus": -3,
- "aboStopped": true,
- "startDate": "string",
- "status": 1,
- "deactivationReason": "string",
- "regionId": "string",
- "permanentExceedMaxAmount": true,
- "diagnose": "string",
- "stomaCreationDate": "string",
- "_id": "string",
- "timestamp": "string",
- "archived": true,
- "createdAt": "string",
- "createdBy": "string",
- "updatedAt": "string",
- "updatedBy": "string",
- "therapyId": 0,
- "therapyTypeId": 0,
- "seriesData": [
- {
- "salesIdSeriesData": "string",
- "nextDeliveryDate": "string",
- "dayOfDelivery": 0,
- "deliveryAddress": {
- "gender": 0,
- "title": 0,
- "name": "string",
- "address": "string",
- "additionalAddress": "string",
- "additionalAddress2": "string",
- "postalCodeId": "string",
- "postalCode": "string",
- "city": "string"
}, - "deliveryInformation": "string",
- "deliveryNote": "string",
- "deliveryStartTime": "string",
- "deliveryOption": "string",
- "_id": "string",
- "timestamp": "string",
- "archived": true
}
], - "proposedArticleLines": [
- {
- "salesLineId": "string",
- "therapyProductGroupId": "string",
- "contractId": "string",
- "articleId": "string",
- "articleCustomerNumber": "string",
- "isPrivateSale": true,
- "bookingCode": "string",
- "serialNumber": "string",
- "annotation": "string",
- "periodStartDate": "string",
- "periodEndDate": "string",
- "salesLineCaseId": "string",
- "salesLinePeriodCaseId": "string",
- "customerContractId": "string",
- "customerContractVersion": "string",
- "attributes": [
- {
- "attributeTemplateId": "string",
- "name": "string",
- "dataType": 0,
- "value": 0
}
], - "dosage": {
- "packagingId": "string",
- "quantity": 0,
- "duration": {
- "amount": 30,
- "timePeriod": 0
}
}, - "notAutomaticDelivery": true,
- "_id": "string",
- "timestamp": "string",
- "archived": true
}
], - "proposedServiceLines": [
- {
- "serviceId": "string",
- "contractId": "string",
- "annotation": "string",
- "visitStartTime": "string",
- "selectedVisitDays": [
- "Monday"
], - "automaticAppointmentCreation": true,
- "_id": "string",
- "timestamp": "string",
- "archived": true
}
], - "archivedArticleLines": [
- {
- "endDate": "string",
- "salesLineId": "string",
- "therapyProductGroupId": "string",
- "contractId": "string",
- "articleId": "string",
- "articleCustomerNumber": "string",
- "isPrivateSale": true,
- "bookingCode": "string",
- "serialNumber": "string",
- "annotation": "string",
- "periodStartDate": "string",
- "periodEndDate": "string",
- "salesLineCaseId": "string",
- "salesLinePeriodCaseId": "string",
- "customerContractId": "string",
- "customerContractVersion": "string",
- "attributes": [
- {
- "attributeTemplateId": "string",
- "name": "string",
- "dataType": 0,
- "value": 0
}
], - "dosage": {
- "packagingId": "string",
- "quantity": 0,
- "duration": {
- "amount": 30,
- "timePeriod": 0
}
}, - "notAutomaticDelivery": true,
- "_id": "string",
- "timestamp": "string",
- "archived": true
}
], - "history": [
- {
- "type": "nextDeliveryDate",
- "date": "string",
- "userId": "string",
- "userName": "string",
- "changeOperation": "REMOVE",
- "articleId": "string",
- "key": "string",
- "valueBefore": "string",
- "valueAfter": "string",
- "_id": "string",
- "timestamp": "string",
- "archived": true
}
], - "applicationPlan": {
- "lines": [
- {
- "articleId": "string",
- "articleName": "string"
}
]
}, - "calculations": { },
- "miscellaneous": {
- "desinfection": "string",
- "changeBandageintervall": "string",
- "thirtyDegreeUpperBodyPosition": true,
- "oralStimulation": true,
- "changeLiquidOnDemand": true,
- "replaceTube": {
- "button": true,
- "gastrotube": true,
- "description": "string",
- "date": "2019-08-24T14:15:22Z",
- "additionalInfo": "string"
}
}
}
]Ruft Bestellungen (ISingleOrder) für Synchronisationszwecke ab.
Die Parameter status und updatedAfter sind Pflichtparameter.
In der Response werden therapyId und therapyTypeId durch einen Hook in Enum-Werte umgewandelt.
Dadurch können diese Felder als string (Enum-Name) zurückgegeben werden.
| status required | string Enum: "created" "transmitted" "updated" "archived" Example: status=updated Filtert nach Änderungsstatus:
|
| updatedAfter required | string <date-time> Example: updatedAfter=2025-05-14T04:25:35.000Z ISO 8601 Zeitstempel (z.B. |
[- {
- "regionId": "string",
- "salesId": "string",
- "patientId": "string",
- "integratedCareId": "string",
- "creationDate": "string",
- "deliveryDate": "string",
- "deliveryOption": "string",
- "reminderDate": "string",
- "accountingMonth": [
- 0
], - "startDate": "string",
- "endDate": "string",
- "deliveryAddress": {
- "gender": 0,
- "title": 0,
- "name": "string",
- "address": "string",
- "additionalAddress": "string",
- "additionalAddress2": "string",
- "postalCodeId": "string",
- "postalCode": "string",
- "city": "string"
}, - "deliveryInformation": "string",
- "doctorId": "string",
- "pharmacyId": "string",
- "location": 0,
- "expressDelivery": true,
- "isInitialCare": true,
- "status": -3,
- "annotation": "string",
- "deliveryNote": "string",
- "deliveryStartTime": "string",
- "hospitalId": "string",
- "prescriptionStatus": "transmissionPending",
- "isHospitalPrescriber": true,
- "tags": [
- "string"
], - "groupOrderId": "string",
- "isGroupOrder": true,
- "orderNumber": "string",
- "attachments": [
- "string"
], - "erpOrderNumber": "string",
- "transmittedAt": "string",
- "hasFollowUpOrder": true,
- "auditIds": [
- "string"
], - "trackingInfo": [
- {
- "trackingLink": "string",
- "trackingCode": "string"
}
], - "_id": "string",
- "timestamp": "string",
- "archived": true,
- "createdAt": "string",
- "createdBy": "string",
- "updatedAt": "string",
- "updatedBy": "string",
- "orderedArticleLines": [
- {
- "_id": "string",
- "salesLineId": "string",
- "proposedArticleLineId": "string",
- "articleId": "string",
- "contractId": "string",
- "articleCustomerNumber": "string",
- "packagingUnitId": "string",
- "unit": "string",
- "quantity": 0,
- "deliveredQuantity": 0,
- "bookingCode": "string",
- "serialNumber": "string",
- "batchNumber": "string",
- "isPrivateSale": true,
- "groupOrderPosition": 0,
- "singleOrderId": "string",
- "timestamp": "string",
- "archived": true
}
], - "therapyId": 0,
- "therapyTypeId": 0
}
]Aktualisiert eine bestehende Bestellung via PATCH.
Beim Aufruf von PATCH sind keine Query-Parameter erlaubt.
| id required | string Example: 2c0a1b2a-3e17-4f09-9c2a-1f9f3b0c2a11 ID der Bestellung ( |
| regionId | string ID der Region, der der Auftrag zugeordnet ist. | |||||||||||||||||||||||||||||||||||||||||||||
| salesId | string Vorgangsnummer im ERP-System des Kunden | |||||||||||||||||||||||||||||||||||||||||||||
| patientId | string ID des Patienten, für den der Auftrag erstellt wurde. | |||||||||||||||||||||||||||||||||||||||||||||
| integratedCareId | string ID der zugehörigen IntegratedCare (Versorgung). Jede SingleOrder gehört zu einer IntegratedCare, die die gesamte Versorgungssituation des Patienten abbildet. | |||||||||||||||||||||||||||||||||||||||||||||
| creationDate | string Erstellungsdatum des Auftrags. | |||||||||||||||||||||||||||||||||||||||||||||
| deliveryDate | string Geplantes Lieferdatum. | |||||||||||||||||||||||||||||||||||||||||||||
| deliveryOption | string Lieferoption. | |||||||||||||||||||||||||||||||||||||||||||||
| reminderDate | string Datum für die Erinnerung zur Nachbestellung. | |||||||||||||||||||||||||||||||||||||||||||||
| accountingMonth | Array of numbers Abrechnungsmonate für den Auftrag. | |||||||||||||||||||||||||||||||||||||||||||||
| startDate | string Die Artikel dieser Bestellung sind für die Versorgung ab diesem Datum gedacht. | |||||||||||||||||||||||||||||||||||||||||||||
| endDate | string Die Artikel dieser Bestellung sind für die Versorgung bis zu diesem Datum gedacht. | |||||||||||||||||||||||||||||||||||||||||||||
object (IDeliveryAddress) Lieferadresse. Erweitert {@link IAddress } für Lieferadressen bei Bestellungen. | ||||||||||||||||||||||||||||||||||||||||||||||
| deliveryInformation | string Zusätzliche Lieferinformationen. | |||||||||||||||||||||||||||||||||||||||||||||
| doctorId | string ID des verordnenden Arztes. | |||||||||||||||||||||||||||||||||||||||||||||
| pharmacyId | string ID der beliefernden Apotheke. | |||||||||||||||||||||||||||||||||||||||||||||
| location | number Lokalisation der versorgten Wunde. Wert entspricht | |||||||||||||||||||||||||||||||||||||||||||||
| expressDelivery | boolean Gibt an, ob es sich um eine Expresslieferung handelt. | |||||||||||||||||||||||||||||||||||||||||||||
| isInitialCare | boolean Deprecated Gibt an, ob es sich um eine Erstversorgung handelt. | |||||||||||||||||||||||||||||||||||||||||||||
| status | number (OrderStatus) Enum: -3 -2 -1 0 1 2 3 4 5 6 7 8 9 10 Status einer Bestellung. Definiert den Lebenszyklus einer Bestellung von der Erstellung bis zur Lieferung. Nicht alle Statusänderungen sind erlaubt.
Erlaubte Statusübergänge: | Von Status | Erlaubte Zielstatus | |------------|---------------------| |
| |||||||||||||||||||||||||||||||||||||||||||||
| annotation | string Anmerkungen zum Auftrag. | |||||||||||||||||||||||||||||||||||||||||||||
| deliveryNote | string Lieferschein-Notiz. | |||||||||||||||||||||||||||||||||||||||||||||
| deliveryStartTime | string Geplante Lieferuhrzeit. | |||||||||||||||||||||||||||||||||||||||||||||
| hospitalId | string ID des Krankenhauses (falls Krankenhausversorgung). | |||||||||||||||||||||||||||||||||||||||||||||
| prescriptionStatus | string (TransmissionStatus) Enum: "transmissionPending" "transmissionInitiated" "transmissionFailed" "faxWaiting" "faxProcessing" "faxSending" "faxFailed" "emailFailed" "requested" "toClarify" "canceled" "faulty" "copyReceived" "originalReceived" Übermittlungsstatus für Dokumente. Definiert den Status der Übermittlung von Dokumenten (Fax, E-Mail).
| |||||||||||||||||||||||||||||||||||||||||||||
| isHospitalPrescriber | boolean Gibt an, ob das Krankenhaus der Verordner ist. | |||||||||||||||||||||||||||||||||||||||||||||
| tags | Array of strings Optionale Tags für den Auftrag (konfigurierbar). | |||||||||||||||||||||||||||||||||||||||||||||
| groupOrderId | string ID der zugehörigen Sammelbestellung (falls Teil einer Sammelbestellung). | |||||||||||||||||||||||||||||||||||||||||||||
| isGroupOrder | boolean Gibt an, ob dies eine Sammelbestellung ist. Bestellungen, die dieser Sammelbestellung zugehörig sind, besitzen die gleiche "groupOrderId". | |||||||||||||||||||||||||||||||||||||||||||||
| orderNumber | string Externe Auftragsnummer für Sammelbestellungen. | |||||||||||||||||||||||||||||||||||||||||||||
| attachments | Array of strings Liste von Anlagen, die dieser Bestellung zugehörig sind. | |||||||||||||||||||||||||||||||||||||||||||||
| erpOrderNumber | string ERP-Auftragsnummer. | |||||||||||||||||||||||||||||||||||||||||||||
| transmittedAt | string Zeitpunkt der Verarbeitung durch das Order-Backend. ISO-String-Datum, wann der Auftrag vom Order-Backend verarbeitet wurde. | |||||||||||||||||||||||||||||||||||||||||||||
| hasFollowUpOrder | boolean Gibt an, ob ein Folgeauftrag in derselben IntegratedCare existiert. | |||||||||||||||||||||||||||||||||||||||||||||
| auditIds | Array of strings Liste von zugehörigen Dokumenten-IDs für diesen Auftrag. | |||||||||||||||||||||||||||||||||||||||||||||
Array of objects (ITrackingInfo) Tracking-Informationen zur Sendungsverfolgung. | ||||||||||||||||||||||||||||||||||||||||||||||
| _id | string Eindeutige ID der Entität (UUID v4 als String). Wird beim Erstellen automatisch generiert. | |||||||||||||||||||||||||||||||||||||||||||||
| timestamp | string Zeitstempel der letzten Änderung. Wird bei jeder Änderung automatisch aktualisiert. | |||||||||||||||||||||||||||||||||||||||||||||
| archived | boolean Markiert die Entität als archiviert (Soft-Delete). Archivierte Entitäten werden nicht physisch gelöscht, sondern nur als archiviert markiert. Sie erscheinen nicht mehr in Standard-Abfragen. | |||||||||||||||||||||||||||||||||||||||||||||
| createdAt | string Zeitpunkt der Erstellung. Wird beim Erstellen der Entität automatisch gesetzt. | |||||||||||||||||||||||||||||||||||||||||||||
| createdBy | string ID des Benutzers, der die Entität erstellt hat. Referenziert einen Benutzer im System. | |||||||||||||||||||||||||||||||||||||||||||||
| updatedAt | string Zeitpunkt der letzten Änderung. Wird bei jeder Änderung automatisch aktualisiert. | |||||||||||||||||||||||||||||||||||||||||||||
| updatedBy | string ID des Benutzers, der die letzte Änderung vorgenommen hat. Referenziert einen Benutzer im System. | |||||||||||||||||||||||||||||||||||||||||||||
Array of objects (ISingleOrderedArticleLineExternal) | ||||||||||||||||||||||||||||||||||||||||||||||
| therapyId | number or string | |||||||||||||||||||||||||||||||||||||||||||||
| therapyTypeId | number or string |
{- "regionId": "string",
- "salesId": "string",
- "patientId": "string",
- "integratedCareId": "string",
- "creationDate": "string",
- "deliveryDate": "string",
- "deliveryOption": "string",
- "reminderDate": "string",
- "accountingMonth": [
- 0
], - "startDate": "string",
- "endDate": "string",
- "deliveryAddress": {
- "gender": 0,
- "title": 0,
- "name": "string",
- "address": "string",
- "additionalAddress": "string",
- "additionalAddress2": "string",
- "postalCodeId": "string",
- "postalCode": "string",
- "city": "string"
}, - "deliveryInformation": "string",
- "doctorId": "string",
- "pharmacyId": "string",
- "location": 0,
- "expressDelivery": true,
- "isInitialCare": true,
- "status": -3,
- "annotation": "string",
- "deliveryNote": "string",
- "deliveryStartTime": "string",
- "hospitalId": "string",
- "prescriptionStatus": "transmissionPending",
- "isHospitalPrescriber": true,
- "tags": [
- "string"
], - "groupOrderId": "string",
- "isGroupOrder": true,
- "orderNumber": "string",
- "attachments": [
- "string"
], - "erpOrderNumber": "string",
- "transmittedAt": "string",
- "hasFollowUpOrder": true,
- "auditIds": [
- "string"
], - "trackingInfo": [
- {
- "trackingLink": "string",
- "trackingCode": "string"
}
], - "_id": "string",
- "timestamp": "string",
- "archived": true,
- "createdAt": "string",
- "createdBy": "string",
- "updatedAt": "string",
- "updatedBy": "string",
- "orderedArticleLines": [
- {
- "_id": "string",
- "salesLineId": "string",
- "proposedArticleLineId": "string",
- "articleId": "string",
- "contractId": "string",
- "articleCustomerNumber": "string",
- "packagingUnitId": "string",
- "unit": "string",
- "quantity": 0,
- "deliveredQuantity": 0,
- "bookingCode": "string",
- "serialNumber": "string",
- "batchNumber": "string",
- "isPrivateSale": true,
- "groupOrderPosition": 0,
- "singleOrderId": "string",
- "timestamp": "string",
- "archived": true
}
], - "therapyId": 0,
- "therapyTypeId": 0
}{- "regionId": "string",
- "salesId": "string",
- "patientId": "string",
- "integratedCareId": "string",
- "creationDate": "string",
- "deliveryDate": "string",
- "deliveryOption": "string",
- "reminderDate": "string",
- "accountingMonth": [
- 0
], - "startDate": "string",
- "endDate": "string",
- "deliveryAddress": {
- "gender": 0,
- "title": 0,
- "name": "string",
- "address": "string",
- "additionalAddress": "string",
- "additionalAddress2": "string",
- "postalCodeId": "string",
- "postalCode": "string",
- "city": "string"
}, - "deliveryInformation": "string",
- "doctorId": "string",
- "pharmacyId": "string",
- "location": 0,
- "expressDelivery": true,
- "isInitialCare": true,
- "status": -3,
- "annotation": "string",
- "deliveryNote": "string",
- "deliveryStartTime": "string",
- "hospitalId": "string",
- "prescriptionStatus": "transmissionPending",
- "isHospitalPrescriber": true,
- "tags": [
- "string"
], - "groupOrderId": "string",
- "isGroupOrder": true,
- "orderNumber": "string",
- "attachments": [
- "string"
], - "erpOrderNumber": "string",
- "transmittedAt": "string",
- "hasFollowUpOrder": true,
- "auditIds": [
- "string"
], - "trackingInfo": [
- {
- "trackingLink": "string",
- "trackingCode": "string"
}
], - "_id": "string",
- "timestamp": "string",
- "archived": true,
- "createdAt": "string",
- "createdBy": "string",
- "updatedAt": "string",
- "updatedBy": "string",
- "orderedArticleLines": [
- {
- "_id": "string",
- "salesLineId": "string",
- "proposedArticleLineId": "string",
- "articleId": "string",
- "contractId": "string",
- "articleCustomerNumber": "string",
- "packagingUnitId": "string",
- "unit": "string",
- "quantity": 0,
- "deliveredQuantity": 0,
- "bookingCode": "string",
- "serialNumber": "string",
- "batchNumber": "string",
- "isPrivateSale": true,
- "groupOrderPosition": 0,
- "singleOrderId": "string",
- "timestamp": "string",
- "archived": true
}
], - "therapyId": 0,
- "therapyTypeId": 0
}