Zum Inhalt springen

Broken/OmniShipping Internal:DHL API: Unterschied zwischen den Versionen

Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
 
(2 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"><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"><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"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output">
= '''ShippingConnect DHL API Versenden einrichten''' =
= '''ShippingConnect DHL API Versenden einrichten''' =
<p style="text-align: center;">'''<span style="background-color:#d35400;">!! DIES IST EINE INTERNE ANLEITUNG UND NUR INNERHALB DER HTK GmbH & Co. KG zu nutzen&nbsp;!!</span>'''</p>  
<p style="text-align: center;">'''<span style="background-color:#d35400;">!! DIES IST EINE INTERNE ANLEITUNG UND NUR INNERHALB DER HTK GmbH & Co. KG zu nutzen&nbsp;!!</span>'''</p>  
Zeile 35: Zeile 35:


[[File:DHL API5.png|RTENOTITLE]]
[[File:DHL API5.png|RTENOTITLE]]
=== BPM Konfiguration ===


Sind die Tabellen etc. alle entsprechend angelegt worden sollte man nun im ersten Schritt die Datenbankverbindung im HTK Service hinterlegen.
Sind die Tabellen etc. alle entsprechend angelegt worden sollte man nun im ersten Schritt die Datenbankverbindung im HTK Service hinterlegen.
Zeile 81: Zeile 83:
'''<span style="color:red">ACHTUNG! Hier muss entsprechend der Mandant geprüft werden</span>'''
'''<span style="color:red">ACHTUNG! Hier muss entsprechend der Mandant geprüft werden</span>'''
<blockquote>
<blockquote>
'
'
</blockquote>  
</blockquote>  
==== Anpassung der dbo.vwHTKVersenden ====
Im Anschluss daran muss man in der dbo.vwHTKVersenden noch eine Anpassung durchführen. Hier muss im Statement an der Stelle " HIER MUSS DIE ABRECHNUNGSNUMMER REIN" die Abrechnungsnummer des Kunden des DHL-Geschäftskundenportal rein - falls die Kunden nicht wissen was das ist und wo man dies findet [https://dhl.support.netresearch.de/support/solutions/articles/12000024658-wie-werden-die-kundennummer-ekp-und-teilnahmenummern-eingerichtet- HIER] gut erklärt.
Im Anschluss daran muss man in der dbo.vwHTKVersenden noch eine Anpassung durchführen. Hier muss im Statement an der Stelle " HIER MUSS DIE ABRECHNUNGSNUMMER REIN" die Abrechnungsnummer des Kunden des DHL-Geschäftskundenportal rein - falls die Kunden nicht wissen was das ist und wo man dies findet [https://dhl.support.netresearch.de/support/solutions/articles/12000024658-wie-werden-die-kundennummer-ekp-und-teilnahmenummern-eingerichtet- HIER] gut erklärt.
<blockquote>
<blockquote>
Zeile 89: Zeile 93:
SET QUOTED_IDENTIFIER ON<br/> GO
SET QUOTED_IDENTIFIER ON<br/> GO


<br/> &nbsp;&nbsp; &nbsp;ALTER VIEW [dbo].[vWHTkVersenden] AS<br/> &nbsp;&nbsp; &nbsp; select&nbsp;<br/> &nbsp;&nbsp; &nbsp; bel.Mandant as [Mandant],<br/> &nbsp;&nbsp; &nbsp; bel.[BelID] as [BelId],<br/> &nbsp;&nbsp; &nbsp; bel.[Belegnummer] as [Belegnummer],<br/> &nbsp;&nbsp; &nbsp; bel.[Belegjahr] as [Belegjahr],<br/> &nbsp;&nbsp; &nbsp; ver.[Storniert] as [Storniert],<br/> &nbsp;&nbsp; &nbsp; ver.[ID] as [VersandDatenId],<br/> &nbsp;&nbsp; &nbsp; ver.[PaketId] as [PaketId],<br/> &nbsp;&nbsp; &nbsp; ver.[Paketnummer] as [Paketnummer],<br/> &nbsp;&nbsp; &nbsp; ver.[Versanddienstleister] as [Versanddienstleister],<br/> &nbsp;&nbsp; &nbsp; (select LieferStrasse from KHKAdressen where mandant = bel.Mandant and adresse = (select adresse from KHKAdressenverweise where mandant = [Mandant] and Verweis = 'Mandant' and Eigentuemer = -1)) as [ShipperStreet],<br/> &nbsp;&nbsp; &nbsp; '' as [ShipperStreetNr],<br/> &nbsp;&nbsp; &nbsp; (select LieferOrt from KHKAdressen where mandant = bel.Mandant and adresse = (select adresse from KHKAdressenverweise where mandant = [Mandant] and Verweis = 'Mandant' and Eigentuemer = -1)) as [ShipperCity],<br/> &nbsp;&nbsp; &nbsp; (select LieferPLZ from KHKAdressen where mandant = bel.Mandant and adresse = (select adresse from KHKAdressenverweise where mandant = [Mandant] and Verweis = 'Mandant' and Eigentuemer = -1)) as [ShipperZip],<br/> &nbsp;&nbsp; &nbsp; (select LieferLand from KHKAdressen where mandant = bel.Mandant and adresse = (select adresse from KHKAdressenverweise where mandant = [Mandant] and Verweis = 'Mandant' and Eigentuemer = -1)) as [ShipperCountryCode],<br/> &nbsp;&nbsp; &nbsp; '' as [ShipperEmail],<br/> &nbsp;&nbsp; &nbsp; (select Name1 from KHKAdressen where mandant = bel.Mandant and adresse = (select adresse from KHKAdressenverweise where mandant = [Mandant] and Verweis = 'Mandant' and Eigentuemer = -1)) as [ShipperFirstName],<br/> &nbsp;&nbsp; &nbsp; (select Name2 from KHKAdressen where mandant = bel.Mandant and adresse = (select adresse from KHKAdressenverweise where mandant = [Mandant] and Verweis = 'Mandant' and Eigentuemer = -1)) as [ShipperLastName],<br/> &nbsp;&nbsp; &nbsp; (select Name1 from KHKAdressen where mandant = bel.Mandant and adresse = (select adresse from KHKAdressenverweise where mandant = [Mandant] and Verweis = 'Mandant' and Eigentuemer = -1)) as [ShipperCompanyName],<br/> &nbsp;&nbsp; &nbsp; (select [Telefon] from KHKAdressen where mandant = bel.Mandant and adresse = (select adresse from KHKAdressenverweise where mandant = [Mandant] and Verweis = 'Mandant' and Eigentuemer = -1)) as [ShipperPhone],<br/> &nbsp;&nbsp; &nbsp; bel.[A1Strasse] as [ReceiverStreet],<br/> &nbsp;&nbsp; &nbsp; '' as [ReceiverStreetNr],<br/> &nbsp;&nbsp; &nbsp; bel.[A1Ort] as [ReceiverCity],<br/> &nbsp;&nbsp; &nbsp; bel.[A1PLZ] as [ReceiverZip],<br/> &nbsp;&nbsp; &nbsp; 'goods' as [Comment],
<br/> &nbsp;&nbsp; &nbsp;ALTER VIEW [dbo].[vWHTkVersenden] AS<br/> &nbsp;&nbsp; &nbsp; select&nbsp;<br/> &nbsp;&nbsp; &nbsp; bel.Mandant as [Mandant],<br/> &nbsp;&nbsp; &nbsp; bel.[BelID] as [BelId],<br/> &nbsp;&nbsp; &nbsp; bel.[Belegnummer] as [Belegnummer],<br/> &nbsp;&nbsp; &nbsp; bel.[Belegjahr] as [Belegjahr],<br/> &nbsp;&nbsp; &nbsp; ver.[Storniert] as [Storniert],<br/> &nbsp;&nbsp; &nbsp; ver.[ID] as [VersandDatenId],<br/> &nbsp;&nbsp; &nbsp; ver.[PaketId] as [PaketId],<br/> &nbsp;&nbsp; &nbsp; ver.[Paketnummer] as [Paketnummer],<br/> &nbsp;&nbsp; &nbsp; ver.[Versanddienstleister] as [Versanddienstleister],<br/> &nbsp;&nbsp; &nbsp; (select LieferStrasse from KHKAdressen where mandant = bel.Mandant and adresse = (select adresse from KHKAdressenverweise where mandant = [Mandant] and Verweis = 'Mandant' and Eigentuemer = -1)) as [ShipperStreet],<br/> &nbsp;&nbsp; &nbsp; ''as [ShipperStreetNr],<br/> &nbsp;&nbsp; &nbsp; (select LieferOrt from KHKAdressen where mandant = bel.Mandant and adresse = (select adresse from KHKAdressenverweise where mandant = [Mandant] and Verweis = 'Mandant' and Eigentuemer = -1)) as [ShipperCity],<br/> &nbsp;&nbsp; &nbsp; (select LieferPLZ from KHKAdressen where mandant = bel.Mandant and adresse = (select adresse from KHKAdressenverweise where mandant = [Mandant] and Verweis = 'Mandant' and Eigentuemer = -1)) as [ShipperZip],<br/> &nbsp;&nbsp; &nbsp; (select LieferLand from KHKAdressen where mandant = bel.Mandant and adresse = (select adresse from KHKAdressenverweise where mandant = [Mandant] and Verweis = 'Mandant' and Eigentuemer = -1)) as [ShipperCountryCode],<br/> &nbsp;&nbsp; &nbsp; '' as [ShipperEmail],<br/> &nbsp;&nbsp; &nbsp; (select Name1 from KHKAdressen where mandant = bel.Mandant and adresse = (select adresse from KHKAdressenverweise where mandant = [Mandant] and Verweis = 'Mandant' and Eigentuemer = -1)) as [ShipperFirstName],<br/> &nbsp;&nbsp; &nbsp; (select Name2 from KHKAdressen where mandant = bel.Mandant and adresse = (select adresse from KHKAdressenverweise where mandant = [Mandant] and Verweis = 'Mandant' and Eigentuemer = -1)) as [ShipperLastName],<br/> &nbsp;&nbsp; &nbsp; (select Name1 from KHKAdressen where mandant = bel.Mandant and adresse = (select adresse from KHKAdressenverweise where mandant = [Mandant] and Verweis = 'Mandant' and Eigentuemer = -1)) as [ShipperCompanyName],<br/> &nbsp;&nbsp; &nbsp; (select [Telefon] from KHKAdressen where mandant = bel.Mandant and adresse = (select adresse from KHKAdressenverweise where mandant = [Mandant] and Verweis = 'Mandant' and Eigentuemer = -1)) as [ShipperPhone],<br/> &nbsp;&nbsp; &nbsp; bel.[A1Strasse] as [ReceiverStreet],<br/> &nbsp;&nbsp; &nbsp; ''as [ReceiverStreetNr],<br/> &nbsp;&nbsp; &nbsp; bel.[A1Ort] as [ReceiverCity],<br/> &nbsp;&nbsp; &nbsp; bel.[A1PLZ] as [ReceiverZip],<br/> &nbsp;&nbsp; &nbsp; 'goods' as [Comment],''


&nbsp;&nbsp; &nbsp; bel.[A1Land] as [ReceiverCountryCode],<br/> &nbsp;&nbsp; &nbsp; --'CH' as [ReceiverCountryCode],<br/> &nbsp;<br/> &nbsp;&nbsp; &nbsp; '' as [ReceiverEmail],<br/> &nbsp;&nbsp; &nbsp; bel.[A1Name1] as [ReceiverFirstName],<br/> &nbsp;&nbsp; &nbsp; bel.[A1Name2] as [ReceiverLastName],<br/> &nbsp;&nbsp; &nbsp; '' as [ReceiverCompanyName],<br/> &nbsp;&nbsp; &nbsp; '' as ReceiverAdditional,<br/> &nbsp;&nbsp; &nbsp; (select top 1 Telefon from khkadressen where adresse = (select A1AdressNr from khkvkbelege where belid = bel.[BelId])) as [ReceiverPhone],<br/> &nbsp;&nbsp; &nbsp; bel.Liefertermin as [ShippingDate],
&nbsp;&nbsp; &nbsp; bel.[A1Land] as [ReceiverCountryCode],<br/> &nbsp;&nbsp; &nbsp; --'CH' as [ReceiverCountryCode],<br/> &nbsp;<br/> &nbsp;&nbsp; &nbsp; ''as [ReceiverEmail],<br/> &nbsp;&nbsp; &nbsp; bel.[A1Name1] as [ReceiverFirstName],<br/> &nbsp;&nbsp; &nbsp; bel.[A1Name2] as [ReceiverLastName],<br/> &nbsp;&nbsp; &nbsp; '' as [ReceiverCompanyName],<br/> &nbsp;&nbsp; &nbsp; ''as ReceiverAdditional,<br/> &nbsp;&nbsp; &nbsp; (select top 1 Telefon from khkadressen where adresse = (select A1AdressNr from khkvkbelege where belid = bel.[BelId])) as [ReceiverPhone],<br/> &nbsp;&nbsp; &nbsp; bel.Liefertermin as [ShippingDate],''


&nbsp;&nbsp; &nbsp; (case when bel.[A1Land] <> 'DE' then<br/> &nbsp;&nbsp; &nbsp;&nbsp;&nbsp; &nbsp;'V53WPAK'<br/> &nbsp;&nbsp; &nbsp; ELSE<br/> &nbsp;&nbsp; &nbsp;&nbsp;&nbsp; &nbsp;'V01PAK' end) as [ProductCode],<br/> &nbsp;&nbsp; &nbsp; --'V53WPAK' as [ProductCode],<br/> &nbsp;<br/> &nbsp;&nbsp; &nbsp; --'22222222220104' as [BillingNumber],&nbsp;<br/> &nbsp;&nbsp; &nbsp;(case when bel.[A1Land] <> 'DE' then<br/> &nbsp;&nbsp; &nbsp;&nbsp;&nbsp; &nbsp;'<span style="background-color:#d35400;">HIER MUSS DIE ABRECHNUNGSNUMMER REIN</span>' + '5301'<br/> &nbsp;&nbsp; &nbsp;ELSE<br/> &nbsp;&nbsp; &nbsp;&nbsp;&nbsp; &nbsp;'<span style="background-color:#e74c3c;">HIER MUSS DIE ABRECHNUNGSNUMMER REIN</span>' + '0104'&nbsp;<br/> &nbsp;&nbsp; &nbsp;end) as [BillingNumber],
&nbsp;&nbsp; &nbsp; (case when bel.[A1Land] <> 'DE' then<br/> &nbsp;&nbsp; &nbsp;&nbsp;&nbsp; &nbsp;'V53WPAK'<br/> &nbsp;&nbsp; &nbsp; ELSE<br/> &nbsp;&nbsp; &nbsp;&nbsp;&nbsp; &nbsp;'V01PAK' end) as [ProductCode],<br/> &nbsp;&nbsp; &nbsp; --'V53WPAK' as [ProductCode],<br/> &nbsp;<br/> &nbsp;&nbsp; &nbsp; --'22222222220104' as [BillingNumber],&nbsp;<br/> &nbsp;&nbsp; &nbsp;(case when bel.[A1Land] <> 'DE' then<br/> &nbsp;&nbsp; &nbsp;&nbsp;&nbsp; &nbsp;'<span style="background-color:#d35400;">HIER MUSS DIE ABRECHNUNGSNUMMER REIN</span>' + '5301'<br/> &nbsp;&nbsp; &nbsp;ELSE<br/> &nbsp;&nbsp; &nbsp;&nbsp;&nbsp; &nbsp;'<span style="background-color:#e74c3c;">HIER MUSS DIE ABRECHNUNGSNUMMER REIN</span>' + '0104'&nbsp;<br/> &nbsp;&nbsp; &nbsp;end) as [BillingNumber],


&nbsp;&nbsp; &nbsp; convert(varchar(255), bel.[Belegnummer]) as [CustomerReference],<br/> &nbsp;&nbsp; &nbsp; ver.[Gewicht] as [WeightInKG],<br/> &nbsp;&nbsp; &nbsp; '' as [LengthInCm],<br/> &nbsp;&nbsp; &nbsp; '' as [WidthInCm],<br/> &nbsp;&nbsp; &nbsp; '' as [HeightInCm],<br/> &nbsp;&nbsp; &nbsp; '' as [IdentFirstName],<br/> &nbsp;&nbsp; &nbsp; '' as [IdentLastName],<br/> &nbsp;&nbsp; &nbsp; '' as [IdentMinAge],<br/> &nbsp;&nbsp; &nbsp; '' as [IdentBirthday],<br/> &nbsp;&nbsp; &nbsp; USER_HTKVersandPackstationsnummer as [PackingstationNumber],<br/> &nbsp;&nbsp; &nbsp; USER_HTKVersandPostnummer as [Postnumber],<br/> &nbsp;&nbsp; &nbsp; USER_HTKVersandPostfilialnummer as [Postfilialnummer],<br/> &nbsp;&nbsp; &nbsp; USER_HTKVersandPacketshopnummer as [Packetshopnummer],<br/> &nbsp;&nbsp; &nbsp; --(select Zuschlag from KHKVKBelegeZuschlaege as z inner join KHKZuschlagsarten as zu on zu.Mandant = z.Mandant and zu.ZuschlagID = z.ZuschlagID where belid = bel.BelID and z.Mandant = bel.Mandant and zu.Zuschlagsart = 'Versand') + bel.Bruttobetrag + 2 as NachnahmeBetrag<br/> &nbsp;&nbsp; &nbsp; NULL as [NachnahmeBetrag]<br/> &nbsp;&nbsp; &nbsp; from KHKVKBelege as bel<br/> &nbsp;&nbsp; &nbsp; inner join [HTKBPM_Plugins_Versanddaten] as ver ON bel.mandant = ver.Mandant AND bel.BelID = ver.BelId<br/> &nbsp;&nbsp; &nbsp; where ver.Versanddienstleister = 'DHL (Versenden API)' and Convert(date ,bel.Liefertermin) = Convert(date, GETDATE())<br/> &nbsp;&nbsp; &nbsp;&nbsp;<br/> &nbsp;&nbsp; &nbsp;&nbsp;<br/> GO
&nbsp;&nbsp; &nbsp; convert(varchar(255), bel.[Belegnummer]) as [CustomerReference],<br/> &nbsp;&nbsp; &nbsp; ver.[Gewicht] as [WeightInKG],<br/> &nbsp;&nbsp; &nbsp; ''as [LengthInCm],<br/> &nbsp;&nbsp; &nbsp; '' as [WidthInCm],<br/> &nbsp;&nbsp; &nbsp; ''as [HeightInCm],<br/> &nbsp;&nbsp; &nbsp; '' as [IdentFirstName],<br/> &nbsp;&nbsp; &nbsp; ''as [IdentLastName],<br/> &nbsp;&nbsp; &nbsp; '' as [IdentMinAge],<br/> &nbsp;&nbsp; &nbsp; ''as [IdentBirthday],<br/> &nbsp;&nbsp; &nbsp; USER_HTKVersandPackstationsnummer as [PackingstationNumber],<br/> &nbsp;&nbsp; &nbsp; USER_HTKVersandPostnummer as [Postnumber],<br/> &nbsp;&nbsp; &nbsp; USER_HTKVersandPostfilialnummer as [Postfilialnummer],<br/> &nbsp;&nbsp; &nbsp; USER_HTKVersandPacketshopnummer as [Packetshopnummer],<br/> &nbsp;&nbsp; &nbsp; --(select Zuschlag from KHKVKBelegeZuschlaege as z inner join KHKZuschlagsarten as zu on zu.Mandant = z.Mandant and zu.ZuschlagID = z.ZuschlagID where belid = bel.BelID and z.Mandant = bel.Mandant and zu.Zuschlagsart = 'Versand') + bel.Bruttobetrag + 2 as NachnahmeBetrag<br/> &nbsp;&nbsp; &nbsp; NULL as [NachnahmeBetrag]<br/> &nbsp;&nbsp; &nbsp; from KHKVKBelege as bel<br/> &nbsp;&nbsp; &nbsp; inner join [HTKBPM_Plugins_Versanddaten] as ver ON bel.mandant = ver.Mandant AND bel.BelID = ver.BelId<br/> &nbsp;&nbsp; &nbsp; where ver.Versanddienstleister = 'DHL (Versenden API)' and Convert(date ,bel.Liefertermin) = Convert(date, GETDATE())<br/> &nbsp;&nbsp; &nbsp;&nbsp;<br/> &nbsp;&nbsp; &nbsp;&nbsp;<br/> GO''


<br/> &nbsp;
<br/> &nbsp;
Zeile 101: Zeile 105:
&nbsp;
&nbsp;


Wenn das nun funktioniert hat und entsprechende Belege gefunden werden sollten in dem Root Verzeichnis des API Exports entsprechende .pdf Dateien generiert werden :
Wenn das nun funktioniert hat und entsprechende Belege gefunden werden sollten in dem Root Verzeichnis des API Exports entsprechende .pdf Dateien generiert werden&nbsp;:


[[File:DHL API13.png]]
[[File:DHL API13.png|RTENOTITLE]]


Nun muss&nbsp;
Nun muss noch im DHL Geschäftskundenportal des Kunden gepürft werden ob der entsprechende Auftrag auch dort vorhanden ist.
</div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div>
</div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div>