Quickbooks Usability Audit

components/quickbooks/actions/create-ap-aging-report/create-ap-aging-report.mjs

@@ -5,7 +5,7 @@ export default {
   key: "quickbooks-create-ap-aging-report",
   name: "Create AP Aging Detail Report",
   description: "Creates an AP aging report in Quickbooks Online. [See the documentation](https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/apagingdetail#query-a-report)",
-  version: "0.0.1",
+  version: "0.0.2",
   type: "action",
   props: {
     quickbooks,

components/quickbooks/actions/create-bill/create-bill.mjs

@@ -4,14 +4,18 @@ import quickbooks from "../../quickbooks.app.mjs";
 export default {
   key: "quickbooks-create-bill",
   name: "Create Bill",
-  description: "Creates a bill. [See docs here](https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/bill#create-a-bill)",
-  version: "0.1.6",
+  description: "Creates a bill. [See the documentation](https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/bill#create-a-bill)",
+  version: "0.1.7",
   type: "action",
   props: {
     quickbooks,
     vendorRefValue: {
-      label: "Vendor Ref Value",
+      propDefinition: [
+        quickbooks,
+        "vendorIds",
+      ],
       type: "string",
+      label: "Vendor Ref Value",
       description: "Reference to the vendor for this transaction. Query the Vendor name list resource to determine the appropriate Vendor object for this reference. Use `Vendor.Id` from that object for `VendorRef.value`.",
     },
     lineItems: {

components/quickbooks/actions/create-customer/create-customer.mjs

@@ -4,8 +4,8 @@ import quickbooks from "../../quickbooks.app.mjs";
 export default {
   key: "quickbooks-create-customer",
   name: "Create Customer",
-  description: "Creates a customer. [See docs here](https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/customer#create-a-customer)",
-  version: "0.1.6",
+  description: "Creates a customer. [See the documentation](https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/customer#create-a-customer)",
+  version: "0.1.7",
   type: "action",
   props: {
     quickbooks,

components/quickbooks/actions/create-invoice/create-invoice.mjs

@@ -4,8 +4,8 @@ import quickbooks from "../../quickbooks.app.mjs";
 export default {
   key: "quickbooks-create-invoice",
   name: "Create Invoice",
-  description: "Creates an invoice. [See docs here](https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/invoice#create-an-invoice)",
-  version: "0.1.6",
+  description: "Creates an invoice. [See the documentation](https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/invoice#create-an-invoice)",
+  version: "0.1.7",
   type: "action",
   props: {
     quickbooks,
@@ -16,9 +16,10 @@ export default {
       ],
     },
     customerRefValue: {
-      label: "Customer Reference Value",
-      type: "string",
-      description: "Reference to a customer or job. Query the Customer name list resource to determine the appropriate Customer object for this reference. Use `Customer.Id` from that object for `CustomerRef.value`.",
+      propDefinition: [
+        quickbooks,
+        "customer",
+      ],
     },
     customerRefName: {
       propDefinition: [

components/quickbooks/actions/create-payment/create-payment.mjs

@@ -3,8 +3,8 @@ import quickbooks from "../../quickbooks.app.mjs";
 export default {
   key: "quickbooks-create-payment",
   name: "Create Payment",
-  description: "Creates a payment. [See docs here](https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/payment#create-a-payment)",
-  version: "0.0.5",
+  description: "Creates a payment. [See the documentation](https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/payment#create-a-payment)",
+  version: "0.0.6",
   type: "action",
   props: {
     quickbooks,
@@ -14,9 +14,10 @@ export default {
       type: "string",
     },
     customerRefValue: {
-      label: "Customer Reference Value",
-      description: "Reference to a customer or job. Query the Customer name list resource to determine the appropriate Customer object for this reference. Use `Customer.Id` from that object for `CustomerRef.value`.",
-      type: "string",
+      propDefinition: [
+        quickbooks,
+        "customer",
+      ],
     },
     customerRefName: {
       propDefinition: [

components/quickbooks/actions/create-pl-report/create-pl-report.mjs

@@ -7,7 +7,7 @@ export default {
   key: "quickbooks-create-pl-report",
   name: "Create Profit and Loss Detail Report",
   description: "Creates a profit and loss report in Quickbooks Online. [See the documentation](https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/profitandloss#query-a-report)",
-  version: "0.0.1",
+  version: "0.0.2",
   type: "action",
   props: {
     quickbooks,

components/quickbooks/actions/create-purchase/create-purchase.mjs

@@ -4,14 +4,18 @@ import quickbooks from "../../quickbooks.app.mjs";
 export default {
   key: "quickbooks-create-purchase",
   name: "Create Purchase",
-  description: "Creates a new purchase. [See docs here](https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/purchase#create-a-purchase)",
-  version: "0.0.4",
+  description: "Creates a new purchase. [See the documentation](https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/purchase#create-a-purchase)",
+  version: "0.0.5",
   type: "action",
   props: {
     quickbooks,
     accountRefValue: {
-      label: "Account Reference Value",
+      propDefinition: [
+        quickbooks,
+        "accountIds",
+      ],
       type: "string",
+      label: "Account Reference Value",
       description: "Specifies the id of the account reference. Check must specify bank account, CreditCard must specify credit card account. Validation Rules:Valid and Active Account Reference of an appropriate type.",
     },
     paymentType: {
@@ -37,26 +41,25 @@ export default {
       optional: true,
     },
     currencyRefValue: {
-      label: "Currency Reference Value",
-      type: "string",
-      description: "A three letter string representing the ISO 4217 code for the currency. For example, `USD`, `AUD`, `EUR`, and so on. This must be defined if multicurrency is enabled for the company.\nMulticurrency is enabled for the company if `Preferences.MultiCurrencyEnabled` is set to `true`. Read more about multicurrency support [here](https://developer.intuit.com/docs?RedirectID=MultCurrencies). Required if multicurrency is enabled for the company.",
-      optional: true,
+      propDefinition: [
+        quickbooks,
+        "currencyRefValue",
+      ],
     },
     currencyRefName: {
-      label: "Currency Reference Name",
-      type: "object",
-      description: "The full name of the currency.",
-      optional: true,
+      propDefinition: [
+        quickbooks,
+        "currencyRefName",
+      ],
     },
-    minorversion: {
-      label: "Minor Version",
-      type: "string",
-      description: "Use the minorversion query parameter in REST API requests to access a version of the API other than the generally available version. For example, to invoke minor version 1 of the JournalEntry entity, issue the following request:\n`https://quickbooks.api.intuit.com/v3/company/<realmId>/journalentry/entityId?minorversion=1`",
-      optional: true,
+    minorVersion: {
+      propDefinition: [
+        quickbooks,
+        "minorVersion",
+      ],
     },
   },
   async run({ $ }) {
-
     let parsedLineItems = parseOne(this.lineItems);
 
     const response = await this.quickbooks.createPurchase({

components/quickbooks/actions/create-sales-receipt/create-sales-receipt.mjs

@@ -5,7 +5,7 @@ export default {
   key: "quickbooks-create-sales-receipt",
   name: "Create Sales Receipt",
   description: "Creates a sales receipt. [See the documentation](https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/salesreceipt#create-a-salesreceipt)",
-  version: "0.0.5",
+  version: "0.0.6",
   type: "action",
   props: {
     quickbooks,

components/quickbooks/actions/delete-purchase/delete-purchase.mjs

@@ -3,8 +3,8 @@ import quickbooks from "../../quickbooks.app.mjs";
 export default {
   key: "quickbooks-delete-purchase",
   name: "Delete Purchase",
-  description: "Delete a specific purchase. [See docs here](https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/purchase#delete-a-purchase)",
-  version: "0.0.4",
+  description: "Delete a specific purchase. [See the documentation](https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/purchase#delete-a-purchase)",
+  version: "0.0.5",
   type: "action",
   props: {
     quickbooks,
@@ -14,18 +14,18 @@ export default {
         "purchaseId",
       ],
     },
-    minorversion: {
-      label: "Minor Version",
-      type: "string",
-      description: "Use the minorversion query parameter in REST API requests to access a version of the API other than the generally available version. For example, to invoke minor version 1 of the JournalEntry entity, issue the following request:\n`https://quickbooks.api.intuit.com/v3/company/<realmId>/journalentry/entityId?minorversion=1`",
-      optional: true,
+    minorVersion: {
+      propDefinition: [
+        quickbooks,
+        "minorVersion",
+      ],
     },
   },
   async run({ $ }) {
     const {
       quickbooks,
       purchaseId,
-      minorversion,
+      minorVersion,
     } = this;
 
     const [
@@ -40,7 +40,7 @@ export default {
         SyncToken,
       },
       params: {
-        minorversion,
+        minorversion: minorVersion,
         operation: "delete",
       },
     });

components/quickbooks/actions/get-bill/get-bill.mjs

@@ -4,15 +4,16 @@ import quickbooks from "../../quickbooks.app.mjs";
 export default {
   key: "quickbooks-get-bill",
   name: "Get Bill",
-  description: "Returns info about a bill. [See docs here](https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/bill#read-a-bill)",
-  version: "0.1.6",
+  description: "Returns info about a bill. [See the documentation](https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/bill#read-a-bill)",
+  version: "0.1.7",
   type: "action",
   props: {
     quickbooks,
     billId: {
-      label: "Bill ID",
-      type: "string",
-      description: "Id of the bill to get details of.",
+      propDefinition: [
+        quickbooks,
+        "billId",
+      ],
     },
     minorVersion: {
       propDefinition: [

components/quickbooks/actions/get-customer/get-customer.mjs

@@ -4,15 +4,16 @@ import quickbooks from "../../quickbooks.app.mjs";
 export default {
   key: "quickbooks-get-customer",
   name: "Get Customer",
-  description: "Returns info about a customer. [See docs here](https://developer.intuit.com/app/developer/qbo/docs/api/accounting/most-commonly-used/customer#read-a-customer)",
-  version: "0.3.6",
+  description: "Returns info about a customer. [See the documentation](https://developer.intuit.com/app/developer/qbo/docs/api/accounting/most-commonly-used/customer#read-a-customer)",
+  version: "0.3.7",
   type: "action",
   props: {
     quickbooks,
     customerId: {
-      label: "Customer ID",
-      type: "string",
-      description: "Id of the account to get details of.",
+      propDefinition: [
+        quickbooks,
+        "customer",
+      ],
     },
     minorVersion: {
       propDefinition: [

components/quickbooks/actions/get-invoice/get-invoice.mjs

@@ -4,16 +4,16 @@ import quickbooks from "../../quickbooks.app.mjs";
 export default {
   key: "quickbooks-get-invoice",
   name: "Get Invoice",
-  description: "Returns info about an invoice. [See docs here](https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/invoice#read-an-invoice)",
-  version: "0.2.7",
+  description: "Returns info about an invoice. [See the documentation](https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/invoice#read-an-invoice)",
+  version: "0.2.8",
   type: "action",
   props: {
     quickbooks,
     invoiceId: {
-      label: "Invoice ID",
-      type: "string",
-      description: "Id of the invoice to get details of.",
-      optional: true,
+      propDefinition: [
+        quickbooks,
+        "invoiceId",
+      ],
     },
     minorVersion: {
       propDefinition: [

components/quickbooks/actions/get-my-company/get-my-company.mjs

@@ -3,14 +3,13 @@ import quickbooks from "../../quickbooks.app.mjs";
 export default {
   key: "quickbooks-get-my-company",
   name: "Get My Company",
-  description: "Gets info about a company. [See docs here](https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/companyinfo)",
-  version: "0.1.6",
+  description: "Gets info about a company. [See the documentation](https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/companyinfo)",
+  version: "0.1.7",
   type: "action",
   props: {
     quickbooks,
   },
   async run({ $ }) {
-
     const response = await this.quickbooks.getMyCompany({
       $,
     });

components/quickbooks/actions/get-payment/get-payment.mjs

@@ -0,0 +1,44 @@
+import { ConfigurationError } from "@pipedream/platform";
+import quickbooks from "../../quickbooks.app.mjs";
+
+export default {
+  key: "quickbooks-get-payment",
+  name: "Get Payment",
+  description: "Returns info about a payment. [See the documentation](https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/payment#read-a-payment)",
+  version: "0.0.1",
+  type: "action",
+  props: {
+    quickbooks,
+    paymentId: {
+      propDefinition: [
+        quickbooks,
+        "paymentId",
+      ],
+    },
+    minorVersion: {
+      propDefinition: [
+        quickbooks,
+        "minorVersion",
+      ],
+    },
+  },
+  async run({ $ }) {
+    if (!this.paymentId) {
+      throw new ConfigurationError("Must provide paymentId parameter.");
+    }
+
+    const response = await this.quickbooks.getPayment({
+      $,
+      paymentId: this.paymentId,
+      params: {
+        minorversion: this.minorVersion,
+      },
+    });
+
+    if (response) {
+      $.export("summary", `Successfully retrieved payment with id ${response.Payment.Id}`);
+    }
+
+    return response;
+  },
+};

components/quickbooks/actions/get-purchase-order/get-purchase-order.mjs

@@ -4,15 +4,16 @@ import quickbooks from "../../quickbooks.app.mjs";
 export default {
   key: "quickbooks-get-purchase-order",
   name: "Get Purchase Order",
-  description: "Returns details about a purchase order. [See docs here](https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/purchaseorder#read-a-purchase-order)",
-  version: "0.1.6",
+  description: "Returns details about a purchase order. [See the documentation](https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/purchaseorder#read-a-purchase-order)",
+  version: "0.1.7",
   type: "action",
   props: {
     quickbooks,
     purchaseOrderId: {
-      label: "Purchase Order ID",
-      type: "string",
-      description: "Id of the purchase order to get details of.",
+      propDefinition: [
+        quickbooks,
+        "purchaseOrderId",
+      ],
     },
     minorVersion: {
       propDefinition: [

components/quickbooks/actions/get-purchase/get-purchase.mjs

@@ -4,15 +4,16 @@ import quickbooks from "../../quickbooks.app.mjs";
 export default {
   key: "quickbooks-get-purchase",
   name: "Get Purchase",
-  description: "Returns info about a purchase. [See docs here](https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/purchase#read-a-purchase)",
-  version: "0.1.6",
+  description: "Returns info about a purchase. [See the documentation](https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/purchase#read-a-purchase)",
+  version: "0.1.7",
   type: "action",
   props: {
     quickbooks,
     purchaseId: {
-      label: "Purchase ID",
-      type: "string",
-      description: "Id of the purchase to get details of.",
+      propDefinition: [
+        quickbooks,
+        "purchaseId",
+      ],
     },
     minorVersion: {
       propDefinition: [
@@ -28,7 +29,7 @@ export default {
 
     const response = await this.quickbooks.getPurchase({
       $,
-      purchaseId: this.purchaseId,
+      purchaseId: this.purchaseId?.value ?? this.purchaseId,
       params: {
         minorversion: this.minorVersion,
       },