REST API to query RICS and return the corresponding DACS entitlement codes?

Rosalind

I am developing an in-house tool that allows market data admins and AD to query RICS and return the corresponding DACS PDP product codes (e.g. WWEIKON), exchange codes, specialist data codes and PE codes required for entitlement access. Is this possible via a REST API, e.g. TRTH?

veerapath.rungruengrayubkul

Hello @Rosalind,

You can retrieve the DACS Entitlement codes in the "PE Code" field of the TermsAndConditions Report Template.

POST https://hosted.datascopeapi.reuters.com/RestApi/v1/Extractions/ExtractWithNots
{
    "ExtractionRequest": {
        "@odata.type": "#ThomsonReuters.Dss.Api.Extractions.ExtractionRequests.TermsAndConditionsExtractionRequest",
        "ContentFieldNames": [
           "PE Code"
        ],
        "IdentifierList": {
            "@odata.type": "#ThomsonReuters.Dss.Api.Extractions.ExtractionRequests.InstrumentIdentifierList",
            "InstrumentIdentifiers": [
                {
                    "Identifier": "IBM.N",
                    "IdentifierType": "Ric"
                }
            ]
        }
    }
}

Response

{
    "@odata.context": "https://hosted.datascopeapi.reuters.com/RestApi/v1/$metadata#ThomsonReuters.Dss.Api.Extractions.ExtractionRequests.ExtractionResult",
    "Contents": [
        {
            "IdentifierType": "Ric",
            "Identifier": "IBM.N",
            "PE Code": "62"
        }

Rosalind

Hi Veerapath. Thanks for your answer. What about the PDP codes necessary to permission the PE Code? e.g. a PE Code alone is not sufficient for the DAC Administrator - they must know the relevant PDP code(s) to apply

veerapath.rungruengrayubkul

Hi @Rosalind,

To get PDP, you may need to use DACS. DACS administrator can use "Item Requirement" tool in DACS UI to get PDP codes required for an item. DACS also provide Web Services (SOAP) having the same functionality. You can use the DACS Web Services to directly get PDPs from an item name.

Please refer to the DACS Web Services Programmer's Guide for more information. For further questions about DACS Web Services, please contact DACS support team via MyRefinitiv.

Below is the sample of SOAP request.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/&quot; xmlns:dac="http://dacsWebService.rfa.reuters.com/"&gt;
   <soapenv:Header/>
   <soapenv:Body>
      <dac:getItemRequirement>
         <!--Optional:-->
         <loginAttribute>
            <!--Optional:-->
            <aAdministratorName>
               <!--Optional:-->
               <mAdministratorName>*admin username*</mAdministratorName>
            </aAdministratorName>
            <!--Optional:-->
            <aAdministratorPassword>
               <!--Optional:-->
               <mAdministratorPassword>*admin password*</mAdministratorPassword>
            </aAdministratorPassword>
         </loginAttribute>
         <!--Optional:-->
         <siteName>
            <!--Optional:-->
            <mSiteName>DACS</mSiteName>
         </siteName>
         <!--Optional:-->
         <service>
            <!--Optional:-->
            <mName>IDN</mName>
         </service>
         <!--Optional:-->
         <concreteService>
            <!--Optional:-->
            <mName>*vendor service*</mName>
         </concreteService>
         <!--Optional:-->
         <item>
            <!--Optional:-->
            <mName>IBM.N</mName>
         </item>
         <!--Optional:-->
         <clientConnection>
            <!--Optional:-->
            <mClientConnection></mClientConnection>
         </clientConnection>
         <limitToSubscribed>F</limitToSubscribed>
      </dac:getItemRequirement>
   </soapenv:Body>
</soapenv:Envelope>

Response:

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/"&gt;
   <S:Body>
      <ns2:getItemRequirementResponse xmlns:ns2="http://dacsWebService.rfa.reuters.com/"&gt;
         <return>
            <aResult>
               <mResultText>SUCCESS</mResultText>
               <mResultCode>0</mResultCode>
               <mErrorText>Operation Success</mErrorText>
            </aResult>
            <products>
               <Subservice>WWBASEPRO</Subservice>
               <Description>Base Professional</Description>
            </products>
            <products>
               <Subservice>WWBASEREDIST</Subservice>
               <Description>Base Redistribution</Description>
            </products>
            <products>
               <Subservice>WWDNASFIN</Subservice>
               <Description>NA Securities (Fin.com)</Description>
            </products>
            <products>
               <Subservice>WWDSBOSP</Subservice>
               <Description>DS Realtime Back Office App Server Perm</Description>
            </products>