n8n-nodes-tripletex

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

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

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

Create Product

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

Process Order

{
  "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:

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

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

🧪 Testing

Unit Tests

npm run test:unit

Integration Tests

npm run test:integration

Full Test Suite

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-AS/devora-n8n/tree/main/devora-connect/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 file for details.

🆘 Support

• Issues: GitHub Issues
• Documentation: Wiki
• Email: dev@devora.no

🔄 Changelog

See CHANGELOG.md for a complete list of changes.

---

Made with ❤️ by Devora