| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Inventory (stock)
• Invoicing (account) • Point of Sale (point_of_sale) • Purchase (purchase) • Discuss (mail) |
| Lines of code | 1761 |
| Technical Name |
karage_pos |
| License | LGPL-3 |
| Website | https://karage.co |
| Versions | 17.0 18.0 19.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Inventory (stock)
• Invoicing (account) • Point of Sale (point_of_sale) • Purchase (purchase) • Discuss (mail) |
| Lines of code | 1761 |
| Technical Name |
karage_pos |
| License | LGPL-3 |
| Website | https://karage.co |
| Versions | 17.0 18.0 19.0 |
Karage POS Integration
Seamlessly sync orders from Karage POS to Odoo
Beta Version: This module is currently in beta. Please report any issues to our support team.
Key Features
- REST API Webhook: Receive POS orders via secure webhook endpoints
- API Key Authentication: Secure integration using Odoo's built-in API key system
- Idempotency Support: Prevent duplicate orders with idempotency key handling
- Bulk Order Sync: Process multiple orders in a single request
- Webhook Logging: Complete audit trail of all incoming webhook requests
- Automatic POS Session Management: Creates and manages POS sessions for external orders
How It Works
1. Configure API Authentication
Create an API key in Odoo (User Preferences > Account Security > New API Key) and configure it in your Karage POS system.
2. Send Orders via Webhook
Your Karage POS system sends completed orders to the webhook endpoint:
POST /api/v1/webhook/pos-order X-API-KEY: your_api_key_here Content-Type: application/json
3. Automatic Order Processing
Orders are automatically validated, created in Odoo POS, and confirmed with proper payment and inventory handling.
API Endpoints
| Endpoint | Method | Description |
|---|---|---|
/api/v1/webhook/pos-order |
POST | Create a single POS order |
/api/v1/webhook/pos-order/bulk |
POST | Create multiple POS orders in batch |
Configuration Options
Access configuration via Settings > Point of Sale > Karage POS:
- Processing Timeout: Maximum time for request processing before retry is allowed
- Record Retention: Days to keep webhook logs before cleanup
- Bulk Sync Max Orders: Maximum orders per bulk request
- Valid Order Statuses: Order status codes to accept from external system
Requirements
- Odoo 18.0
- Point of Sale module installed and configured
- At least one POS configuration with payment methods
Please log in to comment on this module