Frequently Asked Questions

General Questions

How can I get all data from a service?

We generally encourage you to limit the amount of data fetched, but in the instances where you need to fully sync data you can use the ChangedAfter search parameter (or similarily named DateTime search parameter in a service) and set the date sufficiently back in time to ensure that you get all available data.

Is there any rate limiting on API calls?

The rate limit for API calls is 7200 requests per hour.

If you get this error:

SoapService.Library.SecondGen.LimitExceededException:
Limit exceeded by 1. Request is blocked. Quarantine ends at XXX-XX-XX
1
2

This means that you have exceeded the rate limit for that hour. Wait for the next hour to begin, then continue as normal with the requests.
If you need to incease your rate limit contact API support with your IP address.

I'm authenticated when requesting service X, but it fails when requesting service Y?

Our APIs are on two separate domains: api.24sevenoffice.com and webservices.24sevenoffice.com. Please make sure that your session cookie has been added to both domains. An snippet in C# that adds cookie to all 24sevenoffice.com subdomains:

	cookieContainer.Add(new Cookie("ASP.NET_SessionId", sessionId) { Domain = ".24sevenoffice.com" }
1

Do I need a new ApplicationId to gain access to client X?

No, ApplicationIds are used for identifying an integration and is not tied to any specific clients in 24SevenOffice.
Client access is managed through the credentials (email and password) that are used in the Login request.
In order to get access to a specific client, the customer needs to provide you with the proper credentials.

I'm getting different dates from the API than what I'm seeing on the web?

The API returns UTC DateTimes, you have to adjust these to the current timezone your integration is using.

How do I get a test client or increase demo client period?

Contact 24SevenOffice Support at: support@24sevenoffice.com

Availability

Information on planned downtime can be found on Twitter

InvoiceService

Questions

Can I download or upload attachments to outgoing invoices?

No, this is not available through the API. You can download PDFs of generated outgoing invoices, but any attachments for the outgoing invoice are not available. If you wish to upload images of invoice, receipts etc. used in bookkeeping, see our AttachmentService

Can't find the PaymentAmount field when I use GetInvoices?

This field is only used with the SaveInvoices method when registering invoices as paid when they are created.

Can I merge orders through the API?

Not directly, you have to delete the orders that you want to merge and then create a new order with the data from the orders you want to merge.

Is there a due date on the invoice?

To set a due date on an Invoice the property PaymentTime is used. If you set this as 14 it means 14 days from the invoice date. See the InvoiceOrder datatype for more details.

AccountService

Error message "Could not finish last Bundle! iError:2" in response from SaveBundleList

Please make sure that the accounting year has been defined in the client’s Accounting setup.
You can read more in our help article on accounting settings

Error message "Attachment is posted in the journal" in response from SaveBundleList

The StampNo that is used in your request has already been used and can't have any more entries added to it.

Error message "No next Entry Id found with the provided date and sort" in response from GetEntryId

This error could occur if there are no previous entries in the Entry Series you are requesting an Entry Id from.
It can also occur if you're using a non-existent Entry Series Id.