Skip to main content

Quotes (Offers)

EntityActivityActivity.Offer

Quotes (also called Offers or Quotations) represent price proposals sent to prospects or customers. They belong to the sales pipeline and typically follow a sales opportunity. A quote includes product lines, financial totals, an expiration date, and can be digitally signed by the recipient.

Use the Activity_Offer endpoint to create, update, and manage quotations. Quotes inherit all fields from Activity (subject, amount, financial totals) and add offer-specific fields like Version, Reference, ExpirationDate, and respondent details.

Endpoints

List Quotes

Retrieve a paginated list of quotes.

GET/v1/odata/Activity_Offer

Single Quote

Retrieve a single quote by its ID.

GET/v1/odata/Activity_Offer({id})

With expanded relations:

GET/v1/odata/Activity_Offer({id})?$expand=Relationship,Contact,ProductLines,Phase

Create Quote

Create a new quote.

POST/v1/odata/Activity_Offer

Update Quote

Update an existing quote. Provide only the fields to update.

PUT/v1/odata/Activity_Offer({id})

Delete Quote

Delete a quote by ID.

DELETE/v1/odata/Activity_Offer({id})

Fields

Standard Fields (all entities)

FieldTypeDescription
IDGuidPrimary key (UUID)
_TypeStringEntity type discriminator (e.g., Activity.Offer)
_NameStringComputed display name
SortIndexDoubleSorting order
CreationDateDateTimeOffsetDate the record was created
LastMutationDateDateTimeOffsetDate of the last modification
CloseDateDateTimeOffsetDate the record was closed
StartDateTimeOffsetStart date/time
EndDateTimeOffsetEnd date/time
DeadlineDateTimeOffsetDeadline date/time
IsActiveBooleanWhether the record is active
IsClosedBooleanWhether the record is closed
IsRootBooleanWhether this is a root-level activity
IsExclusionBooleanWhether this activity is excluded
NumberOfNotesDoubleNumber of notes linked to this record
NumberOfAttachmentsDoubleNumber of attachments linked to this record

Offer Fields

FieldTypeDescription
VersionDoubleQuote version number
ReferenceStringExternal reference code
DateDateQuotation date
ExpirationDateDateValid until date
ContentStringQuote content / body text
SignLinkStringApproval / digital signature link
RespondentFirstNameStringRespondent first name
RespondentInsertionStringRespondent name prefix
RespondentLastNameStringRespondent last name
RespondentEmailAddressStringRespondent email address
RespondentIpAddressStringRespondent IP address (recorded on sign)
RespondentNoteStringNote left by the respondent

Inherited Fields (from Activity)

FieldTypeDescription
SubjectStringActivity subject / title
NumberStringAuto-generated activity number (e.g., 2026-00042)
AmountDoubleActivity amount
CurrencyStringCurrency code (e.g., EUR)
IsVatIncludedBooleanWhether prices include VAT
DiscountPercentageDoubleDiscount percentage
RelationDescriptionStringDescription of the linked relation
NumberOfProductLinesDoubleNumber of product lines
NumberOfOpenTasksDoubleNumber of open tasks linked to this activity
NumberOfPlannedActionsDoubleNumber of planned actions
BillingAmountDoubleAmount to be invoiced
BillingAmountInCurrencyDoubleAmount to be invoiced (in activity currency)
AmountInCurrencyDoubleAmount in activity currency
TotalSalesExcludingVATDoubleSubtotal excluding VAT
TotalSalesExcludingVATInCurrencyDoubleSubtotal excluding VAT (in activity currency)
TotalSalesIncludingVATDoubleTotal including VAT
TotalSalesIncludingVATInCurrencyDoubleTotal including VAT (in activity currency)
VatAmountDoubleVAT amount
VatAmountInCurrencyDoubleVAT amount (in activity currency)
VatAmountIncludingDiscountDoubleVAT amount after discount
VatAmountIncludingDiscountInCurrencyDoubleVAT amount after discount (in activity currency)
TotalDiscountExcludingVATDoubleTotal discount amount excluding VAT
TotalDiscountExcludingVATInCurrencyDoubleTotal discount amount excluding VAT (in activity currency)
TotalMarginDoubleTotal profit margin
TotalPurchaseAmountDoubleTotal purchase/cost amount
InboundSentimentScoreDoubleInbound sentiment score
OutboundSentimentScoreDoubleOutbound sentiment score

Recurring / Non-recurring Breakdown

These fields split the financial totals between recurring (subscription-based) and non-recurring product lines.

FieldTypeDescription
TotalRecurringSalesExcludingVATDoubleRecurring subtotal excluding VAT
TotalRecurringSalesExcludingVATInCurrencyDoubleRecurring subtotal excluding VAT (in currency)
TotalRecurringSalesIncludingVATDoubleRecurring total including VAT
TotalRecurringSalesIncludingVATInCurrencyDoubleRecurring total including VAT (in currency)
TotalRecurringDiscountExcludingVATDoubleRecurring discount excluding VAT
TotalRecurringDiscountExcludingVATInCurrencyDoubleRecurring discount excluding VAT (in currency)
TotalRecurringVatAmountDoubleRecurring VAT amount
TotalRecurringVatAmountInCurrencyDoubleRecurring VAT amount (in currency)
TotalRecurringMarginDoubleRecurring profit margin
TotalRecurringPurchaseAmountDoubleRecurring purchase/cost amount
TotalNonRecurringSalesExcludingVATDoubleNon-recurring subtotal excluding VAT
TotalNonRecurringSalesExcludingVATInCurrencyDoubleNon-recurring subtotal excluding VAT (in currency)
TotalNonRecurringSalesIncludingVATDoubleNon-recurring total including VAT
TotalNonRecurringSalesIncludingVATInCurrencyDoubleNon-recurring total including VAT (in currency)
TotalNonRecurringDiscountExcludingVATDoubleNon-recurring discount excluding VAT
TotalNonRecurringDiscountExcludingVATInCurrencyDoubleNon-recurring discount excluding VAT (in currency)
TotalNonRecurringVatAmountDoubleNon-recurring VAT amount
TotalNonRecurringVatAmountInCurrencyDoubleNon-recurring VAT amount (in currency)
TotalNonRecurringMarginDoubleNon-recurring profit margin
TotalNonRecurringPurchaseAmountDoubleNon-recurring purchase/cost amount

Relationships

RelationshipTarget EntityCardinalityDescription
RelationshipRelationshipN:1Linked relation (customer/contact)
ContactRelation.Person.ContactN:1Contact person
ProductLinesProductLine1:NProduct lines / line items
InvolvedInvolved1:NInvolved parties
PhaseDatastore.Phase.ActivityOfferN:1Quote phase / status
TemplateTemplate.Document.OfferN:1Document template used to generate the PDF
TemplateFileFileN:1Template file reference
FinalizedDocumentAttachmentAttachmentN:1Generated PDF attachment
FinalizedDocumentFileN:1Generated document file reference
SignedOfferAttachmentAttachmentN:1Signed PDF attachment
DigitalSignaturesDigitalSignature1:NDigital signatures
PriceListPriceListN:1Price list
PictureListFileN:1Picture / image file
LinkedActivitiesActivity1:NLinked activities
ActivityActivityN:1Parent activity
MilestoneProjectMilestoneN:1Linked project milestone
TimeRegistrationsTimeRegistration1:NTime registrations
EmployeeAllocationsEmployeeAllocation1:NEmployee allocations
EventParticipationEventParticipationN:1Linked event participation
InboundSentimentCategoryDatastore.SentimentCategoryN:1Inbound sentiment category
OutboundSentimentCategoryDatastore.SentimentCategoryN:1Outbound sentiment category
SentimentMeasurementSentimentMeasurementN:1Sentiment measurement
SentimentTopicMeasurementsSentimentTopicMeasurement1:NSentiment topic measurements
AggregatedSentimentMeasurementsAggregatedSentimentMeasurement1:NAggregated sentiment measurements
AggregatedSentimentTopicMeasurementsAggregatedSentimentTopicMeasurement1:NAggregated sentiment topic measurements
LastAggregatedInboundSentimentMeasurementAggregatedSentimentMeasurementN:1Latest aggregated inbound sentiment
LastAggregatedOutboundSentimentMeasurementAggregatedSentimentMeasurementN:1Latest aggregated outbound sentiment

Expanding Relationships

GET/v1/odata/Activity_Offer({id})?$expand=Phase
GET/v1/odata/Activity_Offer({id})?$expand=Relationship,Contact,ProductLines,Phase
GET/v1/odata/Activity_Offer({id})/ProductLines
GET/v1/odata/Activity_Offer({id})/DigitalSignatures
DELETE/v1/odata/Activity_Offer({id})/Phase/$ref

Filtering Examples

GET/v1/odata/Activity_Offer?$filter=contains(Subject, '{Subject}')&$top={top}
GET/v1/odata/Activity_Offer?$filter=Amount gt {Amount}&$top={top}
GET/v1/odata/Activity_Offer?$filter=ExpirationDate gt {ExpirationDate}&$top={top}
GET/v1/odata/Activity_Offer?$filter=Version eq {Version}&$top={top}
GET/v1/odata/Activity_Offer?$filter=Reference eq '{Reference}'&$top={top}
GET/v1/odata/Activity_Offer?$filter=CreationDate gt {CreationDate}&$top={top}
GET/v1/odata/Activity_Offer?$filter=IsClosed eq {IsClosed}&$top={top}