Voucher

Represents details about a voucher that's issued to a customer or a loyalty program member. This object is available in API version 51.0 and later.

Supported Calls

create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert()

Fields

AccountId

Type: reference

Properties: Create, Filter, Group, Nillable, Sort

Description: The ID of the account to which the voucher is issued. This field is available in API version 62.0 and later.

This field is a relationship field.

Relationship Name: Account

Refers To: Account

BenefitId

Type: reference

Properties: Create, Filter, Group, Nillable, Sort, Update

Description: ID of the benefit associated with the voucher.

This is a relationship field.

Relationship Name: Benefit

Relationship Type: Lookup

Refers To: Benefit

ContactId

Type: reference

Properties: Create, Filter, Group, Nillable, Sort

Description: ID of the contact to which the voucher is issued.

This is a relationship field.

Relationship Name: Contact

Relationship Type: Lookup

Refers To: Contact

DiscountPercent

Type: int

Properties: Create, Filter, Group, Nillable, Sort, Update

Description: The discount percentage of the voucher.

EffectiveDate

Type: date

Properties: Create, Filter, Group, Sort, Update

Description: Required. The date the voucher goes into effect.

EffectiveDateTime

Type: dateTime

Properties: Create, Filter, Nillable, Sort, Update

Description: The date and time from when the voucher is available for redemption. This field is available in API version 62.0 and later.

ExpirationDate

Type: date

Properties: Create, Filter, Group, Nillable, Sort, Update

Description: The date the voucher expires.

ExpirationDateTime

Type: dateTime

Properties: Create, Filter, Nillable, Sort, Update

Description: The date and time when the voucher expires and is no longer available for redemption. This field is available in API version 62.0 and later.

FaceValue

Type: currency

Properties: Create, Filter, Nillable, Sort, Update

Description: The value of the voucher.

LastReferencedDate

Type: dateTime

Properties: Filter, Nillable, Sort

Description: The most recent date on which a user referenced this record.

LastViewedDate

Type: dateTime

Properties: Filter, Nillable, Sort

Description: The most recent date on which a user viewed this record.

LoyaltyProgramMemberId

Type: reference

Properties: Create, Filter, Group, Nillable, Sort

Description: ID of the loyalty program member who the voucher was issued to.

This is a relationship field.

Relationship Name: LoyaltyProgramMember

Relationship Type: Lookup

Refers To: LoyaltyProgramMember

Name

Type: string

Properties: Autonumber, Defaulted on create, Filter, idLookup, Sort

Description: The autogenerated number of the voucher.

OwnerId

Type: reference

Properties: Create, Defaulted on create, Filter, Group, Sort, Update

Description: The ID of the user who owns this record.

This is a polymorphic relationship field.

Relationship Name: Owner

Relationship Type: Lookup

Refers To: Group, User

PromotionId

Type: reference

Properties: Create, Filter, Group, Nillable, Sort, Update

Description: ID of the promotion associated with the voucher.

This is a relationship field.

Relationship Name: Promotion

Relationship Type: Lookup

Refers To: Promotion

Reason

Type: string

Properties: Create, Filter, Group, Nillable, Sort, Update

Description: The reason why the voucher was issued.

RedeemedValue

Type: currency

Properties: Create, Filter, Nillable, Sort, Update

Description: The voucher balance that was redeemed. This field is available in API version 53.0 and later.

RemainingValue

Type: currency

Properties: Filter, Nillable, Sort

Description: The remaining value of the voucher after partial redemption. This field is available in API version 53.0 and later.

ReservationKey

Type: string

Properties: Create, Filter, Group, Nillable, Sort, Update

Description: The key that's used to redeem a reserved voucher. This field is available in API version 62.0 and later.

ReservedDateTime

Type: dateTime

Properties: Create, Filter, Nillable, Sort, Update

Description: The date and time when the voucher is reserved for redemption. This field is available in API version 62.0 and later.

ReservedValue

Type: currency

Properties: Create, Filter, Nillable, Sort, Update

Description: The value of the voucher reserved by the customer. This field is available in API version 62.0 and later.

Status

Type: picklist

Properties: Create, Defaulted on create, Filter, Group, Restricted picklist, Sort, Update

Description: Required. The status of the voucher.

Possible values are:

  • Cancelled
  • Expired
  • Issued
  • Redeemed

TransactionJournalId

Type: reference

Properties: Create, Filter, Group, Nillable, Sort, Update

Description: ID of the transaction journal associated with the voucher.

This is a relationship field.

Relationship Name: TransactionJournal

Relationship Type: Lookup

Refers To: TransactionJournal

UseDate

Type: date

Properties: Create, Filter, Group, Nillable, Sort, Update

Description: The date the voucher was used.

VoucherCode

Type: string

Properties: Create, Filter, Group, Nillable, Sort, Update

Description: The voucher identifier generated by an external system.

VoucherDefinitionId

Type: reference

Properties: Create, Filter, Group, Nillable, Sort

Description: ID of the voucher definition associated with the voucher.

This is a relationship field.

Relationship Name: VoucherDefinition

Relationship Type: Lookup

Refers To: VoucherDefinition

Associated Objects

This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version and later.

VoucherChangeEvent (API Version 63.0): Change events are available for the object.

VoucherHistory (API version 52.0): History is available for tracked fields of the object.

VoucherShare (API version 52.0): Sharing is available for the object.