477 posts tagged with "API"

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.

Email template management system​

Introduced a comprehensive email template management system that allows marketplace operators to customize and manage all customer, seller, and staff email notifications. This includes:

• GraphQL API mutations for creating and updating email templates
• New permission level (MANAGE_EMAILS) for controlling access to email template management
• Preview functionality to test email templates before sending
• Pre-configured templates for customer, seller, and staff notifications that are automatically loaded when creating new tenants

Product status change tracking​

Added the ability to track product status changes over time. When a product's status is updated, the system now logs the change with a timestamp, making it easier to audit product history and understand when products were published, unpublished, or modified.

Automatic media titles​

Media files uploaded without a title now automatically receive a default title, improving organization and searchability of product images and other media assets.

External ID support for variant bulk creation​

Added support for external IDs and sources when bulk creating product variants, making it easier to integrate with external systems and track variant origins.

Soft deletion for categories​

Categories can now be soft-deleted, allowing them to be hidden from the storefront while preserving historical data and relationships with products.

Seller onboarding checklist enhancements​

The seller onboarding checklist now includes:

• A query to check if all account setup tasks are completed
• Descriptions indicating whether specific tasks can be skipped
• Improved task completion tracking that only marks store setup as complete when truly finished

Enhanced seller profile queries​

The sellerBySlug query now returns additional fields, providing more comprehensive seller information in a single request.

Performance improvements​

Made several performance improvements across the platform:

• Optimized tenant data loading in middleware to reduce redundant queries
• Eliminated performance bottlenecks when loading multi-tenant data models
• Improved query efficiency for better overall platform responsiveness

Fixed an issue where sellers could delete or edit shipping zones they didn't own, improving data security and preventing unintended modifications.

Fixed an issue where Jinja template tags were incorrectly appearing in raw email content, ensuring templates render properly.

Fixed several API-related issues:

• Warehouse mutations now properly check user permissions before allowing changes
• Unique constraints that should have been tenant-specific are now correctly scoped
• Improved error messaging when accessing seller information without proper authentication

Fixed an issue that prevented the populatedb command from running multiple times, making it easier to reset development environments.

October 2024 deprecations​

Removed previously deprecated features as part of the October 1, 2024 deprecation cycle. Additionally, microsites and the features system have been deprecated and will be removed in a future release.

Added productStatusLogs to field to the Product type. This field tracks and saves changes to product statuses, including:

• The user who made the status change.
• The sub-status of the product and the reason for the change.
• A timestamp of when it was updated.

Added additional fields to the sellerBySlug query:

• Banner
• Store description
• Status

The VariantBulkCreate mutation now take externalId and externalSource as inputs.

Fixed an issue with category deletions. Added soft deletion that ensures ledgers, audit trails for commission calculations, and order cancellations are not blocked by deleted categories.

Sellers can now only delete warehouses and shipping zones they own.

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

Newly Deprecated​

The following types have been marked for deprecation:

• The microsites and all related query and mutations.
  • Please use sellerBySlug to query seller related information
  • Please use the collections functionality to create custom product and variant collections
• The features and all related query and mutations.
  • Please use customFields and attributes

Product review functionality has been removed​

The following types had been marked for deprecation and have been removed in this version:

• The productRatingsAndReviews query
• The productReviewSubmit mutation

Catalog export Undeprecated​

The catalogExport mutation has been undeprecated and will continue to be supported.