Traide Changelog

Added the capability to search Nautical orders by voucher code, improving searchability and tracking within the system.

Introduced a new webhook event for fulfillment_updated, enabling real-time tracking for fulfillment status updates.

Improved stability and latency issues in ShippingZone.is_supported_country_area that were affecting Checkout timeouts.

Enhanced checkout stability:

• Fixed integer casting error in CheckoutSellerShippingMethodsUpdate to improve error handling and accuracy when incorrect ID types are provided.
• Addressed issues where voucher usage limits were causing checkout failures.

Added tracking URLs to the fulfillment schema, allowing better visibility and traceability for fulfillment status.

Introduced validation to prevent duplicate voucher codes in a single checkout. Now, attempting to apply the same voucher code multiple times raises an InvalidPromoCode error with a clear message.

For the full list of deprecations and suggested replacements, see GraphQL API Deprecations and Removals.

Newly Deprecated​

The following fields and types are now deprecated and will be removed in future releases:

• Webhooks - webhookSamplePayload.

Fully Deprecated​

The following fields, types, and mutations have reached end of their deprecation period and have been removed:

• actions - Orders will be changed to have no actions. All actions should be performed against the NauticalOrder.
• quantity - On the nauticalOrderLine and OrderLine models. Use the more explicit quantityOrdered instead.
• quantity - On the refundLine model. This value was split into quantityFulfilled and quantityUnfulfilled.
• currencies.totalLinesPrice.
• defaultCurrency.
• isSellerShippingZoneCreationAllowed.

This release contains internal improvements and maintenance updates.

This release contains internal improvements and maintenance updates.

This release contains internal improvements and maintenance updates.

This release contains internal improvements and maintenance updates.

This release contains internal improvements and maintenance updates.

Email notifications for order and payout events​

Added email rendering support for the following events:

• Order cancellation notifications
• Partial order cancellation notifications
• Vendor payout confirmation emails

These emails are now automatically sent when the corresponding events occur, improving communication between the marketplace and its participants.

Fixed an issue where order owners couldn't update order line metadata when they didn't have the full order management permission assigned.

Fixed an issue where the volume discount field was incorrectly removed from the API. The field has been restored to allow for proper deprecation in a future release.

Removed deprecated features​

The following deprecated features have been removed from the API:

• Branding-related GraphQL types and fields
• Core data types and queries
• assignNavigation mutation
• Deprecated Shop type fields
• Fulfillment.totalLinesPrice field
• Affiliates functionality
• Channel-related types and fields
• volumeDiscount field from orders

If you're still using any of these features, please update your integration before upgrading.

Email rendering for order and quote events​

Added support for rendering emails for the following events:

• Pending orders
• Order confirmations (including marketplace operator notifications)
• Pending quotes
• Quote requests

These emails now use global template variables for consistent branding and formatting across all email communications.

Customer upgrade to seller​

Customers can now be upgraded to sellers directly through the API, streamlining the onboarding process for new marketplace vendors.

JWT authentication for single-tenant deployments​

Added JWT authentication support for single-tenant installations, providing consistent authentication across all deployment types.

Metadata filtering for categories and product types​

Added the ability to filter categories and product types by metadata, making it easier to organize and query your catalog based on custom attributes.

Better error handling for unknown tenants​

Requests to unknown tenants now return a proper 404 error instead of a generic error message, improving API error clarity.

Unified customer address rendering​

Customer addresses are now consistently formatted across all email templates, improving the visual presentation of shipping and billing information.

Fixed crashes in email rendering when processing certain recipient names and restored proper recipient handling for order confirmation emails.

Fixed an issue where updating a seller could fail if the slug conflicted with another seller's slug, now properly enforcing uniqueness constraints.

Fixed an issue where checkout would not properly validate product availability, now correctly throwing an error when any product in the cart is unavailable.

Restored the totalLinesMoney resolver that was inadvertently removed, ensuring order line totals are calculated correctly.

Fixed GraphQL errors that could occur when querying designer data that doesn't exist, and corrected the error code returned when updating marketplace configuration.

Added the ability to filter the following by public and private metadata:

• Categories
• Product Templates
• Attributes

Customers can now upgrade their accounts to sellers without creating a new account.

Enhanced API stability with improved logging, monitoring, and error handling.

Enhanced checkout stability:

• Checkouts now display an error when a product is unavailable.
• Fixed error handling for line items from sellers without signed agreements.

Staff members can now perform metadata updates on OrderLine items for orders they placed.

Corrected error messages when attempting to update marketplace configurations.

For the full list of deprecations and suggested replacements, see GraphQL API Deprecations and Removals.

Newly Deprecated​

The following fields, types, and mutations have reached end of their deprecation period and have been removed:

• Branding
• CoreData
• assignNavigation mutation
• Shop Type fields
• Fulfillment.totalLinesPrice field
• Affiliates - All affiliates-related fields, queries and mutations
• Channels - Channel-related fields and types

Enhanced email notifications​

Added support for rendering several new email notification types, providing better communication with users throughout their journey:

• Account activation requests and pending customer notifications
• Account deactivation notifications
• Account deletion confirmations
• Password reset emails for both staff and customers
• CSV export status notifications (success and failure)
• Seller onboarding and status change notifications
• Invoice ready notifications

Custom fields on fulfillments​

Added support for custom fields on fulfillments, allowing you to capture additional fulfillment-specific information when processing orders.

Global background color customization​

Storefronts now support setting a global background color, providing more flexibility in customizing the look and feel of your marketplace.

Product configuration defaults updated​

Product creation now defaults to not requiring product types and uses flexible attribute template strategy, simplifying the product setup process.

Performance improvements​

Made several performance improvements across the platform:

• Order payout status calculations are now significantly faster
• Checkout price calculations are more efficient
• Database queries are limited to 30 seconds to prevent long-running operations

Fixed an issue where expired authentication tokens could cause server errors instead of returning proper error responses.

Fixed an issue with marketplace payout recipient queries that could return incorrect results in certain scenarios.

Fixed an issue with checkout data prefetching that could cause inconsistent behavior.

Fixed permission issues when querying seller agreements that prevented authorized users from accessing agreement data.

Standardized email greetings and support email variables across all notification templates for consistency.

Login requirements for viewing products are now deprecated and will be removed in a future release.

Markup-based commission calculations are now deprecated. Future releases will focus on alternative commission models.