Skip to main content

26.08.01

Introduction

We are pleased to announce the release of Piyovi v26.08.01, which includes key enhancements aimed at improving usability, operational efficiency, and shipment visibility. Below is a summary of the new features and updates included in this release.

Customizable Doc Tab for 4x8 Carrier Labels​

The Doc Tab on 4x8 carrier labels has been enhanced to provide greater flexibility for customer-specific labeling requirements.

Previously, the Doc Tab used a fixed layout with a predefined set of information. It can now be customized to match your company's operational and labeling needs.

What Can Be Customized​

Based on your requirements, the Doc Tab can be tailored to include:

  • Reference Numbers — Choose which reference information appears on the label.
  • Barcodes — Display selected reference numbers as scannable barcodes.
  • Freight / Cost Information — Include applicable published, discounted, or marked-up values.
  • Custom Attributes — Include relevant shipment, package, or item-level information.
  • Package Details — Include information such as weight, dimensions, declared value, tracking number, and dates.
  • Label Naming and Layout — Customize the label content and layout to better align with your business requirements.

Benefits​

This enhancement provides greater flexibility to create 4x8 carrier labels that better fit your operational processes, reducing the limitations of the previous fixed Doc Tab format.

Notes:

  • No changes are required for existing customers. Current 4x8 labels will continue to print as they do today.
  • Doc Tab customization is available based on customer requirements.
  • If you would like to customize the Doc Tab for your organization, please contact the Piyovi Support Team with your requirements.

Webhook Failure Notifications in In-App Notifications​

Piyovi now displays webhook delivery failures in the In-App Notifications panel, allowing users to identify integration issues and take action without navigating to the Webhook page.

Benefits​

  • Quickly identify failed webhook deliveries.
  • Review failure details directly from the notification.
  • Retry failed webhooks without leaving the current page.

Enable notifications: Configuration → Integrations & API → Webhook → Add/Edit Webhook → Notify To Shipper

View notifications: Header → Bell Icon

How to Use​

First, open the required webhook and enable Notify To Shipper. This setting must be enabled to receive webhook failure notifications in the application. When a webhook delivery fails, the Bell icon displays the notification count. Click the Bell icon to open the Notifications panel and view the failed webhook.

Each webhook failure provides two actions:

  • View — Opens the event details, including the URL, response status, status message, and other event information.
  • Resend — Retries the failed webhook delivery.

Steps​

  1. Navigate to Configuration → Integrations & API → Webhook.
  2. Add or edit the required webhook.
  3. Enable Notify To Shipper and save the webhook.
  4. When a delivery fails, click the Bell icon in the application header.
  5. Locate the Webhook Failed notification.
  6. Select View to review the failure or Resend to retry the webhook.

Notes: Notify To Shipper must be enabled on the webhook to receive webhook failure notifications through the Bell icon.

Return Configuration in Business Rules​

Business Rules now include a dedicated Return tab that allows return shipment settings to be configured directly within the rule.

When a Business Rule is applied during shipment creation, the configured return values are automatically populated in the shipment's Return section. This enhancement helps standardize return shipment setup and reduces manual entry for users.

Benefits​

  • Reduces manual entry when creating return shipments.
  • Helps apply consistent return carrier and payment settings.
  • Supports location-aware return configuration.
  • Prevents invalid carrier, service level, or account selections from being applied.
  • Keeps return settings centrally managed within Business Rules.

Configuration → Rule Engine → Business Rules → Add/Edit Rule → Return

Note : The Return tab is available only for Business Rules.

How to Use​

The new Return tab allows users to define the return shipment settings that should be applied when the Business Rule is matched.

Available fields include:

  • Carrier
  • Service Level
  • Account
  • Type
  • Return Shipment Type
  • Payment Type
  • Account number
  • Zip code
  • Country

When a Carrier is selected, the available Service Levels and Accounts are loaded based on that carrier.

Payment Information Behavior​

If Payment Type = Sender:

  • Account number
  • Zip code
  • Country

are not required.

If Payment Type is not Sender, the following fields become mandatory:

  • Account number
  • Zip code
  • Country

The rule cannot be saved until the required payment information is provided.

Steps​

Configure Return Settings in a Business Rule​

  1. Navigate to Configuration → Rule Engine → Business Rules.

  2. Create a new Business Rule or edit an existing rule.

  3. Open the Return tab.

  4. Select the required Carrier.

  5. Select the applicable Service Level and Account.

  6. Configure Type and Return Shipment Type.

  7. Select the required Payment Type.

  8. If the Payment Type is not Sender, enter:

    • Account number
    • Zip code
    • Country

  9. Complete the remaining Business Rule criteria.

  10. Click Save.

The configured values are retained and displayed when the rule is opened again for editing.

Add Rule screen in Business Rules showing the Return tab with Carrier, Service Level, Account, Type, Return Shipment Type, and Payment Type fields configured.

Return tab in the Business Rule editor with return shipment fields configured.

Automated Delayed Shipment Notifications through Report Scheduler​

Piyovi now supports scheduled reporting for Delayed Shipments through the existing Report Scheduler.

Users can create a Shipment report schedule using the new Delayed Shipments sub-type and automatically receive reports for shipments that are behind schedule. This allows operations teams to proactively monitor delayed shipments and take action without manually running reports.

Benefits​

  • Provides proactive visibility into delayed shipments.
  • Reduces the need for manual monitoring.
  • Helps operations teams identify shipment delays earlier.
  • Uses the existing Report Scheduler workflow, so no separate configuration process is required.
  • Supports the same report filters, columns, sorting, time zone, and delivery options already available in Report Scheduler.

Configuration → Automations → Report Scheduler → Add/Edit Report

How to Use​

A new Shipment Report Sub-Type option is available for Shipment reports.

Users can select:

Delayed Shipments

When the schedule runs, Piyovi generates a report containing shipments that meet the delayed shipment criteria and delivers it through the configured channel. The Delayed Shipments report supports the existing Report Scheduler capabilities, including:

  • Filters
  • Column selection
  • Sorting
  • Schedule frequency
  • Schedule time
  • Time zone
  • Excel or CSV format
  • Email delivery
  • SFTP delivery Existing Shipment report schedules continue to work without any changes.

Steps​

Configure a Delayed Shipments Schedule​

  1. Navigate to Configuration → Automations → Report Scheduler.
  2. Click Add Report or edit an existing report schedule.
  3. Select Shipment as the Report Type.
  4. Select Delayed Shipments as the Shipment Report Sub-Type.
  5. Configure the required filters, columns, and sorting.
  6. Select the report frequency and schedule time.
  7. Choose the required output format, such as Excel or CSV.
  8. Configure the delivery channel, such as Email or SFTP.
  9. Select the required Time Zone.
  10. Save the schedule.

At the configured time, Piyovi generates the Delayed Shipments report and delivers it through the selected channel.

Add Report screen with Report Type set to Shipment and Shipment Report Sub-Type set to Delayed Shipments, alongside filter, frequency, and schedule options.

Add Report screen configured for a Delayed Shipments schedule.

Document Share - Secure Document Sharing​

Piyovi now allows users to securely share shipment documents with customers, carriers, brokers, and other external recipients without requiring a Piyovi account.

Benefits​

  • Share one or multiple shipment documents through a secure link.
  • Support Public, Access Code, and Email OTP access.
  • Allow recipients to preview and download documents.
  • Set expiration dates or revoke access when needed.
  • Track share activity and downloads.
  • Customize the external portal with company branding.

Create Share: Shipment View → Docs → Select Documents → Share

Manage Shares: Configuration → File Exchange → Document Share

How to Use​

Select the required shipment documents and create a share with the appropriate access type. Piyovi generates a secure link that can be sent to external recipients.

Recipients can access the shared documents based on the configured security method and then preview or download the available files.

Detailed User Guide

For complete instructions covering share creation, Public/Private access, Access Code, Email OTP, expiration, document downloads, revocation, activity tracking, and portal branding, refer to:

📘[Document Share – https://docs.piyovi.io/guides/shipment/Document-share]

Note: External recipients do not need a Piyovi account to access shared documents. Access is controlled according to the security settings configured when the share is created.

“Action By” Column in Spot Quote Bid Grid (Ship)​

A new “Action By” column has been introduced in the Bid Grid within the Spot Quote tab in Ship. This column identifies the user who accepted or rejected a bid.

Benefits​

  • Helps identify the user who accepted or rejected a bid.
  • Provides better visibility into bid actions performed during the Spot Quote process.
  • Makes it easier to track who performed the bid action.

Ship → Spot Quote → Bid Grid* → Action By

How to Use​

When a bid is accepted or rejected, the Action By column will display the name of the user who performed the respective action.

Impact​

No action is required from users. The Action By column appears automatically in the Bid Grid and populates as bids are accepted or rejected going forward.

Spot Quote Bid Grid showing the new Action By column with the name of the user who accepted or rejected the bid.png

Bid Grid in the Spot Quote tab highlighting the Action By column.

OAuth Credentials (Configuration)​

Piyovi now provides a dedicated configuration screen for OAuth credentials. Users can create OAuth clients directly from the UI. Rotate and Revoke are available as additional options to manage existing clients.

Configuration → Security → OAuth Credentials

How to Use​

The OAuth Credentials screen allows you to create up to 2 clients per company. Client name, Client ID, and Client Secret are all system-generated and read-only.

The secret is displayed only once at creation or rotation, it cannot be retrieved later.

Create​

  1. Navigate to Configuration → Security → OAuth Credentials.
  2. Click Create Credentials. The system generates the Client Name, Client ID, Token URL, and Client Secret.
  3. Copy the Client Secret immediately, it will not be shown again.

OAuth Credentials page with Create Credentials button.png

OAuth Credentials page with Create Credentials button

New Client Secret modal displaying the generated Client ID and Client Secret.png

New Client Secret modal displaying the generated Client ID and Client Secret

Rotate​

  1. Click Rotate Secret next to the client.
  2. Confirm the action. The old secret is invalidated immediately.
  3. Copy the newly generated secret and update your integration.

Active tokens generated with the old secret remain valid until they expire.

Rotate Client Secret confirmation dialog.png

Confirmation dialog shown before rotating a client's secret.

Rotate success confirmation with newly generated Client Secret.png

Success banner and newly generated secret displayed after rotating.

Revoke​

  1. Click Revoke next to the client.
  2. The client is permanently deleted. No new tokens can be generated.

Any tokens already issued continue to work until they expire.

Revoke OAuth Credentials confirmation dialog.png

Confirmation dialog shown before revoking a client's OAuth credentials.

Revoke success confirmation with OAuth Credentials page cleared.png

Revoke success confirmation with OAuth Credentials page cleared

Note: 

Requires Manage Company OAuth Application or Manage Company permission.

Mod 9 Check Digit for PRO Number Ranges​

Mod 9 is now available as a check digit option when setting up PRO number ranges. The system automatically calculates and appends the check digit to every generated PRO number.

Configuration → Carrier → Tracking → Number Range → Check Digit

How to Use​

When adding a new PRO number range, select Mod 9 from the Check Digit dropdown. Enter the start and end values and save. The system appends the calculated check digit to every PRO number generated from that range.

The system sums all digits of the base PRO number and applies: (9 − (sum % 9)) % 9. The result is appended as the final digit.

Example:  Base PRO 2334654  →  sum = 27  →  check digit = 0  →  final PRO = 23346540

Steps​

  1. Navigate to Configuration → Carrier → Tracking → Number Range.
  2. Click Add to create a new PRO range.
  3. Set the Check Digit field to Mod 9.
  4. Enter the Start and End values for the range and save.

Add Config panel showing Check Digit dropdown with Mod 9 selected.png

Add Config panel showing Check Digit dropdown with Mod 9 selected

Note: PRO number ranges are read-only after creation and cannot be edited.

Recharge Support for Freight Com​

Piyovi now supports postage recharge for Freight Com carriers. Users can add funds directly from the carrier settings without leaving the platform.

Configuration → Carrier → Freight Com → Recharge

How to Use​

Open the Recharge tab on the Freight Com carrier page. Select the Account ID, enter the recharge amount, and click Buy Postage. All transactions are logged with Transaction ID, Account Number, Recharge Amount, Status, and Error Message.

Steps​

  1. Navigate to Configuration → Carrier and select Freight Com.
  2. Click the Recharge tab.
  3. Select the Account ID from the dropdown.
  4. Enter the Recharge Amount.
  5. Click Buy Postage and verify the transaction appears in the table.

Freight Com Recharge tab with Account ID, Recharge Amount, and transaction log.png

Freight Com Recharge tab with Account ID, Recharge Amount, and transaction log

Flexible Label Format Configuration​

Piyovi now allows you to configure your preferred label format through document settings. After a shipment is processed, the label is generated in the format selected for the carrier assigned to that document.

 Configuration → Documents → Add Document

How to Use​

Add a document and select the preferred label format. Once saved, all shipments processed for the carrier assigned to that document will generate labels in the configured format.

Steps​

  1. Navigate to Configuration → Documents.
  2. Click Add Document.
  3. Select the desired label format from the Label Format field.
  4. Save the document. After shipment, the label will be generated in the selected format for the carrier associated with that document.

AES Filing Master Export to Excel​

A Master Export option has been added to the AES Direct Filings. This allows users to export detailed AES filings data to an Excel file.

The Master Export option is accessible via the three-dots menu at the top right of the AES Direct Filings.

Benefits​

  • Download detailed AES Direct filing data in Excel format.
  • Review, analyze, filter, and share filing information offline

Export Filing → AES Direct Filings → Three dots Menu → Master Export

Steps​

  1. Navigate to Export Filing → AES Direct Filings.
  2. Locate the three-dots menu at the top-right of the grid.
  3. Click the three-dots menu.
  4. Select Master Export.
  5. The system generates and downloads the filing data as an Excel file.
  6. Open the downloaded file to review detailed filing information.

Filings grid with three dots menu showing Master Export.png

Filings grid with three dots menu showing Master Export

Note: The user must enable the Ability to Export AESDirect permission for the required roles to allow users to export the master file for AESDirect filings.

Declared Currency​

A Declared Currency column has been added to the Packing level. The currency is stored separately for each package along with its declared value.

Benefits​

  • Every declared monetary value has an associated currency.
  • Automatically applies the appropriate location currency to new packages.

Packing → Packages → Declared Currency

Steps​

Add a Package​

  1. Navigate to the Ship Screen and add a new package.
  2. Add the column(Declared Currency) from the column options for package level
  3. Verify the Declared Currency is auto populated with the current location's currency (or USD if none configured)

Change the Currency​

  1. Select the Declared Currency field for a package.
  2. Search for and select the required currency code, or type one manually.

Edit Location dialog showing Default Currency field.png

Edit Location dialog showing Default Currency field

Packing tab with Declared Currency column displaying values per package.png

Packing tab with Declared Currency column displaying values per package

Declared Currency dropdown open with currency options.png

Declared Currency dropdown open with currency options

Note: Each new package automatically receives the currency configured for the current location.

Kitting – Pack and Ship Kit-Based Orders​

Piyovi now supports Kitting, allowing kit-based orders to be packed and shipped while maintaining the relationship between the kit and its individual components.

Kit structures are received from the connected ERP or order system and are automatically identified on the Packing screen.

Benefits​

  • Clearly view kit and component items.
  • Pack complete kits or individual components.
  • Support barcode scanning for kits and components.
  • Split kit components across multiple packages.
  • Generate a dedicated Kit Packing Slip with configurable layouts.

Packing: Ship → Shipment → Packing Kit Packing Slip: Configuration → Shipping & Compliance → Documents

How to Use​

When a shipment contains a kit, Piyovi groups the kit and its components on the Packing screen. Users can pack the complete kit, individual components, or scan barcodes as part of the normal packing workflow.

A kit is considered complete once all required component quantities have been packed.

Detailed User Guide​

For detailed instructions on packing, scanning, quantities, multiple packages, and Kit Packing Slip configuration, refer to:

📘 [Kitting –  https://docs.piyovi.io/guides/shipment/Kitting]

Notes:

  • Kit structures come from the ERP/order system and cannot be manually created in Ship.
  • Users physically pack the components, not the kit parent line.
  • Kit components can be packed across multiple packages.

Improved Navigation and List Page Experience​

Piyovi navigation has been updated to make features easier to find and provide a consistent experience across Configuration, Shipment, and Export pages.

The Configuration menu now has clearer functional sections, while key operational pages use a consistent sidebar and toolbar layout.

Benefits​

  • Makes settings and workflows easier to find.
  • Provides clearer grouping of related features.
  • Creates a consistent experience across frequently used pages.
  • Provides more room to work by letting you collapse the sidebar when it's not needed.

The updated navigation is available in the following areas:

  • Configuration → Shipping | Compliance | File Exchange
  • Shipments → Manifest | Batch Shipment | Ship Confirm | Returns | Consolidation | Spot Quote
  • Export → AESDirect

How to Use​

  • Configuration: Previously Shipping & Compliance section has been reorganized into separate Shipping and Compliance sections. File Exchange is also available as its own section, making these settings easier to access.

Configuration Shipping section showing the expanded sidebar with Address Book, Package, Product, Freight Cost, Documents, Custom Documents, GS1, and HazMat, and the Address Book list open.png

Configuration → Shipping section with the reorganized sidebar.

Configuration Compliance section showing the sidebar grouped separately from Shipping, with a compliance list page open.png

Configuration → Compliance section shown as its own sidebar grouping.

Configuration File Exchange section showing the sidebar and file list with Period and Document Type filters.png

Configuration → File Exchange section available as its own sidebar item.

  • Shipments : Operational pages such as Manifest, Batch Shipment, Ship Confirm, Returns and Spot Quote now follow the same sidebar and toolbar pattern. Select the required option from the sidebar and use the available toolbar actions to search, filter, create, refresh, export, or perform other supported actions.

Shipments page showing the sidebar with Manifest, Batch Shipment, Ship Confirm, Returns, Consolidation, and Spot Quote, and toolbar actions above the shipment list.png

Shipments page showing the sidebar with Manifest, Batch Shipment, Ship Confirm, Returns, Consolidation, and Spot Quote, and toolbar actions above the shipment list

  • Export: For AESDirect, filing status filters remain available in the sidebar for quickly accessing All, Pending, Approved, Rejected, or Canceled Filings.

AESDirect page showing the sidebar filters for All, Pending, Approved, Rejected, and Canceled Filings.png

AESDirect page showing the sidebar filters for All, Pending, Approved, Rejected, and Canceled Filings

  • Collapse Menu: Use the collapse control on the sidebar to hide the menu, and select it again to bring the sidebar back.

sidebar with the Collapse Menu control highlighted at the bottom.png Sidebar with the Collapse Menu control highlighted at the bottom

Notes: This update changes the organization and presentation of navigation. Existing workflows, permissions, filters, and supported actions remain available, although some Configuration settings may now be located under a different section.

Paperless CI and Pickup Details Options for Return Shipments  ​

Two new options, “Paperless CI” and “Pickup Details,” are now available under the Return tab in Ship. These options will help users to manage Paperless CI and pickup details for return shipments. 

Benefits ​

  • Allows users to select the Paperless CI option for applicable return shipments.  
  • Allows users to specify the Pickup Date and Pickup Time for return shipments.  
  • Provides better control over return shipment pickup scheduling.  

Ship → Return Tab → Paperless CI / Pickup Details 

How to Use ​

Paperless CI ​

  • The Paperless CI option is available for both Return Shipment and Outbound and Return shipment types.  
  • Users can select Yes or No for the Paperless CI option if required.

==image_0==.png

Pickup Details ​

  • The Pickup Details option is available when the shipment type is selected as Outbound and Return.  
  • Users can select the required Pickup Date and Pickup Time.  
  • The selected pickup date and time will apply only to the Return shipment.

==image_0==.png

Headless Changes​

https://docs.piyovi.io/changelogs/api-reference#v260801