AIM Web Services

<back to all web services

C2BGetInstrumentDetailRequest

C2BGetInstrumentDetail
Requires active-e Contracts Service.

The following routes are available for this service:
POST, GET/api/C2BGetInstrumentDetail
C2BGetInstrumentDetailRequest Parameters:
NameParameterData TypeRequiredDescription
RsiPkqueryintegerNoID of the Teacher/Instrument record. Either this *or* TeacherId + InstrumentId must be sent.
TeacherIdqueryintegerNoID of the Teacher record. Either this+InstrumentID *or* RsiPk must be sent.
InstrumentIdqueryintegerNoID of the Instrument record. Either this+TeacherID *or* RsiPk must be sent.
RateIdqueryintegerYesID of the Rate to be used. This is required.
IncludeMobileLayoutquerystringNoIf 'Y', then Mobile Layout will be returned.
DeliveryIdqueryintegerYesID of the Delivery option to be used.
LocationIdqueryintegerYesID of the Location. Used for Location required Delivery options.
BaseSecureRequest Parameters:
NameParameterData TypeRequiredDescription
TokenHeaderstringNo
DeviceIdHeaderstringNo
AppIdHeaderstringYes
BaseRequest Parameters:
NameParameterData TypeRequiredDescription
ApiKeyheaderstringYesThis is your AIM API Key provided by Tri-Tech
OAuthTokenheaderstringNo
C2BGetInstrumentDetailResponse Parameters:
NameParameterData TypeRequiredDescription
InstrumentDetailsformC2BInstrumentDetailGenericNo
MobileLayoutformMobileLayoutNo
BaseResponse Parameters:
NameParameterData TypeRequiredDescription
StatusbodyBaseResponseResultNo
BaseResponseResult Parameters:
NameParameterData TypeRequiredDescription
StatusCodebodystringNo
LoginbodystringNo
ErrorCodebodystringNo
ErrorDisplayTextbodystringNo
ErrorMessagebodystringNo
DomainNamebodystringNo
IpAddressbodystringNo
C2BInstrumentDetailGeneric Parameters:
NameParameterData TypeRequiredDescription
PlanCodeformC2BPlanCodeGenericNo
TeacherformC2BTeacherGenericNo
SchoolformC2BSchoolGenericNo
DeliveryDateformstringNo
SalesPersonformstringNo
DistrictformC2BDistrictGenericNo
InstrumentformC2BInstrumentGenericNo
GradeformC2BGradeGenericNo
AccessoryListformList<C2BAccessoryGeneric>No
DeliveryListformList<C2BAccessoryGeneric>No
MaintenanceListformList<C2BAccessoryGeneric>No
C2BPlanCodeGeneric Parameters:
NameParameterData TypeRequiredDescription
CodeformstringNo
NameformstringNo
MonthsformintNo
TopicformstringNo
UrlformstringNo
FinalTopicformstringNo
C2BTeacherGeneric Parameters:
NameParameterData TypeRequiredDescription
TeacherNameformstringNo
SchoolNameformstringNo
DistrictNameformstringNo
TopicformstringNo
IdformlongNo
DeliveryInfoformC2BDeliveryInfoNo
AIMSchoolIdformlong?No
C2BDeliveryInfo Parameters:
NameParameterData TypeRequiredDescription
FirstDeliveryformDateTimeNo
DeliveryTimeformDateTimeNo
DeliveryThresholdformintNo
SundayDeliveryformboolNo
MondayDeliveryformboolNo
TuesdayDeliveryformboolNo
WednesdayDeliveryformboolNo
ThursdayDeliveryformboolNo
FridayDeliveryformboolNo
SaturdayDeliveryformboolNo
C2BSchoolGeneric Parameters:
NameParameterData TypeRequiredDescription
SchoolNameformstringNo
DistrictNameformstringNo
TeacherCountformintNo
TopicformstringNo
IdformlongNo
DeliveryInfoformC2BDeliveryInfoNo
AIMSchoolIdformlong?No
C2BDistrictGeneric Parameters:
NameParameterData TypeRequiredDescription
DistrictNameformstringNo
SchoolCountformintNo
TeacherCountformintNo
TopicformstringNo
IdformlongNo
C2BInstrumentGeneric Parameters:
NameParameterData TypeRequiredDescription
InstrumentNameformstringNo
SkuformstringNo
TopicformstringNo
ImageformstringNo
LevelformintNo
RentPriceformdecimal?No
CashPriceformdecimal?No
TokenformstringNo
InstrumentIdformlongNo
InstrumentTeacherIdformlongNo
GradeListformList<C2BGradeGeneric>No
HasGradesformboolNo
DisplayOrderformintNo
AccessoryListformList<C2BAccessoryGeneric>No
DeliveryListformList<C2BAccessoryGeneric>No
MaintenanceListformList<C2BAccessoryGeneric>No
C2BGradeGeneric Parameters:
NameParameterData TypeRequiredDescription
LevelformintNo
GradeformstringNo
DownPayformdecimalNo
DownMaintformdecimalNo
MoPayformdecimalNo
MoMaintformdecimalNo
IdformlongNo
OutOfStockformboolNo
RentPriceformdecimalNo
CashPriceformdecimalNo
DownPayTaxformdecimal?No
DownMaintTaxformdecimal?No
MoPayTaxformdecimal?No
MoMaintTaxformdecimal?No
RentPricePlusTaxformdecimalNo
RentPricePlusTaxLessDownpayformdecimalNo
C2BAccessoryGeneric Parameters:
NameParameterData TypeRequiredDescription
AccessoryDescformstringNo
PriceformdecimalNo
RequiredformboolNo
DefaultformboolNo
RequiresLocationformboolNo
TypeformstringNo
TopicformstringNo
IdformlongNo
DisplayOrderformintNo
SkuformstringNo
TaxAmountformdecimal?No
CatNumformint?No
MobileLayout Parameters:
NameParameterData TypeRequiredDescription
titleformstringNo
returnurlformstringNo
sectionsformSection[]No
Section Parameters:
NameParameterData TypeRequiredDescription
headerformstringNo
idformstringNo
marginformstringNo
elementsformElement[]No
Element Parameters:
NameParameterData TypeRequiredDescription
typeformstringNo
labelformstringNo
idformstringNo
fontsizeformstringNo
marginformstringNo
backgroundcolorformstringNo
textcolorformstringNo
heightformstringNo
widthformstringNo
valueformstringNo
addvalueformboolNo
valuesformstring[]No
textalignformstringNo
requiredformbool?No
placeholderformstringNo
fontboldformbool?No
selectedformbool?No
disabledformbool?No
totalamountformbool?No
elementsformIEnumerable<Element>No
mapformIEnumerable<LicenseMap>No
LicenseMap Parameters:
NameParameterData TypeRequiredDescription
nameformstringNo
valueformstringNo

To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml

HTTP + XML

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /api/C2BGetInstrumentDetail HTTP/1.1 
Host: active-ewebservice.biz 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<C2BGetInstrumentDetailRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/AIM.WebService">
  <ApiKey>String</ApiKey>
  <OAuthToken>String</OAuthToken>
  <AppId>String</AppId>
  <DeviceId>String</DeviceId>
  <Token>String</Token>
  <DeliveryId>0</DeliveryId>
  <IncludeMobileLayout>String</IncludeMobileLayout>
  <InstrumentId>0</InstrumentId>
  <LocationId>0</LocationId>
  <RateId>0</RateId>
  <RsiPk>0</RsiPk>
  <TeacherId>0</TeacherId>
</C2BGetInstrumentDetailRequest>
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<C2BGetInstrumentDetailResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/AIM.WebService">
  <Status>
    <DomainName>String</DomainName>
    <ErrorCode>String</ErrorCode>
    <ErrorDisplayText>String</ErrorDisplayText>
    <ErrorMessage>String</ErrorMessage>
    <IpAddress>String</IpAddress>
    <Login>String</Login>
    <StatusCode>String</StatusCode>
  </Status>
  <InstrumentDetails xmlns:d2p1="http://schemas.datacontract.org/2004/07/AIM" i:nil="true" />
  <MobileLayout xmlns:d2p1="http://schemas.datacontract.org/2004/07/AIM.BL.Core.ExternalAPIs.MobileRentals">
    <d2p1:returnurl>String</d2p1:returnurl>
    <d2p1:sections>
      <d2p1:MobileLayout.Section>
        <d2p1:elements>
          <d2p1:MobileLayout.Element>
            <d2p1:addvalue>false</d2p1:addvalue>
            <d2p1:backgroundcolor>String</d2p1:backgroundcolor>
            <d2p1:disabled>false</d2p1:disabled>
            <d2p1:elements i:nil="true" />
            <d2p1:fontbold>false</d2p1:fontbold>
            <d2p1:fontsize>String</d2p1:fontsize>
            <d2p1:height>String</d2p1:height>
            <d2p1:id>String</d2p1:id>
            <d2p1:label>String</d2p1:label>
            <d2p1:map i:nil="true" />
            <d2p1:margin>String</d2p1:margin>
            <d2p1:placeholder>String</d2p1:placeholder>
            <d2p1:required>false</d2p1:required>
            <d2p1:selected>false</d2p1:selected>
            <d2p1:textalign>String</d2p1:textalign>
            <d2p1:textcolor>String</d2p1:textcolor>
            <d2p1:totalamount>false</d2p1:totalamount>
            <d2p1:type>String</d2p1:type>
            <d2p1:value>String</d2p1:value>
            <d2p1:values xmlns:d7p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
              <d7p1:string>String</d7p1:string>
            </d2p1:values>
            <d2p1:width>String</d2p1:width>
          </d2p1:MobileLayout.Element>
        </d2p1:elements>
        <d2p1:header>String</d2p1:header>
        <d2p1:id>String</d2p1:id>
        <d2p1:margin>String</d2p1:margin>
      </d2p1:MobileLayout.Section>
    </d2p1:sections>
    <d2p1:title>String</d2p1:title>
  </MobileLayout>
</C2BGetInstrumentDetailResponse>