qbo_api 3.0.1 → 3.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b9924b785fa2755f09e92bf26198280b198dee80d2621d8c86b4e4f2fdb1cc1d
-  data.tar.gz: 26b76ad24f8760ebb5c39385e9798b3799645cbe6d3d69230a6d720ee9676514
+  metadata.gz: 5332ce0a487a0012e3cb020426155b5d8a1775497e32e3f43883c8da46417684
+  data.tar.gz: 4bc7672f4a4e5b3ef937cd1ba23940da15343da38401243b2665b8b9bf910455
 SHA512:
-  metadata.gz: 827f3a675049aa20889d6e7e7cf9b8e2b05df79c0410b9bbef0c9bcd2c57eb81f77f88f5e5c2b9f161318bbd899ccb94bec9a9d2e199977b8545bd16cb8163e6
-  data.tar.gz: e52c00f610340f0a0d13c711782629c56b80fcc6300b05e5f97705de63545c6cb59dbeba33fb15cbe2770628c38458c2535eabfd00e7e74a87223c267c5229e8
+  metadata.gz: 93b46a7ec5c979914e5e7046304bea8df3504e1c60e0168acf4ba8b3f756f7816b292ccc92fd57cce03629febfa6ac957124dfd2da3cc9854e8fa8e90c20d534
+  data.tar.gz: '04531594e0155c2cec1306e4c19ce53eb0f7b15f25e56ba860702ae773afcffa9942e0d26fdfc538b5ed831e4a1007e99b718437f9e15096bb95a9a597aeb6c1'

data/.github/dependabot.yml

@@ -0,0 +1,10 @@
+# Set update schedule for GitHub Actions
+
+version: 2
+updates:
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      # Check for updates to GitHub Actions every weekday
+      interval: "daily"

data/.github/workflows/ci.yaml

@@ -0,0 +1,29 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches: [ master ]
+
+jobs:
+  rspec:
+    runs-on: ubuntu-latest
+    env:
+      RUBYOPT: "-W:deprecated" # show warnings, deprecations only
+      FARADAY_VERSION: ${{ matrix.faraday }}
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: [ '2.7', '3.0', '3.1', '3.2' ]
+        faraday: [ '~> 1.0', '~> 2.0' ]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
+      - name: Run RSpec
+        run: |
+          cp .env.test .env
+          bundle exec rspec spec/

data/README.md

@@ -81,7 +81,7 @@ QboApi.request_id = true
   resp = qbo_api.create(:bill, payload: bill_hash, params: { requestid: qbo_api.uuid })
   # Works with .get, .create, .update, .query methods
 ```
-- To run all requests with a [Minor version](https://developer.intuit.com/docs/0100_quickbooks_online/0200_dev_guides/accounting/minor_versions).
+- By default, this client runs against the current "base" or major version of the QBO API. This client does not run against the latest QBO API [minor version](https://developer.intuit.com/app/developer/qbo/docs/learn/explore-the-quickbooks-online-api/minor-versions) by default. To run all requests with a specific minor version, you must specify it:
 ```ruby
 QboApi.minor_version = 8
 ```
@@ -132,6 +132,12 @@ QboApi.minor_version = 8
   p response['status'] # => "Deleted"
 ```
 
+NOTE: If you are deleting a journal entry you have to use the following syntax with the underscore, even though this is inconsistent with how you create journal entries.
+```ruby
+  response = qbo_api.delete(:journal_entry, id: 145)
+  p response['status'] # => "Deleted"
+```
+
 ### Deactivate (only works for name list entities)
 ```ruby
   response = qbo_api.deactivate(:employee, id: 55)
@@ -329,29 +335,46 @@ See [docs](https://developer.intuit.com/docs/0100_quickbooks_online/0100_essenti
   p qbo_api.is_transaction_entity?(:customer) # => false
   p qbo_api.is_name_list_entity?(:vendors) # => true
 ```
-## <a name='OAuth2-example'>Spin up an example</a>
+## Spin up an example
 - <a href="http://minimul.com/access-the-quickbooks-online-api-with-oauth2.html" target="_blank">Check out this article on spinning up the example</a>.
-- `git clone git://github.com/minimul/qbo_api && cd qbo_api`
-- `bundle`
+
+- Create a Intuit developer account at [https://developer.intuit.com](https://developer.intuit.com)
+- Create an app in the intuit developer backend
+  - Go to [myapps](https://developer.intuit.com/app/developer/myapps)
+  - Create an app with both the `Accounting` & `Payments` selected.
+
+- Setup the app and gather credentials
+  - Go to the [Development Dashboard](https://developer.intuit.com/app/developer/dashboard)
+  - Click on your App name
+  - Click "Keys & credentials" under Development Settings in left menu
+  - Copy the 'Client ID' and the 'Client Secret'
+  - Add a Redirect URI: `http://localhost:9393/oauth2-redirect` (or whatever PORT= is in your .env)
+  - Create a new Sandbox Company by clicking on "View Sandbox companies"
+    Don't use it for anything else besides testing this app.
+  - Copy the 'Company ID' for use later
+    1. Within 'Sandbox Company_US_1' click on the COG -> Additional info
+    2. Copy the 'Company ID'
+  
+- Setup qbo_api
+  - `git clone git://github.com/minimul/qbo_api && cd qbo_api`
+  - `bundle`
+
 - Create a `.env` file
   - `cp .env.example_app.oauth2 .env`
-  - If needed create an account at [https://developer.intuit.com](https://developer.intuit.com)
-  - Click `Get started coding`
-  - Create an app with both the `Accounting` & `Payments` selected.
-  - Go to the [`Development` tab](https://developer.intuit.com/v2/ui#/app/dashboard)
-  and copy the 'Client ID' and the 'Client 'Secret' to your .env
-  as QBO_API_CLIENT_ID and QBO_API_CLIENT_SECRET respectively
-- Add a Redirect URI: `http://localhost:9393/oauth2-redirect` (or whatever PORT= is in your .env)
-- Create a new Company ([from the manage sandboxes page](https://developer.intuit.com/v2/ui#/sandbox))
-  Don't use it for anything else besides testing this app.
--. Copy the 'Company ID' to your .env as QBO_API_COMPANY_ID
-- Start up the example app
+  - Edit your .env and enter the following
+    ```
+    export QBO_API_CLIENT_ID=[YOUR CLIENT ID]
+    export QBO_API_CLIENT_SECRET=[YOUR CLIENT SECRET]
+    export QBO_API_COMPANY_ID=[YOUR COMPANY ID]
+    ```
+
+- Start up the example app and test
   - `ruby example/oauth2.rb`
-- Go to `http://localhost:9393/oauth2`
-- Use the `Connect to QuickBooks` button to connect to your QuickBooks sandbox, which you receive when signing up at [https://developer.intuit.com](https://developer.intuit.com).
-- After successfully connecting to your sandbox go to :
-  - `http://localhost:9393/oauth2/customer/5`
+  - Go to `http://localhost:9393/oauth2`
+  - Use the `Connect to QuickBooks` button to connect to your QuickBooks sandbox, which you receive when signing up at [https://developer.intuit.com](https://developer.intuit.com).
+  - After successfully connecting to your sandbox go to `http://localhost:9393/oauth2/customer/5`
   - You should see "Dukes Basketball Camp" displayed
+
 - Checkout [`example/oauth2.rb`](https://github.com/minimul/qbo_api/blob/master/example/oauth2.rb)
   to see what is going on under the hood.
 

data/lib/qbo_api/error.rb

@@ -13,11 +13,25 @@ class QboApi
   class Error < StandardError
     attr_reader :fault
 
-    def initialize(errors = nil)
-      if errors
-        @fault = errors
-        super(errors[:error_body])
-      end
+    def initialize(errors = {})
+      @fault = errors
+      super(errors[:error_body])
+    end
+
+    def fault_type
+      fault.dig(:error_body, 0, :fault_type)
+    end
+
+    def error_code
+      fault.dig(:error_body, 0, :error_code)
+    end
+
+    def error_message
+      fault.dig(:error_body, 0, :error_message)
+    end
+
+    def error_detail
+      fault.dig(:error_body, 0, :error_detail)
     end
   end
 

data/lib/qbo_api/version.rb

@@ -1,3 +1,3 @@
 class QboApi
-  VERSION = "3.0.1"
+  VERSION = "3.0.2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: qbo_api
 version: !ruby/object:Gem::Version
-  version: 3.0.1
+  version: 3.0.2
 platform: ruby
 authors:
 - Christian Pelczarski
-autorequire:
+autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-01-04 00:00:00.000000000 Z
+date: 2024-07-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -164,7 +164,7 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description:
+description: 
 email:
 - christian@minimul.com
 executables: []
@@ -173,6 +173,8 @@ extra_rdoc_files: []
 files:
 - ".env.example_app.oauth2"
 - ".env.test"
+- ".github/dependabot.yml"
+- ".github/workflows/ci.yaml"
 - ".gitignore"
 - ".travis.yml"
 - Gemfile
@@ -204,7 +206,7 @@ homepage: https://github.com/minimul/qbo_api
 licenses:
 - MIT
 metadata: {}
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -219,8 +221,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.22
-signing_key:
+rubygems_version: 3.3.26
+signing_key: 
 specification_version: 4
 summary: Ruby JSON-only client for QuickBooks Online API v3. Built on top of the Faraday
   gem.