Receipts Manual - Android
Receipts are grouped into accounts. An account may represent a client, project, trip, business, or any other grouping. A default account is included, new accounts may be added when editing a receipt or in Settings. Accounts may be active or inactive, active accounts appear black while inactive accounts are grey. Active accounts appear first in the accounts list (under the Receipts tab) followed by inactive accounts.

Categories are groups of receipts within accounts. Receipts includes 16 categories by default, others may be added when editing a receipt or in Settings. Subcategories may be created by setting a category's parent.

Receipts saves up to three totals for each receipt. These include the receipt total (in the receipt's unit), the account total, and the home currency total. The account and home currency totals are only displayed if the account or home currency unit is different from the receipt unit. The receipt unit is either a currency or a mileage unit. Each account may have a currency set that is different from the home currency. By default, the home currency is set to the current device locale's currency. This may be changed in Settings. Default values for all units are included with Receipts and updated with each app update. Values may be manually updated under Units in the Settings tab or by tapping the refresh button.

Each receipt is assigned a unique global number or a unique account number (depending on the Global Receipt Numbers setting). This number may be used to identify receipts and their attachments. Receipts may be active or inactive. Active receipts appear black in the receipts list while inactive receipts are grey. Receipts can be set up to be repeating with a time interval and an optional end date. If a receipt is a repeating receipt, new receipts are automatically added when the specified time interval has passed. Repeats become inactive when the end date has passed (if set). Repeats are deleted when all receipts related to the repeat are deleted. When editing a receipt that is part of a repeating series, changes may be applied to the edited receipt only, all future receipts (including the edited receipt), or all related receipts. When deleting a repeating receipt, either only the receipt may be deleted or all related receipts as well.

Each receipt may contain multiple photos, drawings, voice memos, and other attachments. These are displayed in a tray that appears at the bottom of a receipt (scrollable horizontally). Photos may be added from an existing photo album or captured using the device camera(s). Receipts supports photo editing in the photo view. Drawings may also be attached to receipts. These may be used for signatures and quick notes. Voice memos may also be included to capture short voice notes. Attachments of any file type may be added from other apps. Receipts supports previews of many common file types. Tap an attachment to see a preview. Attachments may also be opened in other apps or printed.

Receipts consists of four tabs along the bottom of the screen.

Overview
The Overview tab helps you keep track of income and expenses. Tap the left or right arrows at the top left of the view or tap the page control dots at the bottom to scroll through the various graphs. Zoom in or out by pinching the screen in or out.

Graphs

Bar and pie charts are included to show totals by account, category, and unit (currency/mileage). The next graph shows spending over time. This graph displays a straight line that represents the average spending for the given time interval. The next graph shows income/expenses over time. Finally, if there are any custom currency fields, the final graph shows totals for each custom currency field.

Email, Print, Open in App, or SD Card

Tap the action button on the top right to email, print, open in app, or save the graph to the SD Card. Select to include the current graph or all graphs in the PDF. If email is selected, the Default Email address is used for the To address (if set).

Settings

Tap the settings button on the top right to change the graph settings. Select a filter to limit which receipts are included in the graphs. A new filter may be created or an existing filter may be modified. Select how to sort the data, either by total (descending) or name.

Receipts
The Receipts tab allows you to add, edit, and view your receipts. It also provides totals for each account and category. There are four main views including an account list view, category list view, receipt list view, and the receipt view. Tap the + button from any of the list views to add a new receipt. If sync is enabled, pull down any of the list views to initiate sync.

Accounts

The top-level view displays a list of accounts and filters. Active accounts are listed first followed by inactive accounts and filters. Tap an account to view the category list for that account. Tap a filter to view receipts that match the filter criterion. If an account has a budget set, the budget bar is displayed. Tap the info button on the right side of an account or filter to see its details.

Categories

The category list view displays a list of categories. Tap a category to view a list of receipts for that category. If the account has a budget set and the budget includes the category, a budget bar is displayed. Tap the info button to see the category details.

Receipts

The receipt list view displays receipts sorted by date. The receipts are grouped by day with the totals for each day included in the header (converted to the account currency). Active receipts are displayed in black while inactive receipts are grey. The receipt number is displayed on the left side of each receipt. This number is either a unique global or account receipt number. If the receipt has not been synced, 'sync' will be displayed until a receipt number is obtained. If a receipt contains attachments, a small paperclip is displayed on the right side of the receipt. Tap a receipt to view or edit its details. Tap the Edit button to perform operations on multiple receipts.

Receipt

The receipt view displays a receipt's details. All standard receipt fields and any custom user fields are displayed in the order as specified in Settings. Tap the email button to generate an email with the receipt details including attachments. If a receipt is part of a repeat, tap the info button next to the Repeat field to see the related receipts. Tap an attachment in the tray at the bottom to preview it.

Tap the Edit button to edit the receipt. Tap a field to change its value. If autofill is enabled, modifying a field may cause the other fields to be populated based on the field value.

Text fields (such as Business, Description, and Notes) have an info button on the right for selecting previous values. To enter a new value for these fields, tap anywhere else in the field.

Tap the Total field to set the total amount for the receipt. This displays the calculator where the total amount may either be set directly or calculated. Tap the Income or Expense button to specify the type of receipt. The receipt unit is displayed next to the total value. Tap the unit to select the receipt unit. Mileage units are listed at the top (kilometres and miles) followed by a list of currency favourites, and then all other currencies. If the receipt unit is different from the account currency, a second total field is displayed with the account currency value. The account total is automatically calculated when the receipt total is updated but may be overridden with a custom value. If the receipt and account units are different from the home currency, a third total field will appear with the home currency value.

Tap the Repeat field to enable receipt repeating and set the repeat interval. The repeat end date is displayed on the right in the field. By default, repeating receipts never end. Tap the end date to clear or set a specific end date.

Tap the Notes field to set a receipt note.

Attachments include photos, drawings, voice memos, and other files. These are displayed in the tray at the bottom of the view. Scroll the view by swiping left or right. Delete an item by tapping the X button on the top left corner. Reorder the attachments by tapping and holding the attachment, and then dragging the attachment to a new position. Change the attachment name by tapping on the file name.

To capture a new photo, tap the camera button on the toolbar at the bottom. To add an existing photo, tap the picture icon next to the camera. The photo view supports photo editing. Tap the rotate/scale or crop buttons to edit the photo. Tap the adjustments button to modify the photo brightness, contrast, and saturation. Tap the camera button to retake the photo or the picture icon to select a different album image. Tap the trash button to delete the photo. Tap the Revert button to restore the previously saved photo. Note that this button is disabled until the photo has been saved.

To record a voice memo, tap the microphone button. Tap the record button to begin recording and the pause button to end recording. When playing back a voice memo, double tap the play/pause button to restart the playback from the beginning.

Tap the paste button to paste attachments into the receipt. This button is only enabled if a valid text clip/file has been copied to the clipboard.

Tap the drawing button button to add a new drawing to the receipt. Drawings may be used for signatures or quick notes. Change the brush colour and size at the bottom of the view. Tap Clear at the top of the view to reset the drawing.

To add a file attachment to a receipt, launch an app that supports opening files in other apps, find the attachment, and tap and hold the attachment until the Chooser view appears. Select Receipts from the list of apps that support opening files. If a receipt is currently being edited, the attachment will be added to it. Otherwise, Receipts will display an alert giving the option to add the attachment to either a new or existing receipt.

Tap the delete button to delete the receipt.

Reports
The Reports tab is used to create customized reports of your data.

Select a filter to limit which receipts are included in the report. A new filter may be created or an existing filter may be modified.

Report Settings

Tap the Report switch to include the report (disable it to send only the receipt attachments).

Select the File Type. CSV (comma separated value) files are supported by almost all spreadsheets and many finance applications. Excel (.xlsx format) and HTML files include links to attachments. PDF files are generally read-only and may (optionally) include embedded photos and drawings.

The File Name setting allows a custom file name to be selected for the report. Enter a list of file names for various reports and then select the file name to use when generating a report.

The Report Name is the name included in the report itself. Similar to the file name setting, a list of report names may be entered. Select the report name from the list when creating a new report.

The Headers setting allows you to include custom header lines at the top of the report. Select which items to include in the report by tapping them (faded items are not included in the report). Header items may be reordered. Three special keywords are included that are replaced with generated values. These include <filter> (represents the selected filter), <count> (the receipt count), and <date> (the current date).

Select Fields to select which fields to include and in what order. Fields may be enabled or disabled by tapping the field name. Reorder a field by dragging the icon on the right of the field.

The Sort Field and Sort Order options specify which field to sort the report by and the sort order.

The Group Field option allows report receipts to be grouped by a field. For example, selecting the Business field would group receipts that have the same business field values.

Attachment Settings

The top section includes switches for including photos, voice memos, drawings, and other attachments in the report.

If PDF is selected for the report type, the two embed options are enabled. If selected, photos and drawings are embedded in the report itself.

The Attachment Name setting allows customization of attachment file names. By default, receipt numbers are used for attachment file names. The account name is prepended if global receipt numbers are not used. The Date option prepends the receipt date, Account prepends the receipt account name (if it is not already included), Category prepends the receipt category name, and Account/Category prepends the receipt account and category.

The Number Per Page setting specifies how many attachments per page to include for embedded photos and drawings. This setting is only enabled for PDF reports.

Select Fields to overlay receipt field values on photo and drawing attachments. A location, font size, and font colour may also be set. If enabled, the fields are drawn on both embedded photos and drawings (for PDF reports) and included photo and drawing attachments.

The Zip setting specifies whether or not to zip the report, photo, drawing, voice memo, and attachment files into one file.

If enabled, the Preview option shows a preview of the report before sending it.

The Destination setting specifies where to send the generated report and attachments. Note that the above settings may not be available depending on the selected destination. To generate the report and send it to its destination, tap the Send button at the bottom.

Email

An email app is displayed with the report file and any attachments. The message may be edited before being sent. If set, the Default Email address is used for the To address. Note that most email providers limit email sizes to 5-10 MB. Receipts will display an alert if the approximate email size is 5 MB or more.

SD Card

Use the device's SD Card to quickly and easily transfer reports. The report is saved to the app's folder on the SD Card (/Android/data/com.tidalpoolsoftware.receipts/files/). Note that Receipts does not delete reports generated to this destination.

WiFi

To send via WiFi, both the device and computer must be connected to the same WiFi network. To connect, enter the displayed URL in a browser on your computer and download the report files and any attachments to the desktop.

App

Reports may be opened in other apps that support the selected report file type (or zip files, if the report is zipped). Note that attachments may not be included unless zip is enabled.

Print

Printing reports requires Android 4.4 or later and a compatible printer. Note that receipt photos and drawings are only included if the embed photos and drawings options are selected.

Box

Enter account details (including the default folder to use) under Settings or enter them when prompted. The reports and attachments are uploaded to your Box account to a new folder. You can learn more or sign up for a free Box account here:

Learn More about Box
Sign Up for a Box Account

CloudApp

Enter account details under Settings or enter them when prompted. The reports and attachments are zipped and then uploaded to your CloudApp account. You can learn more or sign up for a free CloudApp account here:

Learn More about CloudApp
Sign Up for a CloudApp Account

Dropbox

Enter account details (including the default folder to use) under Settings or enter them when prompted. The reports and attachments are uploaded to your Dropbox account to a new folder. You can learn more or sign up for a free Dropbox account here:

Learn More about Dropbox
Sign Up for a Dropbox Account

Evernote

Evernote performs OCR on receipt photos (and some attachments) and allows you to search for receipts by photo/attachment content. Enter account details (including the Notebook to use) under Settings or enter them when prompted. The report along with attachments are uploaded to your Evernote account as a new note to the specified notebook. You can learn more or sign up for a free Evernote account here:

Learn More about Evernote
Sign Up for an Evernote Account

Google Drive

Enter account details (including the default folder to use) under Settings or enter them when prompted. The reports and attachments are uploaded to your Google Drive account to a new folder. You can learn more or sign up for a free Google Drive account here:

Learn More about Google Drive
Sign Up for a Google Drive Account

Settings
The Settings tab allows you to manage app settings, set up syncing, import/export data, and save/restore backups.

Tap About to view app info, statistics, contact details, or to write an app review. The Store section (Receipts only) displays the Pro upgrade status. Purchase the Pro upgrade to allow an unlimited number of receipts to be added. Tap Restore Previous Purchases to restore the Pro upgrade.

Tap Budgets to add, edit, or delete budgets. Select Global Budget to assign a budget that applies to all accounts. If a budget is selected, a budget bar appears in the All account (and any account categories). The next section lists all budgets. Budgets must include a start date and may optionally include a cycle. If a cycle is set, the budget amounts may be rolled over to the next budget period by enabling the Rollover switch. Each budget includes All and a list of categories. Set the budgeted values for each category of interest. Note that budgets may be assigned to multiple accounts. If an account has a budget assigned to it, a budget bar will appear in the account under the Receipts tab. Each account category will also include a budget bar that displays how much of the budget has been used for that category.

Tap Accounts to add, edit, or delete accounts. All account receipt attachments or all account receipts may be deleted. Deleting an account will delete all of its receipts and attachments. Each account has a name, description, icon, currency, budget, starting receipt number, and active switch. Select an icon from the library or add a new icon from an album. Tap the Tint button to set an icon colour. If the account currency is different from the home currency, each receipt will include a separate total field for the account currency. Selecting a budget will add a budget bar in the accounts list view under the Receipts tab. Also, a budget bar is included for each account category that has a budget value assigned to it (as well as the All category item). The starting receipt number is the minimum number assigned to new receipts and is only used if the Global Receipt Numbers setting is disabled.

Tap Categories to add, edit, or delete categories. Subcategories are created by assigning a parent category to a category. An unlimited number of subcategories may be created. Deleting a category moves all receipts from that category to the None category (which can not be deleted). Tap a category to see a summary of the category receipts for all accounts.

Tap Repeats to see a list of all repeating receipts. Tap Show Future Repeat Receipts to select how far in advance to show repeat receipts. By default, this setting is disabled and repeat receipts are added on the receipt date. The next section displays active repeats which continue to add new receipts. The last section shows inactive repeats which no longer generate new receipts. Delete a repeat by tapping the - button on the left. Delete either the repeat and receipts or only the repeat itself (leaving all current receipts intact). Tap a repeat to see a list of receipts it contains.

Tap Fields to add, edit, or delete receipt fields. Reorder fields by dragging the icon on the far right of each field to a new location. Changing the field order changes the layout of the receipt view. Note that Standard fields can not be deleted although they may be renamed and reordered. Nine types of custom fields may be added including currency, date, list, number, percent, percent total, switch, tags, and text. The currency field always uses the same unit as the total unit for a receipt. List and tag fields contain a list of user items that may be added by tapping the info button on the right side. Tag fields are different from list fields since they may have zero or more items selected while lists always have only one item selected. Percent total fields automatically set their value to a percent of the total value. This value is calculated when the receipt total is modified. Tap the info button to change the percentage to use and enable the Included in Total switch if the value is already included in the receipt total. Switch fields support an on or off state and are included with values 1 or 0 in reports. Deleting a field will also delete all receipt data for that field.

Tap Values to see a list of textual fields that contain previous values. The Separate Account Values option specifies whether or not to separate textual values by account. If enabled, each field's values are saved separately for each account. If disabled, all field values are saved independent of the account. Tap the + button to add a new value. Tap an existing value to change it. Delete a value by tapping the - button next to it. Tap the Reset button to reset all values given the current receipt values or clear all values for the field.

Tap Units to manage mileage and currency exchange rates. For mileage, tap either Kilometres or Miles to set the amount per kilometre or mile in the home currency. For currencies, tap the currency and set the exchange rate relative to your home currency. To download the latest currency exchange rates, tap the refresh button on the top right of the view. To save a favourite currency, tap the circle to the left of the currency. Favourite currencies appear at the top of the Units list in the receipt view.

The Services section is used to save account details for Box, CloudApp, Dropbox, Evernote, and Google Drive services. It is used for reports, backup, import/export, and sync features (if supported). The default folder can also be set for Box, Dropbox, Evernote, and Google Drive accounts. New folders may also be created. Tap Logout to clear the account details.

The Notifications view allows system reminders to be set up. Notifications for adding new receipts, saving a backup, and sending a report may be added. Select the date, repeat period, and notification text. Notifications are displayed even if Receipts is not running.

Tap Filters to add, edit, and delete receipt filters. Filters are used to limit which receipts are included in overview graphs, receipt lists, reports, and exports. Each filter includes a list of criterion. A filter may be set to match all, any, or none of the criterion. Each criteria specifies a field and may include a match selection and value.

Receipt Settings

Tap Autofill to configure receipt autofill settings. If enabled, autofill populates receipt fields based on the last receipt with the same field value. Select which Trigger Fields to use to invoke autofill. When a trigger field's value is set, the other fields are populated based on the last receipt with the same field value. The Autofill Fields are the fields that are populated if a matching receipt is found.

Tap Home Currency to set the local currency. If a receipt has a unit that is different from the home currency, an extra total field is included with the home currency total value.

Enable Global Receipt Numbers to use unique receipt numbers for all receipts across all accounts. Disabling the setting results in unique receipt numbers within each account but potentially duplicate receipt numbers across accounts.

The Starting Receipt Number setting is the minimum receipt number used across all accounts. Changing the starting receipt number does not impact existing receipts, it only applies to new receipts. Note that if the global receipt numbers setting is disabled, each account's Starting Receipts Number is also used to determine the starting number.

Enable the Show All Categories setting to display all categories in the category list view. Disable the setting to hide categories that do not contain any receipts. Even if the categories are hidden, they may still be selected when adding a new receipt.

The Sort Receipts setting specifies how to sort receipts under the Receipts tab.

The Expenses Sign setting allows expenses to be displayed as either positive (the default) or negative values. If expenses are negative, income values are then positive.

Enable the Save Receipt Photos to Gallery setting to save each new or edited receipt photo to the Gallery app.

The Resolution setting contains the maximum resolution to be used for receipt photos. The Full Size option will use the native resolution for the device camera.

Other Settings

The Numeric Input Style setting sets the style of numeric keyboard to use throughout Receipts. The Phone style lays out the numeric keyboard similar to a phone keypad with numbers incrementing from the top. The Calculator style is the opposite with numbers displayed similar to a calculator.

The Default Email setting sets the default email address used for emailing overview graphs, receipts, and reports. Multiple email addresses may be entered by separating each address with a space.

The Passcode setting allows you to set a four digit passcode that is required at startup and when switching from the background to unlock Receipts. Do not lose the passcode since there is no way to retrieve your data if lost. If set, the passcode must also be entered before resetting the app.

Sync

Tap the Sync button to manage sync options. Sync repositories may be created on Box, Dropbox, or Google Drive. Receipts uses a custom locking mechanism to prevent multiple clients from trying to sync at the same time. All receipts (with attachments), budgets, accounts, categories, repeats, fields, and most other settings are synced. The Sync After section specifies when Receipts should sync to the repository. Enable Launch to sync after app launch (or switching from the background), Quit to sync after the app exits (or is moved to the background), or Save to sync whenever a receipt is added/edited. Sync may be manually initiated at any time by tapping the Sync button on the top right. Alternatively, pull down the accounts, categories, or receipt list views to start syncing. Tap the Reset Locks button if a lock was not updated correctly (due to another client exit/crash) and is preventing access to the repository. Note that resetting locks could corrupt the sync repository if another client is currently syncing. If sync is enabled, new receipts are not assigned receipt numbers until they have been synced. Also, if a client has updated a receipt that has also changed on the server, the client version of the receipt is uploaded.

Import/Export

Tap Import to import receipts (CSV) and attachments. Column headers are listed on the left with matching fields listed on the right. Each column header may be matched to a field in Receipts or not imported. Select a column to modify its settings. Enable Import to import the column, select the Field to import to, and specify any other field settings (if applicable). Account, category, list, and tag fields include an option to automatically create new values if they don't already exist. Total fields include a Unit setting for specifying the total unit. Date fields include a Format setting for specifying the date format. The date format must follow conventions specified by the Unicode Technical Standard #35. Attachment fields include a Folder setting for specifying which folder to use for the attachments. Once the settings are configured, tap Parse to display the receipt list. Select which receipts to import from the receipt list by selecting the circle on the left side. By default, Receipts will automatically select any new receipts. Tap Import to import the receipts.

Tap Export to export receipts (CSV) and attachments. Select a filter to limit which receipts to include. Select the receipt fields to include and reorder them by dragging the icon to the right of each field. Enable the Data switch to include the export file and the Photos, Drawings, Voice Memos, and Attachments switches to include various attachment types.

Backups

Save Backup and Restore Backup allow you to save and restore backups to a variety of destinations including email, SD Card, WiFi, other devices, other apps, Box, CloudApp, Dropbox, Evernote, and Google Drive. The backup includes all receipts, attachments, and application settings (except for service account details). Restoring a backup will replace all existing receipts and settings.

  • To restore a backup from an email, open Mail, select the email, and tap and hold the backup file until the Open sheet appears. Select Receipts from the list of apps. Note that backup files can quickly become very large (especially with attachments) and most email providers limit messages to around 5-10 MB.
  • Restoring a backup using WiFi requires both the device and computer to be connected to the same WiFi network. Open the URL in a browser on your computer and select the backup to restore.
  • To save/restore a backup to another device, first make sure both devices are connected to the same WiFi network. Tap Save Backup on the source device and Restore Backup on the destination device. Tap the name of the device to connect to from the destination device. The data will be transferred over the WiFi connection and then restored on the destination device.
  • To restore a backup from another app, tap the file and open it in Receipts. Receipts will recognize the file type and display an alert to authorize restoring the backup.
  • Selecting Box, CloudApp, Dropbox, Evernote, or Google Drive will first download a list of available backups from the default folder (if applicable) from the service. Select the file to restore. Note that backups can be very large files and it can take significant time to save or restore to a web service. Receipts supports completing uploads and downloads in the background.

Reset

Tap Reset to reset all previous text values, delete all receipt attachments, delete all receipts, or reset Receipts back to its original state. If a passcode is set, it must be entered before the reset.