With this call, a return shipment can be created within MBE systems.
A return shipment can only be generated for a previously generated shipment. You can make a return request only and only for those shipments for which a waybill has actually been created. Given the current workflow, the resulting shipment will:
have sender and receiver reversed;
be created in draft status, and will be already closed, so that the store can manage it on HUB;
be associated to the courier that, at the time of the defined request, is the courier set as SmartChoice by the center;
Take also into account that if Referring field is populated in input, it will be inherited in the return shipment; otherwise, the Referring present in the shipment source is inherited in the return shipment.
Note: Call used also by eShip Plugins
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://www.onlinembe.eu/ws/">
<soapenv:Header/>
<soapenv:Body>
<ws:ShipmentReturnRequest>
<RequestContainer>
<System>IT</System>
<Credentials>
<Username></Username>
<Passphrase></Passphrase>
</Credentials>
<InternalReferenceID></InternalReferenceID>
<MbeTracking>IT0000-0L-0000002XG0</MbeTracking>
<!--Optional:-->
<ShipmentOrigin>?</ShipmentOrigin>
<!--Optional:-->
<Referring></Referring>
</RequestContainer>
</ws:ShipmentReturnRequest>
</soapenv:Body>
</soapenv:Envelope>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header/>
<SOAP-ENV:Body>
<ns3:ShipmentReturnRequestResponse xmlns:ns3="http://www.onlinembe.eu/ws/">
<RequestContainer>
<InternalReferenceID/>
<Status>OK</Status>
<SystemReferenceID>IT0000-0L-0000002XG7</SystemReferenceID>
<MasterTrackingMBE>IT0000-0L-0000002XG7</MasterTrackingMBE>
<TrackingsMBE>
<trackingMBE>IT0000-0L-0000002XG7-01</trackingMBE>
</TrackingsMBE>
<Labels>
<label>
<stream>XXX</stream>
<type>PDF</type>
</label>
</Labels>
</RequestContainer>
</ns3:ShipmentReturnRequestResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>