Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Overview


This specifies all the fields associated with Invoices that are to be e-mailed.data structure includes the invoice email information such as sent by user, email template, email type and recipients. 

Format


Panel
titlePwsInvoiceEmailSettings

Elements


Element

Data Type

Required?

Default

Description

Sample Data

EmailFromUserIdentity

PwsUserRef [1]

On Insert: Yes

On Update: Yes

The User Identity user identity that will be assigned to the "From" field in the Invoice Emailinvoice email


EmailInvoiceTemplateIdentity

PwsInvoiceTemplateRef

On Insert: Yes

On Update: Yes

The Invoice Email Templateinvoice email template that will be used for this invoice


InvoiceEmailEnabledFlag

Boolean

On Insert: Yes

On Update: Yes

A setting of 'true' indicates Emailing Invoices emailing invoices is enabled for this installation

true
/false

InvoiceEmailType

String (1)

On Insert: Yes

On Update: Yes

Invoice Email TypeThe invoice email type

"P" to include invoice as a PDF

"H" to embed invoice as HTML in email

"W" to upload invoice to project workspaces and include a link in the email 

P

Recipients

PwsInvoiceEmailRecipient [1..100]

On Insert: Yes

On Update: Yes

The Recipientrecipient(s) of the invoice email

Note: The list is limited to 10 recipients per type ("To", "CC", "BCC"). If more than 10 recipients of the Invoice Emaila specified type are specified the list will be truncated and a warning will be generated.



Usage Example(s)


Code Block
languagexml
titlePwsInvoiceEmailSettings
collapsetrue
                     <b:InvoiceEmailSettings>
            <InvoiceEmailSettings>            <b:EmailFromUserIdentity>
                           <b:UserDisplayName>Betty Smith</b:UserDisplayName>
                           <b:UserId i:nil="true"/>
                           <EmailFromUserIdentity><b:UserReferenceSystemId>Partner - 01</b:UserReferenceSystemId>
                           <PwsUserRef><b:UserUid>1152921504607011056</b:UserUid>
                        </b:EmailFromUserIdentity>
                        <b:EmailInvoiceTemplateIdentity>
                           <b:InvoiceTemplateId i:nil="true"/>
               <EmailInvoiceTemplateIdentity>            <b:InvoiceTemplateName>E001</b:InvoiceTemplateName>
                           <PwsInvoiceTemplateRef><b:InvoiceTemplateUid>1152921504606878906</b:InvoiceTemplateUid>
                        </b:EmailInvoiceTemplateIdentity>
                        <InvoiceEmailEnabledFlag>true<<b:InvoiceEmailEnabledFlag>true</b:InvoiceEmailEnabledFlag>
                        <InvoiceEmailType>H<<b:InvoiceEmailType>P</b:InvoiceEmailType>
                        <b:Recipients>
                           <b:PwsInvoiceEmailRecipient>
                              <b:RecipientType>T</b:RecipientType>
                              <b:UserIdentity>
                                 <b:UserDisplayName>Abby Johnson</b:UserDisplayName>
                            <Recipients>      <b:UserId i:nil="true"/>
                                 <b:UserReferenceSystemId>OPA02</b:UserReferenceSystemId>
                                 <b:UserUid>1152921504607062210</b:UserUid>
                              </b:UserIdentity>
                           <PwsInvoiceEmailRecipient></b:PwsInvoiceEmailRecipient>
                        </b:Recipients>
                     </b:InvoiceEmailSettings>