463 posts tagged with "API"

Fixed a critical database issue that was affecting platform stability. This release restores normal operation.

⛵ Added​

Advanced search filter on products and variants​

Added an advancedSearch filter to search by specific fields for a faster, more targeted search, as opposed to the pre-existing search filter, which searches across all fields.

You can use the advancedSearch argument in the ProductFilterInput for advanced filtering by search term when querying products and variants.

The fields you can target for search are defined in the ProductSearchFieldEnum and ProductVariantSearchFieldEnum. If you don't define search fields, the filter defaults to search only by NAME.

query {
  products(
    first: 25
    filter: {
      advancedSearch: {
        searchTerm: "shiny"
        searchFields: [
          NAME, 
          VARIANT_NAME, 
          DESCRIPTION, 
          CATEGORY_NAME]
      }
    }
  ) {
    edges {
      node {
        id
        name
        description
      }
    }
  }
}

Learn more ->

Retrieve Avalara tax exempt codes​

Added the ability to retrieve the list of Avalara tax exempt codes through a new taxExemptCodes query.

query {
  taxExemptCodes {
    code
    name
    validCountries
  }
}

Dimension argument for marketplace insights​

Added the dimension argument to filter by time period for the following marketplace insight queries:

• insightsOrdersMarketplaceSummary
• insightsMarketplacePaymentsSummary
• insightsMarketplaceTaxSummary

The values for the dimension argument are defined by the InsightDimensionEnum.

Set availability on productCreate​

Added the ability to set product availability while creating products through the API. The productCreate mutation input now supports the isAvailable and startDate fields.

mutation {
  productCreate(
    input: {
      isAvailable: true
      productType: "UHJvZHVjdFR5cGU6NDM5"
      name: "Snow Pants"
      seller: "U2VsbGVyOjI="
      basePrice: "50"
    }
  )
  {
    product {
      name
      isAvailable
    }
  }
}

mutation {
  productCreate(
    input: {
      startDate: "2023-03-24"
      productType: "UHJvZHVjdFR5cGU6NDM5"
      name: "Snow Pants"
      seller: "U2VsbGVyOjI="
      basePrice: "50"
    }
  )
  {
    product {
      name
      startDate
    }
  }
}

Force order fulfillment​

Added the ability for users with the Manage marketplace permission to force order fulfillment for a line with a deleted variant, by passing the allowNullVariants field with the orderFulfill mutation input.

mutation {
  orderFulfill(
    order: "T3JkZXI6MQ==",
    input: {
      lines: [
        {
          orderLineId: "ABC=",
          stocks: [
            {
              quantity: 1,
              warehouse: "ABC=="
            }
          ]
        }
      ],
      notifyCustomer: false,
      allowNullVariants: true
    }
  ) {
    orderErrors {
      field
      message
      code
      warehouse
      orderLine
      variant
    }
    order {
      id
      number
    }
    fulfillments {
      id
      fulfillmentOrder
      status
    }
  }
}

Set status on sellerDataCreate​

Added the ability to set the seller status while adding a new seller with the sellerDataCreate mutation.

A new status field is added to SellerInput. The status field accepts values from the SellerStatusEnum. If unspecified, the status defaults to PENDING.

mutation {
  sellerDataCreate(
    input: {
      name: "Cosmic Shirts Co"
      owner: "VXNlcjo3NDM4"
      plan: "QWdyZWtZW50Ojc="
      status: APPROVED
    } 
  ){
    ok
    seller {
      id
      companyName
      status
    }
  }
}

Available payout balance on orders​

Added the availablePayoutBalance read-only field to the order object, to return the balance remaining to be paid out.

query {
  order(
    id: "T3JkZXI6MTIyMTY="
  )
  {
    id
    availablePayoutBalance {
    	amount
      currency
    }
  }
}

Filter orders by payout status​

Added the ability to filter the orders query by payoutStatus, which accepts values from the OrderPayoutStatusEnum.

query {
  orders(
    first: 10
    filter: {
      payoutStatus: READY_FOR_PAYOUT
    }
  )
  {
    totalCount
    edges {
      node {
        id
        availablePayoutBalance {
          amount
        }
      }
    }
  }
}

Convert offer to quote order​

Added the orderOfferConvertToNauticalQuoteOrder mutation to convert an offer order to a Nautical (marketplace) quote order. You can target the id of either an order or Nautical order.

mutation {
  orderOfferConvertToNauticalQuoteOrder
  (id: "VXNlcjo3MtYw") 
  {
    order {
      id
      status
      created
    }
    orderErrors {
      field
      code
      message
    }
  }
}

Add public metadata on customer checkout​

Added the ability for a customer to add and manage public metadata to their own checkout(s) through the API, for example using the metadataUpdate mutation on checkout.

This functionality must be turned on in your environment before it can be used. Contact a Nautical support representative to enable this functionality in your marketplace.

VAT identification number for customers​

Added the vatIdentificationNumber field to the user object, for example to store and display a customer's VAT identification number on an invoice.

query {
  user(
    id:"VXNlcjo3MjYw"
  )
  {
    vatIdentificationNumber
  }
}

Assign Avalara tax exempt codes​

Added the ability to assign Avalara tax exempt codes to users, through a new Tax Exempt Code field on the customer object.

Through the API, you can assign tax codes by passing the taxExemptCode field through the customerUpdate mutation.

mutation {
  customerUpdate(
    id: "VXNlcjo3MjI2"
    input: {
      taxExemptCode: "R"
    }
  )
  {
    user {
      id
      taxExemptCode
    }
  }
}

🌊 Changed​

Show Error Messages on SellerDataUpdate​

Updated the sellerDataUpdate mutation response to show error messages, by adding the ability to return sellerErrors in addition to the existing ok boolean success indicator.

🪲 Fixed​

• Fixed an issue that prevented exporting products as either a .csv or .xlsx file when one or more fields were selected for export.
• Fixed an issue with sorting and pagination by attributes for the products and productVariants query.
• Fixed an issue where taxes were not being calculated properly for quote orders when the associated marketplace order did yet not have order lines.
• Fixed an issue with stock allocation and de-allocation for grouped products, which could cause a seller issues with fulfilling an order with grouped products.
• Fixed an issue in master-product marketplaces, where products created by a seller user with Manage marketplace permissions were not created as master products.
• Fixed an issue with processing checkouts with Stripe with the Store Customer Cards setting enabled.

⛵ Added​

• Added the ability to fetch the list of available options from the tax engine gateway that can be used to populate the tax_exempt_code field for a customer.

⛵ Added​

• Added an email notification trigger to the incoming fulfillment webhook processing flow.
• Added a new tax_exempt_code field to the user object, along with associated queries and mutations.

🪲 Fixed​

• Fixed an issue causing updateSellerData mutations to fail.
• Fixed an issue that allowed a staff member to be assigned ownership of multiple sellers during webhook-based seller creation, e.g. through a Typeform integration.
• Fixed logic in calculate_order_line_unit for the Avatax plugin, which was preventing seller admins from adding products to quotes.

🌊 Changed​

• Backend updates to Graphene v3 and Django v3.2LTS, resulting in some enhancements to the GraphQL API schema behavior. Enum defaultValues are now spec-compliant, and mutation input validation is now stronger.

🪲 Fixed​

• Fixed an issue where a customer who was also a staff member retained the staff member permissions after the staff member was deleted.
• Fixed an issue where seller order data was incorrectly being sent to Avalara, in addition to the marketplace order. Nautical no longer sends seller order data to Avalara, and instead only sends data from the Nautical (marketplace) order.

⛵ Added​

• Added the ability to input an option price override for the shipping method, by passing the shippingMethodPriceOverrideAmount field with the checkoutSellerShippingMethodsUpdate mutation.
• Added the ability to filter the productVariants query by the seller global ID.
• Added the ability to sort by date and filter by from_email, to_emails, message_type, and date for the emailLogs query.
• Added the marketplace_order field to the order object model, for the ability to retrieve the marketplace order from the seller order.
• Added the following new webhook events triggered by changes to a seller:
  • SELLER_CREATED
  • SELLER_UPDATED
  • SELLER_AGREEMENT_ACKNOWLEDGED

🌊 Changed​

• The Wishlist feature has been updated to require storing only a single-entity product or variant against each wishlistItem. Users of the legacy wishlist model, which stores multiple variants, must update their implementation to the new model as it is no longer possible to associate multiple variants with a wishlistItem. This update provides more flexibility in wishlist management.
• Optimized filters for the attributes query for improved speed and performance.
• Performance improvements to the shop query.

🪲 Fixed​

• Fixed an issue with connecting third-party apps while logged in as a Seller Admin user
• Fixed an issue that prevented changing the payout status for seller orders in cases where the seller had previously been excluded from a payout.
• Fixed context_key name in WishlistByIdLoader.

🌊 Changed​

• Improved mail log organization by sorting the events in reverse chronological order, displaying the most recent events first

🪲 Fixed​

• Fixed an issue that caused the sellers query to fail when the externalPayoutStatus could not be determined

⛵ Added​

• Added validation by seller for DraftOrder mutations.
• Added validation for overrideAmount in draftOrderLinePriceOverride and nauticalDraftOrderLinePriceOverride mutations to ensure the input is not negative or zero.
• Added database table for logging webhook events.

🌊 Changed​

• Extended SendGrid order payloads to include information on grouped products.

🪲 Fixed​

• Fixed the line_price_overridden error that occurred during order events after using draftOrderLinePriceOverride or nauticalDraftOrderLinePriceOverride mutations to override item price in draft orders.
• Fixed issue with incorrect order payout status for orders with products having volume discounts under 'Automated by fulfillment' payout mode.
• Fixed issue where shipping address updates were not being synchronized between Nautical and WooCommerce orders.
• Fixed an issue where the SendGrid payload for orders created with a voucher were missing the discount value.

🪲 Fixed​

• Fixed an issue where filtering attributes by product could return duplicate results.
• Fixed an issue where, if a seller had enabled Shopify sync, updating the inventory in Shopify would overwrite Nautical product prices.

🌊 Changed​

• Updated the wishlistAddProduct and wishlistAddProduct mutations to support specifying the target user with user_id

🪲 Fixed​

• Fixed an issue where SendGrid order confirmation emails were not being sent to the customer or seller after a quote order was created
• Fixed an issue that prevented creating a Typeform seller onboarding (SELLER_CREATION) form