n8n-nodes-tripletex/README.md

n8n node for Tripletex API v2 integration

# n8n-nodes-tripletex

[![npm version](https://badge.fury.io/js/n8n-nodes-tripletex.svg)](https://badge.fury.io/js/n8n-nodes-tripletex)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

A comprehensive n8n community node for integrating with Tripletex API v2, Norway's leading accounting and business management platform.

## 🚀 Features

- **Complete Tripletex API v2 Support** - All major business operations
- **Customer Management** - Create, read, update, delete customers
- **Product Management** - Full product lifecycle management
- **Order Processing** - End-to-end order management
- **Invoice Management** - Automated invoicing workflows
- **Inventory Tracking** - Real-time inventory management
- **Webhook Support** - Real-time event notifications
- **WooCommerce Integration** - Ready-to-use mapping utilities
- **TypeScript Support** - Full type definitions included

## 📦 Installation

### Via n8n UI (Recommended)

1. Open your n8n instance
2. Go to **Settings** > **Community Nodes**
3. Click **Install a community node**
4. Search for `n8n-nodes-tripletex`
5. Click **Install**

### Via npm

```bash
npm install n8n-nodes-tripletex
```

## 🔧 Configuration

### 1. Get Tripletex API Credentials

1. Log in to your Tripletex account
2. Go to **Settings** > **API Access** or **Integrasjoner**
3. Create a new API application or use existing integration
4. Note down your **Consumer Token** and **Employee Token**

> **Important**: Tripletex API v2 uses Consumer Token + Employee Token to generate Session Token for authentication.

### 2. Configure in n8n

1. In n8n, go to **Settings** > **Credentials**
2. Click **Add Credential**
3. Select **Tripletex API**
4. Fill in:
   - **Consumer Token**: Your Tripletex Consumer Token
   - **Employee Token**: Your Tripletex Employee Token (from API brukernøkler)
   - **Environment**: `production` or `test`

## 🎯 Usage Examples

### List Customers

```json
{
  "resource": "customer",
  "operation": "getAll",
  "limit": 50
}
```

### Create Product

```json
{
  "resource": "product",
  "operation": "create",
  "name": "My Product",
  "unitPrice": 299.00,
  "currency": "NOK"
}
```

### Process Order

```json
{
  "resource": "order",
  "operation": "create",
  "orderDate": "2024-12-19",
  "customerId": "12345",
  "orderLines": [
    {
      "productId": "67890",
      "quantity": 2,
      "unitPrice": 299.00
    }
  ]
}
```

## 🔗 WooCommerce Integration

This node includes built-in utilities for mapping WooCommerce data to Tripletex format:

```javascript
// In a Code node
const { mapWooCommerceOrder } = require('n8n-nodes-tripletex/utils');

const tripletexOrder = mapWooCommerceOrder($input.all()[0].json);
```

## 🧪 Testing

### Unit Tests

```bash
npm run test:unit
```

### Integration Tests

```bash
npm run test:integration
```

### Full Test Suite

```bash
npm test
```

## 📚 Resources

- **Tripletex API Documentation**: https://api-test.tripletex.tech/v2-docs/
- **n8n Community Nodes**: https://docs.n8n.io/integrations/community-nodes/
- **GitHub Repository**: https://github.com/devora-ai/n8n-nodes-tripletex

## 🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests
5. Submit a pull request

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## 🆘 Support

- **Issues**: [GitHub Issues](https://github.com/devora-ai/n8n-nodes-tripletex/issues)
- **Documentation**: [Wiki](https://github.com/devora-ai/n8n-nodes-tripletex/wiki)
- **Email**: dev@devora.ai

## 🔄 Changelog

See [CHANGELOG.md](CHANGELOG.md) for a complete list of changes.

---

**Made with ❤️ by [Devora AI](https://devora.ai)**