======  ======



A common desire is to easily send invoices to customers when their orders reach the Sales status. This can be invoked manually or automatically when the status is changed.



This How-To covers how to set up Control to manually send invoices to all new orders in Sale since the last email was sent. For information on automatically sending invoices when the order is made a sale, see [[how-to_email_invoices_on_orders_in_sale_automatically]].



===== Concept =====



The basic approach used is:
  * Create an Order UDF to track which orders we've already sent invoices to.
  * Create a Saved Query to pull up all of the Sale Orders that haven't been sent invoices.
  * [Optional] Exclude all existing Sale orders by setting in the UDF value.
  * Create a Macro to send this group and invoice and set the UDF.



===== Notes =====
  * This macro uses the Order contact's email.
  * This macro does not send the invoice for orders that are already closed (fully paid), though it could be easily modified to pull Closed orders also.
  * Make sure before you run this for the first time update the UDF on all the older Sale orders that you don't want to receive an invoice.



===== Steps =====



==== Create UDF ====



Create an Order UDF called "Invoice Emailed" of type Date. This will be used to track who has received the email already.
  - Click on **Sales & Marketing | User Defined Field Setup**.
  - In the left panel, choose Transaction Under "User Defined Fields"
  - Click on the "Add" button in the middle panel
  - Enter "Invoice Emailed" as the Field Name.
  - Select "Date" as the Data Type.
  - Enter a Description and any category names if desired.
  - Make sure that "Show For Orders" is checked.
  - Make sure that "Show For Service Tickets" is checked (if you use service tickets).
  - Make sure that "Clear When Cloned" is checked.
  - Save the UDF.



{{::http:www.ecyrious.comcontrolimagesinvoice_email_udf_setup.jpg?nolink&|}}
  - Restart Control so the UDF will be created.



==== Create Advanced Query ====



Create an advanced query to pull all orders in Sale where the UDF is not set.
  - Open Order Explorer
  - Clear all of the criteria except "Sale" so that only orders in Sale are showing.
  - Click on the "Advanced" button to switch to the Advanced Query setup.
  - Click on the "Modify Criteria..." button.
  - In the left panel, expand **Order Criteria | User Defined Fields | All Fields** and click on the "Invoice Emailed" UDF. The center panel will fill with date criteria for this UDF.
  - In the center panel, double click Double the criteria "Not Set".
  - In the bottom right panel, change the "Show:" range to All.



{{::http:www.ecyrious.comcontrolimagesinvoice_email_advanced_query.jpg?nolink&|}}
  - Click OK.
  - Check that the query results look correct.
  - In the left panel, click on the "Save..." button. Enter "Invoices Not Emailed" as the query name.



{{::http:www.ecyrious.comcontrolimagesinvoice_email_save_query.jpg?nolink&|}}



==== Set UDF on Existing Orders ====

**[Optional]** Set the "Invoice Emailed" UDF for all the existing Sale orders so that these are excluded from the initial emails.
  - With Advanced Explorer showing all the results, click on the down-arrow by "Run Macro Action" on the action menu.
  - Select "Run User Field Macro". A dialog window will appear.
  - Select "Transcation Fields" as the Category.
  - Select "Invoice Emailed" as the User Field Name.
  - Select "Set the field to the value below"
  - Select "Current Date When Executed" to set the UDF to todays date.
  - Click Execute to set the UDFs for all the orders selected in Explorer.



{{::http:www.ecyrious.comcontrolimagesinvoice_email_macro_action.jpg?nolink&|}}



==== Create Macro ====



Create a Macro Using this query that Emails an Invoice
  - Click on "Marketing Home" on the main Toolbar.
  - Click on "Macro Setup". This will open the Macro Setup Window.
  - Click on "Order Macros" in the left panel.
  - Click on "New Macro" at the top of the left panel.
  - Enter "Email New Sale Invoices" as the Macro Name on the **Description Tab**.
  - Click on the **Trigger Tab**.
  - We want to run this manually, so click on "Run this macro manually or on a schedule".
  - Choose to "Use a saved query" under this otpion.
  - Select the query we saved above, "Invoices Not Emailed" from the list.
  - Click on the **Actions Tab**
  - The macro tab automatically starts with two pop-up message prompts. We will use before we run and one after.
  - Click in the "Message Text" box under the "Prompt to Begin" action tab. Type a message such as:



<html><div style="margin-left: 20px;"> This macro will automatically email invoices for orders that were marked as Sale since the last time it was run. </div></html>
  - Check the box "Allow user to cancel macro execution with this message" so they user will have an OK & Cancel buttons and not just an OK button.
  - Click on the Notify og Completion macro action tab. Type a message such as:



<html><div style="margin-left: 20px;"> Done! </div></html>
  - Add an action to send the emails. In the center panel is a list of macro actions. Click on "Report Macro (SQL)" and click the "Add" button above it. This will add a new action on the right. **Note**: Even though we want to send an email, what we are sending is the report so we will use a Report Macro in this case.
  - First, let's move this action before the completion message. Click the "Move Up" button in the middle column once to move this action up in the sequence. You will notice that the order of the tabs has now changed.
  - Fill in these fields in the Report Macro action sub-tabs:
    * **General Sub-Tab** Options
    * Menu Item Name --> Invoice (required field, but any name will do)
    * Print Option --> select **Quick Email**. (necessary so it just auto-sends the invoice without prompting or previewing first)
    * File Location --> Choose System Report and select the standard invoice template you use from the drop-down (Order_Invoice01 for example), or if you use a Custom Invoice choose Custom Report and select the invoice you use from the browse dialog.
    * **Options Sub-Tab** Options
    * Click on the "Show Detail" button under Email
      * Click in the To: box
      * Click on the "Merge Fields" button and choose Contact | Email Address. You will notice that Control inserted the code  in the To: field. This will be replaced with the email address of the order's contact.
      * Click in the Subject Line and enter a subject. You can use merge fields in this as well (for example "Invoice  - ")
    * Click in the Message box and enter a meaningful message. Again, you can use mail-merge fields by clicking on the "Merge Fields" button above. For a larger editing area, click on the "Show Exanded" button. Close the expanded message area by clicking on the "X" at the top right of that pop-up.
    * Set the other invoice options corresponding to your preferences.
  - Add an action to update the Order UDFs (so they are excluded next time). In the center panel, click on "User Defined Field Macro" and click the "Add" button above it. This will add a new action on the right.
  - Move this action before the completion message. Click the "Move Up" button in the middle column once to move this action up in the sequence.
  - Select "Transcation Fields" as the Category.
  - Select "Invoice Emailed" as the User Field Name.
  - Select "Set the field to the value below"
  - Select "Current Date When Executed" to set the UDF to the date which the query is executed.
  - Save the Macro by clicking "Save" on the action toolbar.



==== Run Macro ====



To run the macro at any point in time,
  - Click on Marketing Home on the action toolbar.
  - Expand **Existing Macros | Order Macros**.
  - Double-click on "Email New Sale Invoices".
  - Click "Yes" when prompted to run this macro.



==== Schedule a Macro ====



You may schedule this macro to run at a particular time using the following steps.
  - Click on "Activity Manager" on the main toolbar to open your calendar.
  - Right-click on the calendar and choose **New | Macro Activity**.
  - Enter a description that will appear on your activity manager.
  - Select "Email New Sale Invoices" as the macro.
  - Select to Automatically Run "only if logged in". While email macros from the server are possible, you will need to set up the system email information with the default. Until you are successfully using the macro from a manned station, it is not recommended you move it to running in the background on the server.
  - Select a date and time to run.
  - If desired, you can make this a recurring activity. Caution, however, that recurring activities incorrectly created (so they occur with incredibly high frequency) can slow down the entire system.
  - Click OK to save macro activity.



===== Source =====



Contributor: Cyrious Software



Date: 7/30/2009



Version: Control 4.0 and higher