Wiki source code of API Konfiguration
Version 34.1 by Dimitri Rupp on 2026/07/08 13:55
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
1.1 | 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 | |||
| |
23.1 | 10 | = 🗺️ Workflow API-Einstellung = |
| |
1.1 | 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] | ||
| |
23.1 | 19 | O1 --> O2[Einstellungen -> Rimo-API -> Rimo-Secret-Token abrufen] |
| |
1.1 | 20 | O2 --> OK[API verbunden] |
| 21 | style OK fill:#90ee90 | ||
| 22 | {{/mermaid}} | ||
| 23 | |||
| |
23.1 | 24 | = ⚙️ API einstellen = |
| |
1.1 | 25 | |
| |
23.1 | 26 | Die API muss in Odoo und in Rimo eingestellt werden. |
| |
1.1 | 27 | |
| |
23.1 | 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//**. |
| |
1.1 | 29 | |
| |
23.1 | 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;"]] |
| |
1.1 | 31 | |
| |
23.1 | 32 | //Abb. 1: Rimo, „Create User", Master Class **SDMInterfaceMaster** (①), „Create User" (②).// |
| |
1.1 | 33 | |
| |
23.1 | 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. |
| |
1.1 | 35 | |
| |
23.1 | 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;"]] |
| |
1.1 | 37 | |
| |
23.1 | 38 | //Abb. 2: Rimo-API (Swagger), //__renew-token__// – Passwort ändern.// |
| |
1.1 | 39 | |
| |
23.1 | 40 | Wenn alles erfolgreich war, dann erhalten wir den Token: |
| |
1.1 | 41 | |
| |
23.1 | 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;"]] |
| |
1.1 | 43 | |
| |
23.1 | 44 | //Abb. 3: Server-Response //__200__// mit ausgegebenem **Token**.// |
| |
1.1 | 45 | |
| |
23.1 | 46 | Unser InterfaceUser bekommt die Rolle: |
| |
1.1 | 47 | |
| |
23.1 | 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;"]] |
| |
1.1 | 49 | |
| |
23.1 | 50 | //Abb. 4: Interface-Person „API connector" mit Connection //__rimo_inbound_rest_api_2.0__//.// |
| |
1.1 | 51 | |
| |
23.1 | 52 | Nun gehen wir zum Connector unter **MasterData → Connectors → Odoo Purchase Order**: |
| |
1.1 | 53 | |
| |
23.1 | 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;"]] |
| |
1.1 | 55 | |
| |
23.1 | 56 | //Abb. 5: Interface Manager → Connectors, „Odoo Purchase Order" (//__Running__//).// |
| |
1.1 | 57 | |
| |
23.1 | 58 | Setzen den User und vergeben den Token: |
| |
1.1 | 59 | |
| |
23.1 | 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;"]] |
| |
1.1 | 61 | |
| |
23.1 | 62 | //Abb. 6: Connector „Odoo Purchase Order" – InterfaceUser (①), ApiKey (②).// |
| |
1.1 | 63 | |
| |
23.1 | 64 | In Odoo gehen wir auf **Einstellungen → FastAPI → FastAPI Endpoints**: |
| |
1.1 | 65 | |
| |
23.1 | 66 | [[image:2584541401.png||alt="Odoo Einstellungen FastAPI FastAPI Endpoints" style="display:block; max-width:760px; border:1px solid #dddddd; margin:8px 0;"]] |
| |
1.1 | 67 | |
| |
23.1 | 68 | //Abb. 7: Odoo, Einstellungen → FastAPI → FastAPI Endpoints.// |
| |
1.1 | 69 | |
| |
23.1 | 70 | Dort finden wir den Endpoint //SPL TELE Supplier API//: |
| |
1.1 | 71 | |
| |
23.1 | 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;"]] |
| |
1.1 | 73 | |
| |
23.1 | 74 | //Abb. 8: FastAPI Endpoints, „SPL TELE Supplier API".// |
| |
1.1 | 75 | |
| |
23.1 | 76 | Tragen unten den **API-Key** ein, den wir vergeben haben: |
| |
1.1 | 77 | |
| |
23.1 | 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;"]] |
| |
1.1 | 79 | |
| |
23.1 | 80 | //Abb. 9: Endpoint-Detail – **API-Key** (Bearer-Token).// |
| |
1.1 | 81 | |
| |
23.1 | 82 | Dann wieder in **Einstellungen → Rimo-API → //Rimo-Secret-Token abrufen//**: Benutzer und Passwort des InterfaceUsers vergeben, den wir angelegt haben: |
| |
1.1 | 83 | |
| |
23.1 | 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;"]] |
| |
1.1 | 85 | |
| |
23.1 | 86 | //Abb. 10: Dialog „Rimo-Secret-Token abrufen" (Benutzername/Passwort, ④).// |
| |
1.1 | 87 | |
| |
23.1 | 88 | War die Verbindung erfolgreich, so kann man sie in **Odoo** testen: |
| |
1.1 | 89 | |
| |
23.1 | 90 | [[image:3853990727.png||alt="Odoo Rimo-API Rimo-API testen" style="display:block; max-width:760px; border:1px solid #dddddd; margin:8px 0;"]] |
| |
1.1 | 91 | |
| |
23.1 | 92 | //Abb. 11: Rimo-API – „Rimo-API testen".// |
| |
1.1 | 93 | |
| |
23.1 | 94 | Und auch in **Rimo**: |
| |
1.1 | 95 | |
| |
23.1 | 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;"]] |
| |
1.1 | 97 | |
| |
23.1 | 98 | //Abb. 12: Connector „Odoo Lieferantenmanagement" – Menü //__Actions__// (Test endpoint).// |
| |
1.1 | 99 | |
| |
23.1 | 100 | Die Ergebnis-Events zeigen den Verbindungsstatus: |
| |
1.1 | 101 | |
| |
23.1 | 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;"]] |
| |
1.1 | 103 | |
| |
23.1 | 104 | //Abb. 13: Connector – //__Processed/Error Out Events__// (Login 200).// |
| |
1.1 | 105 | |
| |
23.1 | 106 | Zum Schluss muss man den API-User an **allen Firmen berechtigen**: |
| |
1.1 | 107 | |
| |
23.1 | 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 |