Skip to content

Release Notes

Copyright IBM Corporation and GTD Solution Inc. 2018, 2021

Maintenance notices published on the TradeLens status page at https://status.tradelens.com/ will indicate updates to Release Notes are available when applicable.

An advanced preview notice for upcoming Release Notes will be published using My Notifications. For details, see the My Notifications section of the Support topic.

Special Release Note

  • Multi-factor authentication (MFA) will be enabled for IBMid login to TradeLens.
    • The estimated dates when this will be enabled are 09/22/2021 for Sandbox and 09/27/2021 for Production.
    • When logging into TradeLens, a verification code will be sent to your email and you will need to enter the code and click the Verify button during the sign-in process. An example of the additional screen is shown here.
    • The device should be remembered so you do not have to authenticate every time (unless using different browsers or incognito browser).

09/21/2021

(estimated date)

  • The UI has a new Event Publisher capability to help truckers (for example) send events representing the progress of a container in its journey, right from their phone. Organizations can configure default locations and containers that will be visible to truckers in drop down menus for easy selection.
  • Several UI enhancements have been made related to alerts and notifications.
  • Vessel related notifications will now include the associated identifiers for the vessel and voyage.
  • When searching for an eBL, the party reference of the consignee (from the first version of the structured eBL) will now be provided in the response.
  • Bulk document uploads now support request validation earlier in the process.  Users will now get immediate feedback if they do not have permission or structured documents have incorrect fields.
  • Bulk document uploads have added the following validation:
    • File types are restricted to the following: jpg, png, pdf, and json.
    • File names can not include the following characters: /()$%&
    • Users can not upload more than one document of the same type that has the same document references (or no document references).
  • A new eBL "on behalf of" scenario is now supported:
    • Allow consignors (agents, 3rd parties) to be the initial BL document and title receiver.
    • Allow (1) transfers, (2) switch to paper, and (3) surrenders on behalf of the consignor, mirroring the current paper BL process.  
    • The new "document receiver" will be given the same permissions as the REQUEST_PARTY in the consignment as defined in the Data Sharing Specification (DSS).
    • In order for the document receiver to be assigned the "title holder" role at BL issuance, both the document receiver and the consignor have to be entitled to use the eBL functionality.
  • API Updates (see API Release Notes 09/21/2021 for more details). 
  • Bug fixes.

09/13/2021

  • A new document type Shipper's Letter of Instruction (SLI) has been added. An update to the Data Sharing Specification (DSS) is forthcoming. The SLI can be uploaded by organizations with the role of: Seller, Buyer, Exporter, Importer, Origin 3PL Agent, and Destination 3PL Agent. The SLI can be viewed/read by organizations that are a party on the shipment with the role of: Seller, Buyer, Exporter, Importer, Origin 3PL Agent, Destination 3PL Agent, Export Customs Broker, Import Customs Broker, Certificate Issuer, Export Authority, Import Authority, Buyer's Bank, Seller's Bank, and Insurance Provider.
  • Organizations allowed to create shipments can now do so from the UI by uploading an unstructured Shipper's Letter of Instruction document and providing required meta data.  Upon success, a new notification (alert) will be sent.
  • From the consignments view in the UI, a consignment can now be linked to a shipment if no associations already exist.  Similarly, from the shipments view, a shipment can be linked to a consignment.  In either of those cases, a new notification (alert) will be sent.
  • When bulk uploading shipment documents, users are no longer required to provide consignment related data.
  • The UI for cargo owners could formerly see several top level statistics.  They were removed due to internal performance impacts.  The query APIs options used in those statistics were also removed both in the UI and API.
  • API Updates (see API Release Notes 09/13/2021 for more details). 
  • Bug fixes.

08/23/2021

  • Several dashboard enhancements have been made:
    • Updated detention and demurrage simulators indicate the billable days and cost.
    • Shipper and consignee filters were added to all dashboards.
    • Intermodal and Terminal Time screens now include 20' and 40' High Cube as container types.
    • Current dashboards now only show events from the last 180 days.
  • Surrendering an eBL document now requires acknowledgement of terms and conditions.
  • Agents can now take eBL actions on behalf of shippers and consignees. The agent gains this authority through specification of the "document receiver" (docReceiver) in the bill of lading document schema. The role has the same DSS permissions as Origin 3PL Agent.
  • The document schema IDs (documentSchemaId) remain the same, but new versions of the document schemas for Verify Copy, Sea Waybill, Bill of Lading, and House Bill of Lading are available due to the new document receiver (docReceiver) role.
  • The UI has multiple improvements including an update to organization management.
  • The alerts list presented in the UI can now be filtered by document action.
  • When a document is transferred to a new party, that party will now receive former alerts (Sea Waybill, Verify Copy, Bill of Lading, and House Bill of Lading) associated with the trade object.
  • With the previous release on 07/14/2021, partyName was added as an option to the consignment partyAdded, partyListUpdated, and partyRemoved events. Now Actionable Flows can also set the partyName from the printedParty field of the submitted document (such as a Bill of Lading). In addition, if the partyName is specified for a partyRole of CONSIGNOR or CONSIGNEE, the consignorName or consigneeName will be set to the partyName and stored in the consignment trade object. The consignorName and consigneeName values will be available through the UI (on the consignment and in search, and in the events for the partyAdded, partyListUpdated, and partyRemoved) and through the API for consignment queries, but will not be sent to Subscriptions. Subscriptions will receive the partyName field for the partyAdded, partyListUpdated, and partyRemoved events. The following will have visibility to the partyName, consignorName, and consigneeName:
    • the owner of the consignment (Transport Service Provider).
    • organizations with the Transport Service Buyer role on the consignment.
    • the following organization types if they are parties to the consignment: Customs Authority, Cargo Interest, and 3PL Agent.
  • API Updates (see API Release Notes 08/23/2021 for more details). 
  • Bug fixes.

08/04/2021

  • The UI has a new Beta feature - a container driven user experience.
    • New search options from the initial home page.
    • New Containers option in the left navigation panel.
  • Clients can perform their outstanding eBL actions, even if no longer entitled to the feature.
  • New alert types have been created representing the upload of several document types (API and UI).
  • Downloading large documents in the UI now provides an option to download in the background (as opposed to waiting on the download screen for the process to finish).
  • API Updates (see API Release Notes 08/04/2021 for more details). 
  • Bug fixes.

07/29/2021

  • User experience improvements were made around bulk document download in the UI.
  • Bulk document download now supports documents across related consignments and shipments.
  • Doc Bulk Processor API in Swagger grouping was renamed Document Sharing Bulk Operations API.
  • Alert subscriptions for document alerts now support filtering on the document action.
  • DSS Data Sharing Model for Simplified Chinese is now available (see Data Sharing Specification).
  • API Updates (see API Release Notes 07/29/2021 for more details). 
  • Bug fixes.

07/14/2021

  • Integration with INTTRA can be initiated through new "Plan" and "Booking" links in the UI.
  • Consignments now provide a view of the consignor and consignee organizations. This is available in the API and UI, but visibility is controlled based on the role of the caller.
  • Several general user experience improvements have been made to the UI.
  • Document upload maximum size is now 60MB for documents of type Inspection Certificate.
  • Documents can now be downloaded in bulk as a zip file, gathering the latest versions of all documents in either a consignment or shipment.
  • Document names may now include the comma character.
  • Dashboards intermodal time screens and terminal time screens have several enhancements:
    • There is a new filter "Stack Bars by" with options Port of Loading and Port of Discharge.
    • The content was divided into two screens: current and historical.
  • When consignments are split, only the latest transport plan will be copied over to the newly created consignment (whereas all former transport plans were copied before).
  • API Updates (see API Release Notes 07/14/2021 for more details). 
  • Bug fixes.

06/08/2021

  • Bulk document upload notifications have improved clarity for partial success.
  • New event fields are present in the UI (formerly only in the API)
    • eventPublishTime - provides the time TradeLens received the event from the publisher
    • fromOceanAggregator - identifies if the event publisher was from an aggregator (vs ocean carrier).
  • UI fields for doing consignment and shipment search are grouped into categories.
  • Dashboard support for CSV export has been improved.
  • API Updates (see API Release Notes 06/08/2021 for more details). 
  • Bug fixes.

06/01/2021

  • A new Event Publish API allows up to 100 events to be uploaded in bulk.
  • The UI has been enhanced to support managing business partner permissions before the business partner relationship has been established (formerly only supported through the API).
  • Business partner rules can now be deleted with the PATCH API.
  • Bulk document upload through the UI now triggers a "system" alert to notify the user of completion.  
  • The UI enables the creation and viewing of system alerts.
  • Events accessed through query and subscription now include an "eventPublishTime" field representing when TradeLens received the event.
  • Events sent from ocean aggregators are now filtered out once ocean carriers start sending data. This helps to prevent duplication of events.
  • Dashboards now render data formats compatible with user's browser locale.
  • Dashboards enable downloading all displayed rows of a report in CSV/Excel format.
  • API Updates (see API Release Notes 06/01/2021 for more details). 
  • Bug fixes.

05/24/2021

  • Documents can now be uploaded in bulk, including documents for consignments and shipments.
  • BCO Dashboards have several enhancements including BL number labels, date filtering, location names, bar chart groupings, country filters, date formats, and country-level selection in most recent location view.
  • References to consignments and transport equipment can now be removed even when a caller does not have visibility to the trade object (applicable only to references that the caller added).
  • Reference change events will now be applied to all matching trade objects. Formerly they had to match a single trade object only.
  • Several UI improvements including a new footer at the bottom of the Shipment Manager UI.
  • API Updates (see API Release Notes 05/24/2021 for more details). 
  • Bug fixes.

04/25/2021

  • An upgrade to our services over the weekend of 4/23-25 has resulted in a few changes that clients should be aware of. This upgrade is different than the typical release updates that are delivered for TradeLens, so this special Release Notes will mention some key changes vs new features.

  • Tokens:

    • Tokens now expire in 1 hour instead of 3 hours.

      • A 401 is returned as usual when the token expires, and this is what code should check for; however, it is worth noting that the response message string for an expired token changed from "JWT expired" to "SMException: SM_195".
    • Prior to 4/23/2021, the URL to obtain the solution token (bearer token) was
      "Solution_Manager_domain/onboarding/v1/iam/exchange_token/solution/{solutionId}/
      organization/{organizationId}", where the solutionId was "gtd-sandbox" for the sandbox zone and "gtd-prod" for the production zone. This old URL will be supported for a limited time to allow organizations to transition their code to using the new URL
      "Solution_Authorizer_domain/sa/api/v1/auth/exchange_token/organizations/
      {organizationId}", where Solution_Authorizer_domain is "https://platform-sandbox.tradelens.com" for example for the Platform stack Sandbox environment.

    • The sample exampleSolutionManagerService.zip has been updated and renamed exampleSolutionAuthorizerService.zip (provided "AS IS" without warranty).

    • See topic Authentication and Token Generation for API usage for additional information.

  • When adding a ServiceId, it is no longer necessary to specify the ServiceId as a "System User" so the System User checkbox has been removed from the UI for Add New User. See topic Authentication and Token Generation for API usage for an example.

04/14/2021

  • Consistency improvements have been made in the UI with regard to opening various pages and sub-tabs.
  • eBL has the following enhancements:
    • The endorsement chain view now includes the corresponding eBL number and document versions.
    • Every action will record the document version on the Blockchain when the action was performed.
  • References can now be added to consignments and transport equipment by organizations without visibility. They need only provide valid identifiers (for example, carrier booking number, bill of lading number, equipment number) to uniquely identify the trade object.
  • BCO dashboards have improved handling of split/combine consignments.
  • The DSS (Data Sharing Specification) has been improved for usability. API links have been added to the DSS so that any participant can filter on their role to see what APIs they need to call. Hover help for each link shows the section on the Swagger page where the API can be found.
  • API Updates (see API Release Notes 04/14/2021 for more details). 
  • Bug fixes.

03/25/2021

  • Two additional events can now trigger alerts: estimated and actual discharge from rail.
  • UI improvements were made for scrolling list views.
  • API Updates (see API Release Notes 03/25/2021 for more details). 
  • Bug fixes.

03/15/2021

  • Business Partner rules can now be configured in the UI (formerly API only).
  • A new Event Subscription API documents the full list of event fields sent to subscriptions.
  • The empty container interchanged event now marks a container as no longer in use, improving the matching of follow on events to the new usage of the container.
  • API Updates (see API Release Notes 03/15/2021 for more details). 
  • Bug fixes.

03/02/2021

  • Alerts in the UI are now presented in a slide-out view similar to events elsewhere.
  • EDI connectivity enabled for customers in China.
  • New rules can grant visibility to business partners automatically (without partyAdded events).  This feature is available in API only for now. 
  • Several usability enhancements in the UI.
  • API Updates (see API Release Notes 03/02/2021 for more details). 
  • Bug fixes.

02/01/2021

  • DSS Data Sharing Sheets was updated to V4.2, adding new role Participant Inland Service Provider.
  • A new API allows truck operators, barge operators, rail operators, and data aggregators to be granted visibility to transport equipment based on a combination of references and container numbers.
  • The UI was updated with several usability enhancements.
  • API Updates (see API Release Notes 02/01/2021 for more details). 
  • Bug fixes.

01/13/2021

  • Notify parties are now updated in consignments when they are changed explicitly in associated structured documents (Verify Copy, Bill of Lading, Sea Waybill) using Actionable Doc Flows.
  • Searching for business partners now filters out disabled organizations (no longer active on TradeLens).
  • The existing role SUBCONTRACTED_TSP is being replaced with the improved name PARTICIPANT_INLAND_SERVICE_PROVIDER.  
  • The existing Customs Release event has been updated and a new Customs Control event has been created to properly support flows in the trade industry, aligning with how many countries handle these customs operations.
  • API Updates (see API Release Notes 01/13/2021 for more details). 
  • Bug fixes.

12/17/2020

  • Beta Feature - Actionable Flows API and Shipment Manager UI enables uploading a shipment document which will handle several steps automatically: creating a shipment, adding parties/references to it, and associating the document.
    In this first phase of the beta feature, from the consignment object:
    • The organization uploading the shipment document must be an existing party to the consignment.
    • One document can be uploaded at a time. The organization must have permission (based on party role) to upload the document.
    • If a shipment is already associated with the consignment, the document will be uploaded to the existing shipment.
    • If a shipment is not associated with the consignment, a new shipment will be created using the provided reference.
    • Parties and references can be added to the shipment at the time of document upload.
  • When adding a consignment to a shipment (consignmentAdded event), now only the bill of lading is required, whereas before a booking number was needed as well.
  • UI enhancements: improvements to Business Partners table navigation and Alerts/Notification filters.
  • API Updates (see API Release Notes 12/17/2020 for more details). 
  • Bug fixes.

12/01/2020

  • Users can now export a CSV containing details for all containers that match a consignment search. 
  • The Current Progress view of a container in the UI now includes several milestone events: do not load, customs release, carrier release, terminal release, container ready for pickup, VGM submitted, and VGM received.
  • Organization admins can now provide a reason when adding a user to their org, recorded for auditability.
  • APIs that fetch events now include several fields aligning with content seen by event subscriptions.
  • eBL submission amendments can now be processed after transfer.
  • API Updates (see API Release Notes 12/01/2020 for more details). 
  • Bug fixes.

11/11/2020

  • eBL flows now support the Telex release process.
  • References throughout TradeLens now have more readable "labels" for each type.
  • Consignment search by date for "Planned Vessel Arrival" and "Planned Vessel Departure" now considers estimated and actual events to determine the most current date.
  • API Updates (see API Release Notes 11/11/2020 for more details). 
  • Bug fixes.

10/29/2020

  • Several enhancements to the UI, especially in the area of Alerts and Notifications.
  • The requirements for submitting transport plan events has been simplified. The "eventOccurrenceTime8601" field was formerly required and is now optional. However, the "transportPlanSequenceNumber" field is now mandatory.  
  • API Updates (see API Release Notes 10/29/2020 for more details). 
  • Bug fixes.

10/21/2020

  • eBL as well as other actionable flows now support search based on client provided references (shared with carriers and configured as consignment references).
  • eBL transfer logic has been updated to prevent transferring to a carrier. One can only submit a "switch to paper" request or surrender to the issuing carrier.
  • Several enhancements around Alerts including search.
  • Consignment search now supports arrays of carrier booking numbers, bill of lading numbers, or equipment numbers.
  • Consistency improvements have been added to published events:
    • The carrierBookingNumber and billOfLadingNumber fields will only be present if provided by the original sender of the event (vs only being added by TradeLens).
    • The associatedBillOfLadingNumbers field has been added and will be treated similar to the existing associatedCarrierBookingNumbers field, updated by TradeLens only.
  • UI summary view of consignments now has updated data related to the transport plan and count of transport equipment, whereas before it was from the original booking data.
  • API Updates (see API Release Notes 10/21/2020 for more details). 
  • Bug fixes.

09/30/2020

  • The former Beta "Current Progress" view of events in the UI is now the default.
  • Events published to subscribers now include location names similar to the query API.
  • When profile nicknames are updated, associated existing alerts are now also updated.
  • "Certificate Issuer" is a new organization type and party role with the ability to create shipments as well as add parties to them.
  • Several UI improvements: customized view of BOL, paging, notifications navigation, etc.
  • API Updates (see API Release Notes 09/30/2020 for more details). 
  • Bug fixes.

09/21/2020

  • Part load scenarios are now supported where multiple consignments share the same equipment in the booking stage. This is similar to part bill support, but handled prior to the bill of lading being issued.
  • The "cargoTypeUpdate" event behavior was changed (back to how it was in the past) so that it can once again be sent to either a consignment or a transport equipment.
  • Consignment updates are now tracked at a more fine grain level. Booking data can now be updated without preventing a bill of lading being issued with an older document issuance time.
  • Several UI enhancements: consistency, look and feel, keyboard accessibility, etc.
  • API Updates (see API Release Notes 09/21/2020 for more details). 
  • Bug fixes.

09/03/2020

  • A default user preferences profile is now set up (using logged in credentials) eliminating the need to set this up manually in order to leverage notifications and alerts features.
  • eBL transfers in the UI are now enabled for more than just organization admins.
  • Commodity description fields are now properly URL decoded on the UI (removes odd % characters).
  • Several other UI enhancements in the areas of alerts, document views, and endorsement views.
  • eBL now supplies the ocean carrier with a list of organizations for which the eBL was endorsed to during the workflow.  
  • eBL now supports the House Bill of Lading from an NVOCC.
  • API Updates (see API Release Notes 09/03/2020 for more details). 
  • Bug fixes.

08/24/2020

  • Support has been added for the House Bill of Lading schema.
  • UI enhancements were made around user preferences, endorsement chains, and eBL views.
  • Actionable Flows eBL flows can supply the Ocean Carrier with a list of organizations in which the eBL was endorsed during the workflow. 
  • The "document issuance time" related to Actionable Flows API is now leveraged to ensure proper ordering of changes to successive BoL uploads.
  • Parties granted visibility implicitly by transport plans or actionable flows are now more controlled, preventing the potential to be overwritten by explicit party add/remove/update events.
  • Several improvements were made to properly match events with trade objects.
  • API Updates (see API Release Notes 08/24/2020 for more details). 
  • Bug fixes.

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.