Schedule MacroRIS-SM-2028 – ShippingErrorLabel

Shipping Error Label Monitoring

Monitor shipping label generation failures and send automated email alerts for affected orders to ensure quick resolution.

Overview

The RIS-SM-2028 – ShippingErrorLabel macro monitors recent orders for shipping label failures and notifies stakeholders via email.

It scans open orders, detects label errors, sends alerts, and tags affected orders to prevent duplicate notifications.

Ensure SMTP email configuration is correctly set up before running this macro.

Purpose

This macro:

  • Detects orders with shipping label errors
  • Sends email alerts with order details
  • Tags processed orders to avoid duplicate alerts

👉 In short:
Monitor label errors and notify via email.

When It Runs

Used for error monitoring and alerting

Typically runs:

  • Scheduled execution (recommended)
  • Manually triggered
  • Before or after label generation workflows

Parameters

path
locationsstring
Required

Comma-separated list of warehouse locations to monitor.

path
useSSLboolean
Required

Enable or disable SSL for email communication.

path
portnumber
Required

SMTP port number.

path
userNamestring
Required

Email account username.

path
passwordstring
Required

Email account password.

path
fromEmailstring
Required

Sender email address.

path
fromNamestring
Required

Sender display name.

path
toEmailstring
Required

Recipient email address.

The macro processes only recent orders (last 1 day) from the specified locations.

How It Works

Initialize Email Settings

Configure SMTP server, authentication, and email details.

Fetch Locations

Parse input locations and match them with Linnworks locations.

Retrieve Open Orders

Fetch open orders from the last 24 hours for selected locations.

Identify Error Orders

Filter orders where shipping label errors exist and no identifier is assigned.

Send Email Alerts

Generate email content with order details and send notifications.

Track Processed Orders

Store order IDs that have been processed.

Assign Identifier

Assign identifier: "Shipping Label Error" to avoid duplicate alerts.

Log Execution

Record processing details, success, and completion.

Final Result

  • Orders with label errors are identified

  • Email alerts are sent to stakeholders

  • Orders are tagged to prevent duplicate alerts

  • Monitoring process is logged

Usefulness

This macro is highly beneficial for:

  • Detecting shipping issues early
  • Enabling faster issue resolution
  • Preventing dispatch delays
  • Automating alert mechanisms
  • Improving warehouse efficiency

Important Notes

  • Processes only orders from the last 1 day

  • Requires correct SMTP configuration

  • Uses identifier to prevent duplicate alerts

  • No retry mechanism for failed emails

  • Credentials must be handled securely

  • Depends on LabelError field availability

Example Scenario

Key Insight

By proactively monitoring and alerting shipping label failures, this macro ensures rapid issue resolution and prevents operational bottlenecks in the fulfilment process.