Table of Contents
Purpose
Have you set your invoices up in Aspire but clients are still not able to receive them? This article troubleshoots the different places in Aspire where your invoicing information may cause invoices not reaching your customers.
This includes places like:
Configuration in Administration
The Contact record
The Property record
However, to first be able to understand what the problem is, you’ll always want to check the Invoices tab in the Invoicing module!
Let’s start there in the next section and gain an understanding of how each part of Aspire is set up correctly!
Requirements
✅You have read Email Authentication Requirements for Aspire
✅You have read Syncing Your Email and Calendar to Aspire
Check Invoicing Module for Email and Batch Statuses
Your first step to troubleshooting the invoice process is to review Statuses that can be found in the Invoicing module. Those two statuses are Invoice Batch Status and Email Status.
Neither of these statuses are added to the default search list view. To add them, you will need to add a display for each.
To add your display columns:
Navigate to Invoicing ▶️ Invoices.
Select the Display option on the Invoices Search List.
Add a display for Invoice Batch Status and Email Status.
The Invoice Batch and Email statuses are now visible! But what do each of these statuses represent? Let’s find out!
Review the Invoice Batch and Email Statuses
In Aspire, Invoicing Emails are not generated and sent until the Invoice Batch has been completed.
Once an Invoice Batch is generated, the Email Status comes into play. This is outlined in our Invoicing- Workflow Overview!
With Email Status, this status signals the progress in the process of emailing an invoice based on that status of the batch. Let’s break these statuses down to better understand where issues may occur.
Batch Status | Email Status | Meaning | Troubleshooting |
Draft | N/A | The batch is still in progress and is yet to be sent.
Email Status is N/A if the invoice did not have assigned email (billing) contacts and was not emailed. | If you intend not to email the invoice, the email status will remain as N/A if there is no email contact set.
If you intend to email the invoice and are expecting an email to be sent, you will need to set an invoice email contact. For more information, click here! |
Draft | Pending | The invoice has invoice email contacts assigned and the batch is in draft status. | To progress the email to In Queue, you will need to complete the batch. |
Sent | In Queue | The invoice batch has been completed.
The email is added to the email queue to be sent to the invoice’s recipients.
| If there is a sync in place, validation of the email sync will occur for the sender.
If the email is stuck in the queue for over an hour, the invoice may be held up by the sync not being validated.
|
Sent | Sent | The invoice batch is completed.
The invoice has been sent to the designated email contacts.
| If the invoice has not been received by the client, have them check their junk/spam folder.
You can also check the email of the sender to confirm there were no undeliverable or kickback emails received. |
⚠️ Once the email has truly left Aspire, any issues with receiving the email will occur with the recipient of the email. Reach out to your IT, Email Host Provider, or Email Administrator if an issue occurs after the email has left Aspire!
Check Administration to Confirm Sender’s Information
Have You Confirmed Branch or Region Level Settings?
You can find Branch and Region settings by heading over to:
User Settings ▶️ Administration ▶️ Organization
If you have Branch or Region settings set up, ask yourself:
Is the Invoicing Email From field set to the correct email address that will be sending emails, such as invoices, to your customers?
If so, does the user that has that email address in Aspire have their email sync configured properly?
🧠 To verify that the sync is accurately set up from the User Screen of that employee, please see the section below for Has the User Information Been Set Up Correctly on the User Screen?
Have You Confirmed Invoicing Settings on the Configuration Screen?
You can find the Configuration screen by heading over to:
User Settings ▶️ Administration ▶️ Configuration
If Branch or Region settings are configured as mentioned in the previous section, they will take priority over Configuration settings to who the sender is from. If Branch or Region settings are not configured, all invoicing emails will be sent using the information set in Configuration.
📌Note: For recommendations on setting up the Configuration screen, please see How to Set Up Aspire to Email Invoices to Customers!
The Configuration screen, in terms of email invoicing, will reflect what you see in the Branch and Region settings.
Confirm you have a user set as the Invoice Email From and that they have a valid email sync in place, as you did in the previous section for your Branches and Regions!
That will conclude the administration portion of this guide. Next, have you confirmed that the Contact and User have been set up correctly?
Check Contacts for Contact and User Email Configuration
Has the Contact Record Been Set Up Correctly?
You can find the Contact screen by heading over to the Contacts module.
Then, find and select the employee you are wanting to confirm has been set up correctly.
This will land you at their Contact screen.
In Aspire, a contact’s email address must be valid and unique within your system. It is important to keep this in mind when setting up the email address for your new customer or employee.
If you attempt to use an email address that is already in use when creating or updating a contact, you will receive an error message.
📌Note: This means that no two contacts can share the same email address.
This also means that this email address should be able to receive email and is an active inbox.
🧠 To verify the uniqueness of the email address before creating the contact, you can use a filter in your contact search list to see if the email address already exists and who it is associated with. Be sure to also check the Active status of the employee contact when filtering to avoid confusion with inactive contacts.
To set up your filter, you can:
Go to Filters in your Contacts Search List.
Select the trashcan icon to remove the Active filter. This will provide a list of active and inactive contacts.
Add a filter for Email and set the value to the email address you are trying to use.
Another issue to watch out for is unexpected spacing or unsupported characters in the email address when adding it to Aspire.
While this is not as common, extra spaces at the beginning or end of the email, or special characters that aren't supported, may cause issues! If you feel that the email field may have an issue, please delete out all of the text and manually retype the email address to confirm.
Has the User Information Been Set Up Correctly on the User Screen?
📌Note: Syncing the intended email sender’s email is not required for sending email. A user should have their SPF and DNS information configured and then, a sender can email with no sync set up.
To be sure this is set up accurately, please see Email Authentication Requirements for Aspire article.
The User page is located in the contact record under the three dot menu or Administration ▶️ Organization ▶️ Users.
For setting up the email sync, this can only be configured when logged in as an individual user under the User Settings screen.
Here are some common issues you might run into when dealing with syncing email addresses to Aspire:
Unaccepted Provider
Aspire supports Microsoft 365 and Google Suite.
Any other options will need to rely on the SMTP option via SPF and DNS validation.
Sync Breaks
Password Change
This typically occurs due to needing to change the password for the Google or Microsoft accounts that are synced to Aspire. A resync would need to take place to resolve the issue.
Token Expiration
Aspire stores an authorization token that will stay valid for 90 days. This token refreshes each time a user logs into Aspire.
As long as a user logs into Aspire once every 90 days, the token will stay current and the integration continues to work.
Check Properties for Assigned Contacts
Is there an Email Contact Assigned to the Invoiced Property?
The only potential issues that can arise from the Property page is ensuring that the Contacts section listed at the bottom is set up accurately.
The Email Invoice option will need to be selected, as well as the Primary and Billing checkboxes, depending on how you want your associated customers to receive their invoice(s).
📌Note: For more information on the Contacts section of the Property screen, click here!
💡Tip: Making sure these settings are accurate will help avoid any issues with who your invoice will land with on the property level!