Define a Business Area using an API

A business area can be defined in M3 using 'Business Area. Open' (CRS036). This can either be a geographical area or a line of business. The business area is a tool used to group information for budgeting and statistical purposes.

In the next sections, details on how to add and update a business area using API transactions in CRS036MI will be discussed.

Limitation

The API transactions for CRS036MI are only valid for the company where it is run. If we use CRS036MI, transaction AddBusinessArea for Company 123 for example, it will only be added to Company 123.

Add a business area

Use the API transaction AddBusinessArea in CRS036MI when adding a business area. To do this, specify values in these fields:
  • Business Area (BUAR): Unique ID for the business area
  • Description (TX40): Short description of the business area that you want to add
  • Name (TX15): Name for the business area

It is required to specify a value for the 'Description' field and optionally, the 'Name' field. If the 'Name' field is left blank, the value is automatically set to the same value as the 'Description' field (first 15 characters).

Also, duplicate business area records are not allowed, which means that you cannot have two business areas with the same business area ID (BUAR).

Update a business area

Use the API transaction UpdBusinessArea in CRS036MI to change or update an existing business area record. To do this, specify values in these fields:
  • Business Area (BUAR): Unique ID of the business area that you want to update
  • Description (TX40): New description for the business area
  • Name (TX15): New name for the business area

If the 'Description' or 'Name' fields are left blank, no changes should be made on the existing field values.

Add a language for business area text

Language handling is supported for a business area in M3. One business area record can have multiple language records, but only the languages defined in 'Language. Open' (CRS010) can be used.

To add a language text for a business area, run the API transaction AddLngTxt in CRS036MI and specify values in these fields:
  • Business Area (BUAR): Unique ID of the business area where you want to add a language text
  • Language (LNCD): The language ID for the language text
  • Description (TX40): Description of the language text
  • Name (TX15): Name of the language text

If the 'Name' field is left blank, the value is automatically set to the same value as the 'Description' field (first 15 characters).

Duplicate language records are also not allowed.

Related topics