MICROS 3700 API Calls

[jmoats]

I'm working on an integration that's using the 'Oracle Hospitality RES 3700 POS API' to pull in check information. I have the API set up and working fine, but I'm having trouble getting specific check information, namely the line items on the check. I'm trying to do this with the GetPrintedCheck call.

The call returns CheckPrintLines, GuestCheck, and TotalsResponse correctly. However, the CheckInfoLines part of the GuestCheck structure just has a bunch of empty strings. According to the API documentation, it says 'The ResPosAPI_GuestCheck structure is also passed but is only an out parameter. This way the developer will have all of the needed information about the check'. I'm assuming information should be there, but it's not. Is there something configured wrong on the MICROS side? Any suggestions on settings/configuration to check?

Is there a better way to get detailed check information for an open check using the API? Specifically, I want to get each item on the check along with the line item's quantity, total, and some kind of menu ID to be able to use these items in a future API call.

 

[codexPOSed]

According to the WSDL, this is what you will get back from GetPrintedCheck method:

<soap:Envelope xmlns:soap="[URL unfurl="true"]http://www.w3.org/2003/05/soap-envelope"[/URL] xmlns:res="[URL unfurl="true"]http://schemas.micros.com/RESPOS">[/URL]
   <soap:Header/>
   <soap:Body>
      <res:GetPrintedCheck>
         <res:CheckSeq>?</res:CheckSeq>
         <res:EmplObjectnum>?</res:EmplObjectnum>
         <res:TmedObjectNum>?</res:TmedObjectNum>
         <!--Optional:-->
         <res:ppCheckPrintLines>
            <!--Zero or more repetitions:-->
            <res:string>?</res:string>
         </res:ppCheckPrintLines>
         <res:pGuestCheck>
            <!--Optional:-->
            <res:CheckID>?</res:CheckID>
            <res:CheckTableObjectNum>?</res:CheckTableObjectNum>
            <res:CheckRevenueCenterObjectNum>?</res:CheckRevenueCenterObjectNum>
            <res:CheckOrderType>?</res:CheckOrderType>
            <res:CheckEmployeeObjectNum>?</res:CheckEmployeeObjectNum>
            <res:CheckSeq>?</res:CheckSeq>
            <res:CheckNum>?</res:CheckNum>
            <res:CheckDateToFire>?</res:CheckDateToFire>
            <res:CheckGuestCount>?</res:CheckGuestCount>
            <!--Optional:-->
            <res:pCheckInfoLines>
               <!--Zero or more repetitions:-->
               <res:string>?</res:string>
            </res:pCheckInfoLines>
            <res:CheckStatusBits>?</res:CheckStatusBits>
            <!--Optional:-->
            <res:pPrintJobIds>
               <!--Zero or more repetitions:-->
               <res:int>?</res:int>
            </res:pPrintJobIds>
         </res:pGuestCheck>
         <res:pTotalsResponse>
            <!--Optional:-->
            <res:TotalsSubTotal>?</res:TotalsSubTotal>
            <!--Optional:-->
            <res:TotalsTaxTotals>?</res:TotalsTaxTotals>
            <!--Optional:-->
            <res:TotalsOtherTotals>?</res:TotalsOtherTotals>
            <!--Optional:-->
            <res:TotalsAutoSvcChgTotals>?</res:TotalsAutoSvcChgTotals>
            <!--Optional:-->
            <res:TotalsTotalDue>?</res:TotalsTotalDue>
         </res:pTotalsResponse>
      </res:GetPrintedCheck>
   </soap:Body>
</soap:Envelope>

I don't believe it includes the check details, just the summary information and the facsimile of the check as you describe what you are getting.

I don't think there is a suitable method for what you are trying to do(at least not in TS of 3700). For a previous project i've done which i wrapped the TS with a RESTful API, I had to go directly to the Sybase micros database to obtain the kind of information you are looking for.

Hope this helps