HVS32 SOAP Interface (Interactive): Unterschied zwischen den Versionen
(Änderung 4107 von Preichert (Diskussion) rückgängig gemacht.) Markierung: Rückgängigmachung |
|||
Zeile 23: | Zeile 23: | ||
= Examples = | = Examples = | ||
<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"> | ||
− | + | Request from DGS to SOAP Server | |
− | <source> | + | <source lang="xml"> |
− | <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns: | + | <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> | </soapenv:Envelope> | ||
</source> | </source> | ||
− | + | <br> | |
− | + | Response from SOAP Server to DGS for the above request | |
− | <source> | + | <source lang="xml"> |
− | < | + | <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> | ||
+ | </source></div></div> | ||
+ | <br> | ||
+ | <div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"> | ||
+ | <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"> | ||
+ | Request from DGS to 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: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> | ||
</source> | </source> | ||
− | </div></div> | + | <br> |
+ | Response from SOAP Server to DGS for the above request<source lang="xml"> | ||
+ | <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> | ||
+ | </source></div></div> | ||
<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;">''' | + | <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"> | ||
− | <source> | + | Request from DGS to SOAP Server |
− | <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns: | + | <source lang="xml"> |
− | + | <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> | </soapenv:Envelope> | ||
</source> | </source> | ||
− | </div></div> | + | <br> |
+ | Response from SOAP Server to DGS for the above request<source lang="xml"> | ||
+ | <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> | ||
+ | </source></div></div> | ||
<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;">''' | + | <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"> | <div class="mw-collapsible-content"> | ||
− | <source> | + | Request from DGS to SOAP Server |
− | <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns: | + | <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> | </soapenv:Envelope> | ||
</source> | </source> | ||
− | </div></div> | + | <br> |
+ | Response from SOAP Server to DGS for the above request<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:Envelope> | ||
+ | </source></div></div> | ||
= FAQ / Troubleshooting = | = FAQ / Troubleshooting = |
Aktuelle Version vom 1. Februar 2022, 09:32 Uhr
Prerequisites
DGS-Version | 3.6.0.588 or higher |
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.
Available HVS32 functions
Item data and dangerous goods information have a 1:n relationship with package data.
Please note that the field descriptions only refer to a standard, which should serve as a suggestion for the interface. Function names, field names /-lengths /-formats can deviate in principle, but must be considered/analyzed individually in this case.
Verfügbare HVS32 Funktionen
Examples
Request from DGS to 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>
Response from SOAP Server to DGS for the above request
<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>
Request from DGS to 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>
<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>
Request from DGS to 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>
<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>
Request from DGS to 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>
<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>