@accede/node-red-contrib-odbcwritenow 1.0.0

package/LICENSE

@@ -0,0 +1,7 @@
+ISC License
+
+Copyright 2025 Accede Holdings PTY LTD
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,52 @@
+# node-red-odbcwritenow
+
+Node-RED node for accessing MYOB data via **ODBCWriteNow**. Useful when you want AccountRight-style ODBC-style reads/writes in Node-RED without wrangling the raw HTTP yourself.
+
+## Features
+- Node-RED palette node that talks to ODBC WriteNow
+- Read/write operations against MYOB AccountRight via the ODBC WriteNow API
+- Simple config for credentials and endpoint base URL
+
+## Prerequisites
+- Node-RED ≥ 4.x installed and running
+- An active **ODBC WriteNow** account + API key
+
+## Install
+
+```bash
+# install into your Node-RED user dir
+cd ~/.node-red
+npm install DarkAxi0m/node-red-odbcwritenow
+```
+
+Restart Node-RED.
+
+If you manage Node-RED as a service:
+```bash
+sudo systemctl restart nodered
+```
+
+## Usage
+
+1. In the Node-RED editor, open the palette and drag **ODBC WriteNow** onto your flow.
+2. Double-click the node and set:
+   - **Base URL**: your ODBC WriteNow endpoint (e.g. `https://myobsync.accede.com.au/`)
+   - **API Key**: your issued key
+   - **Operation/Path**: API route you need (e.g. download/upload endpoints per docs)
+   - **Params/Body**: any query/body fields required for your action
+
+Refer to the ODBC WriteNow developer docs for the exact routes and parameters.
+
+Example (generic pattern):
+```text
+GET /api/download?table=Customers&updatedSince=2024-01-01
+POST /api/upload  (JSON body with rows)
+```
+
+## License
+ISC © Accede Holdings PTY LTD. See `LICENSE`.
+
+## Links
+- Repo: [DarkAxi0m/node-red-odbcwritenow](https://github.com/DarkAxi0m/node-red-odbcwritenow)
+- [ODBC WriteNow – Overview & pricing](https://odbcwritenow.com/)
+- [ODBC WriteNow – Developer docs](https://odbcwritenow.com/developers/)

package/odbcwritenow.html

@@ -0,0 +1,37 @@
+<script type="text/javascript">
+    RED.nodes.registerType('odbcwritenow-get',{
+        category: 'ODBCWriteNow',
+        color: '#2596be',
+        defaults: {
+            name: {value:""},
+            apikey: {value:""},
+            what: {value:""}
+        },
+        inputs: 1,
+        outputs: 2,
+        icon: "odbcwritenow.png",
+        label: function() {
+            return this.name||"Get " + this.what;
+        }
+    });
+</script>
+
+<script type="text/html" data-template-name="odbcwritenow-get">
+    <div class="form-row">
+        <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
+        <input type="text" id="node-input-name" placeholder="Name">
+    </div>
+  <div class="form-row">
+        <label for="node-input-what"><i class="fa fa-lock"></i> What</label>
+        <input type="text" id="node-input-what" placeholder="sales_invoice_item">
+    </div>
+  <div class="form-row">
+        <label for="node-input-apikey"><i class="fa fa-lock"></i> APIKey</label>
+        <input type="text" id="node-input-apikey" placeholder="APIKey">
+    </div>
+</script>
+
+<script type="text/html" data-help-name="odbcwritenow-get">
+    <p>odbcwritenow downloader</p>
+</script>
+

package/odbcwritenow.js

@@ -0,0 +1,81 @@
+async function DoImport(msg, url, node) {
+    console.log('>', url)
+    msg.nodata = false
+    delete msg.complete
+    node.status({ fill: "blue", shape: "ring", text: `Fetching #${msg.page}: ${msg.what}` })
+    var datastr = ""
+    try {
+        const response = await fetch(url);
+
+        datastr = await response.text();
+        if (datastr.toLowerCase().includes("no data found")) {
+            msg.nodata = true
+            msg.complete = true
+            msg.payload = []
+            node.status({ fill: "green", shape: "ring", text: `#${msg.page}: No data found` })
+            return node.send([null, msg]);
+        }
+
+        //Errors and retrys etc
+        if (datastr.toLowerCase().includes("timeout")) {
+            node.status({ fill: "red", shape: "ring", text: `#${msg.page}: MYOB Gateway Timeout` })
+            console.error("******* MYOB Gateway Timeout", msg.retry, msg.page, url)
+            msg.retry = msg.retry + 1
+            return await DoImport(msg, url, node)
+        }
+        if (datastr.toLowerCase().includes("token error")) {
+            node.status({ fill: "red", shape: "ring", text: `#${msg.page}: MYOB Token Error` })
+            console.error("******* MYOB Token Error", msg.retry, msg.page, url)
+            msg.retry = msg.retry + 1
+            return await DoImport(msg, url, node)
+        }
+        //---------------------------------
+        //Everything looks good
+        const data = JSON.parse(datastr);
+        msg.rows = data.length
+        node.status({ fill: "green", shape: "dot", text: `#${msg.page}: ${msg.rows} Rows` })
+        msg.payload = data;
+        node.send([msg, null]);
+    } catch (error) {
+        node.status({ fill: "red", shape: "ring", text: error.message })
+        console.error(error.message)
+        console.log(datastr)
+    }
+
+}
+
+
+module.exports = function(RED) {
+    function ODBCWriteNowGet(config) {
+        RED.nodes.createNode(this, config);
+        var node = this;
+        node.status({ text: `` })
+        node.on('input', async function(msg) {
+            const page = parseInt(encodeURIComponent(msg.page || 0));
+            const apikey = encodeURIComponent(msg.apikey || config.apikey);
+            const what = encodeURIComponent(config.what)
+
+            msg.page = page
+            msg.what = what
+            msg.retry = 0
+
+            var filtersstr = "";
+            const filters = encodeURIComponent(msg.filters || "")
+            if (filters.length > 0) {
+                filtersstr += `&filters=${filters}`
+            }
+
+            const datefrom = encodeURIComponent(msg.datefrom || "")
+            if (datefrom.length > 0) {
+                filtersstr += `&datefrom=${datefrom}`
+            }
+
+            const url = `https://myobsync.accede.com.au/download/${what}/json/${page}?apikey=${apikey}${filtersstr}`;
+            DoImport(msg, url, node)
+
+        });
+    }
+    RED.nodes.registerType("odbcwritenow-get", ODBCWriteNowGet);
+
+}
+

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@accede/node-red-contrib-odbcwritenow",
+  "version": "1.0.0",
+  "description": "Node-RED library for access in MYOB data via ODBCWriteNow",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "author": "",
+  "license": "ISC",
+  "description": "",
+  "node-red": {
+   "version": ">=4.0.0",
+    "nodes": {
+      "odbcwritenow-get": "odbcwritenow.js"
+    }
+  },
+  "dependencies": {
+    "node-fetch": "^3.3.2"
+  }
+}