QuickBooks Online integration reference

GET /connections/{connectionId}/accounts

{
  "accounts": [
    {
      "id": "64",
      "name": "Office Expenses",
      "type": "Expense",
      "subType": "OfficeExpenses",
      "status": "Active",
      "fullyQualifiedName": "Office Expenses"
    }
  ]
}

GET /connections/{connectionId}/tax-rates

{
  "taxRates": [
    {
      "id": "tax-10",
      "name": "Sales Tax 10%",
      "rate": 10.0,
      "status": "Active"
    }
  ]
}

GET /connections/{connectionId}/suppliers

{
  "suppliers": [
    {
      "id": "supplier-123",
      "name": "Office Supplies Co",
      "status": "Active"
    }
  ]
}

GET /connections/{connectionId}/customers

{
  "customers": [
    {
      "id": "customer-456",
      "name": "Acme Corp",
      "status": "Active"
    }
  ]
}

GET /connections/{connectionId}/tracking-categories

{
  "trackingCategories": [
    {
      "id": "class-1",
      "name": "Department",
      "options": [
        {
          "id": "option-1",
          "name": "Sales"
        },
        {
          "id": "option-2",
          "name": "Marketing"
        }
      ]
    }
  ]
}

{
  id: string;                    // QuickBooks account ID
  name: string;                 // Account name
  type: string;                 // Account type (e.g., "Expense")
  subType?: string;             // Account subtype
  status: "Active" | "Inactive";
  fullyQualifiedName: string;   // Fully qualified account name
}

{
  id: string;                   // QuickBooks tax rate ID
  name: string;                 // Tax rate name
  rate: number;                 // Tax rate percentage
  status: "Active" | "Inactive";
}

{
  id: string;                   // QuickBooks vendor ID
  name: string;                 // Supplier name
  status: "Active" | "Inactive";
}

{
  id: string;                   // QuickBooks customer ID
  name: string;                 // Customer name
  status: "Active" | "Inactive";
}

{
  id: string;                   // QuickBooks tracking category ID
  name: string;                 // Category name
  options: Array<{
    id: string;                 // Option ID
    name: string;               // Option name
  }>;
}

{
  "Purchase": {
    "Id": "162",
    "SyncToken": "0",
    "TxnDate": "2024-01-15",
    "TotalAmt": 110.00,
    "PaymentType": "CreditCard",
    "AccountRef": {
      "value": "41",
      "name": "Checking Account"
    },
    "EntityRef": {
      "value": "supplier-123",
      "name": "Office Supplies Co"
    },
    "Line": [
      {
        "Amount": 110.00,
        "DetailType": "AccountBasedExpenseLineDetail",
        "AccountBasedExpenseLineDetail": {
          "AccountRef": {
            "value": "64",
            "name": "Office Expenses"
          },
          "TaxCodeRef": {
            "value": "tax-10"
          }
        }
      }
    ]
  }
}