intuitdeveloper / qboconceptstutorial-dotnet

Sample app in .Net demonstrating QBO concepts like invoicing, billing, inventory management

QBOConceptsTutorial-DotNet

MVC5 Sample app for Dotnet with crud samples for different workflows

The Intuit Developer team has written this OAuth 2.0 Sample App in .Net(C#) MVC5 to provide working examples of OAuth 2.0 concepts, and how to integrate with Intuit endpoints.It uses the Owin Context to save the user cookies for the session. More details can be read here- https://www.asp.net/aspnet/overview/owin-and-katana https://brockallen.com/2013/10/24/a-primer-on-owin-cookie-authentication-middleware-for-the-asp-net-developer/

Getting Started

Before beginning, it may be helpful to have a basic understanding of OAuth 2.0 concepts. There are plenty of tutorials and guides to get started with OAuth 2.0. Check out the docs on https://developer.intuit.com/

PreRequisites

.Net Framework 4.6.1

Setup Clone this repository/Download the sample app.

Configuring your app

All configuration for this app is located in web.config. Locate and open this file.

We will need to update 4 items:

1)clientId 2)clientSecret 3)redirectUri logPath

First 3 values must match exactly with what is listed in your app settings on developer.intuit.com. If you haven't already created an app, you may do so there. Please read on for important notes about client credentials, scopes, and redirect urls. logPath should be the location of a physical path on your disk.

Client Credentials

Once you have created an app on Intuit's Developer Portal, you can find your credentials (Client ID and Client Secret) under the "Keys" tab. You will also find a section to enter your Redirect URI here.

Redirect URI You'll have to set a Redirect URI in both 'web.config' and the Developer Portal ("Keys" section). With this app, the typical value would be http://localhost:27353/callback, unless you host this sample app in a different way (if you were testing HTTPS, for example or changing the port).

Scopes

Use the scopes as shown in the sample app or docs for different flows.

It is important to ensure that the scopes your are requesting match the scopes allowed on the Developer Portal. For this sample app to work by default, your app on Developer Portal must support both Accounting and Payment scopes. If you'd like to support Accounting only, simply remove thecom.intuit.quickbooks.payment scope from web.config.

Run your app!

After setting up both Developer Portal and your web.config(setup Log Path too), run the sample app. Check logs on the path you have already configured in the web.config to get details of how the flow worked.

All flows should work. The sample app supports the following flows:

Connect To QuickBooks - this flow requests non-OpenID scopes. You will be able to make a QuickBooks API different workflow calls (using the OAuth2 token) on the /connected landing page.

qboconceptstutorial-dotnet's Issues

Unable to get to the AppController Due to Authorization Failure

Hi,
I am not sure how to proceed with the Sample Concept Tutorial.

1. I was able to get the Application Started.
2. I was able to Connect to QuickBooks and get a Callback to my localhost page with a Callback:

Code: AB11673721022K5fV5hzdcM7oPm8W2bukssBAeKAFJwHxO9bw9
State: e851fbb9e9d949be98479f885c83687b (valid)
RealmId: 4620816365268362850
Error: none
Note:SIWI flow does not returns relamId as it does not have the required scopes 

3. I am not able to navigate to the AppController View (Not Authorized).

I would like to test the Create Customer and the other features that are available oon the App View controller as well.
Would you please assist me in getting pass the [Authorized] Check on the AppController so I can proceed with my test and l;earning?

Thank you for your Support.