Skip to content

wowarjuna/SampleApp-CRUD_.Net_Oauth2

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Sample Banner

SampleApp-CRUD-.Net for Oauth2 apps

CRUD sample for V3 .Net SDK (This sample app has NO UI to show QBO APi calls request or response. It has UI for just the Oauth flow and then please run it in debug mode after enabling logging on Test class to understand how the api calls are made.)

Welcome to the Intuit Developer's .Net Sample App for CRUD operations.

This sample app is meant to provide working examples of how to integrate your app with the Intuit Small Business ecosystem. Specifically, this sample application demonstrates the following:

  • Create, Read, Query, Update, Delete, Void entities.
  • All operations are performed using QuickBooks .Net V3 SDK.

Please note that while these examples work, features not called out above are not intended to be taken and used in production business applications. In other words, this is not a seed project to be taken cart blanche and deployed to your production environment.

For example, certain concerns are not addressed at all in our samples (e.g. security, privacy, scalability). In our sample apps, we strive to strike a balance between clarity, maintainability, and performance where we can. However, clarity is ultimately the most important quality in a sample app.

Therefore there are certain instances where we might forgo a more complicated implementation (e.g. caching a frequently used value, robust error handling, more generic domain model structure) in favor of code that is easier to read. In that light, we welcome any feedback that makes our samples apps easier to learn from.

Table of Contents

Requirements

In order to successfully run this sample app you need a few things:

  1. .Net Framework 4.6.1
  2. A developer.intuit.com account
  3. An app on developer.intuit.com created after Jul 17th, 2017 as only those accounts have Ouath2 apps and the associated client id, client secret and redirect url mapping to what you have in the web.config of this app (http://localhost:49372/Default.aspx)
  4. One sandbox company, connect the company with your app and generate the OAuth tokens.
  5. Update QuickBooks .Net SDK using Nuget (https://www.nuget.org/packages/IppDotNetSdkForQuickBooksApiV3/) to the latest version.

First Use Instructions

  1. Clone the GitHub repo to your computer
  2. Update Nuget Package for .Net to the latest version.
  3. Fill in the web.config file values (cient id, client secret, redirect url, app environment and log folder) by copying over from the keys section for your app. tab->Set time duration in seconds for 180 days and get the access token and secret for your app and company by right clicking on the page and doing a view source.
  4. Build and run.

Running the code

This app is directed to provide individual sample code for CRUD operations for various QBO entities. Set Default.aspx as start page and run.

Notes:

  1. The sample code has been implemented for US locale company, certain fields may not be applicable for other locales or minor version. Care should be taken to handle such scenarios separately.
  2. Before running AttachableUpload sample, update the path of the pdf that you wish to upload to point to your local directory.
  3. This app uses new OAuth2Client. If you want to refer the other way to use standalone OAuth2 clients, download v1.0 from Release tab

About

SampleApp-CRUD_.Net_Oauth2

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 99.4%
  • Classic ASP 0.6%