Cloud accounting and selective sync
List accounting provider capabilities
/a/Accounting_providerCapabilities
Read the facade’s fixed provider/action catalogue before building an integration selector.
When to use this endpoint
Use this catalogue to choose supported provider IDs. Use Accounting_status separately to establish whether the tenant is connected.
Authentication and permissions
Use signed API-key authentication or a logged-in CRM session on the account’s routed host. API keys act as their owner; session requests require the dispatcher’s CSRF token where configured. Tenant rows and settings belong to that authenticated account.
These handlers add no accounting page or CRM2 role check. The dispatcher has no Accounting/DataSync object-scope mapping. Settings-screen access controls are separate from these shared API handlers; CRM2 screen roles are not a CRM1 API requirement.
Parameters
This endpoint has no operation-specific parameters.
Example request
$result = FM_api('Accounting_providerCapabilities', []);
Example response
{
"ok": 1,
"providers": [
{
"provider": "quickbooks",
"label": "QuickBooks Online",
"actions": [
"authorisation",
"status",
"progress",
"sync",
"logsList",
"logLoad",
"disconnect"
],
"public_authorisation": false,
"configuration": [
"preflight"
]
},
{
"provider": "xero",
"label": "Xero",
"actions": [
"authorisation",
"status",
"progress",
"sync",
"logsList",
"logLoad",
"disconnect"
],
"public_authorisation": true,
"configuration": [
"account_mapping"
]
},
{
"provider": "microsoftbusinesscentral",
"label": "Microsoft Business Central",
"actions": [
"authorisation",
"status",
"progress",
"sync",
"logsList",
"logLoad",
"disconnect"
],
"public_authorisation": false,
"configuration": [
"company_selection",
"settings"
]
}
]
}
Database numeric values can be strings. Read the JSON error/warning fields as well as the HTTP status.
Errors and unusual responses
| Response | Condition |
|---|---|
{"error":"not logged in"} | No authenticated tenant context is available. Invalid signed credentials can be rejected by the dispatcher before the handler runs. |
Legacy application errors may be returned with HTTP 200. Check the decoded response for error, not only the HTTP status.
Behaviour and edge cases
- Returns all three providers in declaration order, with no tenant feature filtering, search or pagination.
- public_authorisation applies only to starting OAuth; it does not waive authentication for the other actions.
- configuration contains setup capability labels, not configured values or URLs. The catalogue excludes local DataSync even though the policy endpoints also accept provider=datasync.
Side effects
- No provider connection, token refresh or database write is performed by this catalogue helper.
See it in Fieldmotion
CRM1
Source search found no direct CRM1 caller for the catalogue. Finance screens select a known provider and call its facade actions.
CRM2
Source search found no direct CRM2 caller for the catalogue. Finance screens and widgets select their provider explicitly.
Related endpoints
Accounting_authorisation— Start or renew provider consent.Accounting_status— Check connection state.Accounting_syncPolicyGet— Read phase modes and supported keys.