​

Manual entries

These tools work with manual entries in Fyvel. They read and change bookings you maintain manually, not the originally imported accounting files.

​

Available tools

• list_manual_uploads — available areas for manual entries of a company
• create_manual_upload — create a new area for manual entries (matches “New group” on the Manual entries page)
• list_manual_transactions — bookings in an area (uploadUuid)
• append_manual_transactions — add new bookings
• patch_manual_transactions — change existing bookings
• remove_manual_transactions — remove bookings

​

Areas (uploads)

Manual entries are grouped in areas — the same groups as in the web app under Manual entries (for example one area per month or topic). Each area has an uploadUuid. With create_manual_upload you create an empty area. With list_manual_uploads you list existing areas.

​

Scope

Manual entries are company-specific. Always pass a companyUuid from list_companies. For every call except list_manual_uploads and create_manual_upload you also need an uploadUuid from list_manual_uploads or from the response of create_manual_upload.

​

Important notes

• Write tools change only the manual booking layer in Fyvel.
• When you change data, send only the rows you want to add, change, or remove.
• Each new row in append_manual_transactions must have exactly one of amountDebit or amountCredit greater than zero.
• The organisation comes from the MCP bearer token.

​

Typical flow

New area with bookings:

1. list_companies
2. create_manual_upload with companyUuid and name → uploadUuid from the response
3. append_manual_transactions with companyUuid, uploadUuid, and the new rows

Existing area:

1. list_companies
2. list_manual_uploads with companyUuid
3. choose the uploadUuid you want
4. list_manual_transactions to read, or a mutation (append_*, patch_*, remove_*)