Skip to main content

Changelog

Developer Changelog

We regularly update our API and provide detailed notes on each release. We first release to staging, then to production about a week later. Learn more about our release process.

: Staging

: Production

✨ New

Catalog

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

Shipping

Added metadata and privateMetadata to the following models:

  • ShippingMethod
  • ShippingZone

Manage metadata with the metadataUpdate and privateMetadataUpdate mutations.

🪲 Fixed

Webhooks

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

🚫 Deprecated

Shipping

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

: Staging

: Production

✨ New

Seller mgmt

Seller slug field

Added the slug field to the Seller model.

Seller mgmt

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

Fees

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

🚫 Deprecated

Dashboard

Deprecated dashboard types

The following types related to the Dashboard have been deprecated:

  • The dashboard query
  • The dashboardConfigurationUpdate mutation

: Staging

: Production

💎 Changed

user mgmt

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.

taxes

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

webhooks

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

storefront

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

🪲 Fixed

payouts

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

🚫 Deprecated

Reviews

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

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

Catalog type removals

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

Queries
  • barcodeLookup
  • upcItemDb
  • drugLookup
Mutations
  • productVariantReorder
  • variantImageAssign
  • variantImageUnassign
  • importCatalog
  • exportCatalog
  • exportProducts
  • importProducts
  • attributeReorderValues
Fields
  • Category.url
  • Product.url
  • ProductVariant:

    • quantity
    • quantityAllocated
    • stockQuantity
    • isAvailable
    • availableShippingMethods
orders

Order type removals

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

Mutations
  • acceptBid
  • rejectBid
  • submitRatingAndReview
  • paymentRefund
  • orderCapture
  • orderFulfillmentUpdateReturnStatus
  • orderMarkAsPaid
  • orderRefund
  • nauticalOrderRefund
  • orderVoid
  • bulkFulfillmentReturn
  • sendQuoteToCustomer
  • setWishlistAsDefault
Fields
  • Checkout.availableShippingMethods
  • Checkout.localized
warehouse

Warehouse type removals

The following previously deprecated warehouse mutations have been removed:

Mutations
  • createWarehouse
  • updateWarehouse
  • deleteWarehouse
user mgmt

User type removals

The following previously deprecated user management mutations have been removed:

Mutations
  • requestPasswordReset
  • confirmAccount
  • setPassword
  • requestEmailChange
  • confirmEmailChange
  • accountSetDefaultAddress
webhooks

Webhook type removals

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

Queries
  • webhooks
  • serviceAccounts
  • serviceAccount
Mutations
  • serviceAccountCreate
  • serviceAccountUpdate
  • serviceAccountDelete
  • serviceAccountTokenCreate
  • serviceAccountTokenDelete
Fields
  • Webhook.serviceAccount
seller mgmt

Seller type removals

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

Mutations
  • getPayoutOnboardingLink
  • acknowledgeSellerAgreement
  • createSellerData
  • createSellerUserMapping
  • updateSellerData
  • sellerAddNote
  • createSellerShell
  • updateSellerSettings
designer

Designer type removals

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

Mutations
  • createDesignerData
  • updateDesignerData
  • updateBranding
  • deleteBrandingImages
  • createCoreData
  • updateCoreData
metadata

Metadata type removals

The following previously deprecated metadata mutations have been removed:

Mutations
  • deleteMetadata
  • deletePrivateMetadata
  • updateMetadata
  • updatePrivateMetadata
Plugins

YotPo plugin removal

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

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

: Staging

: Production

🪲 Fixed

discounts

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

: Staging

: Production

🪲 Fixed

refunds

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

refunds

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

refunds

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.

🚫 Deprecated

config

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

: Staging

: Production

🪲 Fixed

orders

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

quotes

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

: Staging

: Production

🪲 Fixed

webhooks

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

orders

Fixed an order line CSV upload issue on draft and quote orders that could apply discounts incorrectly after the 1.35 release.

checkout

Fixed performance issues related to checkouts and editing order lines after the 1.35 release.

: Staging

: Production

✨ New

payouts

Delete payouts

Added the payoutDelete mutation, for deleting an individual draft payout.

Learn more ->

payouts

Create empty payouts

You can now create draft payouts even when no orders qualify, to enable the creation of vendor payouts against an empty payout to support prepayment scenarios.

catalog

Numeric variant attributes

Variants now support attributes with the numeric input type.

🪲 Fixed

payouts

Fixed an issue where payouts could fail with an error stating that the vendor payout did not match the orders.

data entry

Fixed an issue preventing multiple options to be entered in multi-select fields.

checkout

Fixed an issue where checkoutSellerShippingMethodsBulkUpdate mutation did not update shipping prices after the 1.34 release.

emails

Fixed an issue where the display_gross_prices field was always sent as true in SendGrid email payloads.

payouts

Fixed an issue where payout statements could display shipping costs incorrectly on payout statements processed with the legacy, non-ledgerized payout system. This was purely a Dashboard display issue for historical payouts and did not affect the amount paid to the seller.

: Staging

: Production

✨ New

discounts

Added the following fields to the NauticalOrderLine object, to retrieve information about discounted pricing specific to an order line:

  • sale
  • saleDiscount
  • voucherDiscount
  • discountedUnitPrice
  • originalUnitPrice
discounts

Added the currency field to the sale query.

payouts

Added the following fields to the VendorPayout model:

  • subtotal
  • total

🪲 Fixed

data entry

Fixed an issue where you could not set dropdown or multi-select attributes back to an empty value after they are set to a value.

Taxes

Fixed an issue where the nauticalOrderRefreshTaxes mutation was failing due to an error with the vat_code field.

🚫 Deprecated

The enable_edit_checkout_public_metadata_by_customer configuration in the NauticalConfiguration model has been deprecated.

: Staging

: Production

✨ New

payouts

Add vendor payout to draft payout

Added the vendorPayoutCreate mutation, to add a seller to a draft payout if they were not included when the payout was initially created.

checkout

Checkout line sale field

Added the sale field to the checkoutLine model, which returns a matching sale for the checkout line, if applicable.

🪲 Fixed

invoices

Fixed an issue where multiple invoices could be generated with the same invoice number.

webhooks

Fixed an issue where ACH payments were not triggering the Nautical Order Updated Webhook or the Nautical Order Fully Paid Webhooks when the ACH payment was captured.

🚫 Deprecated

checkout

The following MarketplaceConfiguration fields have been deprecated:

  • maxCheckoutLineQuantity
  • maxCheckoutQuantity
  • minCheckoutAmount
orders

Removed the subscription model

checkout

Removed checkoutLinePriceOverride mutation.

Was this page helpful?