All docs

Data Sources

Connecting DigitalOcean

Import your DigitalOcean invoices and credits into Financica automatically.

3 min read

If you host with DigitalOcean, Financica can pull your invoices in automatically and keep track of the credits that pay them. When you open an expense that looks like a DigitalOcean invoice, a banner offers to connect DigitalOcean.

How to connect

  1. Open an expense from DigitalOcean. A banner says the expense looks like a DigitalOcean invoice and offers Connect DigitalOcean, which opens the connection page.
  2. Click Connect DigitalOcean.
  3. You are redirected to DigitalOcean to authorize read-only access. Financica can never change anything in your DigitalOcean account.
  4. After authorizing, you are returned to the integration page, and the first sync starts.

Accounts that belong to a DigitalOcean Organization

DigitalOcean does not let apps read billing through the standard connection when your team belongs to an Organization: billing can only be read with an Organization-level token. If that applies to you, the integration page shows Billing access needs a token after the first sync. To finish connecting:

  1. In DigitalOcean, switch to your Organization workspace (top-right workspace switcher).
  2. Open API > Tokens and generate a new token with the billing:read scope.
  3. Paste it into Organization billing token on the integration page and click Save token.

Financica checks the token and starts importing. You can replace it later with Replace billing token.

What gets imported

  • Every invoice, in every format. Each DigitalOcean invoice is matched to its expense, or created as one, with the PDF, a CSV usage breakdown and a JSON summary attached. The expense has one line per product (Droplets, backups, and so on).
  • Automatic posting. New invoices are booked at their gross amount (what the usage cost) to a DigitalOcean hosting expense account.
  • Invoices paid with credits. The part of an invoice that DigitalOcean covered with account credit is settled from a DigitalOcean Credits asset account. Any remainder stays unpaid until you link the card or bank payment.
  • Your credit balance. The integration page shows your current DigitalOcean account balance, kept up to date on every sync, and the invoices imported with their gross amount, credits applied and net amount.

Recording credit grants

DigitalOcean does not report when credits are granted, so Financica cannot book the grant itself. When you receive promotional credit, record it once with a journal entry that debits DigitalOcean Credits and credits an income account of your choice (for example other operating income). From then on, each invoice paid with credit draws that asset down, and its balance shows how much credit you have left.

Good to know

  • Access is read-only and limited to billing data.
  • New invoices are picked up every hour; Sync now on the integration page fetches them right away.
  • When deleting the integration, you can tick Also delete all associated data to remove every imported invoice, its bookkeeping entries and the attached documents in one go.