n8n BackOffice ERP Node

Community node for n8n that connects to the BackOffice ERP REST API. It wraps every documented endpoint so you can automate BackOffice ERP workflows without building custom HTTP requests.

Features

• Authenticates with the BackOffice ERP authtoken header
• Works with any BackOffice tenant URL (e.g. https://tenant.bo.ge/api)
• Covers all REST controllers provided in the official BackOffice ERP API documentation
• Flexible payload handling � provide JSON bodies exactly as the API expects
• Consistent error messages surfaced in n8n

Installation

Install the package in your n8n instance and restart n8n to load the node:

npm install n8n-nodes-backoffice-erp

Once installed, search for BackOffice ERP in the node palette.

Credentials

Create BackOffice ERP credentials in n8n using the following fields:

• Base URL � Full tenant API base, including /api (example: https://local.bo.ge/api).
• Auth Token � Your BackOffice ERP API token. It is sent in the authtoken header for every request.

The node uses these values for all operations. A simple GET /calendar request is used to validate credentials.

Supported Resources & Operations

| Resource | Operations | | --- | --- | | Calendar | Get Many, Get, Create, Update, Delete | | Common Data | Get Expense Categories, Get Payment Modes, Get Taxes | | Contacts | Get, Search, Create, Update, Delete | | Contracts | Get, Create, Update, Delete | | Credit Notes | Get, Search, Create, Update, Delete | | Customers | Get, Search, Create, Update, Delete | | Custom Fields | Get | | Estimates | Get, Search, Create, Update, Delete | | Expenses | Get, Search, Create, Update, Delete | | Invoices | Get, Search, Create, Update, Delete | | Items | Get Many, Get, Search | | API Keys | Generate, Delete, Set Level, Suspend, Regenerate | | Leads | Get Many, Get, Search, Create, Update, Delete | | Milestones | Get, Search, Create, Update, Delete | | Payments | Get Many, Get, Search | | Projects | Get, Search, Create, Update, Delete | | Property | Get Many, Get, Get By Floor, Search | | Proposals | Get Many, Search, Create, Update, Delete | | Staff | Get, Search, Create, Update, Delete | | Subscriptions | Get Many, Get, Create, Update, Delete | | Tasks | Get, Search, Create, Update, Delete | | Tickets | Get, Search, Create, Update, Delete | | Timesheets | Get Many, Get, Create, Update, Delete |

Each operation mirrors the path structure from the BackOffice ERP apidoc controllers, including optional path segments for IDs and special routes such as delete/* endpoints.

Usage

1. Drop the BackOffice ERP node into your workflow.
2. Select the resource and operation you want to call.
3. Fill in any required path parameters (IDs, search terms, floor numbers, etc.).
4. For POST/PUT endpoints, paste the JSON payload you would send to the REST API.
5. Execute the workflow to send the request and work with the JSON response inside n8n.

The node returns exact API responses, for example property records:

[
  {
    "id": "1",
    "name": "Villa Test",
    "short_description": "<p>Description</p>",
    "amenities": ["1"],
    "customfields": [
      { "label": "???", "value": "??" },
      { "label": "test", "value": "1" }
    ]
  }
]

Development

Clone the repository, install dependencies, and use the n8n Node CLI for local development:

npm install
npm run dev

Build production assets before publishing:

npm run build

License

MIT