HVS32 SOAP Schnittstelle (Interaktiv): Unterschied zwischen den Versionen

Aus Wiki - Heidler Strichcode GmbH
Zur Navigation springen Zur Suche springen
 
(7 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 23: Zeile 23:
 
= Beispiele =
 
= Beispiele =
 
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
−
<div style="font-weight:bold;line-height:1.6;">'''VersandDatenAnfrage'''</div>
+
<div style="font-weight:bold;line-height:1.6;">'''VersandDatenAnfrage ([https://wiki.heidler-strichcode.de/w/index.php?title=HVS32_Funktionen_Interaktiv#Datenanfragemeldung_.28VersandDatenAnfrage.29 Datenanfragemeldung])'''</div>
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 
Anfrage vom DGS an den SOAP Server
 
Anfrage vom DGS an den SOAP Server
Zeile 69: Zeile 69:
 
             <ARTIKELBTNNR>124</ARTIKELBTNNR>
 
             <ARTIKELBTNNR>124</ARTIKELBTNNR>
 
             <ARTIKELGEWICHT>0.25</ARTIKELGEWICHT>
 
             <ARTIKELGEWICHT>0.25</ARTIKELGEWICHT>
−
             <ARTIKELMENGE>2</ARTIKELMENGE>
+
             <ARTIKELMENGE>1</ARTIKELMENGE>
 
             <ARTIKELTEXT1>Testartikel 2</ARTIKELTEXT1>
 
             <ARTIKELTEXT1>Testartikel 2</ARTIKELTEXT1>
 
             <ARTIKELTEXT2/>
 
             <ARTIKELTEXT2/>
Zeile 81: Zeile 81:
 
<br>
 
<br>
 
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
−
<div style="font-weight:bold;line-height:1.6;">'''PaketscheinDruckMeldung'''</div>
+
<div style="font-weight:bold;line-height:1.6;">'''PaketscheinDruckMeldung ([https://wiki.heidler-strichcode.de/w/index.php?title=HVS32_Funktionen_Interaktiv#R.C3.BCckmeldung_der_Lieferscheindaten_.28LieferscheinRueckMeldung.29 Rückmeldung der Paketscheindaten])'''</div>
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 
Anfrage vom DGS an den SOAP Server
 
Anfrage vom DGS an den SOAP Server
Zeile 89: Zeile 89:
 
   <soapenv:Body>
 
   <soapenv:Body>
 
       <soap:PaketscheinDruckMeldung>
 
       <soap:PaketscheinDruckMeldung>
−
         <AUSGANGDATETIME>05.01.2022</AUSGANGDATETIME>
+
        <AUFTRAGGEBERID>01</AUFTRAGGEBERID>
−
         <DRUCKDATETIME>05.01.2022</DRUCKDATETIME>
+
         <AUSGANGDATETIME>01.01.2021</AUSGANGDATETIME>
 +
         <DRUCKDATETIME>01.01.2021</DRUCKDATETIME>
 
         <FEHLER/>
 
         <FEHLER/>
 
         <FEHLERTEXT1/>
 
         <FEHLERTEXT1/>
−
         <GEBUEHR>6.50</GEBUEHR>
+
         <FRACHTFUEHRERTYP>DPD</FRACHTFUEHRERTYP>
−
        <GEBUEHRWAEHRUNG>EUR</GEBUEHRWAEHRUNG>
+
         <GEWICHT>0.700</GEWICHT>
−
         <GEWICHT>1.200</GEWICHT>
 
 
         <LIEFERSCHEINNR>LS-123</LIEFERSCHEINNR>
 
         <LIEFERSCHEINNR>LS-123</LIEFERSCHEINNR>
−
         <PACKSTKGES>1</PACKSTKGES>
+
         <PACKSTKGES>2</PACKSTKGES>
 
         <PACKSTKNR>1</PACKSTKNR>
 
         <PACKSTKNR>1</PACKSTKNR>
 
         <RETOURTRACKINGNR/>
 
         <RETOURTRACKINGNR/>
−
         <TRACKINGNR>05190</TRACKINGNR>
+
         <TRACKINGNR>00112233445566778899</TRACKINGNR>
 +
        <VERPACKUNGSART>KT</VERPACKUNGSART>
 
       </soap:PaketscheinDruckMeldung>
 
       </soap:PaketscheinDruckMeldung>
 
   </soapenv:Body>
 
   </soapenv:Body>
Zeile 110: Zeile 111:
 
   <soapenv:Header/>
 
   <soapenv:Header/>
 
   <soapenv:Body>
 
   <soapenv:Body>
−
       <soap:ArtikelRueckMeldungResponse>
+
       <soap:PaketscheinDruckMeldungResponse>
 
         <FEHLER/>
 
         <FEHLER/>
 
         <FEHLERTEXT1/>
 
         <FEHLERTEXT1/>
−
       </soap:ArtikelRueckMeldungResponse>
+
       </soap:PaketscheinDruckMeldungResponse>
 
   </soapenv:Body>
 
   </soapenv:Body>
 
</soapenv:Envelope>
 
</soapenv:Envelope>
Zeile 119: Zeile 120:
 
<br>
 
<br>
 
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
−
<div style="font-weight:bold;line-height:1.6;">'''PaketscheinDruckMeldung'''</div>
+
<div style="font-weight:bold;line-height:1.6;">'''ArtikelRueckMeldung ([https://wiki.heidler-strichcode.de/w/index.php?title=HVS32_Funktionen_Interaktiv#R.C3.BCckmeldung_der_Positionsdaten_.28Artikel.29_.28ArtikelRueckMeldung.29 Rückmeldung der Positionsdaten])'''</div>
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 
Anfrage vom DGS an den SOAP Server
 
Anfrage vom DGS an den SOAP Server
Zeile 127: Zeile 128:
 
   <soapenv:Body>
 
   <soapenv:Body>
 
       <soap:ArtikelRueckMeldung>
 
       <soap:ArtikelRueckMeldung>
 +
        <LIEFERSCHEINNR>LS-123</LIEFERSCHEINNR>
 
         <ArtikelDaten>
 
         <ArtikelDaten>
 
             <ARTIKELBTNNR>123</ARTIKELBTNNR>
 
             <ARTIKELBTNNR>123</ARTIKELBTNNR>
 
             <ARTIKELMENGE>1</ARTIKELMENGE>
 
             <ARTIKELMENGE>1</ARTIKELMENGE>
 
             <KUNDENARTIKELNR>0123456789</KUNDENARTIKELNR>
 
             <KUNDENARTIKELNR>0123456789</KUNDENARTIKELNR>
−
            <LIEFERSCHEINNR>LS-123</LIEFERSCHEINNR>
+
             <PACKSTKGES>2</PACKSTKGES>
−
             <PACKSTKGES>1</PACKSTKGES>
 
 
             <PACKSTKNR>1</PACKSTKNR>
 
             <PACKSTKNR>1</PACKSTKNR>
 
             <POSITIONNR>1</POSITIONNR>
 
             <POSITIONNR>1</POSITIONNR>
Zeile 139: Zeile 140:
 
         <ArtikelDaten>
 
         <ArtikelDaten>
 
             <ARTIKELBTNNR>124</ARTIKELBTNNR>
 
             <ARTIKELBTNNR>124</ARTIKELBTNNR>
−
             <ARTIKELMENGE>2</ARTIKELMENGE>
+
             <ARTIKELMENGE>1</ARTIKELMENGE>
 
             <KUNDENARTIKELNR>0123456790</KUNDENARTIKELNR>
 
             <KUNDENARTIKELNR>0123456790</KUNDENARTIKELNR>
−
            <LIEFERSCHEINNR>LS-123</LIEFERSCHEINNR>
+
             <PACKSTKGES>2</PACKSTKGES>
−
             <PACKSTKGES>1</PACKSTKGES>
+
             <PACKSTKNR>2</PACKSTKNR>
−
             <PACKSTKNR>1</PACKSTKNR>
 
 
             <POSITIONNR>2</POSITIONNR>
 
             <POSITIONNR>2</POSITIONNR>
−
             <TRACKINGNR>00112233445566778899</TRACKINGNR>
+
             <TRACKINGNR>00112233445566778900</TRACKINGNR>
 
         </ArtikelDaten>
 
         </ArtikelDaten>
 
       </soap:ArtikelRueckMeldung>
 
       </soap:ArtikelRueckMeldung>
Zeile 160: Zeile 160:
 
         <FEHLERTEXT1/>
 
         <FEHLERTEXT1/>
 
       </soap:ArtikelRueckMeldungResponse>
 
       </soap:ArtikelRueckMeldungResponse>
 +
  </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 ([https://wiki.heidler-strichcode.de/w/index.php?title=HVS32_Funktionen_Interaktiv#R.C3.BCckmeldung_der_Ausgangslisten_.28AusgangslistenRueckMeldung.29 Rückmeldung der Ausgangslisten])'''</div>
 +
<div class="mw-collapsible-content">
 +
Anfrage vom DGS an den SOAP Server
 +
<source lang="xml">
 +
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="http://soap.server.test/">
 +
  <soapenv:Header/>
 +
  <soapenv:Body>
 +
      <soap:AusgangslistenRueckMeldung>
 +
        <ListenDaten>
 +
            <AUFTRAGGEBERID>01</AUFTRAGGEBERID>
 +
            <AUSGANGDATETIME>01.01.2021</AUSGANGDATETIME>
 +
            <DRUCKDATETIME>01.01.2021</DRUCKDATETIME>
 +
            <FRACHTFUEHRERTYP>DPD</FRACHTFUEHRERTYP>
 +
            <GEWICHT>0.700</GEWICHT>
 +
            <LIEFERSCHEINNR>LS-123</LIEFERSCHEINNR>
 +
            <PACKSTKGES>2</PACKSTKGES>
 +
            <PACKSTKNR>1</PACKSTKNR>
 +
            <RETOURTRACKINGNR/>
 +
            <TRACKINGNR>00112233445566778899</TRACKINGNR>
 +
        </ListenDaten>
 +
        <ListenDaten>
 +
            <AUFTRAGGEBERID>01</AUFTRAGGEBERID>
 +
            <AUSGANGDATETIME>01.01.2021</AUSGANGDATETIME>
 +
            <DRUCKDATETIME>01.01.2021</DRUCKDATETIME>
 +
            <FRACHTFUEHRERTYP>DPD</FRACHTFUEHRERTYP>
 +
            <GEWICHT>0.500</GEWICHT>
 +
            <LIEFERSCHEINNR>LS-123</LIEFERSCHEINNR>
 +
            <PACKSTKGES>2</PACKSTKGES>
 +
            <PACKSTKNR>2</PACKSTKNR>
 +
            <RETOURTRACKINGNR/>
 +
            <TRACKINGNR>00112233445566778900</TRACKINGNR>
 +
        </ListenDaten>
 +
      </soap:AusgangslistenRueckMeldung>
 +
  </soapenv:Body>
 +
</soapenv:Envelope>
 +
</source>
 +
<br>
 +
Rückmeldung vom SOAP Server an den DGS zur obigen Anfrage<source lang="xml">
 +
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="http://soap.server.test/">
 +
  <soapenv:Header/>
 +
  <soapenv:Body>
 +
      <soap:AusgangslistenRueckMeldungResponse>
 +
        <FEHLER/>
 +
        <FEHLERTEXT1/>
 +
      </soap:AusgangslistenRueckMeldungResponse>
 
   </soapenv:Body>
 
   </soapenv:Body>
 
</soapenv:Envelope>
 
</soapenv:Envelope>

Aktuelle Version vom 20. Januar 2022, 15:24 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 DataGatewayServer (DGS) ist die zentrale Kommunikationseinheit, über die sämtliche Daten zwischen dem Versandsystem und dem Hostsystem 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 (Datenanfragemeldung)

Anfrage vom DGS an den SOAP Server 

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="http://soap.server.test/">
   <soapenv:Header/>
   <soapenv:Body>
      <soap:VersandDatenAnfrage>
         <LIEFERSCHEINNR>LS-123</LIEFERSCHEINNR>
      </soap:VersandDatenAnfrage>
   </soapenv:Body>
</soapenv:Envelope>


Rückmeldung vom SOAP Server an den DGS zur obigen Anfrage 

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="http://soap.server.test/">
   <soapenv:Header/>
   <soapenv:Body>
      <soap:VersandDatenAnfrageResponse>
         <AUFTRAGGEBERID>01</AUFTRAGGEBERID>
         <AUFTRAGNR>A1234</AUFTRAGNR>
         <FEHLER/>
         <FEHLERTEXT1/>
         <KUNDENNR>KD123</KUNDENNR>
         <LIEFERSCHEINNR>LS-123</LIEFERSCHEINNR>
         <VERSANDARTID>DPD</VERSANDARTID>
         <ZIELADRLKZ>D</ZIELADRLKZ>
         <ZIELADRNAME1>Heidler Strichcode GmbH</ZIELADRNAME1>
         <ZIELADRNAME2>Wareneingang</ZIELADRNAME2>
         <ZIELADRNAME3/>
         <ZIELADRORT>Wolfschlugen</ZIELADRORT>
         <ZIELADRPLZ>72649</ZIELADRPLZ>
         <ZIELADRSTRASSE>Max-Eyth-Straße 25</ZIELADRSTRASSE>
         <ArtikelDaten>
            <ARTIKELBTNNR>123</ARTIKELBTNNR>
            <ARTIKELGEWICHT>0.5</ARTIKELGEWICHT>
            <ARTIKELMENGE>1</ARTIKELMENGE>
            <ARTIKELTEXT1>Testartikel 1</ARTIKELTEXT1>
            <ARTIKELTEXT2/>
            <KUNDENARTIKELNR>0123456789</KUNDENARTIKELNR>
            <POSITIONNR>1</POSITIONNR>
         </ArtikelDaten>
         <ArtikelDaten>
            <ARTIKELBTNNR>124</ARTIKELBTNNR>
            <ARTIKELGEWICHT>0.25</ARTIKELGEWICHT>
            <ARTIKELMENGE>1</ARTIKELMENGE>
            <ARTIKELTEXT1>Testartikel 2</ARTIKELTEXT1>
            <ARTIKELTEXT2/>
            <KUNDENARTIKELNR>0123456790</KUNDENARTIKELNR>
            <POSITIONNR>2</POSITIONNR>
         </ArtikelDaten>
      </soap:VersandDatenAnfrageResponse>
   </soapenv:Body>
</soapenv:Envelope>


PaketscheinDruckMeldung (Rückmeldung der Paketscheindaten)

Anfrage vom DGS an den SOAP Server 

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="http://soap.server.test/">
   <soapenv:Header/>
   <soapenv:Body>
      <soap:PaketscheinDruckMeldung>
         <AUFTRAGGEBERID>01</AUFTRAGGEBERID>
         <AUSGANGDATETIME>01.01.2021</AUSGANGDATETIME>
         <DRUCKDATETIME>01.01.2021</DRUCKDATETIME>
         <FEHLER/>
         <FEHLERTEXT1/>
         <FRACHTFUEHRERTYP>DPD</FRACHTFUEHRERTYP>
         <GEWICHT>0.700</GEWICHT>
         <LIEFERSCHEINNR>LS-123</LIEFERSCHEINNR>
         <PACKSTKGES>2</PACKSTKGES>
         <PACKSTKNR>1</PACKSTKNR>
         <RETOURTRACKINGNR/>
         <TRACKINGNR>00112233445566778899</TRACKINGNR>
         <VERPACKUNGSART>KT</VERPACKUNGSART>
      </soap:PaketscheinDruckMeldung>
   </soapenv:Body>
</soapenv:Envelope>


Rückmeldung vom SOAP Server an den DGS zur obigen Anfrage
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="http://soap.server.test/">
   <soapenv:Header/>
   <soapenv:Body>
      <soap:PaketscheinDruckMeldungResponse>
         <FEHLER/>
         <FEHLERTEXT1/>
      </soap:PaketscheinDruckMeldungResponse>
   </soapenv:Body>
</soapenv:Envelope>


ArtikelRueckMeldung (Rückmeldung der Positionsdaten)

Anfrage vom DGS an den SOAP Server 

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="http://soap.server.test/">
   <soapenv:Header/>
   <soapenv:Body>
      <soap:ArtikelRueckMeldung>
         <LIEFERSCHEINNR>LS-123</LIEFERSCHEINNR>
         <ArtikelDaten>
            <ARTIKELBTNNR>123</ARTIKELBTNNR>
            <ARTIKELMENGE>1</ARTIKELMENGE>
            <KUNDENARTIKELNR>0123456789</KUNDENARTIKELNR>
            <PACKSTKGES>2</PACKSTKGES>
            <PACKSTKNR>1</PACKSTKNR>
            <POSITIONNR>1</POSITIONNR>
            <TRACKINGNR>00112233445566778899</TRACKINGNR>
         </ArtikelDaten>
         <ArtikelDaten>
            <ARTIKELBTNNR>124</ARTIKELBTNNR>
            <ARTIKELMENGE>1</ARTIKELMENGE>
            <KUNDENARTIKELNR>0123456790</KUNDENARTIKELNR>
            <PACKSTKGES>2</PACKSTKGES>
            <PACKSTKNR>2</PACKSTKNR>
            <POSITIONNR>2</POSITIONNR>
            <TRACKINGNR>00112233445566778900</TRACKINGNR>
         </ArtikelDaten>
      </soap:ArtikelRueckMeldung>
   </soapenv:Body>
</soapenv:Envelope>


Rückmeldung vom SOAP Server an den DGS zur obigen Anfrage
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="http://soap.server.test/">
   <soapenv:Header/>
   <soapenv:Body>
      <soap:ArtikelRueckMeldungResponse>
         <FEHLER/>
         <FEHLERTEXT1/>
      </soap:ArtikelRueckMeldungResponse>
   </soapenv:Body>
</soapenv:Envelope>


AusgangslistenRueckMeldung (Rückmeldung der Ausgangslisten)

Anfrage vom DGS an den SOAP Server 

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="http://soap.server.test/">
   <soapenv:Header/>
   <soapenv:Body>
      <soap:AusgangslistenRueckMeldung>
         <ListenDaten>
            <AUFTRAGGEBERID>01</AUFTRAGGEBERID>
            <AUSGANGDATETIME>01.01.2021</AUSGANGDATETIME>
            <DRUCKDATETIME>01.01.2021</DRUCKDATETIME>
            <FRACHTFUEHRERTYP>DPD</FRACHTFUEHRERTYP>
            <GEWICHT>0.700</GEWICHT>
            <LIEFERSCHEINNR>LS-123</LIEFERSCHEINNR>
            <PACKSTKGES>2</PACKSTKGES>
            <PACKSTKNR>1</PACKSTKNR>
            <RETOURTRACKINGNR/>
            <TRACKINGNR>00112233445566778899</TRACKINGNR>
         </ListenDaten>
         <ListenDaten>
            <AUFTRAGGEBERID>01</AUFTRAGGEBERID>
            <AUSGANGDATETIME>01.01.2021</AUSGANGDATETIME>
            <DRUCKDATETIME>01.01.2021</DRUCKDATETIME>
            <FRACHTFUEHRERTYP>DPD</FRACHTFUEHRERTYP>
            <GEWICHT>0.500</GEWICHT>
            <LIEFERSCHEINNR>LS-123</LIEFERSCHEINNR>
            <PACKSTKGES>2</PACKSTKGES>
            <PACKSTKNR>2</PACKSTKNR>
            <RETOURTRACKINGNR/>
            <TRACKINGNR>00112233445566778900</TRACKINGNR>
         </ListenDaten>
      </soap:AusgangslistenRueckMeldung>
   </soapenv:Body>
</soapenv:Envelope>


Rückmeldung vom SOAP Server an den DGS zur obigen Anfrage
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="http://soap.server.test/">
   <soapenv:Header/>
   <soapenv:Body>
      <soap:AusgangslistenRueckMeldungResponse>
         <FEHLER/>
         <FEHLERTEXT1/>
      </soap:AusgangslistenRueckMeldungResponse>
   </soapenv:Body>
</soapenv:Envelope>

FAQ / Troubleshooting

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