Mapping
The mapping tools mirror the Mapping page in Fyvel. They read imported bookings, show AI suggestions, and set or remove categories.Available tools
list_mapping_transactionsretrain_ai_mapping_suggestionsaccept_ai_mapping_suggestionsset_booking_categories(assign withcategoryUuid, or clear assignments whencategoryUuidis null)set_booking_ignore(ignored: trueonly whenmappingIgnoreEnabledfromlist_companiesis true;ignored: falseclears ignore and any category)
Scope
Mapping is company-specific. You need acompanyUuid.
What list_mapping_transactions can do
list_mapping_transactions is paginated and supports the main filters from the web app:
- search
- tracked or excluded accounts
- mapped or unmapped bookings (
mapped:unmapped,mapped,both—mappedincludes ignored bookings) - filter by categories, optionally including ignored bookings (
includeIgnored) - bookings with AI suggestions
- minimum confidence for suggestions
- sort
Typical use cases
list_mapping_transactions- choose a matching category — or
set_booking_ignorewithignored: true, when the booking should deliberately stay without a category andmappingIgnoreEnabledis true for the company set_booking_categories(withcategoryUuid; to clear, setcategoryUuidto null)- optionally retrain AI suggestions or accept them in bulk
set_booking_ignore with ignored: false puts them back in the queue, also clears any category, and works regardless of the flag. ignored: true fails when ignore is disabled for the company. Suggestions return after the next retrain.
Notes
- The tools change Fyvel mappings, not the original upload files
- AI suggestions can be accepted explicitly or retrained
- Categories come from
list_categories