> For the complete documentation index, see [llms.txt](https://apidocs.juicefin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidocs.juicefin.com/apis/administration/manage-terminal.md).

# Manage Terminal

## Manage Terminal

The Manage Terminal API allows a given organization to create or update its own terminal, and its sub-organizations terminals.

## Input Parameters:

| Name             | Required | Definition                                                                                   | Comments |
| ---------------- | -------- | -------------------------------------------------------------------------------------------- | -------- |
| OperationType    | Y        | <p>Format options:<br>Create<br>Update</p>                                                   |          |
| RoleId           | Y        | <p>Format options:<br>Manager<br>Accounting<br>Inventory<br>Full<br>Issuing<br>Reporting</p> |          |
| Status           | C        | Format: ACTIVE (default) ALL                                                                 |          |
| TargetOrgName    | Y        | Format: Alphanumeric, 6-30                                                                   |          |
| TargetStoreId    | Y        | Format: Alphanumeric, 1-20                                                                   |          |
| TargetTerminalId | Y        | Format: Alphanumeric, 1-10                                                                   |          |

## Output Parameters:

## XML Samples

### Input XML

```json
<?xml version="1.0" ?>
  <PraxellXMLRequest>
     <AuthenticationDetails>
        <UserName>test_sad</UserName>
        <UserPassword>test_sad</UserPassword>
      <ClientSourceIP></ClientSourceIP> 
 </AuthenticationDetails>;
    <ServiceDetails>
       <ServiceName>ManageTerminal</ServiceName>
      <UniqueRequestId>1212121212121213</UniqueRequestId>
   </ServiceDetails>
   <Origin>
     <OriginType>ExtAPI</OriginType>
   </Origin>
   <ServiceParams>    
      <OperationType>Create</OperationType>
      <TargetOrgName>Store</TargetOrgName>
      <RoleId>TERM</RoleId>
      <TargetStoreId>2</TargetStoreId>
      <TargetTerminalId>7</TargetTerminalId>
  </ServiceParams>
 </PraxellXMLRequest>
```

```json
<?xml version="1.0"?>
  <PraxellXMLResponse>
    <ResponseDetails>
        <ServiceName>ManageTerminal</ServiceName>
        <SessionId>05200637022706028152</SessionId>
        <StatusCode>0</StatusCode>
        <StatusName>StatusOK</StatusName>
        <StatusDescription>NA</StatusDescription>
        <ServiceDate>2007-07-12 06:55:13</ServiceDate>
        <ServiceId>99998888777766111</ServiceId>
    </ResponseDetails>
    <ResponseParams>
    </ResponseParams>
  </PraxellXMLResponse>
```

```json
<?xml version="1.0"?>
<PraxellXMLResponse>
  <ResponseDetails>
    <ServiceName>ManageTerminal</ServiceName>
    <SessionId>07071612200737105</SessionId>
    <StatusCode>70012</StatusCode>
    <StatusName>ServiceNotAllowed</StatusName>
    <StatusDescription>ServiceNotAllowed</StatusDescription>
    <ServiceDate>2021-10-01 12:37:50</ServiceDate>
    <ServiceId>07071612200737105</ServiceId>
  </ResponseDetails>
  <ResponseParams>
  </ResponseParams>
</PraxellXMLResponse>
```