{"id":48084094,"url":"https://github.com/zurd46/n8n_node_bexio","last_synced_at":"2026-04-04T15:04:59.372Z","repository":{"id":323859676,"uuid":"1094898648","full_name":"zurd46/n8n_node_bexio","owner":"zurd46","description":"This is an n8n community node that provides comprehensive integration with the Bexio API.  Bexio is a Swiss business software solution for accounting, invoicing, contact management, and more.","archived":false,"fork":false,"pushed_at":"2025-11-14T14:02:54.000Z","size":229,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-21T16:26:56.853Z","etag":null,"topics":["bexio","n8n","n8n-automation","n8n-nodes"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/@zurdai/n8n-nodes-bexio","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zurd46.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-12T10:18:22.000Z","updated_at":"2026-03-05T20:09:12.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/zurd46/n8n_node_bexio","commit_stats":null,"previous_names":["zurd46/n8n_node_bexio"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/zurd46/n8n_node_bexio","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zurd46%2Fn8n_node_bexio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zurd46%2Fn8n_node_bexio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zurd46%2Fn8n_node_bexio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zurd46%2Fn8n_node_bexio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zurd46","download_url":"https://codeload.github.com/zurd46/n8n_node_bexio/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zurd46%2Fn8n_node_bexio/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31403952,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T10:20:44.708Z","status":"ssl_error","status_checked_at":"2026-04-04T10:20:06.846Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bexio","n8n","n8n-automation","n8n-nodes"],"created_at":"2026-04-04T15:04:08.315Z","updated_at":"2026-04-04T15:04:59.360Z","avatar_url":"https://github.com/zurd46.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# @zurdai/n8n-nodes-bexio\n\nThis is an n8n community node that provides comprehensive integration with the [Bexio API](https://docs.bexio.com/).\n\nBexio is a Swiss business software solution for accounting, invoicing, contact management, and more.\n\n[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.\n\n## Installation\n\nFollow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.\n\n### Community Nodes (Recommended)\n\n1. Go to **Settings \u003e Community Nodes** in your n8n instance\n2. Select **Install**\n3. Enter `@zurdai/n8n-nodes-bexio` in **Enter npm package name**\n4. Agree to the [risks](https://docs.n8n.io/integrations/community-nodes/risks/) of using community nodes\n5. Select **Install**\n\n### Manual Installation\n\nTo install this node manually in your n8n instance:\n\n```bash\nnpm install @zurdai/n8n-nodes-bexio\n```\n\n## Credentials\n\nThis node uses **Personal Access Token (PAT)** authentication for simple and reliable API access.\n\n### Setup Steps\n\n1. Go to the [Bexio Developer Portal](https://developer.bexio.com/)\n2. Create a **Personal Access Token (PAT)**\n3. Copy the token (it will only be shown once!)\n4. In n8n, create a **Bexio API** credential\n5. Paste your Personal Access Token\n\n📖 **Detailed Setup Guide**: See [PERSONAL_ACCESS_TOKEN_SETUP.md](PERSONAL_ACCESS_TOKEN_SETUP.md)\n\n### Available Permissions\n\nWhen creating your Personal Access Token, you can select permissions for:\n\n**Contacts**: View, create, edit, and delete contacts (customers and suppliers)\n**Invoices**: View, create, edit, and delete invoices\n**Quotes**: View, create, edit, and delete quotes (offers)\n**Orders**: View, create, edit, and delete orders\n**Items/Products**: View, create, edit, and delete items (products and services)\n**Banking**: View bank accounts and manage payments\n**Company**: Access company profile information\n\n**Recommended**: Enable all permissions for the resources you plan to use when creating the token. You can always create a new token with different permissions if needed.\n\n## Operations\n\nThis node focuses on essential business operations with the following resources:\n\n### Contact (Customers \u0026 Suppliers)\n- **Create**: Create a new contact (person or company)\n- **Delete**: Delete a contact\n- **Get**: Retrieve a single contact\n- **Get Many**: Retrieve multiple contacts\n- **Search**: Search contacts with criteria\n- **Update**: Update a contact\n\n### Invoice\n- **Create**: Create a new invoice\n- **Delete**: Delete an invoice\n- **Get**: Retrieve a single invoice\n- **Get Many**: Retrieve multiple invoices with advanced filtering\n  - Filter by status: Draft, Pending, Paid, Partially Paid, Overdue, Cancelled\n  - Quick filters: Overdue Only, Unpaid Only\n  - Supports pagination or \"Return All\" option\n- **Get PDF**: Download invoice as PDF\n- **Issue**: Issue an invoice\n- **Mark as Sent**: Mark invoice as sent\n- **Search**: Search invoices with criteria\n- **Send**: Send invoice via email\n- **Update**: Update an invoice\n\n### Item (Products/Services)\n- **Create**: Create a new item\n- **Delete**: Delete an item\n- **Get**: Retrieve a single item\n- **Get Many**: Retrieve multiple items\n- **Search**: Search items with criteria\n- **Update**: Update an item\n\n### Quote (Offers)\n- **Create**: Create a new quote\n- **Delete**: Delete a quote\n- **Get**: Retrieve a single quote\n- **Get Many**: Retrieve multiple quotes\n- **Get PDF**: Download quote as PDF\n- **Issue**: Issue a quote\n- **Search**: Search quotes with criteria\n- **Update**: Update a quote\n\n### Order\n- **Create**: Create a new order\n- **Delete**: Delete an order\n- **Get**: Retrieve a single order\n- **Get Many**: Retrieve multiple orders\n- **Get PDF**: Download order as PDF\n- **Search**: Search orders with criteria\n- **Update**: Update an order\n\n### Banking\n- **Get Bank Accounts**: Retrieve bank accounts\n- **Get Payments**: Retrieve multiple payments\n- **Get Payment**: Retrieve a single payment\n- **Create Payment**: Create a new payment\n\n## Usage Examples\n\n### Example 1: Create a Contact\n1. Add a Bexio node to your workflow\n2. Select **Contact** as the resource\n3. Select **Create** as the operation\n4. Choose **Contact Type** (Person or Company)\n5. Fill in the contact details (name, email, address, etc.)\n\n### Example 2: Create and Send an Invoice\n1. Create an invoice using the **Invoice** resource with **Create** operation\n2. Add invoice positions (line items) as JSON\n3. Use **Issue** operation to finalize the invoice\n4. Use **Send** operation to email the invoice to the customer\n\n### Example 3: Create a Quote and Convert to Order\n1. Create a quote using the **Quote** resource with **Create** operation\n2. Add quote positions (line items) as JSON\n3. Use **Issue** operation to finalize the quote\n4. Once accepted, create an order from the same data using the **Order** resource\n\n### Example 4: Get All Overdue Invoices\n1. Add a Bexio node to your workflow\n2. Select **Invoice** as the resource\n3. Select **Get Many** as the operation\n4. Enable **Return All** to get all invoices\n5. Under **Options**, enable **Overdue Only** filter\n6. This will return all invoices with overdue status\n\n## API Documentation\n\nFor detailed information about the Bexio API, visit:\n- [Bexio API Documentation](https://docs.bexio.com/)\n- [Bexio Developer Portal](https://developer.bexio.com/)\n\n## Compatibility\n\n- Tested with n8n version 1.0.0 and above\n- Uses Bexio API v2.0 and v3.0 endpoints\n- All endpoints verified and tested against Bexio API documentation\n\n## Resources\n\n- [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)\n- [Bexio API Reference](https://docs.bexio.com/)\n\n## Support\n\nFor issues and feature requests, please create an issue on the [GitHub repository](https://github.com/zurd46/n8n_node_bexio/issues).\n\n## Custom Adjustments\n\nIf you need specific customizations or have special requirements for this integration, please contact:\n\n- **Email**: daniel.zurmuehle@zurdai.com\n- **Phone**: +41 79 127 55 54\n\n## Development\n\n### Setup\n\n```bash\n# Install dependencies\nnpm install\n\n# Build the node\nnpm run build\n\n# Run linter\nnpm run lint\n\n# Fix linting issues\nnpm run lintfix\n```\n\n### Project Structure\n\n```\n@zurdai/n8n-nodes-bexio/\n├── credentials/\n│   ├── BexioApi.credentials.ts          # PAT Authentication (Current)\n│   └── BexioOAuth2Api.credentials.ts    # OAuth2 (Deprecated)\n├── nodes/\n│   └── Bexio/\n│       ├── Bexio.node.ts                # Main node implementation\n│       ├── GenericFunctions.ts          # API request helpers\n│       ├── OperationsHandlers.ts        # Resource operation handlers\n│       ├── bexio.svg                    # Node icon\n│       └── descriptions/\n│           ├── ContactDescription.ts     # Contact resource fields\n│           ├── InvoiceDescription.ts     # Invoice resource fields\n│           ├── ItemDescription.ts        # Item resource fields\n│           ├── QuoteDescription.ts       # Quote resource fields\n│           ├── OrderDescription.ts       # Order resource fields\n│           └── BankingDescription.ts     # Banking resource fields\n├── package.json\n├── tsconfig.json\n├── gulpfile.js\n└── README.md\n```\n\n## License\n\n[MIT](LICENSE.md)\n\n## Author\n\nDaniel Zurmühle (daniel.zurmuehle@zurdai.com) zurdai.com\n\n## Version History\n\n### 1.1.0 (Current) - @zurdai/n8n-nodes-bexio\n- **Node Improvements**: Added required fields (`user_id`, `owner_id`) for Contact, Invoice, Quote, and Order resources\n- **Comprehensive Test Suite**: Created full test coverage for all 87 operations across 14 resources\n  - 85.88% success rate (73/85 tests passing)\n  - Automated test runner with JSON and HTML reports\n  - Dynamic test data fetching to adapt to any Bexio account\n- **API Integration Fixes**: Improved error handling and field validation\n- **Developer Experience**: Better error messages and complete test documentation\n\n### 1.0.5 - @zurdai/n8n-nodes-bexio\n- **Security Fixes**: Fixed all dependency vulnerabilities (npm audit: 0 vulnerabilities)\n- Added JSON parsing error handling\n- Added DoS protection with pagination limits\n- Implemented missing `getLanguages` LoadOptions method\n\n### 1.0.0 - @zurdai/n8n-nodes-bexio\n- **New Scoped Package**: Republished as `@zurdai/n8n-nodes-bexio` under zurdai organization\n- All features from the previous package (v1.0.16) included\n- Comprehensive PDF binary download support for Invoice, Quote, and Order\n- 6 essential business resources: Banking, Contact, Invoice, Item, Order, Quote\n- Personal Access Token (PAT) authentication\n- All API endpoints verified and tested\n\n### Previous Package (n8n-nodes-bexio) - Deprecated\n\nThe package was previously published as `n8n-nodes-bexio` (versions 1.0.0 - 1.0.16, now deprecated).\nAll functionality has been migrated to the scoped package `@zurdai/n8n-nodes-bexio`.\n\nFor complete version history of the previous package, see [CHANGELOG.md](CHANGELOG.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzurd46%2Fn8n_node_bexio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzurd46%2Fn8n_node_bexio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzurd46%2Fn8n_node_bexio/lists"}