Traide Changelog

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.

External ID support for products and variants​

Added the ability to specify an external ID when creating products and variants, making it easier to integrate with external systems and maintain cross-platform references.

Improved voucher discount calculations​

Fixed voucher discount calculations to ensure accurate pricing when applying promotional codes at checkout.

Marketplace configuration updates​

• Supported currencies are now managed through marketplace configuration instead of domain settings, simplifying multi-currency setup.
• Removed deprecated domain and client-related GraphQL queries and mutations, streamlining the API surface.

Attribute value references​

Updated how attribute value references are handled, improving consistency when working with product attributes.

Fixed an issue where refunds not connected to orders could cause errors during payout processing.

• Stripe webhook events now properly update refund status.
• Credit card details are now correctly populated during Stripe webhook processing.
• Refunds are no longer processed multiple times, preventing duplicate transactions.
• Fixed handling of refunds charged to multiple sellers simultaneously.

• Guest users can now view their own orders on the thank you page.
• Ensured that declined quantities are always positive values.
• Fixed an issue with quote orders that have a total amount of zero.

• Fixed checkout purchase event tracking.
• Resolved an issue when removing vouchers from checkout.

Made user ID optional for source permission groups, improving flexibility in permission management.

Fixed an issue where refunds processed through Stripe were not consistently being updated to the PAID status.

Fixed an issue where refunds charged to the seller were not included in the seller payout calculations in certain cases.

Fixed an issue with the payout summary for a seller order (order.payoutsSummary.refunds), where the reported refund amount could be incorrect in certain situations. This issue did not affect the actual payout amount.

Removed the sites model, referred to as domains in the dashboard. Supported currencies for the marketplace will now be read from MarketplaceConfiguration.

Improved discount tracking​

Enhanced the discount system to ensure the correct discount values are consistently saved and tracked across order and checkout flows.

Order fee IDs now returned​

The orderFeeCreate mutation now returns the ID of the created fee, making it easier to track and reference fees programmatically.

Updated payout permissions​

All payout-related mutations now require the MANAGE_MARKETPLACE permission for improved security and access control.

Sale type requirement​

The saleType field is now required when creating or updating sales, ensuring consistent categorization of promotional activities.

Fixed an issue where guest checkout without automatic payment capture was not working correctly. Guests can now complete checkout flows that defer payment capture.

Fixed an issue where creating a checkout for guest users required an email address. Guest checkouts can now be created without providing an email upfront.

Fixed an error that occurred when converting certain checkout types to quote orders, ensuring a smoother quote generation process.

Fixed an issue where payment amounts could exceed the remaining order balance (total minus already captured payments), preventing over-payment scenarios.

Fixed an issue that could create duplicate transaction records in the database, ensuring cleaner payment tracking.

Fixed an issue where certain monetary input values were not being correctly parsed, ensuring accurate order totals and fee calculations.

Fixed an issue where the orderFeeCreate mutation was not returning the ID of the order fee it created.

Fixed an issue that resulted in an AttributeError with the checkoutConvertToNauticalQuoteOrder mutation.

Customer update webhook on address changes​

The customer_update webhook now fires when a customer's address is added, updated, or removed, making it easier to keep external systems in sync with customer data.

Performance improvements​

Made several performance improvements across the platform:

• Checkout completion is now significantly faster, addressing latency issues during order finalization.
• Product variant price calculations are more efficient, reducing database queries.
• Creating and updating marketplace order lines is optimized for better performance.

Fixed an issue where some fields were missing when adding refund lines to orders.

Fixed an issue where field validation errors were displayed twice when creating a customer account.

Fixed an issue where CSV uploads on draft and quote orders could fail or produce incorrect results.

Fixed an issue where the payoutUpdate mutation could update payouts that were already marked as completed or failed.