Skip to main content
Omnitracs Knowledge Base

Transfer Request



This is the actual "Unit Transfer" request type, which moves a unit between two NMC Accounts. As previously stated, the request is answered with an immediate acknowledgment rather than a final response once the unit has been moved. However, clients have the possibility to inquire the status of their requests via the Transfer Status Query.
 

Object Identifier  

The transfer operation is identified by the following OID in the procedure element:

  • urn:oid:1.3.6.1.4.1.1449.60.9.2.3000.1
     

Input Parameters  

Transfer requests contain the same attributes as introduced in the Generic Action Model section. The client is required to provide unique transaction ids for ActionCollection and Actions. The serial number of the unit to be transferred needs to be provided in the Entity element.

Additionally, transfer requests contain the following parameters in the Procedure element:

  • NMC_ACCOUNT: Mandatory, identifies the target NMC account that the unit should be moved into.
  • COMMENT: Optional, additional information regarding the transfer. This parameter will also be provided in the final response.
     

Sample Request (Single)  

<actionCollection xmlns="urn:oid:1.3.6.1.4.1.1449.5.1" version="1.0" source="QUALCOMM" co_id="1" trans_id="1">
    <action trans_id="1">
        <actionTime>
            <beginTime>2010-09-15T12:08:47.28125-08:00</beginTime>
        </actionTime>
        <entity>
            <oid>urn:oid:1.3.6.1.4.1.1449.60.9.1.3000.1</oid>
            <valueBinary name="SERIAL_NO">123456789</valueBinary>
        </entity>
        <procedure>
            <oid>urn:oid:1.3.6.1.4.1.1449.60.9.2.3000.1</oid>
            <valueBinary name="NMC_ACCOUNT">12345</valueBinary>
            <valueBinary name="COMMENT">TRANSFER REQUESTED BY JSMITH</valueBinary>
        </procedure>
    </action>
</actionCollection>


Sample Response (Single)  

<actionCollection xmlns="urn:oid:1.3.6.1.4.1.1449.5.1" version="1.0" source="QUALCOMM" co_id="1" trans_id="1">
    <action trans_id="1">
        <actionTime>
            <beginTime>2010-09-15T12:08:47.28125-08:00</beginTime>
        </actionTime>
        <entity>
            <oid>urn:oid:1.3.6.1.4.1.1449.60.9.1.3000.1</oid>
            <valueBinary name="SERIAL_NO">123456789</valueBinary>
        </entity>
        <procedure>
            <oid>urn:oid:1.3.6.1.4.1.1449.60.9.2.3000.1</oid>
            <valueBinary name="RESULT_STATUS">PENDING</valueBinary>
            <valueBinary name="RESULT_CODE">0</valueBinary>
            <valueBinary name="RESULT_DESC"/>
        </procedure>
    </action>
</actionCollection>


Sample Request (Multiple)  

<actionCollection xmlns="urn:oid:1.3.6.1.4.1.1449.5.1" version="1.0" source="QUALCOMM" co_id="1" trans_id="1">
    <action trans_id="1">
        <actionTime>
            <beginTime>2010-09-15T12:08:47.28125-08:00</beginTime>
        </actionTime>
        <entity>
            <oid>urn:oid:1.3.6.1.4.1.1449.60.9.1.3000.1</oid>
            <valueBinary name="SERIAL_NO">123456789</valueBinary>
        </entity>
        <procedure>
            <oid>urn:oid:1.3.6.1.4.1.1449.60.9.2.3000.1</oid>
            <valueBinary name="NMC_ACCOUNT">12345</valueBinary>
            <valueBinary name="COMMENT">TRANSFER REQUESTED BY JSMITH</valueBinary>
        </procedure>
    </action>
    <action trans_id="1">
        <actionTime>
            <beginTime>2010-09-15T12:08:47.28125-08:00</beginTime>
        </actionTime>
        <entity>
            <oid>urn:oid:1.3.6.1.4.1.1449.60.9.1.3000.1</oid>
            <valueBinary name="SERIAL_NO">123456790</valueBinary>
        </entity>
        <procedure>
            <oid>urn:oid:1.3.6.1.4.1.1449.60.9.2.3000.1</oid>
            <valueBinary name="NMC_ACCOUNT">12345</valueBinary>
            <valueBinary name="COMMENT">TRANSFER REQUESTED BY JSMITH</valueBinary>
        </procedure>
    </action>
    <action trans_id="3">
        <actionTime>
            <beginTime>2010-09-15T12:08:47.28125-08:00</beginTime>
        </actionTime>
        <entity>
            <oid>urn:oid:1.3.6.1.4.1.1449.60.9.1.3000.1</oid>
            <valueBinary name="SERIAL_NO">123456791</valueBinary>
        </entity>
        <procedure>
            <oid>urn:oid:1.3.6.1.4.1.1449.60.9.2.3000.1</oid>
            <valueBinary name="NMC_ACCOUNT">12345</valueBinary>
            <valueBinary name="COMMENT">TRANSFER REQUESTED BY JSMITH</valueBinary>
        </procedure>
    </action>
</actionCollection>


Sample Response (Multiple)  

 <actionCollection xmlns="urn:oid:1.3.6.1.4.1.1449.5.1" version="1.0" source="QUALCOMM" co_id="1" trans_id="1">
    <action trans_id="1">
        <actionTime>
            <beginTime>2010-09-15T12:08:47.28125-08:00</beginTime>
        </actionTime>
        <entity>
            <oid>urn:oid:1.3.6.1.4.1.1449.60.9.1.3000.1</oid>
            <valueBinary name="SERIAL_NO">123456789</valueBinary>
        </entity>
        <procedure>
            <oid>urn:oid:1.3.6.1.4.1.1449.60.9.2.3000.1</oid>
            <valueBinary name="RESULT_STATUS">PENDING</valueBinary>
            <valueBinary name="RESULT_CODE">0</valueBinary>
            <valueBinary name="RESULT_DESC"/>
        </procedure>
    </action>
    <action trans_id="2">
        <actionTime>
            <beginTime>2010-09-15T12:08:47.28125-08:00</beginTime>
        </actionTime>
        <entity>
            <oid>urn:oid:1.3.6.1.4.1.1449.60.9.1.3000.1</oid>
            <valueBinary name="SERIAL_NO">123456790</valueBinary>
        </entity>
        <procedure>
            <oid>urn:oid:1.3.6.1.4.1.1449.60.9.2.3000.1</oid>
            <valueBinary name="RESULT_STATUS">PENDING</valueBinary>
            <valueBinary name="RESULT_CODE">0</valueBinary>
            <valueBinary name="RESULT_DESC"/>
        </procedure>
    </action>
    <action trans_id="3">
        <actionTime>
            <beginTime>2010-09-15T12:08:47.28125-08:00</beginTime>
        </actionTime>
        <entity>
            <oid>urn:oid:1.3.6.1.4.1.1449.60.9.1.3000.1</oid>
            <valueBinary name="SERIAL_NO">123456791</valueBinary>
        </entity>
        <procedure>
            <oid>urn:oid:1.3.6.1.4.1.1449.60.9.2.3000.1</oid>
            <valueBinary name="RESULT_STATUS">PENDING</valueBinary>
            <valueBinary name="RESULT_CODE">0</valueBinary>
            <valueBinary name="RESULT_DESC"/>
        </procedure>
    </action>       
</actionCollection>
  • Was this article helpful?