n8n-nodes-cin7-core

[Velocity BPA Licensing Notice]

This n8n node is licensed under the Business Source License 1.1 (BSL 1.1).

Use of this node by for-profit organizations in production environments requires a commercial license from Velocity BPA.

For licensing information, visit https://velobpa.com/licensing or contact [email protected].

This n8n community node provides comprehensive integration with Cin7 Core inventory management system, supporting 7 essential resources including products, sales, purchases, customers, suppliers, stock transfers, and locations. Enable seamless automation of inventory operations, order management, and business workflows with full CRUD capabilities across all major Cin7 Core entities.

Features

• Complete Product Management - Create, read, update and delete products with full inventory tracking capabilities
• Sales Order Processing - Automate sales workflows including order creation, updates, and status management
• Purchase Order Automation - Streamline procurement processes with comprehensive purchase order handling
• Customer Relationship Management - Manage customer data, contacts, and relationship information seamlessly
• Supplier Management - Handle supplier information, contacts, and procurement relationships
• Stock Transfer Operations - Automate inventory movements between locations with full tracking
• Location Management - Manage warehouse and location data for multi-location inventory control
• Advanced Error Handling - Robust error management with detailed logging and recovery options

Installation

Community Nodes (Recommended)

1. Open n8n
2. Go to Settings → Community Nodes
3. Click Install a community node
4. Enter n8n-nodes-cin7-core
5. Click Install

Manual Installation

cd ~/.n8n
npm install n8n-nodes-cin7-core

Development Installation

git clone https://github.com/Velocity-BPA/n8n-nodes-cin7-core.git
cd n8n-nodes-cin7-core
npm install
npm run build
mkdir -p ~/.n8n/custom
ln -s $(pwd) ~/.n8n/custom/n8n-nodes-cin7-core
n8n start

Credentials Setup

| Field | Description | Required | |-------|-------------|----------| | API Key | Your Cin7 Core API key from account settings | Yes | | Account ID | Your Cin7 Core account identifier | Yes | | Environment | Production or sandbox environment URL | Yes |

Resources & Operations

1. Product

| Operation | Description | |-----------|-------------| | Create | Create a new product with inventory details | | Get | Retrieve a specific product by ID | | Get All | List all products with optional filtering | | Update | Modify existing product information | | Delete | Remove a product from inventory |

2. Sale

| Operation | Description | |-----------|-------------| | Create | Create a new sales order or invoice | | Get | Retrieve a specific sale by ID | | Get All | List all sales with date and status filters | | Update | Modify existing sale information | | Delete | Cancel or remove a sales record |

3. Purchase

| Operation | Description | |-----------|-------------| | Create | Create a new purchase order | | Get | Retrieve a specific purchase order by ID | | Get All | List all purchase orders with filtering options | | Update | Modify existing purchase order details | | Delete | Cancel or remove a purchase order |

4. Customer

| Operation | Description | |-----------|-------------| | Create | Add a new customer to the system | | Get | Retrieve specific customer information | | Get All | List all customers with search capabilities | | Update | Modify existing customer details | | Delete | Remove a customer from the system |

5. Supplier

| Operation | Description | |-----------|-------------| | Create | Add a new supplier to the system | | Get | Retrieve specific supplier information | | Get All | List all suppliers with filtering options | | Update | Modify existing supplier details | | Delete | Remove a supplier from the system |

6. StockTransfer

| Operation | Description | |-----------|-------------| | Create | Create a new stock transfer between locations | | Get | Retrieve a specific stock transfer by ID | | Get All | List all stock transfers with status filters | | Update | Modify existing transfer details | | Delete | Cancel or remove a stock transfer |

7. Location

| Operation | Description | |-----------|-------------| | Create | Add a new warehouse or location | | Get | Retrieve specific location information | | Get All | List all locations in the system | | Update | Modify existing location details | | Delete | Remove a location from the system |

Usage Examples

// Create a new product
{
  "name": "Wireless Bluetooth Headphones",
  "sku": "WBH-001",
  "category": "Electronics",
  "price": 79.99,
  "description": "Premium wireless headphones with noise cancellation",
  "stockOnHand": 150
}

// Create a sales order
{
  "customerId": "12345",
  "orderDate": "2024-01-15",
  "items": [
    {
      "productId": "67890",
      "quantity": 2,
      "unitPrice": 79.99
    }
  ],
  "shippingAddress": {
    "street": "123 Main St",
    "city": "New York",
    "state": "NY",
    "zipCode": "10001"
  }
}

// Transfer stock between locations
{
  "fromLocationId": "LOC001",
  "toLocationId": "LOC002",
  "productId": "67890",
  "quantity": 25,
  "transferDate": "2024-01-15",
  "notes": "Restock for high-demand location"
}

// Get all products with low stock
{
  "filters": {
    "stockLevel": "low",
    "category": "Electronics",
    "active": true
  },
  "limit": 50,
  "orderBy": "stockOnHand"
}

Error Handling

| Error | Description | Solution | |-------|-------------|----------| | Authentication Failed | Invalid API key or account credentials | Verify API key and account ID in credentials | | Rate Limit Exceeded | Too many requests sent to Cin7 Core API | Implement delays between requests or reduce frequency | | Resource Not Found | Requested product, sale, or other resource doesn't exist | Check resource ID and ensure it exists in Cin7 Core | | Validation Error | Required fields missing or invalid data format | Review field requirements and data types | | Insufficient Permissions | API key lacks permissions for requested operation | Check API key permissions in Cin7 Core settings | | Network Timeout | Request to Cin7 Core API timed out | Check network connectivity and retry request |

Development

npm install
npm run build
npm test
npm run lint
npm run dev

Author

Velocity BPA

• Website: velobpa.com
• GitHub: Velocity-BPA

Licensing

This n8n community node is licensed under the Business Source License 1.1.

Free Use

Permitted for personal, educational, research, and internal business use.

Commercial Use

Use of this node within any SaaS, PaaS, hosted platform, managed service, or paid automation offering requires a commercial license.

For licensing inquiries: [email protected]

See LICENSE, COMMERCIAL_LICENSE.md, and LICENSING_FAQ.md for details.

Contributing

Contributions are welcome! Please ensure:

1. Code follows existing style conventions
2. All tests pass (npm test)
3. Linting passes (npm run lint)
4. Documentation is updated for new features
5. Commit messages are descriptive

Support

• Issues: GitHub Issues
• Cin7 Core API Documentation: https://core.cin7.com/api-docs
• Cin7 Core Support: https://support.cin7.com