Skip to Content

Wiki source code of API Konfiguration

Last modified by Dimitri Rupp on 2026/07/08 13:55
Show last authors
1 {{box cssClass="floatinginfobox" title="**Auf dieser Seite**"}}
2 {{toc/}}
3 {{/box}}
4
5 {{info}}
6 Die **API-Konfiguration** muss sowohl in **Odoo** als auch in **Rimo** eingestellt werden.
7 Diese Seite entspricht der eigenständigen SharePoint-Page //API-Konfig.aspx//.
8 {{/info}}
9
10 = 🗺️ Workflow API-Einstellung =
11 {{mermaid}}
12 flowchart TD
13 R1[Rimo: InterfaceUser erstellen<br/>NICHT Personen Master, sondern Interface Master] --> R2[E-Mail mit initialem Passwort<br/>sorgfaeltig wählen]
14 R2 --> R3[Passwort in der API ändern<br/>alt -> neu, speichern]
15 R3 --> R4[Token erhalten]
16 R4 --> R5[InterfaceUser Rolle vergeben]
17 R5 --> R6[MasterData -> Connectors -> Odoo Purchase Order<br/>User + Token setzen]
18 R6 --> O1[Odoo: Einstellungen -> FastAPI -> FastAPI Endpoints<br/>API-Key eintragen]
19 O1 --> O2[Einstellungen -> Rimo-API -> Rimo-Secret-Token abrufen]
20 O2 --> OK[API verbunden]
21 style OK fill:#90ee90
22 {{/mermaid}}
23
24 = ⚙️ API einstellen =
25
26 Die API muss in Odoo und in Rimo eingestellt werden.
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//**.
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;"]]
31
32 //Abb. 1: Rimo, „Create User", Master Class **SDMInterfaceMaster** (①), „Create User" (②).//
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.
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;"]]
37
38 //Abb. 2: Rimo-API (Swagger), //__renew-token__// – Passwort ändern.//
39
40 Wenn alles erfolgreich war, dann erhalten wir den Token:
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;"]]
43
44 //Abb. 3: Server-Response //__200__// mit ausgegebenem **Token**.//
45
46 Unser InterfaceUser bekommt die Rolle:
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;"]]
49
50 //Abb. 4: Interface-Person „API connector" mit Connection //__rimo_inbound_rest_api_2.0__//.//
51
52 Nun gehen wir zum Connector unter **MasterData → Connectors → Odoo Purchase Order**:
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;"]]
55
56 //Abb. 5: Interface Manager → Connectors, „Odoo Purchase Order" (//__Running__//).//
57
58 Setzen den User und vergeben den Token:
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;"]]
61
62 //Abb. 6: Connector „Odoo Purchase Order" – InterfaceUser (①), ApiKey (②).//
63
64 In Odoo gehen wir auf **Einstellungen → FastAPI → FastAPI Endpoints**:
65
66 [[image:2584541401.png||alt="Odoo Einstellungen FastAPI FastAPI Endpoints" style="display:block; max-width:760px; border:1px solid #dddddd; margin:8px 0;"]]
67
68 //Abb. 7: Odoo, Einstellungen → FastAPI → FastAPI Endpoints.//
69
70 Dort finden wir den Endpoint //SPL TELE Supplier API//:
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;"]]
73
74 //Abb. 8: FastAPI Endpoints, „SPL TELE Supplier API".//
75
76 Tragen unten den **API-Key** ein, den wir vergeben haben:
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;"]]
79
80 //Abb. 9: Endpoint-Detail – **API-Key** (Bearer-Token).//
81
82 Dann wieder in **Einstellungen → Rimo-API → //Rimo-Secret-Token abrufen//**: Benutzer und Passwort des InterfaceUsers vergeben, den wir angelegt haben:
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;"]]
85
86 //Abb. 10: Dialog „Rimo-Secret-Token abrufen" (Benutzername/Passwort, ④).//
87
88 War die Verbindung erfolgreich, so kann man sie in **Odoo** testen:
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;"]]
91
92 //Abb. 11: Rimo-API – „Rimo-API testen".//
93
94 Und auch in **Rimo**:
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;"]]
97
98 //Abb. 12: Connector „Odoo Lieferantenmanagement" – Menü //__Actions__// (Test endpoint).//
99
100 Die Ergebnis-Events zeigen den Verbindungsstatus:
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;"]]
103
104 //Abb. 13: Connector – //__Processed/Error Out Events__// (Login 200).//
105
106 Zum Schluss muss man den API-User an **allen Firmen berechtigen**:
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}}