HVS32 SOAP Schnittstelle (Interaktiv): Unterschied zwischen den Versionen

Aus Wiki - Heidler Strichcode GmbH
Zur Navigation springen Zur Suche springen
Zeile 1: Zeile 1:
 +
= Voraussetzungen =
 +
{| class="wikitable"
 +
|-
 +
| DGS-Version || 3.6.0.588 oder höher
 +
|-
 +
| DGS-Plugins || HVS32Server, SOAP Client
 +
|}
 
= Funktionsbeschreibung =
 
= Funktionsbeschreibung =
 +
Bei einer interaktiven Verarbeitung werden Anfragen aus dem Versandsystem heraus an Ihren SOAP Server gestellt. Dabei agiert der DGS als SOAP Client.<br>
 +
Dadurch hat man zum Beispiel die Möglichkeit, aus dem HVS32 heraus Versanddaten zur einer Referenznummer (z.B. Lieferscheinnummer) anzufragen. Die Ihnen zur Verfügung stehenden Funktionalitäten können Sie unter [[#Verfügbare HVS32 Funktionen|Verfügbare HVS32 Funktionen]] entnehmen.
  
−
= Voraussetzungen =
+
Der DGS ist die zentrale Kommunikationseinheit, über die sämtliche Daten zwischen dem Versandsystem und dem SAP-System ausgetauscht werden. Er läuft in Form eines Dienstes auf einem Windows-Server.
 +
= Verfügbare HVS32 Funktionen =
 +
Artikel-Daten und Gefahrgut-Informationen stehen in einer 1:n Beziehung zu den Packstückdaten.
  
−
= Verfügbare HVS32 Funktionen =
+
Bitte beachten Sie, dass die Feld-Beschreibungen sich nur auf einen Standard beziehen, welcher als Vorschlag für die Schnittstelle dienen soll. Funktionsnamen, Feldnamen /-längen /-formate können prinzipiell abweichen, müssen in diesem Fall jedoch individuell betrachtet/analysiert werden.
 +
<br><br>
 
[[HVS32_Funktionen_Interaktiv|Verfügbare HVS32 Funktionen]]
 
[[HVS32_Funktionen_Interaktiv|Verfügbare HVS32 Funktionen]]
  
 
= Beispiele =
 
= Beispiele =
 +
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 +
<div style="font-weight:bold;line-height:1.6;">'''VersandDatenAnfrage'''</div>
 +
<div class="mw-collapsible-content">
 +
;Request (Anfrage vom DGS an den SOAP Server)
 +
<source>
 +
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:std="http://my.path.to.endpoint.functions">
 +
<soapenv:Header/>
 +
<soapenv:Body>
 +
<std:my_function>
 +
<arg0>
 +
<item>LS-123</item>
 +
</arg0>
 +
</std:my_function>
 +
</soapenv:Body>
 +
</soapenv:Envelope>
 +
</source>
  
 +
;Response (Rückmeldung vom SOAP Server an den DGS
 +
<source>
 +
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
 +
  <S:Body>
 +
      <ns2:my_function_Response xmlns:ns2="http://my.path.to.endpoint">
 +
        <return>
 +
            <AUFTRAGGEBERID>01</AUFTRAGGEBERID>
 +
            <LIEFERSCHEINNR>LS-123</LIEFERSCHEINNR>
 +
            <PACKSTUECKID>PID-53185</PACKSTUECKID>
 +
            <VERSANDARTID>UPS</VERSANDARTID>
 +
            <ZIELADRLKZ>D</ZIELADRLKZ>
 +
            <ZIELADRNAME1>Heidler Strichcode GmbH</ZIELADRNAME1>
 +
            <ZIELADRORT>Wolfschlugen</ZIELADRORT>
 +
            <ZIELADRPLZ>72649</ZIELADRORT>
 +
            <ZIELADRSTRASSE>Max-Eyth-Straße 25</ZIELADRORT>
 +
        </return>
 +
      </ns2:my_function_Response>
 +
  </S:Body>
 +
</S:Envelope>
 +
</source>
 +
</div></div>
 +
<br>
 +
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 +
<div style="font-weight:bold;line-height:1.6;">'''PaketscheinDruckMeldung'''</div>
 +
<div class="mw-collapsible-content">
 +
<source>
 +
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:std="http://my.path.to.endpoint.functions">
 +
<soapenv:Header/>
 +
<soapenv:Body>
 +
<std:my_function>
 +
<arg0>
 +
<AUSGANGDATETIME>28.04.2020</AUSGANGDATETIME>
 +
<DRUCKDATETIME>28.04.2020 15:23:45</DRUCKDATETIME>
 +
<FEHLERTEXT1/>
 +
<FEHLERTEXT2/>
 +
<GEBUEHR>5.30</GEBUEHR>
 +
<GEBUEHRWAEHRUNG>EUR</GEBUEHRWAEHRUNG>
 +
<PACKSTUECKID>PID-53185</PACKSTUECKID>
 +
<RETOURTRACKINGNR/>
 +
<TRACKINGNR>1Z0000DE6860000014</TRACKINGNR>
 +
</arg0>
 +
</std:my_function>
 +
</soapenv:Body>
 +
</soapenv:Envelope>
 +
</source>
 +
</div></div>
 +
<br>
 +
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 +
<div style="font-weight:bold;line-height:1.6;">'''AusgangsListenRueckmeldung'''</div>
 +
<div class="mw-collapsible-content">
 +
<source>
 +
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:std="http://my.path.to.endpoint.functions">
 +
<soapenv:Header/>
 +
<soapenv:Body>
 +
<std:my_function>
 +
<arg0>
 +
<PACKSTUECK>
 +
<PACKSTUECKID>PID-102</PACKSTUECKID>
 +
<TRACKINGNR>889000232</TRACKINGNR>
 +
</PACKSTUECK>
 +
<PACKSTUECK>
 +
<PACKSTUECKID>PID-100</PACKSTUECKID>
 +
<TRACKINGNR>889000221</TRACKINGNR>
 +
</PACKSTUECK>
 +
<PACKSTUECK>
 +
<PACKSTUECKID>PID-101</PACKSTUECKID>
 +
<TRACKINGNR>889000221</TRACKINGNR>
 +
</PACKSTUECK>
 +
<PACKSTUECK>
 +
<PACKSTUECKID>PID-104</PACKSTUECKID>
 +
<TRACKINGNR>889000243</TRACKINGNR>
 +
</PACKSTUECK>
 +
<PACKSTUECK>
 +
<PACKSTUECKID>PID-105</PACKSTUECKID>
 +
<TRACKINGNR>889000243</TRACKINGNR>
 +
</PACKSTUECK>
 +
<PACKSTUECK>
 +
<PACKSTUECKID>PID-106</PACKSTUECKID>
 +
<TRACKINGNR>889000243</TRACKINGNR>
 +
</PACKSTUECK>
 +
</arg0>
 +
</std:my_function>
 +
</soapenv:Body>
 +
</soapenv:Envelope>
 +
</source>
 +
</div></div>
 
= FAQ / Troubleshooting =
 
= FAQ / Troubleshooting =

Version vom 28. April 2020, 15:30 Uhr

Voraussetzungen

DGS-Version 3.6.0.588 oder höher
DGS-Plugins HVS32Server, SOAP Client

Funktionsbeschreibung

Bei einer interaktiven Verarbeitung werden Anfragen aus dem Versandsystem heraus an Ihren SOAP Server gestellt. Dabei agiert der DGS als SOAP Client.
Dadurch hat man zum Beispiel die Möglichkeit, aus dem HVS32 heraus Versanddaten zur einer Referenznummer (z.B. Lieferscheinnummer) anzufragen. Die Ihnen zur Verfügung stehenden Funktionalitäten können Sie unter Verfügbare HVS32 Funktionen entnehmen.

Der DGS ist die zentrale Kommunikationseinheit, über die sämtliche Daten zwischen dem Versandsystem und dem SAP-System ausgetauscht werden. Er läuft in Form eines Dienstes auf einem Windows-Server.

Verfügbare HVS32 Funktionen

Artikel-Daten und Gefahrgut-Informationen stehen in einer 1:n Beziehung zu den Packstückdaten.

Bitte beachten Sie, dass die Feld-Beschreibungen sich nur auf einen Standard beziehen, welcher als Vorschlag für die Schnittstelle dienen soll. Funktionsnamen, Feldnamen /-längen /-formate können prinzipiell abweichen, müssen in diesem Fall jedoch individuell betrachtet/analysiert werden.

Verfügbare HVS32 Funktionen

Beispiele

VersandDatenAnfrage
Request (Anfrage vom DGS an den SOAP Server)
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:std="http://my.path.to.endpoint.functions">
	<soapenv:Header/>
	<soapenv:Body>
		<std:my_function>
			<arg0>
				<item>LS-123</item>
			</arg0>
		</std:my_function>
	</soapenv:Body>
</soapenv:Envelope>
Response (Rückmeldung vom SOAP Server an den DGS
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <ns2:my_function_Response xmlns:ns2="http://my.path.to.endpoint">
         <return>
            <AUFTRAGGEBERID>01</AUFTRAGGEBERID>
            <LIEFERSCHEINNR>LS-123</LIEFERSCHEINNR>
            <PACKSTUECKID>PID-53185</PACKSTUECKID>
            <VERSANDARTID>UPS</VERSANDARTID>
            <ZIELADRLKZ>D</ZIELADRLKZ>
            <ZIELADRNAME1>Heidler Strichcode GmbH</ZIELADRNAME1>
            <ZIELADRORT>Wolfschlugen</ZIELADRORT>
            <ZIELADRPLZ>72649</ZIELADRORT>
            <ZIELADRSTRASSE>Max-Eyth-Straße 25</ZIELADRORT>
         </return>
      </ns2:my_function_Response>
   </S:Body>
</S:Envelope>


PaketscheinDruckMeldung
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:std="http://my.path.to.endpoint.functions">
	<soapenv:Header/>
	<soapenv:Body>
		<std:my_function>
			<arg0>
				<AUSGANGDATETIME>28.04.2020</AUSGANGDATETIME>
				<DRUCKDATETIME>28.04.2020 15:23:45</DRUCKDATETIME>
				<FEHLERTEXT1/>
				<FEHLERTEXT2/>
				<GEBUEHR>5.30</GEBUEHR>
				<GEBUEHRWAEHRUNG>EUR</GEBUEHRWAEHRUNG>
				<PACKSTUECKID>PID-53185</PACKSTUECKID>
				<RETOURTRACKINGNR/>
				<TRACKINGNR>1Z0000DE6860000014</TRACKINGNR>
			</arg0>
		</std:my_function>
	</soapenv:Body>
</soapenv:Envelope>


AusgangsListenRueckmeldung
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:std="http://my.path.to.endpoint.functions">
	<soapenv:Header/>
	<soapenv:Body>
		<std:my_function>
			<arg0>
				<PACKSTUECK>
					<PACKSTUECKID>PID-102</PACKSTUECKID>
					<TRACKINGNR>889000232</TRACKINGNR>
				</PACKSTUECK>
				<PACKSTUECK>
					<PACKSTUECKID>PID-100</PACKSTUECKID>
					<TRACKINGNR>889000221</TRACKINGNR>
				</PACKSTUECK>
				<PACKSTUECK>
					<PACKSTUECKID>PID-101</PACKSTUECKID>
					<TRACKINGNR>889000221</TRACKINGNR>
				</PACKSTUECK>
				<PACKSTUECK>
					<PACKSTUECKID>PID-104</PACKSTUECKID>
					<TRACKINGNR>889000243</TRACKINGNR>
				</PACKSTUECK>
				<PACKSTUECK>
					<PACKSTUECKID>PID-105</PACKSTUECKID>
					<TRACKINGNR>889000243</TRACKINGNR>
				</PACKSTUECK>
				<PACKSTUECK>
					<PACKSTUECKID>PID-106</PACKSTUECKID>
					<TRACKINGNR>889000243</TRACKINGNR>
				</PACKSTUECK>
			</arg0>
		</std:my_function>
	</soapenv:Body>
</soapenv:Envelope>

FAQ / Troubleshooting

Abgerufen von „https://wiki.heidler-strichcode.de/w/index.php?title=HVS32_SOAP_Schnittstelle_(Interaktiv)&oldid=2785“