OmniSeller:SW6 Plugin: Unterschied zwischen den Versionen

Zur Navigation springen Zur Suche springen

OmniSeller:SW6 Plugin (Quelltext anzeigen)

Version vom 11. Oktober 2021, 10:15 Uhr

10.283 Bytes hinzugefügt ,  11. Oktober 2021
→‎B2BPreise
Keine Bearbeitungszusammenfassung
 
(19 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:


<div class="mw-parser-output">
<div class="mw-parser-output">
<div class="mw-parser-output">
== das OmniSeller Plugin für Zusatzfunktionen in Shopware6 ==
== das OmniSeller Plugin für Zusatzfunktionen in Shopware6 ==
<div class="mw-parser-output">
<div class="mw-parser-output">
=== Hintergründe ===
=== Hintergründe ===
<div>Uns erreichen zunehmend Anfragen zur Ausleitung von bestimmten Sage100/ERP Daten in Richtung Shopware, um dort zusätzliche Funktionen &nbsp;wie z.B. Kundenstamm-Import, kundenspezifische Preise oder Erstellungsmöglichkeiten von Verkaufsstatistiken abbilden zu können.</div> <div>&nbsp;</div> <div>Dieses Plugin soll ein paar dieser Punkte abbilden.</div> <div>Technisch erweitert dieses Plugin die von Shopware existierende REST-API.</div> <div>Es werden spezifische Endpunkte zur Verfügung gestellt, die dann angesprochen werden können.</div> <div>Eine Übersicht hierzu finden Sie unten.</div> <div>&nbsp;</div> </div>
<div>Uns erreichen zunehmend Anfragen zur Ausleitung von bestimmten Sage100/ERP Daten in Richtung Shopware, um dort zusätzliche Funktionen &nbsp;wie z.B. Kundenstamm-Import, kundenspezifische Preise oder Erstellungsmöglichkeiten von Verkaufsstatistiken abbilden zu können.</div> <div>&nbsp;</div> <div>Dieses Plugin soll ein paar dieser Punkte abbilden.</div> <div>Technisch erweitert dieses Plugin die von Shopware existierende REST-API.</div> <div>Es werden spezifische Endpunkte zur Verfügung gestellt, die dann angesprochen werden können.</div> <div>Eine Übersicht hierzu finden Sie unten.</div> <div>&nbsp;</div> </div> <div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output">
=== Inhalte/API Endpunkte ===
 
==== Shopware API Authentifizierung ====
 
{| border="1" cellpadding="1" cellspacing="1" style="width: 500px;"
|-
| style="width: 102px;" | Route
| style="width: 385px;" | /api/oauth/token
|-
| style="width: 102px;" | Request-Tpye
| style="width: 385px;" | POST
|-
| style="width: 102px;" | Request-Json
| style="width: 385px;" | <div>{</div> <div>&nbsp;&nbsp;&nbsp;&nbsp;"client_id":&nbsp;"administration",</div> <div>&nbsp;&nbsp;&nbsp;&nbsp;"grant_type":"password",</div> <div>&nbsp;&nbsp;&nbsp;&nbsp;"username":"<username>",</div> <div>&nbsp;&nbsp;&nbsp;&nbsp;"password":"<password>"</div> <div>}</div> <div>&nbsp;</div>
|-
| style="width: 102px;" | Response-Json
| style="width: 385px;" | <div>{</div> <div>&nbsp;&nbsp;&nbsp;&nbsp;"token_type":&nbsp;"Bearer",</div> <div>&nbsp;&nbsp;&nbsp;&nbsp;"expires_in":&nbsp;600,</div> <div>&nbsp;&nbsp;&nbsp;&nbsp;"access_token":&nbsp;"<Token>",</div> <div>&nbsp;&nbsp;&nbsp;&nbsp;"refresh_token":&nbsp;"<RefreshToken>"</div> <div>}</div> <div>&nbsp;</div>
|}
 
&nbsp;
 
Nach der erfolgreichen Authentifizierung wird dann bei den folgenden Endpunkt Requests ein Authorization Header mit "Bearer <Token>" angehängt.
 
&nbsp;
 
==== Statistik Import ====
 
{| border="1" cellpadding="1" cellspacing="1" style="width: 500px;"
|-
| style="width: 102px;" | Route
| style="width: 385px;" | /api/v3/omniseller/statistik
|-
| style="width: 102px;" | Request-Tpye
| style="width: 385px;" | POST
|-
| style="width: 102px;" | Request-Json
| style="width: 385px;" | <div>[{<br/> &nbsp; &nbsp; &nbsp; &nbsp; "kunde": "D100000",<br/> &nbsp; &nbsp; &nbsp; &nbsp; "periode": "2002003",<br/> &nbsp; &nbsp; &nbsp; &nbsp; "mandant": 123,<br/> &nbsp; &nbsp; &nbsp; &nbsp; "menge": "10,0000",<br/> &nbsp; &nbsp; &nbsp; &nbsp; "umsatz": "77,7900",<br/> &nbsp; &nbsp; &nbsp; &nbsp; "roherloes": "77,7900"<br/> &nbsp; &nbsp; }</div> <div>]</div>
|-
| style="width: 102px;" | Response-Json
| style="width: 385px;" | <div>{</div> <div>&nbsp;&nbsp;&nbsp;&nbsp;"status":&nbsp;"FINISHED",</div> <div>&nbsp;&nbsp;&nbsp;&nbsp;"successful":&nbsp;1,</div> <div>&nbsp;&nbsp;&nbsp;&nbsp;"inserts":&nbsp;0,</div> <div>&nbsp;&nbsp;&nbsp;&nbsp;"updates":&nbsp;1,</div> <div>&nbsp;&nbsp;&nbsp;&nbsp;"errors":&nbsp;0</div> <div>}</div>
|}
 
&nbsp;
<div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output">
==== B2BPreise ====
 
einfacher Request für Versionserfragung und Test ob Plugin installiert/aktiv
 
{{{!}} style="width: 500px;" border="1" cellspacing="1" cellpadding="1"
{{!}}-
{{!}} style="width: 102px;" {{!}} Route
{{!}} style="width: 385px;" {{!}} /api/v3/omniseller/b2bpricesCheck
{{!}}-
{{!}} style="width: 102px;" {{!}} Request-Tpye
{{!}} style="width: 385px;" {{!}} GET
{{!}}-
{{!}} style="width: 102px;" {{!}} Request-Json
{{!}} style="width: 385px;" {{!}} &nbsp;
{{!}}-
{{!}} style="width: 102px;" {{!}} Response-Json
{{!}} style="width: 385px;" {{!}} <div><div>{</div>
<div>&nbsp;&nbsp;&nbsp;&nbsp;"Installation":&nbsp;"OK",</div>
<div>&nbsp;&nbsp;&nbsp;&nbsp;"version":&nbsp;"1.0.2"</div>
<div>}</div></div>
{{!}}}
&nbsp;
 
Anlegen von B2B-Preise
 
{{{!}} style="width: 500px; height: 604px;" border="1" cellspacing="1" cellpadding="1"
{{!}}- style="height: 28px;"
{{!}} style="width: 103.271px; height: 28px;" {{!}} Route
{{!}} style="width: 389.729px; height: 28px;" {{!}} /api/v3/omniseller/b2bprices
{{!}}- style="height: 28px;"
{{!}} style="width: 103.271px; height: 28px;" {{!}} Request-Tpye
{{!}} style="width: 389.729px; height: 28px;" {{!}} POST
{{!}}- style="height: 362px;"
{{!}} style="width: 103.271px; height: 362px;" {{!}} Request-Json
{{!}} style="width: 389.729px; height: 362px;" {{!}} <div>[</div>
<div>&nbsp; &nbsp;&nbsp; {<br>&nbsp; &nbsp; &nbsp; &nbsp; "Company": "123",<br>&nbsp; &nbsp; &nbsp; &nbsp; "CustID": "D12345",</div>
<div>&nbsp; &nbsp; &nbsp; &nbsp; "Email":"example@htk.de",<br>&nbsp; &nbsp; &nbsp; &nbsp; "Item": "08154711",<br>&nbsp; &nbsp; &nbsp; &nbsp; "Variation": "0",<br>&nbsp; &nbsp; &nbsp; &nbsp; "Ref": "",</div>
<div>&nbsp; &nbsp; &nbsp; &nbsp; "AbMenge":"0",<br>&nbsp; &nbsp; &nbsp; &nbsp; "Price": "123,45",</div>
<div>&nbsp; &nbsp; &nbsp; &nbsp; "Discount": "10,00",</div>
<div>&nbsp; &nbsp; &nbsp; &nbsp; "IsBruttoPrice": true,</div>
<div>&nbsp; &nbsp; &nbsp; &nbsp; "AllowDiscount": true,</div>
<div>&nbsp; &nbsp; &nbsp; &nbsp; "UploadID": 1234657890<br>&nbsp; &nbsp; }</div>
<div>]</div>
{{!}}- style="height: 158px;"
{{!}} style="width: 103.271px; height: 158px;" {{!}} Response-Json
{{!}} style="width: 389.729px; height: 158px;" {{!}} <div>{</div>
<div>&nbsp;&nbsp;&nbsp;&nbsp;"status":&nbsp;"FINISHED",</div>
<div>&nbsp;&nbsp;&nbsp;&nbsp;"successful":&nbsp;1,</div>
<div>&nbsp;&nbsp;&nbsp;&nbsp;"inserts":&nbsp;0,</div>
<div>&nbsp;&nbsp;&nbsp;&nbsp;"updates":&nbsp;1,</div>
<div>&nbsp;&nbsp;&nbsp;&nbsp;"errors":&nbsp;0</div>
<div>}</div>
{{!}}}
&nbsp;
 
Ein Delete Request, der alle Einträge löscht, die eine alte UploadID haben. Bereinigt alte Einträge unmittelbar nach einer vollständigen B2BPrice Synchronisation


=== Inhalte/API Endpunkte ===
{{{!}} style="width: 500px; height: 197px;" border="1" cellspacing="1" cellpadding="1"
</div>
{{!}}- style="height: 28px;"
{{!}} style="width: 103.271px; height: 28px;" {{!}} Route
{{!}} style="width: 389.729px; height: 28px;" {{!}} /api/v3/omniseller/b2bpricesdeleteold
{{!}}- style="height: 28px;"
{{!}} style="width: 103.271px; height: 28px;" {{!}} Request-Tpye
{{!}} style="width: 389.729px; height: 28px;" {{!}} POST
{{!}}- style="height: 28px;"
{{!}} style="width: 103.271px; height: 28px;" {{!}} Request-Body
{{!}} style="width: 389.729px; height: 28px;" {{!}} "1234567890"
{{!}}- style="height: 113px;"
{{!}} style="width: 103.271px; height: 113px;" {{!}} Response-Json
{{!}} style="width: 389.729px; height: 113px;" {{!}} <div><div>{</div>
<div>&nbsp; &nbsp; &nbsp; &nbsp; "message":"Es wurden xx Einträge gelöscht",</div>
<div>&nbsp; &nbsp; &nbsp; &nbsp; "success":true</div>
<div>}</div></div>
{{!}}}
&nbsp;
 
Es können auch gezielt einzelne Preise gelöscht werden:
 
{{{!}} style="width: 500px;" border="1" cellspacing="1" cellpadding="1"
{{!}}-
{{!}} style="width: 102px;" {{!}} Route
{{!}} style="width: 385px;" {{!}} /api/v3/omniseller/b2bpricesDeleteSpecific
{{!}}-
{{!}} style="width: 102px;" {{!}} Request-Tpye
{{!}} style="width: 385px;" {{!}} POST
{{!}}-
{{!}} style="width: 102px;" {{!}} Request-Json
{{!}} style="width: 385px;" {{!}} <div>[&nbsp; &nbsp; &nbsp;</div>
<div>&nbsp; &nbsp; &nbsp; &nbsp;{<br>&nbsp; &nbsp;&nbsp; "Company": "123",<br>&nbsp; &nbsp;&nbsp; "CustID": "D12345",<br>&nbsp; &nbsp;&nbsp; "Item": "08154711",<br>&nbsp; &nbsp;&nbsp; "Variation": "0"<br>&nbsp; &nbsp; }</div>
<div>]</div>
{{!}}-
{{!}} style="width: 102px;" {{!}} Response-Json
{{!}} style="width: 385px;" {{!}} <div>{</div>
<div>&nbsp;&nbsp;&nbsp; "status":"FINISHED",</div>
<div>&nbsp;&nbsp;&nbsp; "successful":1,</div>
<div>&nbsp;&nbsp;&nbsp; "errors":0,</div>
<div>&nbsp; &nbsp; "deleted":1</div>
<div>}</div>
{{!}}-
{{!}} style="width: 102px;" {{!}} &nbsp;
{{!}} style="width: 385px;" {{!}} &nbsp;
{{!}}}
&nbsp;
<div class="mw-parser-output">&nbsp;</div>
 
==== Kundenimport ====
 
{| border="1" cellpadding="1" cellspacing="1" style="width: 500px;"
|-
| style="width: 102px;" | Route
| style="width: 385px;" | /api/v3/omniseller/customersImport
|-
| style="width: 102px;" | Request-Tpye
| style="width: 385px;" | POST
|-
| style="width: 102px;" | Request-Json
| style="width: 385px;" | <div><div>[{<br/> &nbsp;&nbsp; &nbsp;"Kto_Aktiv":"1",<br/> &nbsp;&nbsp; &nbsp;"Kto":"D10000",<br/> &nbsp;&nbsp; &nbsp;"AdressID":"12345",<br/> &nbsp;&nbsp; &nbsp;"EUUStID":"DE 12345677",<br/> &nbsp;&nbsp; &nbsp;"EULand":"DE",<br/> &nbsp;&nbsp; &nbsp;"Sprache":"DE",<br/> &nbsp;&nbsp; &nbsp;"Rabattgruppe":"R1",<br/> &nbsp;&nbsp; &nbsp;"Rabattsatz":"20",&nbsp;<br/> &nbsp;&nbsp; &nbsp;"Istgesperrt":0,<br/> &nbsp;&nbsp; &nbsp;"Zahlungskondition":"Vorkasse",&nbsp;<br/> &nbsp;&nbsp; &nbsp;"Vertreter":"",<br/> &nbsp;&nbsp; &nbsp;"Adressgruppe":"",<br/> &nbsp;&nbsp; &nbsp;"Ansprechpartner_Nummer":"123546",&nbsp;<br/> &nbsp;&nbsp; &nbsp;"EMail":"mh@htk.de",<br/> &nbsp;&nbsp; &nbsp;"Anrede":"Herr",<br/> &nbsp;&nbsp; &nbsp;"Ansprechpartner":"",<br/> &nbsp;&nbsp; &nbsp;"Vorname":"Marvin",<br/> &nbsp;&nbsp; &nbsp;"Nachname":"Harant",<br/> &nbsp;&nbsp; &nbsp;"Typ":"L",<br/> &nbsp;&nbsp; &nbsp;"Name1":"",<br/> &nbsp;&nbsp; &nbsp;"Name2":"",<br/> &nbsp;&nbsp; &nbsp;"Lieferstrasse":"In der Nauroth 2",<br/> &nbsp;&nbsp; &nbsp;"LieferPLZ":"67158",<br/> &nbsp;&nbsp; &nbsp;"LieferOrt":"Ellerstadt",<br/> &nbsp;&nbsp; &nbsp;"Lieferzusatz":"",<br/> &nbsp;&nbsp; &nbsp;"Lieferland":"DE",<br/> &nbsp;&nbsp; &nbsp;"Telefon":"06237 306010",<br/> &nbsp;&nbsp; &nbsp;"Telefax":""</div> <div>}</div> <div>]</div> </div>
|-
| style="width: 102px;" | Response-Json
| style="width: 385px;" | <div>{</div> <div>&nbsp;&nbsp;&nbsp;&nbsp;"status":&nbsp;"FINISHED",</div> <div>&nbsp;&nbsp;&nbsp;&nbsp;"successful":&nbsp;1,</div> <div>&nbsp; &nbsp; "inserts":10,</div> <div>&nbsp; &nbsp; "updates":2,&nbsp;</div> <div>&nbsp;&nbsp;&nbsp;&nbsp;"errors":&nbsp;0</div> <div>}</div>
|-
| style="width: 102px;" | &nbsp;
| style="width: 385px;" | &nbsp;
|}
 
&nbsp;
 
<div class="mw-parser-output">
<div class="mw-parser-output">
<div class="mw-parser-output">
= Installation =
<div>Da das Plugin in dieser Form (noch) nicht im Shopware Store existiert muss dieses manuell über das Shopware Backend installiert werden.</div> <div>Bei neuen Shopware6 Versionen (6.4+) gibt es links ein Feld "Erweiterungen". Dort kann dann unter "meine Erweiterungen" das Zip File hochgeladen werden. Anschließend über die 3 Punkte installieren und zuletzt aktivieren.</div> <div>Bei älteren Shopware6 Versionen ist das Prinzip das gleiche, nur ist die Plugin Seite links im Menü unter Einstellungen->System->Plugins zu finden.</div> </div></div>
MH
Administratoren
1.348

Bearbeitungen

Abgerufen von „https://wiki.htk.de/Spezial:Mobiler_Unterschied/1735...2093“

Navigationsmenü