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

πŸͺ² 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.

: Staging

: Production

πŸͺ² Fixed

Webhooks

Fixed an issue where the product_update webhook was not being triggered when products were published in bulk using the productBulkPublish mutation.

Payouts

Fixed an issue where seller admins could not query order.fees, resulting in a 404 page when opening a payout in the Dashboard.

Discounts

Fixed an issue where voucher discounts, specifically those with the "Limit one per customer" setting enabled, were not calculated correctly after a fulfillment was declined.

: Staging

: Production

✨ New

Catalog

Custom fields​

Added the ability for marketplace operators to define custom fields for various object models. The following objects support custom fields: USER, PRODUCT, VARIANT, CATEGORY, and COLLECTION.

Add attributes to custom field templates to make those attributes available for data entry on the associated object.

This feature includes the following GraphQL changes:

  • Assign an attribute to an object model’s custom field template with the customAttributeAssign mutation.
  • Query custom field templates with the customFieldTemplates query.
  • Remove attributes from a custom field template with the customAttributeUnassign mutation.
  • The following inputs have been updated to support assigning customFields when creating and updating objects:
  • ProductInput, ProductCreateInput
  • ProductVariantInput, ProductVariantCreateInput
  • UserCreateInput, CustomerInput, StaffUpdateInput
  • CategoryInput
  • CollectionInput, CollectionCreateInput

Learn more ->

Catalog

Attribute template strategy field​

Added the attributeTemplateStrategy field to the MarketplaceConfiguration model, allowing operators to customize how attributes are assigned across product attributes, variant attributes, and custom fields.

Related to this change, added the templated field, which you can query under product attributes, variant attributes, and custom fields to see if the selected attribute came from a templated assignment.

Catalog

Product type strategy field​

Added the requireProductTypes field to the MarketplaceConfiguration model, allowing operators to make product type usage optional.

Catalog

New attribute input types​

Added several new supported input types to the AttributeInputTypeEnum.

Catalog

Update product type on product​

The productUpdate mutation now accepts the productType input field, allowing you to change the product type on an existing product.

Catalog

Update parent product on variant​

The productVariantUpdate mutation now accepts the product input field, allowing you to change the parent product of a variant.

πŸͺ² Fixed

Catalog

Fixed an issue with filtering the variants list based on the isPublished field.

: Staging

: Production

πŸ’Ž Changed

Catalog

Updated the ProductVariantFilter input to support filtering variants by metadata or privateMetadata.

πŸͺ² Fixed

Catalog

Fixed an issue with the productUpdate mutation, where passing a null taxCode value did not clear the existing value.

Payouts

Fixed an issue where orders outside the payout end date were incorrectly attributed to payouts with the ledger accounting system.

Vendor mgmt

Fixed an issue where the agreementUpdate mutation required all the same inputs as agreementCreate.

Was this page helpful?