Skip to main content

Integrations Permissions and Troubleshooting

Missing menus or failed syncs are usually the plan, connector assignment or permissions. Your company admin manages roles under Management → Users.

Permissions, in plain language​

To do thisYou need
See the hub, settings and mappingsView Integrations
Save credentials, connect or disconnectManage Integration Settings
Save or apply field mappingsManage Integration Mappings
Read the Execution logView Integration Logs
Toast screens and reportsView Toast Integration
Toast connection and summary emailManage Toast Settings
Toast product and location mappingsManage Toast Mappings
Toast sync, imports, comparison, cutoverRun Toast Sync
Toast Sync logsView Toast Logs

The Integrations Manager role grants the four hub permissions without broader company-settings access.

Hub troubleshooting​

SymptomCause and fix
No Integrations or Integration hub menuNot on your plan, or you lack the permissions. Ask your administrator
A connector card shows "not found"The connector is not assigned to your company
A hub run shows FailedRead the message in the Execution log, then check credentials, field mappings and the external system's status
QuickBooks or Xero says reconnectThe authorization was revoked or expired. Click Reconnect
Xero connected but nothing syncsNo organisation is selected. Use Change organisation
Invoices land in the wrong accountOpen Account mapping, click Suggest matches, then clear the remainder
Xero refuses a paymentMap your cash or bank ledger account
A record stopped syncingIt changed on both sides. Open Conflicts, choose the winner and mark it resolved
Shopify orders do not arriveCheck the webhook is registered for orders/create, the write-back target is Import as sale, and a default warehouse is set
Webhook sent but nothing changedThe target may be Log only. Check the Execution log

Toast troubleshooting​

SymptomCause and fix
No Toast Integration menuThe Toast module is separate from the hub. Ask your administrator to enable it and assign permissions
Nothing has syncedSync mode must not be Off. Click Test connection, then read Sync logs. If still silent, ask whether the Toast sync job is paused
Test connection failsCheck the client ID and secret, restaurant GUID and Toast API access
An item did not come off stockIt is not matched yet. Check Product mappings
A sale failed with "no stock"Count the item or set it to Flexible, then re-post failed lines
Sales on the wrong day, or times hours offCheck the closeout hour and that the Company Profile time zone matches the restaurant
No waste figuresWaste tracking is off in Toast, or waste appears a day late
A sale was voided after its day went throughUse Correct a day for that date
A file upload went in twiceImport History → Reverse (uploaded files only)
An upload is rejectedThe file is over the size limit. Split it
Failure emails arriveThe sync failed several times in a row. Click Test connection; the emails stop once a sync succeeds

Limitations​

  • Toast: Biznsbook reads from Toast only. Sync is a two-hour poll with no real-time webhook, comparison works only for items with quantity tracking, and deliveries are not read from Toast.
  • QuickBooks and Xero two-way sync is Beta.
  • HubSpot, Salesforce and Square use a pasted access token, not an OAuth button.