Skip to content

Release Notes

Copyright IBM Corporation and GTD Solution Inc. 2018, 2020

08/06/2020

  • Ocean carriers can now configure partners associated with routes in the the transport plan so that their partners are granted visibility implicitly, removing the need to send "partyAdded" events for them.
  • Filtering options have been added to the "unassociatedEvent" API to aid in troubleshooting.
  • The Business Partner UI now enables bulk upload of partner references.
  • Several UI enhancements to the document viewers.
  • The Bill Of Lading Verifier API now supports finding Sea Waybills.
  • Actionable Flows is no longer Beta.
  • The name of the "Ocean Carrier API" Swagger page was changed to "Carrier API".
  • API Updates (see API Release Notes 08/06/2020 for more details). 
  • Bug fixes.

07/23/2020

  • Several UI enhancements related to user experience and consistency.
  • Actionable Flows now prevents back-leveling documents using "docIssuanceTime" specified in the API.
  • Notifications and Alerts enhancements:
    • Email is now supported as alert vehicle (formerly webhooks only).
    • Additional event types added as triggers for alerts: Container Discharged, Container Full Release. 
  • API Updates (see API Release Notes 07/23/2020 for more details). 
  • Bug fixes.

07/13/2020

  • The Business Partner API now enables bulk upload of partner references.
  • Events are now assigned priority based on the data provider and time published. This priority is reflected in both the API and UI (showing highest priority first).
  • A new "Current Progress View" presents planned, estimated, and actual events in a rolled up view of the most current information. Actual events get the highest priority followed by estimated and then planned.
  • Actionable Flows eBL flow supports a new terminal state, "Switch to Paper", available in both the API and UI.
  • API Updates (see API Release Notes 07/13/2020 for more details). 
  • Bug fixes.

06/29/2020

  • Webhook alerts can now be configured for specific event types and associated locations. Set this up using new APIs in Swagger under "User Preferences API" and "Notifications & Alerts API", or through the UI under Account > User Profile / Alerts & Notifications.
  • Retroactive party access. Starting now, events posted to add parties will be reviewed and applied at a later time when those parties are onboarded to TradeLens.
  • Several UI features and improvements including SI management in Actionable Flows.
  • New consolidated transport event type for publishers to submit planned, estimated, and actual events.
  • Actionable Flows updates:
    • SI-BOL flows now allow all VC/BOL to be accepted at any point.
    • Flow definition updated to support "switch to paper" action.
  • API Updates (see API Release Notes 06/29/2020 for more details). 
  • Bug fixes.

06/15/2020

  • Integration Framework now publishes Shipping Instructions related to Actionable Flows.
  • Document Sharing supports the following new document types (unstructured only):
    • For consignments: Importers Security Filing, In Transit Bond 
    • For shipments: Cargo Tally Sheet, Certificate of Insurance
    • For all trade objects: Pictures
  • Several UI enhancements including:
    • Update to the event slide-out.
    • New table/view for SI actionable documents, including VC and BOL.
  • New API User Guide for developers in the documentation: https://docs.tradelens.com/reference/api_user_guide/
  • There are no API updates with this release.
  • Bug fixes.

06/02/2020

  • Several UI improvements: managing business partners (search/edit/delete), accessibility, time stamp consistency, new SI structured document view, updated BOL view for Actionable Flows.
  • Actionable Flows SI upload now adds parties for existing consignments.
  • Part bill support is now extended to include combined consignment scenarios.
  • API Updates (see API Release Notes 06/02/2020 for more details). 
  • Bug fixes.

05/20/2020

  • Initial support for Part Bills.
  • Several document schemas were updated: SI, BoL, SWB, and VC.
  • Updated Bill of Lading document view in the UI, accommodating the latest schema.
  • UI improvements for configuring business partners.
  • A new event is generated internally representing a Verify Copy document has been issued through Actionable Flows, including the capability to handle split and combine use cases.
  • A new group of "Organization Admin" APIs are now in Swagger for managing users in an organization.
  • API Updates (see API Release Notes 05/20/2020 for more details). 
  • Bug fixes.

05/07/2020

  • Cargo Interest organizations have an updated UI landing page with high level statistics across the top.
  • Each page of API documentation (Swagger) now has a version at the top. It will only be updated when an underlying API changes, enabling easier change management for integrations.
  • A new role, Subcontracted_TSP, can be applied to a trade object, providing access to trade objects and events, but not documents. This role is often ideal for subcontracted truck and rail companies.
  • Time zone specific time stamps are now applied to events in cases where they were missing by the publishers, but the UN/Locode was provided (for which a time zone can be determined).
  • A new status page is available at https://status.tradelens.com/ where you can view current system status, active and past incidents, and upcoming maintenance for Production and Sandbox environments. Subscribe to receive status notifications.
  • API Updates (see API Release Notes 05/07/2020 for more details). 
  • Bug fixes.

04/20/2020

  • Fix for Chrome browser disambiguation error during login (delivered to Prod 4/02/2020).
  • Business partner references can now be updated or deleted (API only, UI coming soon).
  • Several UI enhancements related to consistency and user experience.
  • Published events support a new flexible format, enabling multiple forms at the same time (UN/Locode, Address, SPLC, Geo Coordinates, etc).
  • API Updates (see API Release Notes 04/20/2020 for more details). 
  • Bug fixes.

03/31/2020

  • UI updates to buttons and landing page navigation.
  • Bill of Lading Verifier API (for financial institutions) is now more flexible for finding bills of lading.
  • API Updates (see API Release Notes 03/31/2020 for more details). 
  • Bug fixes.

03/19/2020

  • UI improvements: consistency with dates, show sender info for docs, new eBL form view.
  • Bill of Lading Verifier API is no longer case sensitive.
  • API Updates (see API Release Notes 03/19/2020 for more details). 
  • Bug fixes.

03/05/2020

  • eBL improvements
    • Now searchable based on status (API and UI).
    • Ensure documents controlled by actionable flows can only be modified by flow updates.
  • UI improvements
    • Various fields that are not accessible per data sharing specification are listed as such.
    • Navigation improved between consignments and shipments.
    • Consignment search by location is more flexible with type-ahead.
  • Event subscription tools are now available in Swagger to enable, disable, get status, and test webhooks.
  • Events now include the sender organization type (subscription, query API, UI).
  • Sensitive information in events (for example commodity type and originator information) is now only available to appropriate organizations. Orgs that do not have the proper type will not receive these fields on events on subscriptions or in event queries. This affects the following fields:
    • bookingData.commodities.harmonizedCode
    • bookingData.commodities.commodityDescription
    • harmonizedCodes
    • originatorName
    • originatorId
    • senderOrgName
  • API Updates (see API Release Notes 03/05/2020 for more details). 
  • Bug fixes.

02/25/2020

  • Support the new Document Sharing Specification (DSS V4.0) defining new access privileges for each organization type and role.
  • Support for shipments as a new trade object including new APIs and UI.
  • UI enhancements: consignment search by transport equipment references, event slide-out panel, etc.
  • New Actionable Flows automation grants access to parties on the Bill of Lading.
  • Updated documentation topic Setting up Subscriptions with information that the webhook will receive events from the TradeLens platform as a JSONArray. Currently, this array of events is an array of size one.
  • API Updates (see API Release Notes 02/25/2020 for more details). 
  • Bug fixes.

02/10/2020

  • Several UI updates around displaying references, arrays of seal numbers.
  • eBL Beta available in Production (it was only in Sandbox on 01/29/2020).
  • Actionable flows events now indicate the destination organization involved in the transaction. Also, new schema versions for SI, VC, and BoL are available in Production. SI-BoL flow works only with the latest schema version.
  • New flexible management of trade object references including APIs to remove and do bulk updates.
  • Integration Framework: IFTMIN EDI mapping enhancements in shipping-instruction outbound flows. 
  • API Updates (see API Release Notes 02/10/2020 for more details). 
  • Bug fixes.

01/29/2020

  • UI has a new left side navigation bar.
  • UI and API now provide and isolated view of each version of consignment transport plans.
  • UI now prompts the user at login for permission to collect statistics to improve experience and optimize site functionality.
  • New flexible support for managing access to trade objects (consignments and transport equipment).
    • Tighter control of what organization types and roles can create trade objects and grant party access.
    • New APIs for removing parties and doing bulk uploads of all parties at once.
  • Remaining trade object APIs involving delegation IDs are deprecated and replaced by new APIs based on trade object IDs.
  • Actionable flows updates (Beta - and the following function is in Sandbox zone)
    • eBL flow (Beta) for bill of lading is now available (Sandbox zone) and can be used for issue, transfer, and surrender actions. 
    • New schema versions have been introduced (Sandbox zone - Shipping Instructions, Verify Copy, Bill of Lading, Sea Waybill).
  • API Updates (see API Release Notes 01/29/2020 for more details). 
  • Bug fixes.

12/17/2019

  • The "Query API" in Swagger has been renamed to "Trade Object API".
  • The UI option to search by delegation ID has been removed. The platform is moving away from the use of delegation IDs as redundant. Existing broad options provide complete search capability.
  • New permissions validation is in place when creating trade objects (consignments and transport equipment), but also when granting access to other parties.
  • Document Sharing APIs now support fetching the content and metadata for printable versions of documents, when they have been uploaded/associated.
  • To improve data quality in several scenarios, event handling logic was updated to not process transport events that include an equipment number, a full status set to empty, but no carrier booking number or bill of lading number.
  • Document events seen by query APIs and subscriptions have three new values available for the "action" field in support of Actionable Flows: issued, transferred, and surrendered.
  • API Updates (see API Release Notes 12/17/2019 for more details). 
  • Bug fixes.

12/05/2019

  • New validation when creating, updating, and adding parties to trade objects, considering the organization type and role of the caller.
  • New Swagger "Platform Constants API" used as the new home for APIs to fetch event types and country codes. It was formerly part of the "Query API" in Swagger.
  • Several UI improvements.
  • Access to consigneeUpdated and shipperUpdated events is now limited to Authorities unless the values of the consigneeId and shipperId are hashed, per the associated consigneeIdType and shipperIdType field.
  • API Updates (see API Release Notes 12/05/2019 for more details). 
  • Bug fixes.

11/14/2019

  • UI enhancements: new list views, landing page search, consignment details, search for consignments based on equipment number is now case insensitive.
  • System users can now have admin authority to enable automation of APIs only usable by organization admins.
  • Actionable Flows (Beta) updates:
    • Updated APIs
    • Ability to trigger new actions on documents (message flows)
    • Support for updated Sea Waybill schema
    • Add Bill of Lading as accepted schema
  • Several Event Publish APIs formerly deprecated are no longer visible in Swagger. They will be deactivated in as early as one month from now. They have the form POST /visibility/v1/events/*.  Only a small number of similarly named APIs remain documented, although still deprecated. When consignments are split, booking data is now copied over to the new split consignment.
  • API Updates (see API Release Notes 11/14/2019 for more details). 
  • Bug fixes.

11/05/2019

  • Events including the equipment type have more flexible validation. Formerly the "equipmentType" had to fit into a fixed list of enumerated values. Now it needs to abide by the ISO 6346 standard.
  • UI updates
    • Business partner UI shows an indicator if party references have been assigned.
    • Consignment search can be done by vehicle name, and several search fields are now case insensitive.
  • Vehicle name now accepted in several API and displayed instead of vehicle ID in the UI when available.
  • New event subscription type providing authority level access to provinces and associated ports.
  • API Updates (see API Release Notes 11/05/2019 for more details). 
  • Bug fixes.

10/24/2019

  • New Bill of Lading Verifier feature for financial services institutions only (updated 3/05/2020). A new Swagger API is available for this under "Financial Institution API". The Bill of Lading Verifier solution is sold separately. Contact us at https://tradelens.com/connect if you are interested in purchasing this feature or speaking directly with one of our sellers.
  • New support for split consignments, via API and UI.  This involves enhancements to several APIs including the specification of the Bill of Lading number to support routing events to the proper consignment after a split.
  • Combined consignments are now supported.
  • Various usability improvements to UI elements (summary cards, pagination).
  • Several UI enhancements - improved split/combine consignments, consistency, etc.
  • New Doc Sharing API enables pagination when fetching large numbers of transactions.
  • Events can now be published with equipment numbers missing the final digit.
  • Integration Framework - SFTP user accounts for message transfers supports both key-based and password based authentications.
  • Data Sharing Specification updated to V2.3, includes two new roles: Participant Bank and Transport Service Provider.
  • API Updates (see API Release Notes 10/24/2019 for more details). 
  • Bug fixes.

09/17/2019

  • New scenarios supported, leveraging a new "transferFromConsignment" field when creating or updating a piece of equipment.
    • Combining consignments at the booking stage (no bill of lading issued yet)
    • Split consignments at the booking stage (no bill of lading issued yet)
    • Swap equipment between consignments at the booking stage (no bill of lading issued yet)
  • UI Improvements for managing business partners for an organization.
  • API Updates (see API Release Notes 09/17/2019 for more details). 
  • Bug fixes.

09/05/2019

  • New Business Partner APIs (Customer Discovery) allowing customers to securely identify and share with each other. The UI and Swagger are available to org admin users.
  • Integration Framework SFTP service supports Key based authentication.
  • Miscellaneous UI enhancements including improved usability when editing structured documents.
  • New equipment types supported when publishing events for transport equipment.
  • API Updates (see API Release Notes 09/05/2019 for more details). 
  • Bug fixes.

08/26/2019

  • Improved UI look and feel: subscriptions, search filters, user/org management.
  • Integration Framework: support for EDIFACT Booking Confirmation message.
  • New equipment types supported when sending the event to create transport equipment.
  • Bug fixes.

08/07/2019

  • Integration Framework enhancement of email flow to support configurable extensions for .txt and .toc files.
  • UI enhancements - drop down filter updates, originator displayed for documents.
  • API Updates (see API Release Notes 08/07/2019 for more details). 
  • Bug fixes.

07/26/2019

  • Integration Framework support for the older (v1) version of CODECO & COARRI messages sent by some ports and terminals.
  • New UI experience when searching and filtering consignments.
  • New UI visual representation of the location summary above events.
  • Bug fixes.

07/11/2019

  • Actionable Doc Flows feature has been branded "Beta", to better support changes from customer feedback.
  • Integration Framework: support email flow to multiple recipients. 
  • New event API to assert the status of a consignment. The UI shows this status and allows users to filter on it.
  • UI now supports creating subscriptions and filter on document events/types/actions.
  • Updated design for displaying events in the UI.
  • Improvements to reduce number of duplicate events sent to subscriptions.
  • API Updates (see API Release Notes 07/11/2019 for more details). 
  • Bug fixes.

07/02/2019

  • Shipping Instruction documents can now be published as EDI, per actionable doc flows and the integration framework.
  • A new document type, Verify Copy, has been introduced to support Shipping Instructions and Bill of Lading flows.
  • New equipment types are now supported, exposed in APIs to create transport equipment.
  • New event filtering options are now available for document events in org, country, and port subscriptions.
  • UI improvements around Document Sharing. 
  • Document sharing APIs and UI have better validation on document references.
  • Document sharing supports a way to submit documents on behalf of another party (originatorName, originatorId).
  • Updated Data Sharing Specification to V2.2 includes new Verify Copy and House Bill of Lading document types.
  • API Updates (see API Release Notes 07/02/2019 for more details). 
  • Bug fixes.

06/13/2019

  • UI supports adding reference fields to documents when uploading.
  • New event type filter option added to org level subscriptions, enabled in API and UI.
  • Minimize duplication of events sent to subscriptions.
  • API Updates (see API Release Notes 06/13/2019 for more details). 
  • Bug fixes.

05/30/2019

  • UI now shows the role of the organization within consignments and transport equipment.
  • Documents can now be uploaded/associated with transport equipment on the UI.
  • Document schemas have been updated for Shipping Instructions and Bill of Lading.
  • API Updates (see API Release Notes 05/30/2019 for more details). 
  • Bug fixes.

05/20/2019

  • Consignment hierarchies have been introduced, where consignments can have subconsignments.
    • Note: Some limitations exist, like needing to establish a hierarchy before associating transport equipment.
  • Documents can now be associated with Transport Equipment through the APIs (for example Dangerous Goods). UI support will come soon.
    • New V2 Document Sharing APIs, more flexible to handle documents for Consignments and Transport Equipment.
    • Note: Support is limited to new Transport Equipment created after this feature is deployed.
  • New Actionable Flows APIs support the parsing of Bill of Lading and Shipping Instructions documents.
    • These APIs automatically create the consignments, transport equipment, and their association.
  • UI enhancements: consolidated route information, new event details view, consistent event timestamps.
  • API Updates (see API Release Notes 05/20/2019 for more details). 
  • Bug fixes.

05/08/2019

  • Data Sharing Specification updated to V2.1.
  • Document schemas can now be deprecated.
  • New user experience when creating documents.
  • Events now identify the sending organization in the API and UI.
  • New field names to be used in document related events.
  • Integration Framework: Support for handling archived (zip) files sent as email attachments.
  • Performance improvements when sending events to subscribers.
  • API Updates (see API Release Notes 05/08/2019 for more details). 
  • Bug fixes.

04/11/2019

  • Integration framework can now handle documents in the form of Excel files received by email.
  • Usability improvements when searching for consignments in the UI.
  • Events, including those for the transport plan, are now visible for consignments in the UI.
  • Doc sharing APIs expose new identifiers when creating and querying documents. 
  • Terminals no longer receive events after they are removed from the transport plan.
  • API Updates (see API Release Notes 04/11/2019 for more details). 
  • Bug fixes.

04/04/2019

  • New flexible APIs for creating, updating, and querying consignments and transport equipment.
  • Booking information has been added to consignments and can be viewed in the UI.
  • Dynamic event routing based on transport plan events, limiting irrelevant events after route changes.
    • Dynamic route calculation is based on the transport plan: For transport equipment (TE) created with the new POST /v2/transportEquipment endpoint, port and country subscriptions will receive the TE events based on the locations in the planned events.
    • Events including a terminal that is not found in the transport plan will no longer get events.
  • UI and underlying API enhancement to display location descriptions for UN/LOCODE values.
  • Support for EDI and documents as attachments in email messages with tradelens.com domain.
  • Document schema deprecation policy. When old schemas are deprecated, uploads require a new schema.
  • API Updates (see API Release Notes 04/04/2019 for more details). 
  • Bug fixes.

03/14/2019

  • Booking information now available for consignments (UI and API).
  • UI navigation update with new top level menu.
  • UI updated to show "Full" or "Empty" on Gate-in and Gate-out events.
  • Performance improvements.
  • API Updates (see API Release Notes 03/14/2019 for more details).
  • Bug fixes.

02/28/2019

  • User experience improvements: layouts, interactions.
  • API Updates (see API Release Notes 02/28/2019 for more details).
    • Document sharing APIs now include the file type in API responses.
    • Optional equipmentType added to transportEquipment/equipmentNumberUpdated.
    • Document events now include document version.
    • Several deprecated APIs removed from Swagger API documentation.
  • Performance improvements: event handling, API throttling to protect from DOS.
  • Bug fixes.

02/08/2019

  • Enable uploading custom document types with a specified namespace (docTypeNamespace).
  • User experience improvements around document sharing.
  • Complete support for document versioning.
  • Event API: New fields transportPlanTotalNumber and transportPlanSequenceNumber in plan events (initial changes that will roll into upcoming features to improve carrier integration).
  • Miscellaneous enhancements around security and resiliency.
  • Bug fixes.

01/31/2019

  • User experience improvements: accessibility, look and feel, performance.
  • Behavior update for the "partyAdded" (E001) event for proper access to events and documents.
  • Globalization and security improvements.
  • Performance improvement in subscriptions.
  • Integration framework support for parsing Excel (CSV) files into structured document uploads.
  • Fixed race condition formerly resulting in event duplication.
  • Miscellaneous bug fixes.

01/21/2019

  • Enhanced document permissions, controlled at the level of organization role and document type.
  • Document permission overrides enabled for transport service buyers.
  • API update to get all documents and bulk download document APIs.
  • APIs for document sharing change to make docReference optional.
  • User experience improvements: event filtering, document organization, and other UI enhancements.
  • Security improvements: vulnerability fixes, unique blockchain channels for small carriers.
  • Performance and stability improvements.
  • Miscellaneous fixes.