Skip to main content
Version: 2.2.3

changeOrganizationalUnitStatus

This method allows enabling or disabling an organizational unit or department. For this operation, it is necessary to follow the standard documented below.

Java class
Requestweb\wwwroot\ws\java\administration\ChangeOrganizationalUnitStatusRequestType.java
Returnweb\wwwroot\ws\java\administration\ChangeOrganizationalUnitStatusResponseType.java

Request:

ID #RequiredDescription
IDXOrganizational unit or department ID #.
fgdeptenabledOperation code (1 - Enable, 2 - Disable).
If no value is entered, the record status will be edited regardless of the current status.

Request structure:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:admin">
<soapenv:Header/>
<soapenv:Body>
<urn:changeOrganizationalUnitStatus>
<!--You may enter the following 2 items in any order-->
<urn:ID>?</urn:ID>
<urn:fgdeptenabled>?</urn:fgdeptenabled>
</urn:changeOrganizationalUnitStatus>
</soapenv:Body>
</soapenv:Envelope>

Return:

ID #Description
StatusSUCCESS: SUCCESS
FAILURE: FAILURE
DetailSUCCESS: Action successfully executed
FAILURE: Message regarding the error that occurred
CodeSUCCESS: 1.
FAILURE: Code regarding the error that occurred
CodeDescription
43The ID # has no value
52Inexistent organizational unit/department
74The record already is in the entered status
0The fgdeptenabled field accepts only the (1,2) values
It is not possible to disable the record as there are users related to the department
There should be a whole numeric value in the fgdeptenabled field