Neu Anbindung Sendcloud via REST Api

[JulianO]

Moin

da es hier im Forum einige verwaiste Anfragen gibt zum Thema Sendcloud und JTL Wawi und ich für mich das Problem endlich gestern lösen konnte, habe ich mich entschlossen hier einen kleinen Leitfaden zu schreiben.

Anbindung erfolgt via Workflow.
Ich habe mich entschlossen, zumindest für die nächsten Bestellungen, den Workflow auf "Aufträge" - "komplett bezahlt" zu setzen. Natürlich kann man hier das für einen passende Ereignis nutzen.

Bekanntes Problem: Sollte kein Gewicht im Auftrag ermittelt werden, wird nichts an Sendcloud übertragen, da das Feld "Gewicht" nicht 0 sein darf. Lösung für mich: In der Versandart 10g "Zusatzgewicht" eintragen. in der Regel haben meine Artikel alle ein Gewicht drin, aber ab und an, habe ich es vergessen und umgehe so das Problem. Gewicht wird dann eh nochmal überprüft und angepasst.

Meine Lösung sieht vor, dass die Sendung angelegt wird mit den Kundendaten. ein Label wird nicht automatisch erstellt, da ich den Auftrag noch prüfen möchte. Das kann aber jeder natürlich anpassen, wie er möchte.
Für mich war die größte Hürde, wie man das Login per API und die grundsätzliche Abfrage durchführt. Da nun Felder zu ergänzen etc sollte für viele machbar sein.

So nun zum Weg:
Workflow erstellen, Bedingung bleibt (erstmal) leer. Aktion ist ein Webrequest (nicht Webrequest Post)

Im Webrequest selbst ist dann die Method: POST

URL: https://panel.sendcloud.sc/api/v2/parcels

Für das Login braucht ihr aus Sendcloud die API Keys. Den public und private key. Diese müsst ihr so in eine Zeile schreiben: publicrivate
Also hintereinander mit Doppelpunkt in der Mitte. Das alleine reicht aber nicht, sondern diese ganze Zeile nehmt ihr jetzt und lasst es durch irgendein online tool base64 encodieren. Der daraus resultierende Wert, den braucht ihr für das login. Dies herauszufinden hatte mich Stunden gekostet.

Dann geht in in das Feld Header, drückt die 3 Punkte und gebt da ein:

content-type: application/json
Authorization: Basic <euer base64 encodierter Wert>

Also ohne die <>

Dann im Body wieder 3 Punkte und da komm rein:

{
"parcel": {
"name": "{{Vorgang.Stammdaten.Kunde.Adresse.Vorname}} {{Vorgang.Stammdaten.Kunde.Adresse.Nachname}}",
"company_name": "{{Vorgang.Stammdaten.Kunde.Firma}}",
"address": "{{ Vorgang.Stammdaten.Kunde.Adresse.Straße }}",
"city": "{{ Vorgang.Stammdaten.Kunde.Adresse.Ort }}",
"postal_code": "{{ Vorgang.Stammdaten.Kunde.Adresse.PLZ }}",
"telephone": "{{ Vorgang.Stammdaten.Kunde.Adresse.Telefon }}",
"request_label": false,
"email": "{{ Vorgang.Stammdaten.Kunde.Adresse.EMail }}",
"data": {},
"country": "{{ Vorgang.Stammdaten.Kunde.Adresse.ISO }}",
"shipment": {
"id": 8
},
"weight": "1.000",
"order_number": "{{ Vorgang.Stammdaten.Auftragsnummer }}",
"insured_value": 0,
"total_order_value_currency": "EUR",
"total_order_value": "{{ Vorgang.AuftragsPositionen.BruttopreisGesamt | FormatNumber: 'N2', 'en-US'}}",
"quantity": 1,
"shipping_method_checkout_name": "{{ Vorgang.Lieferung.Versandart.Name }}"
}
}

Was genau die Shipment ID ist, habe ich noch nicht herausgefunden. Werde ich ggfs noch hier ergänzen.


Haken setzen bei "Auf Antwort warten"

Jo. So sollte es dann grundsätzlich funktionieren. Verfeinerungen folgen, sobald ich herausgefunden habe, ob es ein Workflowereignis gibt, wenn in WMS das Paket fertig gepackt ist.

Aber so bekomme ich grundsätzlich schon einmal die Kundendaten in Sendcloud rein, brauche eigentlich nur das Gewicht prüfen und Label erstellen.

VG
Julian

 

[romualdo]

Kann man glaubst du auch das Label erstellen und gleich drucken?

lG

 

[topsi]

Moin

da es hier im Forum einige verwaiste Anfragen gibt zum Thema Sendcloud und JTL Wawi und ich für mich das Problem endlich gestern lösen konnte, habe ich mich entschlossen hier einen kleinen Leitfaden zu schreiben.

Anbindung erfolgt via Workflow.
Ich habe mich entschlossen, zumindest für die nächsten Bestellungen, den Workflow auf "Aufträge" - "komplett bezahlt" zu setzen. Natürlich kann man hier das für einen passende Ereignis nutzen.

Bekanntes Problem: Sollte kein Gewicht im Auftrag ermittelt werden, wird nichts an Sendcloud übertragen, da das Feld "Gewicht" nicht 0 sein darf. Lösung für mich: In der Versandart 10g "Zusatzgewicht" eintragen. in der Regel haben meine Artikel alle ein Gewicht drin, aber ab und an, habe ich es vergessen und umgehe so das Problem. Gewicht wird dann eh nochmal überprüft und angepasst.

Meine Lösung sieht vor, dass die Sendung angelegt wird mit den Kundendaten. ein Label wird nicht automatisch erstellt, da ich den Auftrag noch prüfen möchte. Das kann aber jeder natürlich anpassen, wie er möchte.
Für mich war die größte Hürde, wie man das Login per API und die grundsätzliche Abfrage durchführt. Da nun Felder zu ergänzen etc sollte für viele machbar sein.

So nun zum Weg:
Workflow erstellen, Bedingung bleibt (erstmal) leer. Aktion ist ein Webrequest (nicht Webrequest Post)

Im Webrequest selbst ist dann die Method: POST

URL: https://panel.sendcloud.sc/api/v2/parcels

Für das Login braucht ihr aus Sendcloud die API Keys. Den public und private key. Diese müsst ihr so in eine Zeile schreiben: publicrivate
Also hintereinander mit Doppelpunkt in der Mitte. Das alleine reicht aber nicht, sondern diese ganze Zeile nehmt ihr jetzt und lasst es durch irgendein online tool base64 encodieren. Der daraus resultierende Wert, den braucht ihr für das login. Dies herauszufinden hatte mich Stunden gekostet.

Dann geht in in das Feld Header, drückt die 3 Punkte und gebt da ein:



Also ohne die <>

Dann im Body wieder 3 Punkte und da komm rein:


Was genau die Shipment ID ist, habe ich noch nicht herausgefunden. Werde ich ggfs noch hier ergänzen.


Haken setzen bei "Auf Antwort warten"

Jo. So sollte es dann grundsätzlich funktionieren. Verfeinerungen folgen, sobald ich herausgefunden habe, ob es ein Workflowereignis gibt, wenn in WMS das Paket fertig gepackt ist.

Aber so bekomme ich grundsätzlich schon einmal die Kundendaten in Sendcloud rein, brauche eigentlich nur das Gewicht prüfen und Label erstellen.

VG
Julian

Sehr geile anleitung, danke.

Ich habeDein 1.000 kg wie folgt ersetzt: "weight": "{{ Vorgang.AuftragsPositionen.GewichtGesamt | FormatNumber: 'N2', 'en-US'}}",
Allerdings hat mein Auftrag ein Versandgewicht von 17,28kg bei Artikelgewicht 16,80 kg. Bei sendcould landet 33,60 kg. Hast Du dazu zufällig eine Lösung?

Und statt derVersandart UPS, erstellt Sendcloud die Versandmethode "Unstamped letter" und fügt UPS stattdessen bei "Checkout Methode" ein.

 

[topsi]

Endziel: WMS ausdruck beim versenden

 

[romualdo]

Womit löst bei Euch den Workflow aus?
Bei Auftrag Ausgeliefert bekomme ich bei Teillieferungen natürlich kein Event. erst wenn alle Artikel ausgeliefert sind.

 

[romualdo]

Auch wäre interssant die erstellte Paketnummer dann in die WAWI zurückzugeben. Entweder extra oder eben gleich falls man das Paket erstellen auch gleich in einem Zug erledigt.

 

[etechnics_dev]

Hi, ich bin der Entwickler von https://package-bridge-client.vercel.app/. Wäre eine solche Lösung für SendCloud interessant? Wenn ja, würde sich jemand als Tester bereit erklären Feedback zu geben?

 

[marcemomeu]

Hi, ich bin der Entwickler von https://package-bridge-client.vercel.app/. Wäre eine solche Lösung für SendCloud interessant? Wenn ja, würde sich jemand als Tester bereit erklären Feedback zu geben?

sieht sehr interessant aus. Ich bin hauptsächlich auf diesen Beitrag gestoßen, da ich eine Anbindung an Kühne und Nagel suche. Am liebsten tatächlich wie bei dir auch aus dem Packtisch heraus.
Evtl. kann man das ja irgendwie verbinden mit deiner App. Finde deinen aktuellen Preis auch fair. Ich schreib dir ne PN