Overview API resources | Sage Developer

BETA

This file documents the Sage Active Public API V0 objects :

Business description of the resource
resource fields,
list of authorized enumerations for fields with enumeration,
relationship with other resources,
mutations and queries,
constraints for deletion,
additional information on the use of certain fields.

Attention
In the context of V0 of the Sage Active Public API V0, only the Sage Active Stage environment allows the use of the Sage Active Public API V0.

Infos

To see samples of queries and mutations,
download the Postman collection: Quick start / 5. Test your first query in Postman
Except userProfile, it is necessary to mention in the header the Tenant Id
Except userProfile, User, Countries, ZipCodes, DocumentTypes, Organizations, it is necessary to mention in the header the organization Id
The current url of Sage Active Public API V0 for Sage Active stage is:
The current Auth url of Sage Active Public API V0 for Sage Active stage is:
The current access token url of Sage Active Public API V0 for Sage Active stage is:

Hot Chocolate

The Sage Active Public API V0 is a GraphQL API and is developed using Hot Chocolate.

Hot Chocolate is a GraphQL server for .NET that helps you create and deploy GraphQL APIs for your applications. It provides a variety of features to ease the creation of GraphQL schemas, manage requests and responses, and secure data. Hot Chocolate is an open-source library and can be used with a wide range of .NET frameworks for web development.

Hot Chocolate filter types

With Hot Chocolate filters, you can expose complex filter objects through your GraphQL API that translates to native database queries.

In the Postman collection: Quick start / 5. Test your first query in Postman, you will find examples of queries using all allowed filter operators.

Also, see in this documentation the guide dedicated to GraphQL Hot Chocolate concepts for Sage Active Public API V0 :
GraphQL Hot Chocolate concepts

Property Documentation Information

Mandatory property values

Properties whose value is mandatory when creating the resource are marked with an asterisk.
The enumerations, identified by bullets, are also fields whose value is mandatory but they are not identified by an asterisk since it will be necessary to choose one of the values of the enumeration.

Examples: socialName is mandatory and identifiable by an asterisk, status is implicitly mandatory because its value can only be NONE, DISABLED, ENABLED, GDPR_APPLIED, and does not need to be identified by a asterisk.

Fields	Type	Description	Length
socialName *The value of the field or object is mandatory	string	Name	70
status	NONE DISABLED ENABLED GDPR_APPLIED	Status

Unmodifiable system fields

Some fields cannot be assigned in creation or modification. They correspond to system information automatically assigned by the application and are identifiable by the letter S in red.
Example: id is non-modifiable system property.

Fields	Type	Description
idSSystem field that cannot be assigned	string	Id

Read-only fields

Some fields are read-only
They are identified by the letter R in red.
Example : countryName is a read-only field.

Fields	Type	Description
countryNameRThis field is read-only, its value cannot be assigned	string	country Name

Properties cannot be modified after creation

Some fields can be assigned during creation but can no longer be modified.
They are identified by the letter N in red.
Example: code is a property that can be assigned during creation but can no longer be modified afterwards.

Fields	Type	Description
codeNThe value of this field cannot be modified after the record is created	string	Account code

Not visible in the product interface

Some fields technically exist but are not visible from the product interface.
They are identified by the abbreviation Inv in red.
Example: code is a property that can be assigned during creation but can no longer be modified afterwards.

Fields	Type	Description
codeInvThis field is not visible in the product interface	string	Account code

Default value

Some fields can be automatically assigned a default value if they are not filled in.
They are identified by the letter D in red.
Example: code is a property that can be assigned during creation but can no longer be modified afterwards.

Fields	Type	Description
codeDIn creation, this field can have a default value automatically calculated	string	Account code

Field soon to be depreciated

A field may be deprecated in the near future and replaced by another, so it is recommended to anticipate when the depreciation will be active and to update the code accordingly. These fields are identified by the abbreviation SDepr in red.
Example: allowBlankOrDuplicatedIdentificationNumbersSDepr will soon be depreciated.

Fields	Type	Description
allowBlankOrDuplicatedIdentificationNumbersSDepr SDeprThis field will soon be deprecated, so please prepare for upcoming changes	boolean	always true

Depreciated field

A field can be deprecated and replaced by another, so it is imperative to update the code accordingly. These fields are identified by the abbreviation Depr in red.
Example: allowBlankOrDuplicatedIdentificationNumbers is deprecated and replaced by allowBlankIdentificationNumbers

Fields	Type	Description
allowBlankOrDuplicatedIdentificationNumbersSDepr DeprThis field is now deprecated, and we recommend using an alternative solution	boolean	always true