WARNING: This request will be the only ShipmentList request available and supported starting on August 2025
This is an improved version of the ShipmentsListRequest, optimised for obtaining a higher number of shipments through a paginated output. If compared to V2, the only difference is that the waybill is returned via a dynamic temporary link (lasting 1 hour) generated via S3.
In the request:
the StoreId and CustomerId fields (because they were actually no longer processed in the old version either) are deprecated
the Page field was added with a value ranging from 1 to TotalPages (which you get from the output)
fields DateFrom and DateTo do not have any specific limits, as pagination was introduced to handle a large number of shipments queried in the request call. The format must be YYYY-MM-DD
as many MBE Master Trackings may be entered in the MBEMasterTrackings field as desired (no limits)
the parameter WithCourierWaybill follows the same rules listed in the ShipmentListRequest page
the optional parameter ToBeClosed was added
if true, only shipments yet to be closed will be returned
if false, only finalised shipments with a generated waybill will be returned
if absent, all shipments, both finalised and yet to be closed, will be returned
the optional parameter DepartmentID was added
if populated, only shipments from that department will be returned
if not populated, all shipments will be shown without any filtering on the department
If absent, all shipments will be shown without any filtering on the department
through the Referring field, users can find a specific shipment using its original order number
In the response:
the <Page> field was added for showing the returned page (1 if in the request no page is requested; otherwise, the page requested in the request) and the TotalPages field
By default, the system returns a maximum of 25 shipments per page; following pages can be requested in the <Page> field as seen above
The waybill is returned via a dynamic temporary link (lasting 1 hour) generated via S3
At the end of each shipment, there will always be the new fields <ShipmentToBeClosed> and <DepartmentID>, which will indicate whether the shipment is to be closed and if it belongs to a department
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://www.onlinembe.eu/ws/">
<soapenv:Header/>
<soapenv:Body>
<ws:ShipmentsListV3Request>
<RequestContainer>
<System></System>
<Credentials>
<Username></Username>
<Passphrase></Passphrase>
</Credentials>
<InternalReferenceID>testv3</InternalReferenceID>
<DateFrom>01-01-2024</DateFrom>
<WithCourierWaybill>true</WithCourierWaybill>
<Page>1</Page>
<ToBeClosed>false</ToBeClosed>
</RequestContainer>
</ws:ShipmentsListV3Request>
</soapenv:Body>
</soapenv:Envelope>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header/>
<SOAP-ENV:Body>
<ns3:ShipmentsListV3RequestResponse xmlns:ns3="http://www.onlinembe.eu/ws/">
<RequestContainer>
<Status>OK</Status>
<InternalReferenceID>testv3</InternalReferenceID>
<ShipmentsFullInfo>
<ShipmentFullInfo>
<ReceiverInfo>
<CompanyName>Mr. 9 settembre</CompanyName>
<Name>Mr. 9 settembre</Name>
<Address>Via Medeghino 31</Address>
<ZipCode>20141</ZipCode>
<City>Milano</City>
<State>MI</State>
<Country>Italy</Country>
<Phone>6554654</Phone>
<Emails>sfdasfdfds@fd.com</Emails>
</ReceiverInfo>
<ShipmentInfo>
<Description>Mr. 9 settembre</Description>
<Insurance>false</Insurance>
<Courier>DHL</Courier>
<CourierService>Express</CourierService>
<Items>
<Item>
<Dimensions>
<Lenght>11.0</Lenght>
<Height>11.0</Height>
<Width>11.0</Width>
</Dimensions>
</Item>
</Items>
<Date>2021-09-09</Date>
<ShipmentToBeClosed>false</ShipmentToBeClosed>
<DepartmentId>2027</DepartmentId>
</ShipmentInfo>
<TrackingInfo>
<MasterTrackingMBE>IT0001-15-0000000RWC</MasterTrackingMBE>
<TrackingsMBE>
<TrackingMBE>IT0001-15-0000000RWC-01</TrackingMBE>
</TrackingsMBE>
<PresignedLinks>
<PresignedLink>
<Link><![CDATA…613a1b9></Link>
<Type>WAYBILL</Type>
</PresignedLink>
</PresignedLinks>
<CourierMasterTrk>1238248060</CourierMasterTrk>
</TrackingInfo>
</ShipmentFullInfo>
</ShipmentsFullInfo>
<Page>1</Page>
<TotalPages>94</TotalPages>