Sage API Error Codes

The Accounting API from Sage is a RESTful application programming interface (API) that has been designed to expose the data and functionality driving the Sage Business Cloud products of Accounting and Start. The included products allow small to medium-sized businesses to control their financial inputs and outputs either through a web browser, or a mobile app. There are also trial versions of the products that provide access to evaluate the processing and reporting functionality the products offer.

What is an API?

API is an abbreviation for Application Programming Interface. It refers to a collection of standards and programming instructions that allow access to web-based software and enables different platforms to interact with one another. The API interface allows software applications to interact effectively without the need for human intervention.

Useful Terms

• Accounting: This is the Sage product that offers financial control for small to medium-sized businesses. 
• Accounting API: This is the published API for access to the business data behind Start and Accounting.
• API: This is used generically to refer to the Accounting API
• Business or Resource Owner: These are the individuals who pay for product subscriptions and have complete reading and writing access to Start and Accounting.
• Client: This is the 3rd party application that wishes to integrate or intends to integrate with Sage Business Cloud Accounting. 
• Contact: This is an individual or organization that has a business deal with the concerned company. 
• Customer: These are the individuals or organizations that a business charges for products or services concerned. 
• Sage Business Cloud: This is the platform for all Sage Cloud products to operate upon. 
• Start: A standalone product offered by Sage which is a subset of the Accounting product. It offers a reduced subscription. Take note that the API documentation will refer to Accounting which also involves the Start product. Differences will be called out in the detail of the documentation.
• Supplier: individual or organization that a business pays for products or services
• Users: individuals that have access to Start and Accounting

Read More-: Sage 50 Network Error

The Accounting API

The Accounting API provides the opportunity to construct rich and robust integrations through common Restful principles and CRUD-based HTTP requests. Apps and integrations utilize the Create, Read, Update, and Delete options of the API to enhance and extend product functionality and processing capability. Apps and integrations can also accept data, control the products, and simplify the administration that businesses deal with daily. For instance, the user can gain access to transaction details that include attachments, create detailed quotes and invoices, and add products, customers, and suppliers.

API endpoints are segmented into logical groups so you can dive into the portion you need,

• Chart of Accounts: Manage ledger accounts
• Contacts: Contacts, addresses and contact types
• Products & Services: Products, services, stock items, stock movement, and price type
• Transactions: Journals, ledger entries and transactions
• Sales Transactions: Quotes, estimates, invoices, credit notes, corrective invoices and quick entries
• Purchase Transactions: Invoices, credit notes, corrective invoices, and quick entries
• Banking: Bank accounts, bank deposits, bank reconciliation and bank transfers
• Payments & Receipts: Payments, receipts and allocations
• Settings: Business settings, financial settings, and invoice settings
• Status Codes & Types: Invoice, credit note, corrective invoice, and quick entry statuses
• Attachments: Manage attachments to transactions
• Currencies: Currencies and exchange rates
• Taxes: Tax rates, tax schemes, and tax return frequencies
• Opening Balances: Contact opening balances, bank opening balances, and ledger opening balances
• User Accounts: Users and businesses

Products & Versions

Both Sage Business Cloud products of Accounting and Start are accessible via the Accounting API in both trial and subscribed versions. Accounting offers more functionality than Start with the only subtle differences to the API being the allocation of Invoice Payments and the differences in core functionality.

The success and development of Sage Business Cloud Accounting has observed various evolutions of the product and API. The below table provides a guide to those products along with compatible versions of the APIs.

Authentication

The Accounting API needs every API request to offer the details of the valid access token. Using the OAuth 2.0 standard of authentication, the access token can be acquired by authenticating applications with valid business users. The three-legged OAuth process needs business-user interaction to ensure that the client has access to the business data without sharing the credentials.

API V3.1 Limitations

To make sure that the availability and integrity of the Accounting API at all times, where a request rate limit has been set. The rate limit has been set against a client application with the following limitations:

• Rate limit of 1,296,000 requests per app per day
• Maximum of 150 concurrent requests at any time (per app)

In the case when the rate limit is exceeded, the Accounting API will return an HTTP 429 error response. It is recommended that you wait and repeat the functionality to be implemented in your app to handle any 429 response.

What are Different API Error Codes?

A) API Error Codes related to Data Integration

B) API Error Codes related to Authorization

Read Also-: Sage Exchange Error Codes

Final Words

We hope that the discussion above has given you a good understanding of the various types of Sage API Error Codes. If you have any questions about them, we recommend that you consult with some knowledgeable Sage professionals.

Frequently Asked Questions(FAQs)