Approved Email Receipts for Signature Transactions

  • iPad
  • iPhone
  • Browser

End users frequently capture signatures in their day to day tasks. Signatures are captured when distributing samples, when creating Medical Inquiries, or when authorizing orders. Accounts providing signatures frequently request a receipt for the items they have signed for. End users are able to use Approved Email to provide this receipt, providing a versatile method of delivering receipts across many areas of CRM while maintaining the approved content nature of Approved Email.

For example, Sarah Jones visits Dr. Ackerman and disburses a sample of Cholecap. When Dr. Ackerman signs for the sample, she sends him a receipt of his signature and sample via Approved Email. Included in the receipt is an image copy of Dr. Ackerman's signature and an itemized table of the items he signed for.

Users can only send the receipt email to the parent account for each signature transaction. For individual calls, the parent account is the primary account on the call. For group calls, the parent account is the selected sample recipient. If Swap Signee is used, the parent account is the new signer selected. Receipts are not available for samples recorded using Unique Activities on Group Calls.

Email Receipts are supported on the following transaction objects:

  • Call2_vod*
  • Medical_Inquiry_vod*
  • Multichannel_Consent_vod
  • Order_vod*

    Email Receipts for Orders are not supported for Child Accounts of a Business Account.

* Receipts for Calls, Medical Inquiries, and Orders are supported only on iPad.

Configuring Approved Email Receipts

The following configuration enables Approved Email receipts for all supported transaction objects. You can ignore rows of these tables if they are for transaction objects you do not want to enable, for example, Order_vod.

To enable this feature:

  1. Grant admins, content admins, and integration users the following permissions:

    Object OLS Record Types Fields FLS
    Call2_vod CRUD n/a
    • Request_Receipt_vod
    • Receipt_Email_vod
    Edit

    Call2_Sample_vod

    CRUD

    n/a

    n/a

    n/a

    Medical_Inquiry_vod CRUD n/a
    • Request_Receipt_vod
    • Receipt_Email_vod
    Edit
    Multichannel_Route_vod R Email_Receipt_vod
    • Approved_Document_vod
    • Country_vod
    • Default_vod
    • Language_vod
    • Object_vod
    • Record_Type_Name_vod
    • VExternal_Id_vod
    Read
    Order_vod CRUD n/a
    • Request_Receipt_vod
    • Receipt_Email_vod
    Edit

    Order_Line_vod

    CRUD

    n/a

    n/a

    n/a

    Sent_Email_vod

    CRUD

    Email_Receipt_vod

    • Receipt_Record_Id_vod
    • Receipt_Entity_Type_vod

    Edit

  2. Grand end users the following permissions:

    Object OLS Record Types Fields FLS
    Call2_vod CRU n/a
    • Request_Receipt_vod
    • Receipt_Email_vod
    Edit

    Call2_Sample_vod

    CRU

    n/a

    n/a

    n/a

    Medical_Inquiry_vod CRU n/a
    • Request_Receipt_vod
    • Receipt_Email_vod
    Edit
    Multichannel_Route_vod R Email_Receipt_vod
    • Approved_Document_vod
    • Country_vod
    • Default_vod
    • Language_vod
    • Object_vod
    • Record_Type_Name_vod
    • VExternal_Id_vod
    Read
    Order_vod CRU n/a
    • Request_Receipt_vod
    • Receipt_Email_vod
    Edit

    Order_Line_vod

    CRU

    n/a

    n/a

    n/a

    Sent_Email_vod

    CRU

    Email_Receipt_vod

    • Receipt_Record_Id_vod
    • Receipt_Entity_Type_vod

    Edit

  3. Add the following fields to the appropriate transaction object page layouts users should be able to send receipts from:

    • Request_Receipt_vod
    • Receipt_Email_vod
  4. Enter a value of 1 for the ENABLE_APPROVED_EMAIL_RECEIPTS_vod Approved Email setting.
  5. Enable the following VMOCs for the appropriate offline devices:

    VMOC Sync Type WHERE clause
    Multichannel_Route_vod Top Level N/A

Creating Approved Email Receipt Content

Approved Email content used as signature receipts use several unique tokens that render a table containing transaction line items and a photo copy of the signature.

See Signature Transaction Receipt Tokens for the list of tokens and relevant examples.

Adding Table Identifiers for Call Samples

Table identifiers can be added to the {{insertCallSample}} token, which can be helpful if multiple tables exist in the content. Table identifiers display before each table in the email to clearly identify the table.

The tableHeader parameter can be added to any part of the token. For example:

Copy
<p>
{{insertCallSample[tableHeader=Samples Left Behind,filterProductType=Sample,Quantity_vod__c,Product_vod__r.Sample_U_M_vod__c,Product_vod__r.Name,Product_vod__r.Manufacturer_vod__c,Product_vod__r.Distributor_vod__c]}}
</p>
 
<p>
{{insertCallSample[tableHeader=Samples Ordered,filterProductType=BRC,Quantity_vod__c,Product_vod__r.Sample_U_M_vod__c,Product_vod__r.Name,Product_vod__r.Manufacturer_vod__c,Product_vod__r.Distributor_vod__c]}}  
</p>

Would render as:

Currency in Email Receipts

If an Approved Email Receipt references a field with a data type of Currency, the currency ISO Code and numerical value are formatted based on the following criteria:

  • If the org is single currency, the Sent_Email_vod__c.Organization.DefaultCurrencyISOCode value is used and the number value is formatted accordingly. For example, ten thousand Canadian dollars is “$10,000.00”
  • If the org is multi currency, the system checks the transaction record's CurrencyISOCode field and formats the currency and number value accordingly. If the CurrencyISOCode field does not contain value, the Sent_Email_vod__c.CreatedBy.DefaultCurrencyISOCode is used.

Loading Approved Email Receipt Content

Loading receipt content requires work in both Vault and CRM:

Loading Receipt Content into Vault

After the content has been created, content admins need to load the content into Vault:

  1. Create a Vault Product record with the following properties:

    • Name = Email Receipt
    • External ID = email_receipt_vod
  2. Upload the content to Vault with the following properties:

    • Doc Type = Email Template
    • Product = Email Receipt
    • Email Template Type = Receipt Template (located in the Email Properties section of the Email Template page layout.)

Loading Receipt Content into CRM

After the content has been uploaded to Vault, Content admins must perform the following process in CRM before the content can be used:

  1. Create a Product Catalog record with the following properties:

    • Name = Email Receipt
    • Parent Product = null
    • Type = Detail
    • VExternal Id = email_receipt_vod
    • No Details = selected
    • No Metrics = selected
    • No Cycle Plan = selected
    • Company Product = selected

    Do not align users to this product in My Setup.

  2. Create a Multichannel Routing record with the following properties:

    • Transaction Object – The API name of the transaction object
    • Transaction Record Type – The DeveloperName of the Record Type
    • Approved Document – A lookup field. References the Approved Email content to use as a receipt for this object/record type combination.
    • Default – Select the Default check box if this Approved Document should be used when no account or user language matches.

      Only select one Default record for each object/record type combination.