Web Services: Enhanced Capabilities with the New Endpoint Version

MYOB Acumatica 2025.2.1 introduces the Default/25.200.001 system endpoint, which you can review on the Web Service Endpoints (SM207060) form. This new endpoint version provides several enhancements. For example, you can easily get details about a released retainage document. You can also be sure that locale information is available for any type of business account, as described later in this topic.

Learn more about these enhancements below.

An Employee's Workgroup Information

Now you can use the REST API to work with employee workgroup information. You use the new Employee.CompanyTreeInfo property to obtain the list of workgroups the employee belongs to and this key data for each workgroup:

  • CompanyTree.WorkgroupID: The workgroup (on the company tree) this employee is a member of
  • CompanyTree.Owner: The default owner of the workgroup
  • CompanyTree.Active: An indicator of whether this employee is an active member of the workgroup

You can also use the API to add the employee to one or more workgroups.

Time Zone in the Time Activity

Now you can specify the time zone when you enter a time activity through the REST API. See the following example.

PUT /entity/Default/25.200.001/TimeEntry HTTP/1.1
Host: <MYOB Acumatica host>
Accept: application/json
Content-Type: application/json

{
  "Summary" : {"value" : "Time entry summary"},
  "Date" : {"value" : "2024-10-24T10:05:00.000" },
  "Employee" : {"value" : "EP00000026" },
  "ProjectID" : {"value" : "TOMYUM1" },
  "ProjectTaskID" : {"value" : "PHASE1" },
  "CostCode" : {"value" : "00-000" },
  "EarningType" : {"value" : "RG" },
  "TimeSpent" : {"value" : "01:30" },
  "BillableTime" : {"value" : "00:30" },
  "TimeZone" : {"value" : "(GMT+10:00) Canberra, Melbourne, Sydney"}
}

The TimeZone field defines the time zone in which the Date is specified.

Address Details

Because address formats vary across different countries, it is essential for cross-border financial transactions to adhere to the ISO 20022 address standard. As a part of adopting this standard for addresses, the new endpoint introduces the following fields in all entities that contain address information:
  • Department
  • SubDepartment
  • StreetName
  • BuildingNumber
  • BuildingName
  • Floor
  • UnitNumber
  • PostBox
  • Room
  • TownLocationName
  • DistrictName

Retainage Documents for a Bill

In some industries, such as construction, it’s common to withhold part of the contract amount until the project has been completed to ensure that the vendor will satisfy its obligations. By using the REST API, you can process bills and debit adjustments with retained amounts—including creating retainage documents (that is, releasing retainage) on the Bills and Adjustments (AP301000) form.

With the new endpoint, the Bill.RetainageDocuments detail entity gives you direct access to information about a bill’s retainage documents.

Locale Information of Business Accounts

To make locale information available for all types of business accounts, we’ve replaced the BusinessAccount.MainContact.LanguageOrLocale field with BusinessAccount.LocaleName.

Learn More

For the full list of changes between the Default/25.200.001 and Default/24.200.001 endpoints, see Comparison of System Endpoints.