439 posts tagged with "API"

Simplified webhook transaction handling​

Improved the handling of pending webhook transactions, making webhook processing more reliable and easier to manage.

Marketplace shipping methods​

Added support for marketplace-level shipping methods in checkout, allowing operators to configure shipping options that apply across all sellers.

GraphiQL playground​

Added an interactive GraphiQL playground for easier API exploration and testing.

Discount fields on collections​

Added discount-related fields to the Collection type, making it easier to display promotion information on collection pages.

Enhanced marketplace order fields​

Added new fields to NauticalOrder and Checkout objects to support more detailed order management and tracking.

Fixed an issue where the available_currencies field could cause resolution errors in certain queries.

Fixed an issue where filtering orders by APPLYING status could return incorrect results.

Added missing seller_errors fields to several mutations for more consistent error handling.

Fixed a race condition in nauticalDraftOrderComplete by ensuring the order is properly locked during completion.

Added missing error classes for agreement-related mutations to improve error reporting.

Fixed an issue where updating order checkpoints to previous values was incorrectly blocked.

Fixed invoice line items to correctly display discounted totals instead of undiscounted amounts.

Dashboard URL configuration​

Added the ability to configure a custom dashboard URL for each marketplace, providing more flexibility in directing sellers and administrators to their management interfaces.

Seller application checkpoints​

Introduced new status enums for tracking seller application progress, making it easier to manage and monitor the onboarding process.

Country-based shipping method filtering​

Shipping methods can now be filtered by country and area, allowing for more precise control over which shipping options are available to customers based on their location.

Default marketplace content​

New marketplace installations now automatically include default content and configuration data, streamlining the initial setup process.

Automatic fulfillment model updates​

When a product's fulfillment model changes, the sellerFulfilledByMarketplace flag now updates automatically to maintain consistency across the platform.

Fixed an issue where buyer ledgers were not being created correctly for local buyer accounts.

Fixed ledger balancing issues that could occur when partially declining a fulfillment, ensuring accurate financial tracking.

Fixed calculation errors when processing declined fulfillments, ensuring discounted totals are properly accounted for in refund amounts.

Fixed tax calculation discrepancies when declining fulfillments, ensuring accurate tax adjustments based on discounted totals.

Fixed an issue where deleting a payout could fail if its associated event log had already been removed.

Fixed incorrect money type handling in ledger-related API responses, ensuring consistent data formatting.

Removed deprecated API fields and mutations​

Removed several previously deprecated API fields and mutations that have reached their end-of-life dates:

• Money.amount field
• Mutation.errors field
• AttributeInput.value field
• Various deprecated payout-related fields and mutations

If you're still using any of these deprecated features, please update your integration to use the current alternatives.

Fixed an issue where a foreign key error could occur during payout deletion.

Removed deprecated items​

The following API entities have passed their deprecation window and have been removed:

Fields:

• *.*.errors
• Checkout.sellerShippingMethods
• Checkout.shippingMethod
• Money.amount
• NauticalOrder.fulfillments
• NauticalOrder.sellerShippingMethods
• NauticalOrder.shippingMethod
• Order.payments
• Order.totalAuthorized
• Order.totalBalance
• Order.totalCaptured
• Payment.order
• ProductType.taxRate
• Payout.penalties
• Shop.homepageCollection
• VendorPayout.average
• VendorPayout.gross
• VendorPayout.penalty
• VendorPayout.taxes
• VendorPayout.volumeDiscounts

Mutations:

• HomepageCollectionUpdate
• LocationGeocode
• LocationSearch

Types:

• LocationGeocode
• LocationSearch

Update your storefront to ensure you are not calling any of the above fields. For the full list of deprecations and suggested replacements, see GraphQL API Deprecations and Removals.

Seller application management​

Added a complete seller application workflow, allowing prospective sellers to submit applications and marketplace operators to review and approve them. The seller status now includes an "APPLYING" state to track applications in progress.

Shipping discount visibility​

Shipping discounts are now visible directly on the checkout, making it easier to see how vouchers and sales affect shipping costs.

Seller-specific shipping zones and warehouses​

Shipping zones and warehouses now belong to specific sellers, providing better organization and control for multi-vendor marketplaces.

Fulfillment model configuration​

Added the ability to configure fulfillment models at the marketplace level, giving operators more control over how orders are processed and fulfilled.

Seller data management improvements​

Seller owners can now update their own seller data and manage seller identifiers, streamlining the seller onboarding and management process.

Custom field template improvements​

Custom field templates can now be resolved by enum, and custom attributes handling has been aligned with product and variant attributes for consistency.

Fixed an issue where the manual payment gateway wasn't properly stored during the payout process.

Fixed a bug where shipping voucher discounts weren't being calculated correctly in certain scenarios.

Fixed an issue where media queries required authentication when they should have been publicly accessible.

Fixed an issue where default shipping prices weren't working correctly with the dummy tax plugin.

Enabled atomic mutations to ensure database consistency across all GraphQL operations.

Deprecated features​

The following features have been deprecated and will be removed in a future release:

• Affiliate functionality
• Channel-based operations (replaced with seller-based approaches)
• Several unused fields on the Shop type
• Strict product image handling mode
• Adyen payment gateway (non-functional)

Shipping zone owner required​

The shippingZone.owner field is now required when creating a shipping zone.

Warehouse owner required​

The warehouse.owner field is now required when creating a warehouse.

Public media query​

The media query is now a public query that does not require authentication.

Seller APPLYING status​

The SellerStatus enum now supports the APPLYING status.

Update seller with tax identifier​

The sellerDataUpdate mutation now supports the identifiers input for setting the seller's tax identification number.

Fixed an issue where VendorPayout.gateway returned a blank response when querying a payout using the Manual payout gateway.

Deprecated affiliates​

Deprecated the affiliates model and related fields, which will be removed on October 26, 2024. For the full list of deprecations, see GraphQL API Deprecations and Removals.

Deprecated channels​

Deprecated the channels model and related fields, which will be removed on October 29, 2024. For the full list of deprecations, see GraphQL API Deprecations and Removals.

Marketplace seller identification​

Added the ability to identify marketplace sellers with a dedicated boolean field, making it easier to distinguish between marketplace operators and individual sellers.

Invoice generation for draft orders​

Added support for generating invoices for draft orders, streamlining the order approval and payment collection process.

Google Analytics integration​

Added a new Google Analytics plugin, allowing marketplaces to track customer behavior and conversion data directly from the platform.

Query ledgers and custom field templates​

Added the ability to query accounting ledgers and individual custom field templates, providing more flexibility for reporting and custom data management.

Automatic admin user creation for sellers​

When creating local sellers, the platform now automatically creates corresponding admin users, reducing manual setup steps.

Marketplace fulfillment configuration​

Updated marketplace configuration to support new fulfillment models, allowing operators to control whether sellers are fulfilled by the marketplace or handle their own fulfillment.

Fixed an issue where seller-created product attributes could be unintentionally removed by other sellers on the marketplace.

Fixed an issue where order payout data was accessible to users without the proper ManageOrders permission.

Fixed an issue where certain refunds were incorrectly included in payout calculations, leading to inaccurate seller payouts.

Fixed an issue where tax-related metadata keys were cleared instead of being properly removed, causing inconsistent tax calculations in some cases.

Fixed an issue where product data was not correctly displayed based on draft versus published view.

Fixed an issue preventing buyers from completing draft orders in certain scenarios.

Fixed an issue with Stripe ACH payments when using stored customer payment methods.

Updated Stripe integration to support newer API versions with changes to charge handling.

Deprecated fields​

The following fields and models are now deprecated and will be removed in a future release:

• Branding and designer data fields
• CoreData model
• Fulfillment.totalLinesPrice (replaced by totalLinesMoney)

Send payment link for draft orders​

Updated the NauticalQuoteOrderSendToCustomer mutation to add the ability to send a payment link to the buyer for draft orders, similar to quote orders.

Also added the ability for buyers to run the NauticalDraftOrderComplete mutation to submit payment and finalize their own draft orders.

Filter products by mpn​

Added the mpn field to the ProductFilterInput filter, to support filtering products by MPN.

Send payment link for draft orders​

Added the isMarketplaceSeller boolean field to the Seller object, which identifies if a seller corresponds to the marketplace owner.

Query a custom field template​

Added the customFieldTemplate query, to retrieve details for a single custom field template.

Query draft orders by token​

The nauticalOrderByToken query now returns draft orders.

Upgraded Klaviyo plugin API​

Upgraded the Klaviyo integration to use Klaviyo's updated API endpoint.

Upgraded Stripe plugin API​

Updated the Stripe API integration to account for changes to the Stripe Charges API.

Updated permission to view seller order payout data​

Updated the permissions required to view payout summary information on seller orders. Sellers now only need the manage_orders permission to view this data.

Fixed an issue with Stripe ACH payments when the "Store customer cards" setting was turned on.

Fixed an issue where the vendorPayoutList query returned excluded payouts.

Fixed a display issue with the commission column in vendor payouts.

Fixed an issue where sellers with permission to manage attributes could edit or delete attributes added by other sellers.

Fixed an issue that caused the following error when creating a new product with a date attribute: TypeError in AttributeValue Model: Multiple Values for 'date_time'

Removed the following types around Klaviyo plugin sync, which are longer in use:

• PluginSyncSettings query
• PluginSyncUpdate mutation
• SyncConfiguration
• SyncConfigurationDirection

Deprecated the Fulfillment.totalLinesPrice field, which is replaced by the Fulfillment.totalLinesMoney field. This field will be removed by October 25, 2024.

Deprecated the ShippingZone.default field. ShippingZones are not marked as default anymore. This field will be removed by October 17, 2024.

Deprecated the following types around designer data, which are no longer in use and will be removed by October 25, 2024.

• DesignerData
• DesignerDataCreate
• DesignerDataUpdate
• BrandingImagesDelete
• BrandingUpdate

Deprecated the following types around core data, which are no longer in use and will be removed by October 25, 2024.

• CoreData
• CoreDataCreate
• CoreDataUpdate

Filter products by manufacturer part number​

Added the ability to filter products by manufacturer part number (MPN), making it easier to search and manage product catalogs.

Seller onboarding settings​

Introduced configurable seller onboarding settings, allowing marketplace operators to customize the onboarding experience and requirements for new sellers.

Discount apportionment improvements​

Discounts are now apportioned based on net amounts, providing more accurate discount calculations across line items.

Klaviyo plugin API updates​

Updated the Klaviyo plugin to use the latest API endpoints, ensuring continued compatibility with Klaviyo's services.

Fixed an issue where the vendor payout list could incorrectly include excluded payouts.

Fixed an issue where sales invoices were not properly updated when fulfillments were declined.

Fixed an issue where seller commission data could not be resolved correctly for legacy orders.

Draft orders can now be sent to customers and queried by token, improving draft order management capabilities.

Fixed an issue where voucher calculations used incorrect currency in certain checkout scenarios.

Fixed ledger balance calculation errors that could occur in foreign exchange environments.

Fixed an issue where content with future publication dates did not properly activate based on the marketplace's timezone.

Extended lock expiry time when saving content to prevent concurrent editing conflicts.

The isSellerShippingZoneCreationAllowed field has been deprecated and will be removed in a future version.

The requires_secondary_address field on the ShippingMethod model has been deprecated. The "Default shipping zone" option has also been removed from the backend.

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.