FireFly III icon

FireFly III

Read, update, write and delete data using the powerful FireFly III API

Actions89

Bills API → Update Bill

AI-generated

Overview

This node operation updates an existing bill in the FireFly III system using the Bills API. It allows users to modify various attributes of a bill such as its active status, currency, date, amount limits, name, notes, object group details, repeat frequency, and skip periods. This operation is useful for managing and maintaining accurate billing information within financial workflows, ensuring bills reflect current data and conditions.

Use Case Examples

  1. Updating the maximum and minimum expected amounts of a bill to reflect new budget constraints.
  2. Changing the repeat frequency of a bill from monthly to quarterly to match payment schedules.
  3. Adding notes or changing the name of a bill for better identification and record-keeping.

Properties

Name Meaning
X-Trace-ID A unique UUID identifier for the request, used for debugging and tracing.
Bill ID The ID of the bill to be updated.
Update Fields Collection of fields to update on the bill, including active status, currency code and ID, expected date, maximum and minimum amounts, name, notes, object group ID and title, repeat frequency, and skip periods.

Output

JSON

  • json - The updated bill object returned from the FireFly III API after the update operation.

Dependencies

  • FireFly III API with OAuth2 authentication

Troubleshooting

  • Ensure the Bill ID provided is valid and exists in the FireFly III system to avoid 'not found' errors.
  • Verify that the update fields are correctly formatted, especially date fields in YYYY-MM-DD format and numeric fields as strings where required.
  • Check API authentication credentials to ensure the request is authorized.
  • Use the X-Trace-ID for debugging and tracing requests if the API returns errors or unexpected results.

Links

Discussion