REWE-Schnittstelle
Einleitung
Die REWE-Schnittstelle ist als diaLIMS-Standardimplementation vorhanden und wird als Funktionslizenz angeboten.
Insgesamt geht es bei der Schnittstelle darum, dass REWE verschiedene Untersuchungsaufträge anbietet. Das Labor kann daraus dann Aufträge wählen und diese annehmen. Zu den Aufträgen werden automatisch Proben mit Untersuchungsumfang angelegt. Die untersuchte Probe wird dann später an REWE zurück übermittelt, inklusive Prüfbericht. Anschließend kann auch eine mit dem Auftrag verknüpfte Rechnung an REWE übermittelt werden.
Für sämtliche Vorgänge der REWE-Schnittstelle werden Log-Einträge mit der Herkunft 'REWERestClientWrapper' geschrieben.
REWE stellt ein Handbuch zur Verfügung, in dem die Funktionsweise der Schnittstelle (für Labore) erklärt wird. (Bei der dialog ist dieses Dokument am Projekt r00.rewe hinterlegt)
Vorbereitung / Einrichtung
Während die REWE-Schnittstelle zwar als Standard implementiert ist, sind im Kundenprojekt dennoch ein paar Anpassungen und Konfigurationen notwendig, bevor die Schnittstelle eingesetzt werden kann.
-
Programmierseitig müssen im Kundenprojekt die Bibliothek
dialims-rewe-libraryeingebunden und einige Klassen kundenindividuell eingefügt bzw. angepasst werden. Mithilfe des Projektesdialims-rewe-templatekann dies in wenigen Schritten umgesetzt werden (siehereadme.mdim Projektdialims-rewe-template). -
Danach muss der kundenindividuelle Datenbank-Updater auf der Kundendatenbank ausgeführt werden.
-
Auf der Kundendatenbank gibt es nach dem ersten Aufruf eine Einstellungskategorie 'REWE-WS-Client-Properties'. Hier können verschiedene Konfigurationen vorgenommen werden. Wichtig sind insbesondere folgende Einstellungen:
-
ServerURL: Der URL-Stamm, der in sämtlichen Aufrufen verwendet wird. Verweist standardmäßig auf REWE's Test-Endpoint ('staging').
-
APIKey: Der API Key, der von REWE für jedes anzubindende Labor ausgestellt wird. Ohne die Angabe eines gültigen API Keys kann keine Kommunikation mit der
REWE-REST-APIstattfinden. -
CreateStammdaten: Hier kann durch Angabe von "true" bzw. "false" gesteuert werden, ob beim Import fehlende Stammdaten automatisch angelegt werden sollen (true), oder ob bei fehlenden Stammdaten ein Fehler geworfen werden soll (false). Es geht um Analysen/Ergebnisse, Kunden/Ansprechpartner, Einheiten und Produkte. Wenn Stammdaten angelegt werden, werden diese immer auch zugelassen.
-
JsonDateFormat: Hier kann das Format (Java SimpleDateFormat) angegeben werden, wie es von der Schnittstelle primär für alle Im- & Exports von Datumswerten verwendet wird. Im Hintergrund gibt es beim Import noch weitere Formate, die verarbeitet werden können.
-
JsonDateFormatForInvoice: Das Format für Datumswerte, das ausschließlich für den Export von Rechnungen (bzw. REWE Invoices) verwendet wird.
-
Note: Nach Änderungen an der Einstellungskategorie muss die diaLIMS Desktop App neu gestartet werden.
Fachlicher Ablauf
Im Detail ist der fachliche Ablauf wie folgt: Pro Schritt wird auch ein beispielhafter Makroaufruf gezeigt, der in erster Linie an technisch interessierte Anwender gerichtet ist.
Tip:
Alle hier aufgeführten Makroaufrufe können am Makro direkt über die Vordefinierten Aufrufe eingefügt werden.
Aufträge einholen
Es werden alle aktuellen, offenen Aufträge (REWE Bezeichnung 'AnalysisTask') eingelesen. Die Auftrags-Datensätze werden entweder angelegt oder aktualisiert, die Zuordnung erfolgt via 'Auftrag.reweTaskId'. Außerdem werden zu den Aufträgen Proben (REWE Bezeichnung 'SpecificationVariant') importiert, auch diese werden neu erstellt oder aktualisiert via 'Probe.reweSpecificationVariantId'. Die Zuordnung des Prüfumfangs erfolgt auf Einzelergebnis-Ebene. Die Ergebnisse (REWE Bezeichnung 'AnalyticParameter') werden anhand von 'Ergebnis.reweAnalyticParameterId' gesucht und in Abhängigkeit von der Einstellung 'CreateStammdaten' ggf. auch neu angelegt.
// REWE: Offene Aufträge importieren
com.dialog.dialims.business.AuftragController.getInstance().importREWEAuftraegeAndProben(toc);
1: In der Abschlussverarbeitung dieses Vorgangs wird aus technischen Gründen die Funktion zur "Zuordnung von Grenzwerten" (Option: VerhaltenGrenzwertAenderung) temporär deaktiviert.
2: Der Rückgabewert der Methode ist eine Liste mit erfolgreich importierten Aufträgen (List<Auftrag>). Für weitere Logik kann dieser Rückgabewert im Makro verwendet werden.
Statt nach offenen Aufträgen kann auch nach blockierten, laufenden, Vorabbericht-, abgeschlossenen oder stornierten Aufträgen gesucht werden.
// REWE: Blockierte Aufträge importieren
com.dialog.dialims.business.AuftragController.getInstance().importREWEAuftraegeAndProbenLocked(toc);
// REWE: Laufende Aufträge importieren
com.dialog.dialims.business.AuftragController.getInstance()
.importREWEAuftraegeAndProbenInProcess(toc);
// REWE: Vorabbericht-Aufträge importieren
com.dialog.dialims.business.AuftragController.getInstance()
.importREWEAuftraegeAndProbenPreliminaryReport(toc);
// REWE: Abgeschlossene Aufträge importieren
com.dialog.dialims.business.AuftragController.getInstance().importREWEAuftraegeAndProbenClosed(toc);
// REWE: Stornierte Aufträge importieren
com.dialog.dialims.business.AuftragController.getInstance()
.importREWEAuftraegeAndProbenCanceled(toc);
Aufträge bestätigen
Das Labor teilt REWE für einen oder mehrere Aufträge mit, dass es sie annehmen / bestätigen möchte. Dies kann für jeden einzelnen Auftrag aus verschiedenen Gründen fehlschlagen. Am wahrscheinlichsten wohl deswegen, dass er zwischenzeitlich von einem anderen Labor angenommen wurde, oder von einem selbst bereits bestätigt wurde. Wird ein Auftrag erfolgreich bestätigt, wechselt der REWE-Status von 'Open' auf 'InProcess'. Außerdem wird für diesen Auftrag eine 'rewePurchaseOrderID' vergeben, diese wird später wichtig für die Rechnungsstellung.
// REWE: Aufträge bestätigen
com.dialog.dialims.business.AuftragController.getInstance().confirmREWEAuftraege(selected, toc);
Der Rückgabewert der Methode ist eine Liste mit erfolgreich bestätigten Aufträgen (List<Auftrag>). Für weitere Logik kann dieser Rückgabewert im Makro verwendet werden.
Auftragsdetails einlesen
Erst nachdem ein Auftrag bestätigt wurde, können zu diesem Auftrag die Details (REWE Bezeichnung 'Findings') eingelesen werden. Es können dabei weitere Proben dazukommen und der Untersuchungsumfang von Proben kann sich ändern.
// REWE: Findings importieren
com.dialog.dialims.business.AuftragController.getInstance().importREWEFindingsForAuftraege(selected, toc);
1: Bei den Untersuchungsumfängen werden aktuell nur neue Einträge (Parameter) hinzugefügt. Es werden keine existierenden Parameter entfernt, wenn sie bei einer folgenden Übertragung nicht mitgesendet werden.
2: Der Rückgabewert der Methode ist eine Liste mit erfolgreich importierten Aufträgen (List<Auftrag>). Für weitere Logik kann dieser Rückgabewert im Makro verwendet werden.
Ergebnisse zurücksenden
Nachdem eine Probe vollständig untersucht wurde, werden die Ergebnisse der Untersuchung an REWE zurück übermittelt. Dieser Vorgang kann beliebig oft ausgeführt werden, die Untersuchungsergebnisse werden bei REWE überschrieben. Es wird auch ein Prüfbericht (PDF) übertragen. Dabei wird die aktuellste freigegebene PDF-Datei gesendet.
// REWE: Aufträge exportieren
com.dialog.dialims.business.AuftragController.getInstance().exportREWEAuftragProben(selected, toc);
// REWE: Prüfberichte exportieren
com.dialog.dialims.business.AuftragController.getInstance().exportREWEPruefberichte(selected, toc);
Der Rückgabewert der Methode exportREWEAuftragProben() ist eine Liste mit erfolgreich exportierten Aufträgen (List<Auftrag>).
Der Rückgabewert der Methode exportREWEPruefberichte() ist eine Liste der Proben mit erfolgreich exportierten Prüfberichten (List<Probe>).
Für weitere Logik können diese Rückgabewerte im Makro verwendet werden.
Aufträge abschließen
Wenn alle Untersuchungsergebnisse eines Auftrags erfolgreich übertragen wurden, kann er als abgeschlossen markiert werden. An abgeschlossenen Aufträgen können keine Änderungen auf REWE-Seite mehr vorgenommen werden.
// REWE: Aufträge abschließen
com.dialog.dialims.business.AuftragController.getInstance().markREWEAuftraegeAsCompleted(selected, toc);
Der Rückgabewert der Methode ist eine Liste mit erfolgreich abgeschlossenen Aufträgen (List<Auftrag>). Für weitere Logik kann dieser Rückgabewert im Makro verwendet werden.
Rechnungen senden
Die Übertragung ist nur für Rechnungen möglich, die einem bestätigten REWE-Auftrag zugeordnet sind. Pro Rechnung kann nur eine Übertragung stattfinden, das Schlüssel-Attribut ist hier die Kurzbezeichnung. Nachdem eine Rechnung übertragen wurde, kann für sie auch eine PDF übertragen werden. Übertragen wird die aktuellste, freigegebene PDF.
// REWE: Rechnungen exportieren
com.dialog.dialims.business.RechnungController.getInstance().exportREWERechnungen(selected, toc);
// REWE: PDFs exportieren
com.dialog.dialims.business.RechnungController.getInstance().exportREWERechnungenPDFs(selected, toc);
1: Auf REWE-Seite wird beim Export eine neue Rechnung erzeugt. Rechnungen können nachträglich nicht geändert werden! Daher ist der Export einer LIMS-Rechnung nur einmal möglich.
2: Der Rückgabewert der Methoden ist jeweils eine Liste mit erfolgreich exportierten Rechnungen (List<Rechnung>). Für weitere Logik kann dieser Rückgabewert im Makro verwendet werden.
Rechnungen stornieren
Storniert die übergebenen Rechnungen bei REWE. Im diaLIMS erfolgt keine Änderung an den Rechnungen.
// REWE: Rechnungen stornieren
com.dialog.dialims.business.RechnungController.getInstance().cancelREWERechnungen(selected, toc);
Der Rückgabewert der Methode ist eine Liste mit erfolgreich stornierten Rechnungen (List<Rechnung>). Für weitere Logik kann dieser Rückgabewert im Makro verwendet werden.
Technisches
Es wird von REWE ein REST-Endpoint bereitgestellt, über den sämtliche Kommunikation läuft. Das diaLIMS agiert ausschließlich als Client. Das ist insofern praktisch, als dass kein Server (Tomcat o.ä.) aufgesetzt werden muss, auf dem auf eingehende Verbindungen von REWE gewartet wird. Sämtliche Trigger stammen direkt aus der diaLIMS Desktop App und sind i.d.R. in Makros verpackt. Es ist einfach möglich sie kundenindividuell über Worker oder Status-Actions laufen zu lassen. Datensätze werden zwischen diaLIMS und REWE JSON-serialisiert ausgetauscht. Die JSON-Schemata wurden von REWE definiert. Eins-zu-eins Repräsentationen dieser Schemata befinden sich im Package 'com.dialog.dialims.rewe.rest.model' der Bibliothek dialims-rewe-library. In einer 'rewe_readme.txt' stehen weitere Hinweise zur Generierung / Implementierung. Die Konvertierung zwischen LIMS- und diesen JSON-Datensätzen ist in den jeweiligen Controller-Interfaces implementiert und ist somit kundenindividuell leicht anpassbar. Wie bei REST üblich erfolgt die Kommunikation via HTTPS, entsprechend wird auf dem Client eine aktive Internetverbindung vorausgesetzt.
Im der Klasse REWERestUtil befinden sich Methoden für alle Schritte aus dem Ablauf, die für den Aufruf aus einem Makro vorbereitet wurden.
Der REWE-Rest-Endpoint (Test) kann ohne Anmeldung direkt manuell angesehen werden unter folgender URL: https://tiepqslabconnectapi-testing.azurewebsites.net/swagger/index.html
Um mit dem Endpoint kommunizieren zu können, wird ein API Key bentötigt. Dieser wird individuell an die anzubindenden Labore ausgegeben. Der Key dient für REWE gleichzeitig dazu die Labore zu identifizieren.
Mapping
Zur Zuordnung von Datensätzen
Im Folgenden werden an einigen Feldern Referenzen zu anderen Datensätzen gesetzt. Bei diesen Zuordnungen werden stets folgende Prinzipien eingehalten:
- Datensätze werden anhand ihres Schlüsselattributes gesucht, oder neu angelegt, wenn sie nicht gefunden werden konnten.
- Ob auch Stammdatensätze neu angelegt werden sollen, kann über die Option 'CreateStammdaten' gesteuert werden, siehe oben.
- Fertiggestellte, gesperrte und stornierte Datensätze werden bei der Suche grundsätzlich nicht berücksichtigt (können nicht gefunden werden).
Note: Die genaue Bezeichnung der Felder kann auf beiden Seiten variieren. Im diaLIMS sind abweichende Externalisierungen möglich und auf REWE Seite werden hier die Feldnamen verwendet, wie sie technisch angegeben wurden. Die von den QM / Labormitarbeitern verwendeten Bezeichnungen können abweichen. Zum Teil werden in der Bemerkungsspalte englische Werte genannt, in diesen Fällen handelt es sich um die originale Beschreibung von REWE.
|
diaLIMS Feld |
REWE Feld |
REWE Typ |
Bemerkung |
Beispielwert |
|---|---|---|---|---|
|
REWE Task ID |
taskId |
AnalysisTask |
Schlüsselattribut |
UA00001102 |
|
Typ |
|
AnalysisTask |
Statisch 'REWE' |
REWE |
|
Auftraggeber |
customer |
AnalysisTask |
Es wird ein Kunde mit passendem 'REWE Name'n zugeordnet oder angelegt (siehe auch CreateStammdaten). Als Auftraggeber Ansprechpartner wird der Hauptansprechpartner des Kunden zugeordnet. |
|
|
Rechnungsempfänger |
customer |
AnalysisTask |
Identischer Kunde wie Auftraggeber Als Rechnungsempfänger Ansprechpartner wird der Rechnungsempfänger des Kunden zugeordnet. |
|
|
Produkt |
item |
AnalysisTask |
Es wird ein Produkt mit passender 'REWE Item ID' zugeordnet oder angelegt (siehe auch CreateStammdaten) |
|
|
Proben |
specificationVariants |
AnalysisTaskDetails |
Es werden Proben zu dem Auftrag angelegt oder aktualisiert, abhängig vom Schlüsselattribut 'Probe.reweSpecificationVariantId' |
|
|
Wiedervorlagedatum |
plannedDrawingDate |
AnalysisTask |
|
|
|
REWE Nahmeort |
drawingLocation |
AnalysisTask |
|
Abholung im Markt |
|
REWE Bestellung-ID |
purchaseOrderId |
AnalysisTask |
|
B000002802 |
|
REWE Institut-Konto |
instituteAccountNumber |
AnalysisTask |
|
1234567890 |
|
REWE Verteilungsleitung |
distributionLine |
AnalysisTask |
|
RZAG EM Fisch |
|
REWE kurz vor Ablauf |
analysisCloseToBestBeforeDate |
AnalysisTask |
"Should the analysis be performed close to item's best before date?" |
|
|
REWE Auftrag Status |
taskStatus |
AnalysisTask |
Wertemenge |
|
|
REWE Angestellten Gruppe |
employeeGroup |
AnalysisTask |
|
Q-Team Baum |
|
REWE Typ |
requestType |
AnalysisTask |
Wertemenge |
|
|
REWE Produkt Spezifikation |
itemSpecificationName |
AnalysisTask |
|
Bio Vollkorn Spaghetti |
|
REWE Analyse Request ID |
analysisRequestId |
AnalysisTask |
|
UP00294313 |
|
REWE Erwartete Kosten |
expectedCost |
AnalysisTaskDetails |
|
4500 |
|
REWE Währung |
currency |
AnalysisTaskDetails |
|
EUR |
|
REWE Finding ID |
findingId |
Finding |
|
F000000155 |
|
REWE Status |
status |
Finding |
Wertemenge |
|
|
REWE Übertragungsdatum |
transmissionDate |
Finding |
Transmission date of finding |
|
|
REWE Item Status General |
itemStatusGeneral |
Finding |
|
|
|
REWE Verteilungsleitung |
distributionLine |
Finding |
|
RZAG EM Fisch |
|
REWE Institut Fund Nummer |
instituteFindingNumber |
Finding |
|
RW-BEF-000001 |
|
REWE Institut Fund Datum |
instituteFindingsDateOfSampling |
Finding |
|
|
|
REWE Institut Fund Untersuchungsdatum |
instituteFindingsDateOfInvestigation |
Finding |
|
|
|
REWE Institut Fund Ort |
instituteFindingsPlaceOfSampling |
Finding |
|
REWE Markt - Eigelstein 80-88 - Köln |
|
REWE Institut Fund Chargen Identifikation |
instituteFindingsBatchLotIdentification |
Finding |
|
C-8921021212 |
|
REWE Institut Fund Partei Nummer |
instituteFindingsPartyNumber |
Finding |
|
P-121212121 |
|
REWE Institut Fund Identity Code |
instituteFindingsIdentityCode |
Finding |
|
RW-BEF-000001 |
|
REWE Institut Fund Füllmenge |
instituteFindingsFillingQuantity |
Finding |
|
100 |
|
REWE Institut Fund Mengencode |
instituteFindingsQuantityCode |
Finding |
|
g |
|
REWE Institut Fund MHD |
instituteFindingsMHD |
Finding |
|
31.12.2021 |
|
REWE Institut Fund Kommentar |
instituteFindingsComment |
Finding |
|
Finding without Lack |
|
REWE Company ID |
companyId |
Finding |
|
rgb |
|
REWE Language ID |
languageId |
Finding |
|
de |
|
Ergebnisse |
findingPositions |
Finding |
|
|
|
REWE Artikel Verkäufer Kommentar |
itemVendorComment |
Finding |
|
Bei vorhandenen Mangel: keine Marktfreigabe |
|
Im Folgenden werden gekürzt einige Felder zur Spezifikation aufgelistet. Für jedes Feld gibt es jeweils ein weiteres, nicht aufgelistetes Feld mit dem Suffix "NotMeetSpeci" mit einer Wertemenge "Yes / No". Die Wertemenge für alle aufgeführten Felder ist ebenfalls identisch: NotExamined, NoLack, MarketableLack, NotMarketableLack | ||||
|
REWE Deklarationsmangel |
declarationLack |
Finding |
|
|
|
REWE Verpackungsmangel |
packagingLack |
Finding |
|
|
|
REWE Inhaltsmangel |
contentLack |
Finding |
|
|
|
REWE analytischer Mangel |
analyticalLack |
Finding |
|
|
|
REWE Verunreinigungen |
contaminants |
Finding |
|
|
|
REWE Rückstände |
arrears |
Finding |
|
|
|
REWE Mikro Bio Mangel Ohne PG |
microBioLackWithoutPG |
Finding |
|
|
|
REWE Mikro Bio Mangel Mit PG |
microBioLackWithPG |
Finding |
|
|
|
REWE Sensorischer Mangel |
sensoryLack |
Finding |
|
|
|
diaLIMS Feld |
REWE Feld |
REWE Typ |
Bemerkung |
Beispielwert |
|---|---|---|---|---|
|
|
id |
AnalysisParameter |
Wird zur Zuordnung eines Stammdaten Ergebnisses verwendet. Feld: "Ergebnis.REWE Analytic Parameter ID" Hinweis: Beim Export werden nur Probenergebnisse exportiert, an deren Stammdatenergebnis eine REWE Analytic Parameter ID gepflegt ist. Andere Probenergebnisse werden als zusätzliche Parameter gewertet, die für REWE irrelevant sind. |
AP-000060 |
|
REWE Parameter Name |
name |
AnalysisParameter |
|
Fett |
|
|
externalItemId |
AnalysisParameter |
Id of item in laboratory systems |
|
|
|
externalItemName |
AnalysisParameter |
Name of item in laboratory systems |
Neutralfette |
|
REWE Parameter Typ |
type |
AnalysisParameter |
Wertemenge |
|
|
|
decimalPlaces |
AnalysisParameter |
|
2 |
|
REWE Grenz U Operator |
fromOperator |
AnalysisParameter |
Wertemenge, wird in der Grenzwert-Logik nicht berücksichtigt |
|
|
Grenz U |
fromQuantity |
AnalysisParameter |
|
30 |
|
REWE Grenz O Operator |
toOperator |
AnalysisParameter |
Wertemenge, wird in der Grenzwert-Logik nicht berücksichtigt |
|
|
Grenz O |
toQuantity |
AnalysisParameter |
|
35 |
|
|
unit |
AnalysisParameter |
|
m/Osm/Kg |
|
REWE Erwartete Kosten |
expectedCosts |
AnalysisParameter |
|
35 |
|
|
currency |
AnalysisParameter |
|
EUR |
|
|
comment |
AnalysisParameter |
|
Ermittelt durch Kalorimetrieverfahren |
|
REWE Item Beschreibung |
itemDescription |
AnalysisParameter |
Neu in 2022 |
|
|
REWE Typ |
$type |
FindingResultBase |
Auf technischer Ebene ein sehr wichtiges Feld, dadurch wird die Differenzierung zwischen den Types Simple und Complex getroffen |
|
|
REWE Parameter Typ |
analyticParameterId |
FindingResultBase |
|
AP-000060 |
|
REWE Specifikationsvarianten ID |
specificationVariantId |
FindingResultBase |
|
AS639097-001 |
|
REWE Untersuchungsergebnis Status |
findingsResultExaminationStatus |
FindingResultBase |
Wertemenge |
|
|
REWE Untersuchungsergebnis Kommentar |
findingsResultExaminationStatusComment |
FindingResultBase |
|
Analyse mit Kalorimetrie |
|
REWE Ergebnis Status |
findingsResultStatus |
FindingResultBase |
Neu in 2022, Pflichtfeld, Wertemenge |
|
|
REWE Mehrere untersucht |
multipleExamined |
FindingResultBase |
Neu in 2022 |
No (Default) / Yes |
|
REWE Testeinheit |
testModule |
FindingResultBase |
Neu in 2022 |
Prüfmodul Textil: Textil und Chemie |
|
REWE Testeinheit Kostenlimit |
testModuleUpperCostLimit |
FindingResultBase |
Neu in 2022 |
500 |
|
|
FindingResultSimple |
'FindingResultSimple' besitzt alle Felder von 'FindingResultBase' |
| |
|
|
|
FindingResultComplex |
FindingResultComplex' besitzt alle Felder von 'FindingResultBase' |
|
|
REWE Einstufung |
classification |
FindingResultComplex |
Neu in 2022 |
2-3 |
|
Statistikwert.Mittelwert |
actualValue |
FindingResultComplex |
Es wird der Mittelwert aus den Statistikwerten berechnet |
32.58 |
|
REWE Vorzeichen |
actualOperator |
FindingResultComplex |
Wenn gesetzt, wird der Wert aus dem Feld 'REWE Vorzeichen' genommen. Wenn nicht aber es gibt genau einen Ergebniswert am Parameter, wird das Vorzeichen dieses Werts genommen. Sonst wird "None" verwendet. |
|
|
diaLIMS Feld |
REWE Feld |
REWE Typ |
Bemerkung |
|---|---|---|---|
|
REWE Name |
name |
Customer |
Schlüsselattribut |
|
Typ |
|
|
Statisch "REWE" |
|
Hauptansprechpartner.Firma |
name |
Customer |
Hauptansprechpartner wird ggf. neu angelegt |
|
Hauptansprechpartner .Straße .Postleitzahl .Ort .Land oder .Adresszusatz 1 |
address |
Customer |
|
|
Rechnungsempfänger.Firma |
invoiceName |
Customer |
Rechnungsempfänger wird ggf. neu angelegt |
|
Rechnungsempfänger .Straße .Postleitzahl .Ort .Land oder .Adresszusatz 1 |
invoiceAddress |
Customer |
Wird von REWE keine invoiceAddress übertragen, so erhält der Rechnungsempfänger dieselbe Adresse wie der Hauptansprechpartner (address). |
| diaLIMS Feld | REWE Feld | REWE Typ | Bemerkung | Beispielwert |
|---|---|---|---|---|
| Auftrag.REWE Bestellung ID | invoiceId | InvoiceV2 | Schlüsselattribut | |
| Kurzbezeichnung | orderId | InvoiceV2 | ||
| Beschreibung | description | InvoiceV2 | Rechnung zu Befund F000000155 | |
| invoicingParty | InvoiceV2 | Wird mit Daten vom Kunden des angemeldeten Benutzers gefüllt | ||
| Kunde.Beschreibung | name | InvoicingParty | ||
| Kunde.Umsatz Steuer ID | vatNumber | InvoicingParty | ||
| invoiceAddress | InvoicingParty | Wird mit den Adressdaten des Hauptansprechpartners gefüllt | ||
| Rechnungsempfänger | invoiceRecipient | InvoiceV2 | ||
| Kunde.Hauptansprechpartner.Firma | name | InvoiceRecipient | Wenn leer, wird Kunde.Beschreibung genommen | |
| invoiceAddress | InvoiceRecipient | Wird mit den Adressdaten des Hauptansprechpartners gefüllt | ||
| Rechnungsdatum | invoicingDate | InvoiceV2 | Date of invoice creation | |
| Rechnungsdatum | fixedDueDate | InvoiceV2 | Date until the invoice should be paid | |
| Auftrag.REWE Currency | currency | InvoiceV2 | Wenn nicht gesetzt, wird die globale Währung aus den Optionen genommen, wobei "€" zu "EUR" umgewandelt wird | EUR |
| Rechnungspositionen | positions | InvoiceV2 |
| diaLIMS Feld | REWE Feld | REWE Typ | Bemerkung | Beispielwert |
|---|---|---|---|---|
| Artikel.Analyse.Ergebnis.REWE Analytic Parameter ID | itemId | InvoicePositionV2 | Die Zuordnung Analyse.Ergebnis ist nicht eindeutig. Es wird das erste gefundene Ergebnis genommen, bei dem die ID gesetzt ist. | |
| externalItemId | InvoicePositionV2 | |||
| externalItemText | InvoicePositionV2 | |||
| itemName | InvoicePositionV2 | |||
| description | InvoicePositionV2 | |||
| paymentDetails | InvoicePositionV2 | |||
| Menge | quantity | PositionPaymentDetailsV2 | 2 | |
| Mengeneinheit | unit | PositionPaymentDetailsV2 | St | |
| Preisnetto Rabattiert | unitNetAmount | PositionPaymentDetailsV2 | 10 | |
| Preisnetto Rabattiert * Menge | lineAmount | PositionPaymentDetailsV2 | Preis einer Einzelposition multipliziert mit der Menge | 20 |
| Umsatzsteuersatz * 100 | taxPercentage | PositionPaymentDetailsV2 | Mit 100 multipliziert | 19 |
| Umsatzsteuer Berechnet | taxLineAmount | PositionPaymentDetailsV2 | 3,8 |