Het is mogelijk om uw eigen document aan te leveren via de SOAP Webservice of REST API. Dit kan bijvoorbeeld een PDF pakbon zijn die wordt gegenereerd in uw ERP- of WMS-systeem. Met wat extra configuratie in de MyTranssmart Admin Panel - ofwel via selfservice of via onze consultancyafdeling - is het mogelijk om dit document af te drukken op het moment dat het verzendlabel wordt afgedrukt.
Via de SOAP Webservice kunt u het base64 document als volgt aanleveren:
Voor meer informatie over de SOAP Webservice velden, raadpleegt u de wsdl en zoekt u op de term "customerDocuments".
Via de REST API kunt u het base64 document als volgt aanleveren:
Voor meer informatie over de API velden, raadpleegt u de DevDocs en zoekt u op de term "customerDocuments"
Let op: het document kan worden aangeleverd op zendingniveau (meer dan 1 document toegestaan) of op pakketniveau (max. 1 document per zendingregel/pakket).
Example
Hieronder lichten we de flow toe voor het aanleveren van één pakbon PDF op zendingniveau.
1. Zorg ervoor dat in de Admin Panel (als u hier selfservice-toegang toe heeft) configuratie aanwezig is in 2 tabellen.
- Document Generation:
- Document Retrieval:
Zoals hierboven vermeld, neem contact op met onze servicedesk als u geen toegang heeft tot het Admin Panel menu; houd er rekening mee dat extra consultancykosten in rekening kunnen worden gebracht voor het wijzigen van uw configuratie.
2. Boek een zending via SOAP Webservice of REST API met de customerDocuments-sectie gevuld met formaat "PDF" en in dit voorbeeld templateName "DELNOTE" zoals hierboven beschreven.
3. Doe ofwel een getDocs call via de SOAP Webservice of doe een REST API print call en naast de standaard pakket-/zendinglabels wordt ook het DELNOTE document teruggegeven. In MyTranssmart zal bij het uitvoeren van een Print call het/de label(s) en document worden afgedrukt. U kunt ook een ZIP-bestand downloaden en dit zal alle labels en documenten bevatten
Belangrijke opmerkingen:
Het is belangrijk dat de schaal van het document 100% is. Als bijvoorbeeld een PDF wordt aangemaakt met een schaal van 70%, wordt deze niet correct afgedrukt. Zie onderstaand voorbeeld.
De maker van de PDF heeft een schaal van 70% gebruikt:
Daardoor is het daadwerkelijke deel dat op een pagina past dit:
Wat ertoe leidt dat ons platform het document naar u doorstuurt dat er als volgt uitziet: