SDKTestPlus3 is an application that allows you to proceed step-by-step through an interaction, via the SDK, with QuickBooks Desktop. Its interface has separate controls for each step, so you can open a connection to QuickBooks, review the status message returned by QuickBooks, then begin a session and review the status message for that step, and so on. You will probably find SDKTestPlus3 useful throughout the development cycle, as it allows you to test connectivity options and qbXML message validity independent of your application logic, but in this example, you’ll be using it to familiarize yourself with the basics of communicating with QuickBooks via the SDK. You’ll be opening a connection, beginning a session, sending a request message, processing the response message, ending the session, and closing the connection, and at each step you’ll be reviewing the status returned from QuickBooks and observing the behavior of the QuickBooks UI.
Using the SDKTestPlus3 tool
The step-by-step instructions that follow walk you through using SDKTestPlus3 to perform the basic steps for interacting with QuickBooks via the SDK:
Click Begin Session.
You should see QuickBooks open the authorization dialog, indicating that SDKTestPlus3 is requesting access to the company file. Notice that the default is to allow one-time access. Click Continue… to accept this.
You should see a QuickBooks message confirming that SDKTestPlus3 has been given one-time authorization. Click Done.
In the SDKTestPlus3 tool’s interface, you should see a message confirming that the session has begun with the company file currently open in the QuickBooks UI.
Click Send XML to Request Processor. You should see a message confirming that the request has been processed.
To see what you have accomplished:
Click End Session.
Click Close Connection.
In this brief demonstration you used the SDKTestPlus3 tool to open a connection to QuickBooks, begin a session, and send a request message in qbXML. When you develop applications, you will write code that performs these same steps. You also, in this demonstration, used the QuickBooks authorization dialog to choose the default authorization option, which give the SDKTestPlus3 application one-time authorization to the company file that was already open in the QuickBooks UI. When you design and develop your applications you will want to consider other possibilities that are available for authorization, including sending authorization preferences in your BeginSession calls. If you’re curious about the code that opens connections and begins sessions, or about the other options available for authorizing an application, see the page covering Connections, session, and authorizations.
SDKTestPlus3 sends and receives qbXML messages that already exist. You applications will often build their messages from data supplied by the user, and can do this either by writing the qbXML directly, or by using the QBFC support classes. You will see more about this in the next steps.
Now that you’ve seen the basic steps in action, dive a bit deeper into programming with the SDK by viewing the SDK Essentials videos.