Traide Changelog

This release contains internal improvements and maintenance updates.

Fulfillment status emails​

Added email notifications for fulfillment confirmations and denials, keeping customers informed about the status of their orders.

Refund confirmation emails​

Added email notifications when refunds are processed, providing customers with confirmation of their refund details.

Product images in order emails​

Order confirmation and related emails now include product images, making it easier for customers to identify their purchased items.

Customer account activation emails​

Added email notifications when customer accounts are activated, improving the onboarding experience.

Search orders by voucher code​

Marketplace orders can now be searched by voucher codes and names, making it easier to find orders associated with specific promotions.

Fulfillment update webhook​

Added a new webhook event that triggers when fulfillment details are updated, enabling better integration with fulfillment systems.

Email template sorting​

Email templates can now be sorted in the dashboard, making it easier to organize and manage your email communications.

Performance improvements​

Made several performance improvements across the platform:

• Shipping zone country validation is now significantly faster.
• Checkout creation and line item additions are more efficient.
• Order queries are optimized for better response times.
• Discount application during checkout is faster.

Email template improvements​

Enhanced email templates with improved layouts, better organization, and clearer personalization options. Order-related emails now display currency symbols and complete marketplace addresses.

Fixed an issue where volume discount fields were inadvertently removed, causing errors in existing integrations.

Fixed an error that could occur when updating seller shipping methods during checkout with certain seller ID formats.

Fixed an issue where the vendorType field was removed without proper deprecation, restoring compatibility with existing queries.

Fixed a dashboard issue where order summaries were missing volume discount information in delta calculations.

Fixed an issue where the tracking_url field was missing from the fulfillment schema, preventing tracking information from being properly returned.

Fixed filtering on custom field values to work correctly with instantiated values.

Fixed an issue where vouchers limited to one use per customer could be incorrectly marked as used, preventing legitimate redemptions.

Fixed validation for "once per customer" vouchers to properly check usage history before application.

Fixed an issue where updating checkout notes would error if the note text didn't change.

Fixed handling of recipient updates in gift checkout flows.

The webhookSamplePayload query has been deprecated. Please update your integrations to use alternative methods for testing webhook payloads.

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.