Custom services for Microsoft Dynamics 365 for Finance and Operations

You can develop custom services for Microsoft Dynamics 365 for Finance and Operations, Enterprise edition. When a developer writes a custom service under a service group, the service group is always deployed on two endpoints:

  • SOAP endpoint
  • JSON endpoint

SOAP-based custom service

SOAP-based services remain the same as they were in AX 2012.

Code examples for consuming custom services using SOAP are available in the Microsoft Dynamics AX Integration GitHub repository.

Key changes

  • All the service groups under the AOTService group node are automatically deployed.
  • All services that must be deployed must be part of a service group.

The SOAP endpoint is at https://host_uri/soap/services/service_group_name.

Example: https://usnconeboxax1aos.cloud.onebox.dynamics.com/soap/services/UserSessionService?wsdl

For more information, see:

JSON-based Custom Service

This feature enables X++ classes to be consumed as JSON services. In other words, the return data set is in JSON format. JSON, which stands for JavaScript Object Notation, is a compact, lightweight format that is commonly used communicate data between the client and the server.

The JSON Endpoint is at https://host_uri/api/services/service_group_name/service_group_service_name/operation_name.

Example: https://usnconeboxax1aos.cloud.onebox.dynamics.com/en/api/services/UserSessionService/AifUserSessionService/GetUserSessionInfo

Code examples for consuming JSON services are available in the Microsoft Dynamics AX Integration GitHub repository.