Skip to Content

Changes for page API Konfiguration

Last modified by Dimitri Rupp on 2026/07/08 13:55
From version 23.1
edited by Dimitri Rupp
on 2026/07/08 13:55
Change comment: There is no comment for this version
To version 22.1
edited by Dimitri Rupp
on 2026/06/11 09:30
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -7,7 +7,7 @@
7 7  Diese Seite entspricht der eigenständigen SharePoint-Page //API-Konfig.aspx//.
8 8  {{/info}}
9 9  
10 -= 🗺️ Workflow API-Einstellung =
10 += ⚙️ Workflow API-Einstellung =
11 11  {{mermaid}}
12 12  flowchart TD
13 13   R1[Rimo: InterfaceUser erstellen<br/>NICHT Personen Master, sondern Interface Master] --> R2[E-Mail mit initialem Passwort<br/>sorgfaeltig wählen]
... ... @@ -16,137 +16,108 @@
16 16   R4 --> R5[InterfaceUser Rolle vergeben]
17 17   R5 --> R6[MasterData -> Connectors -> Odoo Purchase Order<br/>User + Token setzen]
18 18   R6 --> O1[Odoo: Einstellungen -> FastAPI -> FastAPI Endpoints<br/>API-Key eintragen]
19 - O1 --> O2[Einstellungen -> Rimo-API -> Rimo-Secret-Token abrufen]
19 + O1 --> O2[Einstellungen -> Rimo-API -> 'Rimo-Secret-Token abrufen']
20 20   O2 --> OK[API verbunden]
21 21   style OK fill:#90ee90
22 22  {{/mermaid}}
23 23  
24 -= ⚙️ API einstellen =
24 += Schritte im Detail =
25 25  
26 -Die API muss in Odoo und in Rimo eingestellt werden.
26 +== 👤 1. Rimo: InterfaceUser anlegen ==
27 +* Anlage analog zum normalen User
28 +* **Wichtig:** Am Ende **Interface Master** erstellen (NICHT Personen Master)
29 +* Der User erhält eine **E-Mail mit initialem Passwort** – diese Mailadresse sorgfaeltig wählen
27 27  
28 -Zuerst erstellt man in Rimo einen **InterfaceUser**. Die Anlage ist die gleiche wie beim normalen User, jedoch am Ende erstellt man keinen //Personen Master// sondern **//Interface Master//**.
31 +== 🔑 2. Passwort und Token ==
32 +* In der API: altes Passwort durch ein neues ersetzen, speichern
33 +* Bei Erfolg wird der **Token** angezeigt
34 +* Dem InterfaceUser die entsprechende **Rolle** zuweisen
29 29  
30 -[[image:1621759527.png||alt="Rimo Create User mit Master Class SDMInterfaceMaster" style="display:block; max-width:760px; border:1px solid #dddddd; margin:8px 0;"]]
36 +== ⚙️ 3. Connector konfigurieren ==
37 +Pfad in Rimo: **//MasterData -> Connectors -> Odoo Purchase Order//**
31 31  
32 -//Abb. 1: Rimo, „Create User", Master Class **SDMInterfaceMaster** (①), „Create User" (②).//
39 +* User setzen
40 +* Token vergeben
33 33  
34 -Der User bekommt eine Mail wie jeder andere mit dem initialen Passwort, daher sollte man diese Mail des InterfaceUsers sorgfältig wählen. Nun ändern wir das Passwort des InterfaceUsers in der API: altes Passwort durch ein neues ersetzen und speichern.
42 +== 4. Odoo-Seite =
35 35  
36 -[[image:1816456615.png||alt="Rimo-API Swagger renew-token Passwort ändern" style="display:block; max-width:760px; border:1px solid #dddddd; margin:8px 0;"]]
44 +Pfad: **//Einstellungen -> FastAPI -> FastAPI Endpoints//**
37 37  
38 -//Abb. 2: Rimo-API (Swagger), //__renew-token__// – Passwort ändern.//
46 +* Den vergebenen **API-Key** eintragen
39 39  
40 -Wenn alles erfolgreich war, dann erhalten wir den Token:
48 +Anschliessend: **//Einstellungen -> Rimo-API -> Button //"Rimo-Secret-Token abrufen"//**
41 41  
42 -[[image:2917075449.png||alt="Rimo-API Server-Response 200 mit Token" style="display:block; max-width:760px; border:1px solid #dddddd; margin:8px 0;"]]
50 += ⚙️ Maßeinheiten-Konfiguration =
51 +Pfad: **//Einkauf/Verkauf -> Konfiguration -> Maßeinheiten -> Maßeinheitskategorien//**
43 43  
44 -//Abb. 3: Server-Response //__200__// mit ausgegebenem **Token**.//
53 +In der ersten Kategorie **Einheiten** wird das Label in die **Rimo-Kennung** geschrieben.
45 45  
46 -Unser InterfaceUser bekommt die Rolle:
55 +== Typischer Fehler ==
47 47  
48 -[[image:1894511496.png||alt="Rimo Interface-Person API connector mit Connection" style="display:block; max-width:760px; border:1px solid #dddddd; margin:8px 0;"]]
57 +{{warning}}
58 +**Wenn in Rimo neue Einheiten angelegt wurden, die in Odoo nicht konfiguriert sind**,
59 +liefert der Connector folgenden Fehler:
49 49  
50 -//Abb. 4: Interface-Person „API connector" mit Connection //__rimo_inbound_rest_api_2.0__//.//
61 +``"msg": "Value error, UOM with rimo key '...' not found."``
51 51  
52 -Nun gehen wir zum Connector unter **MasterData → Connectors → Odoo Purchase Order**:
63 +(statt //'...'// steht das Label, das Rimo sendet und Odoo nicht versteht.)
64 +Dann weiss man, dass etwas **nachkonfiguriert** werden muss.
65 +{{/warning}}
53 53  
54 -[[image:974127422.png||alt="Rimo Interface Manager Connectors Odoo Purchase Order Running" style="display:block; max-width:760px; border:1px solid #dddddd; margin:8px 0;"]]
67 +----
55 55  
56 -//Abb. 5: Interface Manager → Connectors, „Odoo Purchase Order" (//__Running__//).//
69 += Screenshots (aus SharePoint migriert) =
57 57  
58 -Setzen den User und vergeben den Token:
71 +[[image:1621759527.png||style="max-width:700px; border:1px solid #ddd; margin:8px 0;"]]
59 59  
60 -[[image:3948552630.png||alt="Rimo Connector Odoo Purchase Order InterfaceUser und ApiKey" style="display:block; max-width:760px; border:1px solid #dddddd; margin:8px 0;"]]
73 +[[image:1894511496.png||style="max-width:700px; border:1px solid #ddd; margin:8px 0;"]]
61 61  
62 -//Abb. 6: Connector „Odoo Purchase Order" – InterfaceUser (①), ApiKey (②).//
75 +[[image:3853990727.png||style="max-width:700px; border:1px solid #ddd; margin:8px 0;"]]
63 63  
64 -In Odoo gehen wir auf **Einstellungen → FastAPI → FastAPI Endpoints**:
77 +[[image:1870121522.png||style="max-width:700px; border:1px solid #ddd; margin:8px 0;"]]
65 65  
66 -[[image:2584541401.png||alt="Odoo Einstellungen FastAPI FastAPI Endpoints" style="display:block; max-width:760px; border:1px solid #dddddd; margin:8px 0;"]]
79 +[[image:2054263603.png||style="max-width:700px; border:1px solid #ddd; margin:8px 0;"]]
67 67  
68 -//Abb. 7: Odoo, Einstellungen → FastAPI → FastAPI Endpoints.//
81 +[[image:391538897.png||style="max-width:700px; border:1px solid #ddd; margin:8px 0;"]]
69 69  
70 -Dort finden wir den Endpoint //SPL TELE Supplier API//:
83 +[[image:2989254328.png||style="max-width:700px; border:1px solid #ddd; margin:8px 0;"]]
71 71  
72 -[[image:2054263603.png||alt="Odoo FastAPI Endpoints Liste SPL TELE Supplier API" style="display:block; max-width:760px; border:1px solid #dddddd; margin:8px 0;"]]
85 +[[image:3948552630.png||style="max-width:700px; border:1px solid #ddd; margin:8px 0;"]]
73 73  
74 -//Abb. 8: FastAPI Endpoints, „SPL TELE Supplier API".//
87 +[[image:3078964151.png||style="max-width:700px; border:1px solid #ddd; margin:8px 0;"]]
75 75  
76 -Tragen unten den **API-Key** ein, den wir vergeben haben:
89 +[[image:3468044009.png||style="max-width:700px; border:1px solid #ddd; margin:8px 0;"]]
77 77  
78 -[[image:391538897.png||alt="Odoo FastAPI Endpoint-Detail mit API-Key Bearer-Token" style="display:block; max-width:760px; border:1px solid #dddddd; margin:8px 0;"]]
91 +[[image:3792569909.png||style="max-width:700px; border:1px solid #ddd; margin:8px 0;"]]
79 79  
80 -//Abb. 9: Endpoint-Detail – **API-Key** (Bearer-Token).//
93 +[[image:1816456615.png||style="max-width:700px; border:1px solid #ddd; margin:8px 0;"]]
81 81  
82 -Dann wieder in **Einstellungen → Rimo-API → //Rimo-Secret-Token abrufen//**: Benutzer und Passwort des InterfaceUsers vergeben, den wir angelegt haben:
95 +[[image:3458358613.png||style="max-width:700px; border:1px solid #ddd; margin:8px 0;"]]
83 83  
84 -[[image:3383646946.png||alt="Odoo Dialog Rimo-Secret-Token abrufen Benutzername und Passwort" style="display:block; max-width:760px; border:1px solid #dddddd; margin:8px 0;"]]
97 +[[image:2584541401.png||style="max-width:700px; border:1px solid #ddd; margin:8px 0;"]]
85 85  
86 -//Abb. 10: Dialog „Rimo-Secret-Token abrufen" (Benutzername/Passwort, ④).//
99 +[[image:2917075449.png||style="max-width:700px; border:1px solid #ddd; margin:8px 0;"]]
87 87  
88 -War die Verbindung erfolgreich, so kann man sie in **Odoo** testen:
101 +[[image:797274892.png||style="max-width:700px; border:1px solid #ddd; margin:8px 0;"]]
89 89  
90 -[[image:3853990727.png||alt="Odoo Rimo-API Rimo-API testen" style="display:block; max-width:760px; border:1px solid #dddddd; margin:8px 0;"]]
103 +[[image:974127422.png||style="max-width:700px; border:1px solid #ddd; margin:8px 0;"]]
91 91  
92 -//Abb. 11: Rimo-API – „Rimo-API testen".//
105 +[[image:1627722157.png||style="max-width:700px; border:1px solid #ddd; margin:8px 0;"]]
93 93  
94 -Und auch in **Rimo**:
107 +[[image:3383646946.png||style="max-width:700px; border:1px solid #ddd; margin:8px 0;"]]
95 95  
96 -[[image:2989254328.png||alt="Rimo Connector Odoo Lieferantenmanagement Menü Actions Test endpoint" style="display:block; max-width:760px; border:1px solid #dddddd; margin:8px 0;"]]
109 +----
97 97  
98 -//Abb. 12: Connector „Odoo Lieferantenmanagement" – Menü //__Actions__// (Test endpoint).//
111 +== Verwandte Themen ==
99 99  
100 -Die Ergebnis-Events zeigen den Verbindungsstatus:
113 +//Kuratiert — kann direkt im Editor ergänzt werden://
101 101  
102 -[[image:3468044009.png||alt="Rimo Connector Processed und Error Out Events Login 200" style="display:block; max-width:760px; border:1px solid #dddddd; margin:8px 0;"]]
115 +* [[Dashboard>>doc:IT-Wiki.02-Tools.Odoo.Lieferantenmanagement.Dashboard.WebHome]]
116 +* [[Lieferanten manuell anlegen wenn Sie in Rimo schon vorhanden sind>>doc:IT-Wiki.02-Tools.Odoo.Lieferantenmanagement.Lieferanten-manuell-anlegen.WebHome]]
117 +* [[Lieferantengenehmigungseinstellungen>>doc:IT-Wiki.02-Tools.Odoo.Lieferantenmanagement.Lieferantengenehmigungseinstellungen.WebHome]]
103 103  
104 -//Abb. 13: Connector – //__Processed/Error Out Events__// (Login 200).//
119 +{{include reference="IT-Wiki.Makros.Verwandte-Themen.WebHome"/}}
105 105  
106 -Zum Schluss muss man den API-User an **allen Firmen berechtigen**:
121 +----
122 +**Status:** Migriert — Team-Review ausstehend · **Owner:** //(festlegen)// · **Letzter Review:** 2026-06-11
107 107  
108 -[[image:3458358613.png||alt="Rimo Dialog Select Objects for AUTH-Creditor" style="display:block; max-width:760px; border:1px solid #dddddd; margin:8px 0;"]]
109 -
110 -//Abb. 14: Dialog „Select Objects for: AUTH-Creditor".//
111 -
112 -= 📐 Einheiten konfigurieren =
113 -
114 -Als Einheit schickt Rimo das Label der Unit vom Masteritem. Folgende Units gibt es:
115 -
116 -|=Label|=English|=German
117 -|Stk|pcs.|Stk.
118 -|M|m|m
119 -|KG|kg|kg
120 -|L|l|Ltr.
121 -|KIT|Kit|Kit
122 -|SET|Set|Satz
123 -|mm|mm|mm
124 -|pa| |psch.
125 -|H|h|Std.
126 -|t|t|t
127 -|Pauschale|Lump sum|
128 -
129 -Entsprechend müssen wir diese in Odoo konfigurieren unter **Verkauf → Konfiguration → Maßeinheiten → Maßeinheitskategorien**, gleich die erste Kategorie //Einheiten//:
130 -
131 -[[image:3792569909.png||alt="Odoo Übersicht Maßeinheitskategorien" style="display:block; max-width:760px; border:1px solid #dddddd; margin:8px 0;"]]
132 -
133 -//Abb. 15: Maßeinheitskategorien-Übersicht.//
134 -
135 -[[image:3078964151.png||alt="Odoo Kategorie Einheit mit Spalte Rimo-Kennung" style="display:block; max-width:760px; border:1px solid #dddddd; margin:8px 0;"]]
136 -
137 -//Abb. 16: Kategorie „Einheit" – Spalte **Rimo-Kennung**.//
138 -
139 -Das Label schreibt man in die **Rimo-Kennung**.
140 -
141 -{{warning}}
142 -Sollten in Rimo neue Einheiten angelegt und in Odoo nicht konfiguriert werden, kommt im Connector der Fehler:
143 -
144 -``"msg": "Value error, UOM with rimo key '...' not found."``
145 -
146 -(statt //'...'// steht das Label, das Rimo sendet und Odoo nicht versteht.)
147 -Dann muss nachkonfiguriert werden.
148 -{{/warning}}
149 -
150 -
151 -
152 -