Collapse Menu
Documentation
FastSpring App
Developer Tools
Contact Support

quote.updated

Overview

This article provides information about the quote.updated webhook

The quote.updated webhook is fired anytime a quote is updated. The reason field indicates the reason that the webhook was fired.

Reasons for Firing the Webhook

  • Quote Expired - The Quote status changed from Open to Expired.
  • Quote Canceled - The Quote status changed from Open to Canceled.
  • Quote Accepted - The Quote status changed from Open to Pending Payment. This means that the Quote has been accepted, however the prospect has not yet paid. This can happen when the buyer or seller generates an invoice instead of clicking Pay Now
  • Quote Completed - The Quote status changed from Open to Completed. This indicates that the prospect accepted the Quote and made a payment.
  • Quote Modified via App - A FastSpring user updated the Quote’s details using the FastSpring UI.
  • Quote Modified via API - A FastSpring user updates the Quote’s details via the /quotes API.

Contents of Event Payload

NameTypeDescription
quotestringInternal quote ID of the quote associated with the failed fulfillment
quoteNamestringName of the quote
changedstringUpdated in milliseconds
changedInSecondsstringUpdated in milliseconds
changedDisplaystringThe date in which the quote changed
changedTimeDisplaystringTime in which the quote changed
typestringType of quote that was generated: Self-Serve or Assisted
updatedBystringThe email address of the sales representative or seller who updated the quote
orderstringInternal order ID
order referencestringOrder Reference Number
order statusstringThe current status of the order (Open, Pending Payment, Completed, Expired, or Canceled)
invoiceURLstringURL of the customer-facing invoice for this order
reasonstringReason approval is required for the order
creatorstringThe email address of the person who created the quote
quoteStatusstringThe current status of the quote (Open, Pending Payment, Completed, Expired, or Canceled)
languagestringTwo-character ISO code for the language associated with the quote
quoteCurrencystringThree-character ISO code for the order currency
quoteURLstringThe prospect-facing URL of the quote
accountstringFastSpring-generated customer account ID
couponarrayThe Coupon ID applied to the quote
recipientarrayDetails of the prospect
recipient.firststringThe prospect's first name
recipient.laststringThe prospect's last name
recipient.emailstringThe prospect's email address
recipient.companystringThe company that the prospect associates with
recipient.phonestringThe prospect's phone number
recipient.vatIDstringtThe prospect’s VAT ID (if applicable)
addressarrayThe prospect’s physical address
fulfillmentSettingstringDisplays the fulfillment type
notesstringNotes added while creating the quote
tagsobjectTags added while creating the quote
itemsarrayA list of the items included in the quote
items.productstringproduct path/product ID of the product in the quote
items.quantitystringquantity of the current product in this transaction
items.displaystringprospect-facing Display name of the product
items.subtotalstringSubtotal of the specific item
items.subtotalDisplaystringSubtotal with currency
items.discountstringDiscount on particular item
items.discountDisplaystringDiscount with currency

Sample Payload:

  • {
       "quote":"QUUWOACS4PXFFGPFFM6AKNBTJ3P4",
       "quoteName":"Quote for Company",
       "changed":1617927858699,
       "changedInSeconds":1617927858,
       "changedDisplay":"04/09/21",
       "changedTimeDisplay":"00:24:18 UTC",
       "type":"Assisted",
       "updatedBy":"example@fastspring.com",
       "order":"yUIaT8yzSJew_IUCS5uhew",
       "order reference":"SAL210409-7545-63119",
       "order status":"AWAITING_PAYMENT",
    "invoiceUrl":"https://store.onfastspring.com/popup-defaultB2B/account/order/SAL210409-7545-63119/invoice",
       "Reason":"Quote Accepted",
       "creator":"aholmes@fastspring.com",
       "quoteStatus":"AWAITING_PAYMENT",
       "language":"en",
       "quoteCurrency":"USD",
    "quoteUrl":"https://store.onfastspring.com/popup-defaultB2B/account/order/quote/QUUWOACS4PXFFGPFFM6AKNBTJ3P4",
       "account":"M72EC3GtSfagETDA6lmBXw",
       "coupon":"10OFF",
       "recipient":{
          "first":"Name",
          "last":"Name",
          "email":"example@fastspring.com",
          "company":"FastSpring",
          "phone":"",
          "vatID":null
       },
       "address":{
          "addressLine1":"123 Main St",
          "city":"SANTA BARBARA",
          "region":"California",
          "postalCode":"93101",
          "country":"US",
          "display":"123 Main St, SANTA BARBARA, California, 93101, US"
       },
       "fulfillmentSetting":"ON PAYMENT",
       "notes":"Terms & Conditions of Sale",
       "tags":{
          
       },
       "items":[
          {
             "product":"agency",
             "quantity":1,
             "display":"Active Product",
             "subtotal":100.0,
             "subtotalDisplay":"$100.0",
             "discount":"10",
             "discountDisplay":"$10"
          }
       ]
    }