The “AutoFileManifest” macro automates the process of filing manifests for shipping accounts integrated with Linnworks. It enables seamless generation of manifests and facilitates email notifications with manifest attachments to designated recipients.
There are three steps you need to complete to start using the macro:
- 1. Go to Apps > Application Store > AutoFileManifest > click Install and follow the on-screen instructions until the installation is complete.
- 2. Configure the macro.
- 3. Configure the rule in the Rules Engine screen.
Functionality
Manifest Filing
1. Retrieves a list of shipping accounts from Linnworks.
2. For each account, initiates the filing of a manifest via the Linnworks API.
3. Monitors manifest status and ensures pending manifests are processed.
Email Notification
1. Generates a PDF label for each successfully filed manifest.
2. Sends an email notification to the specified recipient containing the manifest PDF attachment.
3. Handles errors gracefully and logs progress for monitoring purposes.
Configure The Macro
Step 1 : Go to Apps > Macro Configuration and click + Add new configuration.
Step 2 : Select the AutoFileManifest macro and click Create Configuration.
Step 3 : In the Macro Configuration screen, specify the below details and click Save:
Step 4 : Make sure to enable the macro to continue with the Rules Engine configuration.
Usage of App
Parameters
1. Vendor : Identifier for the shipping service provider.
2. AccountId : Unique identifier for the shipping account within Linnworks.
3. Email : Email address of the recipient for notification.
Execution
1. Configuration
– Set up the email server details (ServerName, port, username, password, useSSL) within the code.
– Ensure the Linnworks API endpoint (https://eu-ext.linnworks.net/api/ShippingService/) is accessible and authorized.
2. Scheduling
– Configure the macro to run on a predefined schedule using a rules engine or scheduling mechanism.
3. Execution
– At the scheduled time, the macro automatically triggers the Execute method.
– The method fetches shipping account information from Linnworks.
– For each account, it attempts to file a manifest using the ApiPost method.
– Upon successful filing, it generates a PDF label for the manifest.
Outcome
1. The macro ensures timely filing of manifests for all configured shipping accounts.
2. Email notifications are sent to the specified recipient, containing the manifest PDF attachments.
3. Logs are maintained to track the progress and handle any errors encountered during execution.
