Shipments ListV3 Request

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
- 1. if true, only shipments yet to be closed will be returned
  2. if false, only finalised shipments with a generated waybill will be returned
  3. if absent, all shipments, both finalised and yet to be closed, will be returned
the optional parameter DepartmentID was added
- 1. if populated, only shipments from that department will be returned
  2. if not populated, all shipments will be shown without any filtering on the department
  3. 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

Request Sample (given a starting range)

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://www.onlinembe.eu/ws/">

<soapenv:Header/>

<soapenv:Body>

<ws:ShipmentsListV3Request>

</Credentials>

<InternalReferenceID>testv3</InternalReferenceID>

<ToBeClosed>false</ToBeClosed>

</RequestContainer>

</ws:ShipmentsListV3Request>

</soapenv:Body>

</soapenv:Envelope>

Response Sample

<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/">

<InternalReferenceID>testv3</InternalReferenceID>

<CompanyName>Mr. 9 settembre</CompanyName>

<Name>Mr. 9 settembre</Name>

<Address>Via Medeghino 31</Address>

<City>Milano</City>

<Country>Italy</Country>

<Emails>sfdasfdfds@fd.com</Emails>

</ReceiverInfo>

<Description>Mr. 9 settembre</Description>

<Insurance>false</Insurance>

<CourierService>Express</CourierService>

<Items>

<Item>

</Dimensions>

</Item>

</Items>

<ShipmentToBeClosed>false</ShipmentToBeClosed>

</ShipmentInfo>

</TrackingsMBE>

<Type>WAYBILL</Type>

</PresignedLink>

</PresignedLinks>

</TrackingInfo>

</ShipmentFullInfo>

</ShipmentsFullInfo>