Destinations
Documentation on Finicom Destinations, 3rd party external apps that financial transactions can be synced to.
Intro
A destination is somewhere Finicom is syncing transaction data to, from a specific source account.
Transaction Syncing
For transaction posted to a source account, a destination, will sync that transaction to the downstream account if it's active.
Transaction States
Transactions within financial accounts typically have 3 states:
- Pending: the transaction has been created, but not yet finalized. All details, like amount and description, can change.
- Posted: the transaction has been finalized and is unlikley to change.
- Void: the transaction has been removed, deleted, or reversed. Transactions move into this state when they are either deleted or marked as void by your bank.
Finicom syncs once per transaction state. Destinations, will attempt to overwrite existing synced data for transaction state updates if possible. For example, if a transaction gets synced in a pending state with an amount of $10, then moves to posted with an amount of $20, Finicom will overwrite the $10 amount with $20 in the downstream destination, if possible.
Finicom detects transaction state updates for transactions created in the last 60 days.
Syncing
- Your destinations are updated once per transaction per destination per transataction state; Finicom ensures no duplicate syncs are sent!
- Usually refreshed quickly, typically hour(s) after transaction changes occur, but may be longer.
Creating Destinations
The number of destinations your organization can have is unlimited.
To create an new Destination:
- Navigate to the destinations page
- Click "Add Destination" button
- Choose which destination type you'd like to create
- Give your destination a name, select which source you'd like to sync from, and complete any Configuration
- Click "Create Destination"
Viewing Destinations
To view destinations, visit your organization's destinations page.
Clicking on a destination will allow you to see recent syncs from that destination and it's settings.
Managing Destinations
To view your destination's settings, visit your organization's destinations page, click on the destination you want to manage, then click on the "Settings" tab.
Within settings, you'll see many options to manage and edit your destination.
- Status: allows you to enable or disable this destination. Disabled destinations will not sync transactions. Enabling a destination resumes it, and any transactions that occured in the last 60 days will sync.
- Name: allows editing the name of this destination.
- Source Account: displays the financial account connected to this destination. Source Accounts are not changeable. If you wish to change a source account, we recommend creating a new destination instead.
- Configuration: contains specific settings to the type of destination chosen.
- Filter Transactions: allows you to specify which transactions are synced to the destination. Transactions not matching the data will not be synced. Editing the filter later will not sync already-skipped transactions.
Filtering Transactions
Finicom allows filtering out specific transactions that you don't want synced to your destination, allowing for powerful conditional logic.
For example, if you want to be emailed only when a transactions is more than $1000, you could configure a filter on your email destination to only sync transactions when Amount > 1000
.
Deleted transactions cannot be filtered.
Archive Destinations
Archiving a destination will irreversibly archive it forever, hiding it from view and causing all syncing from it to stop. Archiving a destination does not effect it's source. Existing synced transactions will still be synced and still be counted in your dashboard.
To archive a destination, visit your organization's destinations page, click on the destination you want to archive, then press the archive button in top right corner.