Traide Changelog

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.

Fixed an issue where financial ledger lock failures caused ledger imbalances and checkout issues.

Improved error handling around authentication to prevent tenant validation middleware from causing 500 errors when tokens expire.

Stabilized the permissions for agreement queries to ensure correct access control.

Optimized the Order.payout_status query to improve response time and handling for payout status updates.

Added the ability to include custom fields in fulfillments and the OrderFulfill mutation for greater flexibility.

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

Login For Products​

The "Login For Products" marketplace option has been deprecated and removed.

Email change request notifications​

Added email rendering support for account email change requests and confirmations, improving communication when customers update their email addresses.

Fixed an issue where capturing a payment could incorrectly trigger the nautical_order_fully_paid event in certain scenarios.

Fixed incorrect titles and descriptions appearing in certain API responses.

Fixed an issue preventing favicon images from being uploaded properly in checkout themes.

Fixed an issue with the Order.vendorPayout field during the deprecation transition period to ensure accurate payout data.

Email system improvements​

Added a new email infrastructure with support for multiple email providers, starting with Postmark integration. This provides more reliable email delivery and better template customization options.

Refund tracking on order lines​

Added unfulfilledQuantityRefunded and fulfilledQuantityRefunded fields to order lines, making it easier to track refund quantities separately for fulfilled and unfulfilled items.

Multiple orders per payout​

Changed the relationship between orders and vendor payouts to support many-to-many connections, allowing a single payout to include multiple orders for more flexible payout management.

Better handling of product type deletion​

Improved the product type deletion process to properly handle attributes that are used across multiple product types, preventing accidental data loss.

Performance improvements​

Made several performance improvements across the platform:

• Calculating available shipping methods by seller is now significantly faster.
• Collection mutations are more efficient when managing products.

Fixed an issue where guest checkout confirmations could fail for anonymous buyers.

Fixed an issue that could cause product pages to return errors when displaying certain attribute configurations.

Fixed an issue where attribute values and assignments could have null sort orders, ensuring consistent ordering across the platform.

Fixed an issue where the manage_emails permission was not automatically migrated to the full access group during upgrades.

Fixed an issue where adding permissions to seller admin groups could fail in certain scenarios.

Fixed an issue where seller checklists were returning existing table data instead of default values.

Fixed an issue where staffCreate and staffUpdate mutations were not triggering the appropriate webhook events.

Fixed an issue where guest orders were not generating a SalesInvoice in Avalara.

Resolved an issue where the Nautical order confirmation was not appearing for guest users.

Fixed an attribute-related inequality error on the products page.

Resolved an issue where the new MANAGE_EMAILS permission was not automatically added to users with full access permissions.

Fixed an issue where users were unable to add permissions to the seller admin group.

Orders related to previous payouts will now remain linked to that payout, even when the same order is involved in a new payout.

Addressed a timeout issue on collection reordering mutations.

staffCreate and staffUpdate now correctly trigger the appropriate user events.

Added unfulfilledQuantityRefunded and fulfilledQuantityRefunded fields to the OrderLine. These fields now reflect the quantities refunded on orders.

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

Default Shipping Zone​

• The default field for ShippingZone will be removed on October 17, 2024. Shipping zones will no longer be marked as default, and this field will no longer be supported. The default shipping zone will be used for countries not covered by other zones.

Email template preview and customization​

Added comprehensive email template preview functionality, allowing you to preview how emails will appear before sending them. This includes support for account-related variables, invoices, quotes, CSV exports, staff accounts, seller notifications, and order confirmations. Email templates now support storefront theming in headers and footers for a consistent brand experience.

Seller logo and banner management​

Added the ability to delete seller logos and banners directly through the API, providing more control over seller branding assets.

Warehouse management improvements​

Enhanced warehouse creation with additional configuration options, making it easier to set up and manage warehouse locations.

Improved order filtering​

Seller orders can now be filtered by vendor payout IDs or payout IDs, making it easier to track and reconcile payments.

Multi-tenant support for Prismatic​

Prismatic integrations now work seamlessly in multi-tenant environments, with proper tenant isolation and permissions.

Fixed an issue where staff members could not update metadata on checkout objects that belonged to them.

Fixed an issue that prevented users from logging in with the same email address across different tenant environments.

Fixed an issue where seller members could not access checklist data they should have had permission to view.

Fixed product bulk delete operations to return standardized error messages, improving error handling and debugging.

• Fixed product status logs to display in a consistent, predictable order.
• Fixed an issue where payment capture operations did not properly trigger marketplace order processing in certain scenarios.

Fixed address preparation logic when business and shipping addresses are different, ensuring accurate address handling.

• Fixed tenant creation to properly initialize default content, permission groups, and marketplace seller accounts.
• Fixed email template backfilling for existing tenants to ensure all tenants have access to the latest email templates.
• Fixed Redis cache keys to be tenant-specific for country data and tax calculations, preventing data leakage between tenants.
• Fixed a missing favicon field in storefront theme configuration.

Removed deprecated agreement fields and plugin configuration settings that are no longer in use.

Added the ability to filter seller orders by vendor payout IDs or payout IDs. It is now easier to get the overall list of orders that are included in payouts via vendorPayout and payouts queries.

• Added mutations to delete the banner and logo on Sellers.
• Seller staff members, in addition to seller owners, can now access and complete Seller Onboarding Checklist tasks.
• Added the ability to set the seller's default address as the warehouse address when creating new warehouses.

Staff can now perform metadata updates on checkouts that belong to them.

Fixed issue where certain payment capture types were not triggering autocommit in Avalara when the Autocommit toggle was set to true.

Improved error handling in the product bulk delete flow. Error message now shows the reason for failure if the one or more products are in active orders.

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

Designer Data Undeprecated​

Undeprecated designerData to meet SendGrid requirements. This data will remain available until further notice.