The Automatic Bulk Pickup Workflow provides a streamlined solution for high-volume shipping operations that require minimal manual intervention. This workflow automatically handles shipment creation, batch management, and pickup request coordination using predefined default settings.
This workflow operates on a template-based approach using user-configured defaults:
Default pickup address: all shipments will use the MOL user's designated default pickup location.
Please check the CreatePickupAddressRequest section for guidance
Default pickup data: predefined time windows, cutoff periods, and operational notes are applied automatically.
Please check the SetPickupDefaultDataRequest section for guidance
If no default pickup data is defined, or the MOL user does not have a default pickup address, an error will be returned.
For managing this workflow, the ShipmentRequest API call requires minimal input parameters while leveraging comprehensive default settings to automate all pickup-related processing, which is done by MBE systems behind the scene.
The ShipmentRequest API is now enhanced to include a specific Pickup container, with the following field. In order to have an automatic bulk pickup shipment the field MolDefaultPickupTime must be populated with the value TRUE.
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://www.onlinembe.eu/ws/">
<SOAP-ENV:Body>
<ns2:ShipmentRequest xmlns:ns2="http://www.onlinembe.eu/ws/">
<RequestContainer>
<System></System>
<Credentials>
<Username></Username>
<Passphrase></Passphrase>
</Credentials>
<InternalReferenceID>OR1536</InternalReferenceID>
<!-- Note: No Sender Container!! - Automatically populated from default address -->
<!-- Standard: Recipient Information -->
<Recipient>
<Name>Recipient Contact Name</Name>
<CompanyName>Recipient Company Name</CompanyName>
<Address>Recipient street address</Address>
<Phone>3331112222</Phone>
<ZipCode>20158</ZipCode>
<City>MILANO</City>
<State>MI</State>
<Country>IT</Country>
<Email>recipient@email.com</Email>
</Recipient>
<Shipment>
<ShipperType>MBE</ShipperType>
<Description>ECOMMERCE SHOP PURCHASE</Description>
<Service></Service>
<PackageType>GENERIC</PackageType>
<GoodType>ART</GoodType>
<Items>
<Item>
<Weight>0.3</Weight>
<Dimensions>
<Lenght>10</Lenght>
<Height>10</Height>
<Width>10</Width>
</Dimensions>
</Item>
</Items>
</Shipment>
<!-- Required: Automatic bulk pickup mode flag -->
<Pickup>
<MolDefaultPickupTime>true</MolDefaultPickupTime>
</Pickup>
</RequestContainer>
</ns2:ShipmentRequest>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
If the request is formally correct and the MOL user is allowed to execute pickup requests for the selected courier and the courier accepts the pickup request, the shipment will be created.