HVS32 SOAP Interface (Interactive): Unterschied zwischen den Versionen

Aus Wiki - Heidler Strichcode GmbH
Zur Navigation springen Zur Suche springen
Zeile 1: Zeile 1:
 
[[de:HVS32_SOAP_Schnittstelle_(Interaktiv)]]
 
[[de:HVS32_SOAP_Schnittstelle_(Interaktiv)]]
 +
 +
= prerequisites =
 +
{| class="wikitable"
 +
|-
 +
| DGS-Version || 3.6.0.588 oder höher
 +
|-
 +
| DGS-Plugins || HVS32Server, SOAP Client
 +
|}
 +
= Function description =
 +
In interactive processing, requests are made from the dispatch system to your SOAP server. Thereby the DGS acts as SOAP Client.<br>
 +
This gives you the possibility, for example, to request shipping data for a reference number (e.g. delivery note number) from the HVS32. The functionalities available to you can be found under [[#Verfügbare HVS32 Funktionen|Verfügbare HVS32 Funktionen]].
 +
 +
The DataGatewayServer (DGS) is the central communication unit through which all data is exchanged between the shipping system and the host system. It runs as a service on a 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.
 +
<br><br>
 +
'''[[HVS32_Funktionen_Interaktiv|Verfügbare HVS32 Funktionen]]'''
 +
 +
= 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">
 +
;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>
 +
 +
;Rückmeldung vom SOAP Server an den DGS zur obigen Anfrage
 +
<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 =

Version vom 6. September 2021, 12:27 Uhr


prerequisites

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

Function description

In interactive processing, requests are made from the dispatch system to your SOAP server. Thereby the DGS acts as SOAP Client.
This gives you the possibility, for example, to request shipping data for a reference number (e.g. delivery note number) from the HVS32. The functionalities available to you can be found under Verfügbare HVS32 Funktionen.

The DataGatewayServer (DGS) is the central communication unit through which all data is exchanged between the shipping system and the host system. It runs as a service on a 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
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>
Rückmeldung vom SOAP Server an den DGS zur obigen Anfrage
<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_Interface_(Interactive)&oldid=3659“