Domain API

Introduction

The Domain API is the primary API for accessing and manipulating data in ERP.net. It is most useful for UI and service apps. For BI, you should use the Table API.

For an overview and introduction of the Domain API, read the thorough presentation at the home page of the developer docs.

Based on OData

The Domain API is based on the OData protocol. It allows object-oriented access to the data exposed by the ERP.net domain objects.

The OData API is structured along a number of entity types (called "repositories" in ERP.net), that represent the Domain Model of the ERP Instance. Each entity type contains data attributes, which can be filtered, sorted, etc. The model also provides information on how to navigate between the repositories.

For a quick introduction to OData, check the beginners tutorial at the OData site:

https://www.odata.org/getting-started/understand-odata-in-6-steps/

Next steps

To learn more about the ERP.net Domain API, read below:

1. Querying data - Introduction to data querying.
2. Data manipulation - Introduction to data manipulation.
3. Common tasks - Useful examples.
4. Working with documents - working with documents is a common scenario when using the API.
5. Batch requests (OData site) - ERP.net fully supports batch requests, saving round-trips to the server.