Scopes
A scope is one permission a company grants your app. Request scopes space-separated in the scope parameter of the Connect URL (see Connect). The company's owner sees each scope in plain language on the consent screen before approving.
Read
| Scope | Grants |
|---|---|
org:read | Basic company information |
invoices:read | Read your invoices |
customers:read | Read your customers |
shifts:read | Read your employees' shift times and hours (personal data about your employees; no names or addresses) |
mileage:read | Read your employees' mileage distances and dates (personal data about your employees; no names or addresses) |
org:readBasic company information
invoices:readRead your invoices
customers:readRead your customers
shifts:readRead your employees' shift times and hours (personal data about your employees; no names or addresses)
mileage:readRead your employees' mileage distances and dates (personal data about your employees; no names or addresses)
Write
POST Partner apps only. Every write needs an Idempotency-Key; see Idempotency.
| Scope | Grants |
|---|---|
shifts:write | Create shifts and register hours for your employees (hours wait for your approval) |
mileage:write | Register mileage trips for your employees (they wait for your approval; nothing is booked) |
shifts:writeCreate shifts and register hours for your employees (hours wait for your approval)
mileage:writeRegister mileage trips for your employees (they wait for your approval; nothing is booked)
A write creates. Records your app creates are marked as created by your app in Sparro. Shifts, hours and mileage are personal data about the company's employees; the owner sees them named on the consent screen, and hours and mileage wait for the owner's approval.
Not offered
| Area | Status |
|---|---|
bank:read | Not offered in this version. |
| Bookkeeping | Never offered: ledger, VAT and receipts. |
| Payroll and CPR | Never offered. |
| Payments | Never offered: payouts and bank payments. |
| Filings | Never offered: VAT and annual-report submissions. |
bank:readNot offered in this version.
Bookkeeping
Never offered: ledger, VAT and receipts.
Payroll and CPR
Never offered.
Payments
Never offered: payouts and bank payments.
Filings
Never offered: VAT and annual-report submissions.