Traide Changelog

Fixed an issue where payout adjustments could be calculated incorrectly for certain vendor payout configurations.

Fixed an issue where vouchers set to "apply once per order" were not correctly applying to the lowest-cost eligible product.

Fixed an issue where content with a future publication date could be incorrectly marked as published immediately.

Fixed an issue where voucher usage tracking was incorrectly recorded when applying vouchers to draft orders.

Fixed an issue preventing the creation of new content using a slug that was previously used by deleted content.

Content management mutations​

Added new mutations for managing marketplace content:

• Create, update, and publish content pages
• Auto-save draft content with automatic expiration
• Discard draft changes
• Delete content pages

Draft content auto-saves expire after 30 minutes of inactivity.

Country-based shipping zones​

Added support for defining shipping zones by country areas, allowing more granular control over where shipping methods are available. Shipping zones now support:

• Country area definitions for more precise geographic coverage
• Validation to ensure country areas are configured correctly
• Metadata and private metadata fields for custom shipping zone data
• Metadata and private metadata fields for shipping methods

Marketplace supported countries​

Added supportedCountries to marketplace configuration, allowing operators to define which countries are available for shipping and checkout. The shop.countries query now respects this configuration when the feature flag is enabled.

Order line relationships​

Added a nauticalOrderLine field to OrderLine, making it easier to access marketplace-specific order data.

Fixed several issues with product attributes:

• Swatch attributes now behave correctly when applied to products and variants
• File attributes can now be properly assigned and updated
• Attribute input values now have explicit validation

Fixed multiple issues with voucher application:

• Vouchers with "once per order" enabled now correctly apply to only one variant
• Vouchers use the minimum price from available products when calculating discounts
• Vouchers with "once per customer" enabled now properly prevent reuse by the same customer
• Percentage discounts now use proper rounding (ROUND_HALF_UP) for more accurate calculations

Fixed an issue where content creation would succeed with duplicate slugs. The API now returns an error when attempting to create content with a slug that already exists.

Fixed an issue where querying sellers could fail if the seller record was missing an owner.

Fixed an issue where adding a new address to a customer record did not trigger the Customer Updated webhook.

Fixed an issue where payment tokens could be incorrectly updated while processing Stripe webhooks.

The isSellerShippingZoneCreationAllowed field has been deprecated in favor of the new country area-based shipping zone configuration.

Added the value input field to AttributeValueInput to support more input type usages, such as the color value for swatch attributes.

Added metadata and privateMetadata to the following models:

• ShippingMethod
• ShippingZone

Manage metadata with the metadataUpdate and privateMetadataUpdate mutations.

Fixed an issue where the customer_updated webhook was not being triggered by adding a customer address.

Deprecated the isSellerShippingZoneCreationAllowed field on the MarketplaceConfiguration model. This field will now always be overridden as true and wil be removed soon.

Unique seller slugs​

Sellers now have unique URL-friendly slugs, making it easier to reference and link to seller profiles throughout the platform.

Query sellers by slug​

Added the ability to query sellers using their unique slug, providing a more user-friendly way to retrieve seller information.

Public seller information​

Introduced a public seller query that returns limited seller information, ideal for displaying seller profiles on storefronts without exposing sensitive data.

Storefront theme customization​

Added support for storefront theme modeling, enabling customization of storefront appearance and branding through queries and mutations.

Media management​

Introduced new media queries and mutations for managing media assets across the platform, providing better control over images, videos, and other media content.

Content management​

Added content type support with queries, enabling more flexible content management capabilities within the platform.

Enhanced shipping zone configuration​

Added support for country-area shipping zones, providing more granular control over shipping configurations by geographic region.

Expanded fee support​

Platform fees can now be applied to any orders, providing more flexibility in how marketplace fees are structured and applied.

Legacy dashboard configuration fields have been marked as deprecated and will be removed in a future release. Please migrate to the new configuration system.

Fixed an issue where shipping sale discounts were not being properly subtracted from order totals.

Fixed an issue preventing seller slugs from being edited through the API.

Fixed validation issues with sale discount amounts that could result in incorrect discount calculations.

Fixed an issue where voucher discounts were not being apportioned correctly across order lines, ensuring accurate per-line discount calculations.

Improved the accuracy of order payout status filtering, ensuring queries return the correct results.

Fixed an issue where image fields were missing alt text attributes.

Fixed an issue where WorkOS user profile information was not being properly retrieved during SSO token creation.

Fixed an issue where inactive sales were being displayed on product and variant pages. Only active sales are now shown.

Seller slug field​

Added the slug field to the Seller model.

PublicSeller model​

Added the PublicSeller model, to retrieve public information about sellers. Also added the sellerBySlug query to retrieve a publicSeller by their unique slug.

Fixed an issue where you could not add order fees to fulfilled orders.

Deprecated dashboard types​

The following types related to the Dashboard have been deprecated:

• The dashboard query
• The dashboardConfigurationUpdate mutation

Sales and vouchers on products and variants​

Added the ability to view all active sales and vouchers directly on product and variant objects, making it easier to understand which discounts apply to specific items.

Voucher apply-once per product​

Added support for vouchers that can be configured to apply only once per product, even when multiple quantities are in the cart. This provides more granular control over discount application.

Sale shipping type updates​

Sales can now be updated to change their shipping type, providing more flexibility in managing promotional campaigns.

Filter staff users by active status​

Added the ability to filter staff users by their active/inactive status, making it easier to manage team member access.

Marketplace default country configuration​

Added a default country setting to marketplace configuration, which is now used throughout the platform for better localization support.

External ID support for warehouses and product images​

Warehouses and product images can now be created or updated using external IDs and sources, simplifying integration with external systems.

Performance improvements​

Made several performance improvements across the platform:

• Updating shipping methods on orders is now significantly faster.
• Creating draft order lines is more efficient.
• Discount calculation performance has been optimized throughout checkout and order flows.

Password reset improvements​

The password reset mutation now allows the redirect URL to be optional, providing more flexibility in implementation.

Fixed an issue where vouchers configured for specific products would incorrectly calculate discounts based on the entire cart subtotal instead of only the specified products.

Fixed an issue where removing the last item from a checkout could cause errors when discounts were applied.

Fixed an issue where sale discount amounts were not properly updated when order line quantities changed.

Fixed an issue where discount amounts in the ledger were incorrect on order finalization.

Fixed an issue where older orders would fail to load when discount v2 features were enabled.

Fixed an issue where adding products to checkouts could cause errors in certain scenarios.

Fixed an issue where the platform could crash if Avalara returned incomplete transaction data.

Fixed how voucher data is sent to Avalara for invoice creation, resolving checkout issues related to tax calculation.

Fixed an issue where invalid refunds could be incorrectly connected to payouts in the ledger flow.

Fixed an issue with Stripe configuration where the auto-capture setting was not properly retrieved.

Fixed an issue with product and variant substatuses not displaying correctly.

Fixed an issue where the PRODUCT_UPDATED webhook was not firing when product features were modified.

Removed deprecated API features​

Removed several long-deprecated queries, mutations, and fields from the API:

• Service account queries and mutations
• Barcode queries
• Legacy webhooks query
• Various deprecated type fields

If you are still using these deprecated features, please update your integration to use the recommended alternatives.

The staffUserInput type now accepts the userIsActive field, which is a boolean that can be used to filter if a staff member is active or not.

Improved handling when Avalara doesn't return a response after posting a transaction.

The product_updated webhook will now be triggered by changes to product features.

Added a MarketplaceConfiguration field for defaultCountry, which will be used to set the default country in the storefront in a future release.

Fixed an issue where refunds in an invalid state could connect to payouts.

Product review deprecations​

The following types have been marked for deprecation and will be removed on October 1, 2024:

• The productRatingsAndReviews query
• The productReviewSubmit mutation

Catalog export deprecations​

The catalogExport mutation is no longer supported and has been marked for deprecation. This will be removed on October 1, 2024.

Catalog type removals​

The following previously deprecated types related to catalog management have been removed:

Order type removals​

The following previously deprecated types related to checkout and orders have been removed:

Warehouse type removals​

The following previously deprecated warehouse mutations have been removed:

User type removals​

The following previously deprecated user management mutations have been removed:

Webhook type removals​

The following previously deprecated webhook and service account types have been removed:

Seller type removals​

The following previously deprecated seller-related mutations have been removed:

Designer type removals​

The following previously deprecated designer-related mutations have been removed:

Metadata type removals​

The following previously deprecated metadata mutations have been removed:

YotPo plugin removal​

The YotPo plugin has been removed, including removal of the following types:

• YotpoCustomer
• UserInput
• customerLoyaltyAndReferralsDetails
• loyaltyAndReferralsInfo
• YotpoCustomer
• yotpoLoyaltyAndReferralsCreateOrUpdateCustomerRecord
• yotpoLoyaltyAndReferralsAwardCustomerLoyaltyPoints

CORS configuration improvements​

Enhanced CORS (Cross-Origin Resource Sharing) configuration to support environment-based settings, providing more flexibility when deploying the API across different environments.

Discounted unit price display​

Checkout lines now display the discounted unit price, making it easier for customers to see savings at the line-item level during checkout.

Product and variant creation with existing attributes​

Added support for creating products and variants using existing attribute values, streamlining the product setup process for sellers with established attribute libraries.

Discount ledger recordings​

Financial ledger entries now include detailed discount information, providing better tracking and reporting of promotional impacts on orders.

Feature flag-based pricing and tax display​

Pricing and tax information across checkout and orders now respects feature flag configurations, allowing for more flexible rollout of pricing changes and tax calculation methods.

Order data access from order lines​

Order lines now expose their parent order data, enabling better integration with refund management interfaces.

Fixed an issue where payment capture amounts could exceed the revised order total, preventing overpayment in cases where orders were modified after initial authorization.

Fixed an issue where the discounted total wasn't being properly saved when completing checkout, ensuring accurate order totals.

Fixed an issue where payment status could display incorrectly for certain orders, improving order management clarity.

Fixed an issue where sale discounts were being incorrectly adjusted when recalculating draft orders, preserving the intended discount amounts.

Fixed an issue where orders with a full discount, leaving a balance of $0, were not being marked as paid.