Skip to Content

Portal & API - Grevlin Price Intelligence Suite

by
Odoo

$ 1402.90

v 19.0 Third Party
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies • Website (website)
• Discuss (mail)
• Contacts (contacts)
• Sales (sale_management)
• Invoicing (account)
Community Apps Dependencies
Lines of code 18263
Technical Name grev_od_market_portal
LicenseOPL-1
Websitehttps://grevlin.com
You bought this module and need support? Click here!
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies • Website (website)
• Discuss (mail)
• Contacts (contacts)
• Sales (sale_management)
• Invoicing (account)
Community Apps Dependencies
Lines of code 18263
Technical Name grev_od_market_portal
LicenseOPL-1
Websitehttps://grevlin.com

Portal & API

A powerful customer portal and RESTful API that puts market price intelligence directly in your customers’ hands.

Odoo 19.0 Compatible Grevlin Price Intelligence Suite

Portal & API gives your customers self-service access to market price data through a beautiful, interactive portal and a full-featured REST API. Search prices, compare markets, view interactive charts, download reports, and integrate programmatically—all from within Odoo.

Customer Portal

🔍

Price Search & Browsing

Customers can search, filter, and browse market prices directly from the portal. Powerful search with product, market, and date range filters delivers the exact data they need in seconds.

📈

Market Comparison Tool

Compare prices across multiple markets side by side. Identify arbitrage opportunities, spot trends, and make data-driven decisions with an intuitive comparison interface.

📊

Interactive Charts

Beautiful, interactive charts powered by Chart.js and built with Odoo’s OWL framework. Visualize price trends, historical data, and forecasts with responsive, touch-friendly charting components.

📑

Report Browsing & Purchasing

Browse available market intelligence reports, preview summaries, and purchase premium reports using subscription credits. Seamless in-portal purchasing experience for your customers.

🔔

Alert Subscriptions

Customers can create and manage price alerts directly from the portal. Set thresholds, choose notification preferences, and stay informed about market movements that matter to their business.

📊

Usage Dashboard

Give customers full visibility into their subscription usage: API calls made, credits consumed, remaining quotas, and historical usage patterns. Transparency builds trust and reduces support requests.

REST API (v1)

🚀 A complete RESTful API with 6 endpoints covering prices, historical data, analytics, forecasts, markets, and products. Bearer token authentication, rate limiting, credit consumption, JSON responses with pagination—everything developers need to integrate market price intelligence into their applications.

🌐

6 API Endpoints

Complete coverage with dedicated endpoints for prices, historical prices, analytics, forecasts, markets, and products. Each endpoint supports filtering, sorting, and pagination.

🔒

Bearer Token Authentication

Industry-standard Bearer token authentication with API key verification. Each request is authenticated, authorized against the customer’s subscription plan, and rate-limited automatically.

💾

Saved Searches & Downloads

Customers can save frequently used search criteria and download data in multiple formats: CSV, Excel, JSON, and PDF. Streamlined workflows for recurring data needs.

⚡

Rate Limiting & Credits

Built-in rate limiting and credit consumption on every API call. Respects subscription plan quotas, deducts credits automatically, and returns clear error responses when limits are reached.

🔗 Extends Odoo Portal — The customer portal seamlessly integrates into Odoo’s existing portal framework. Market price navigation appears alongside other portal features like invoices, orders, and support tickets. No separate login required.

Screenshots

Customer Portal - Price Search and Browsing Interface

🔍 Portal Price Search

Interactive Charts - Price trends and historical data visualization

📊 Interactive Charts

REST API Documentation - Endpoints and authentication

🌐 REST API Endpoints

Usage Dashboard - Subscription usage and credit consumption

📋 Usage Dashboard

Changelog

Version 19.0.2.0.0 - June 2026

  • Faceted search on price records (by market, commodity, date range)
  • Rate limiting middleware for API endpoint protection
  • OpenAPI 3.0 specification for all 6 REST endpoints
  • Remote Access menu for external connectivity management
  • JSON-RPC migration and Odoo 19 API compatibility

Version 19.0.1.0.0 - March 2026

  • Initial release of Portal & API module
  • Customer portal with price search, browsing, and filtering
  • Market comparison tool for side-by-side analysis
  • Interactive charts with Chart.js and OWL components
  • Report browsing and credit-based purchasing
  • Alert subscription management from the portal
  • Usage dashboard with consumption visibility
  • REST API v1 with 6 endpoints: prices, historical, analytics, forecasts, markets, products
  • Bearer token authentication and API key verification
  • Rate limiting and automatic credit consumption
  • Data downloads in CSV, Excel, JSON, and PDF formats
  • Saved searches for recurring data needs

Need Help?

For support, contact us at odoo@grevlin.com

Follow us on X: @GrevlinGlobal

✅ 30 days free support

Grevlin Price Intelligence Suite - Portal & API

This module provides the customer-facing portal interface and RESTful API for the Grevlin Price Intelligence Suite, enabling external access to market price data, analytics, and reports.

Overview

The Portal & API module is the access layer for customers and integrators. It extends Odoo's portal with market price browsing, comparison tools, and alert management. It also exposes a versioned REST API with Bearer token authentication for programmatic data access.

Key Features

  1. Customer portal with price search and browsing
  2. Market comparison tool for side-by-side analysis
  3. Interactive charts powered by Chart.js (OWL components)
  4. Report browsing and purchasing
  5. Alert subscription management from portal
  6. Usage dashboard showing consumption and limits
  7. REST API v1 with 6 endpoints
  8. Bearer token authentication with API key verification
  9. Rate limiting and credit consumption
  10. Saved searches and data downloads (CSV, Excel, JSON, PDF)

Installation

  1. Place the grev_od_market_portal folder in your Odoo addons path
  2. Ensure all dependency modules are installed:
    • grev_od_market_analytics
    • grev_od_market_subscription
    • grev_od_market_report
    • grev_od_market_alert
  3. Install from :menuselection:`Settings --> Technical --> Database Structure --> Update Apps List`

Note

This module depends on the portal and website modules. Both are standard Odoo modules.

Portal Usage

Market Comparison

  1. Navigate to :guilabel:`Market Comparison` in the portal
  2. Select a product and two or more markets to compare
  3. View side-by-side price data with difference calculations

Reports

  1. Navigate to :guilabel:`Market Reports` in the portal
  2. Browse available published reports
  3. Purchase reports (if applicable) and download PDFs

Alert Management

  1. Navigate to :guilabel:`My Alerts` in the portal
  2. Subscribe to available alert rules
  3. Choose notification channel and frequency
  4. View alert history

Usage Dashboard

  1. Navigate to :guilabel:`My Usage` in the portal
  2. View current plan details and usage statistics
  3. Monitor API call and query consumption
  4. Track remaining credits

REST API Reference

Authentication

All API endpoints require Bearer token authentication:

curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://your-odoo.com/api/v1/prices

The API key must be generated via the Subscriptions module.

Endpoints

Endpoint Method Description
/api/v1/prices GET Query current prices with filters
/api/v1/prices/historical GET Historical price data with date range
/api/v1/analytics GET Computed analytics results
/api/v1/forecasts GET Price forecast data
/api/v1/markets GET List available markets
/api/v1/products GET List tracked commodities

Common Query Parameters

Parameter Type Description
product_id Integer Filter by product ID
market_id Integer Filter by market ID
country_id Integer Filter by country ID
date_from Date Start date (YYYY-MM-DD)
date_to Date End date (YYYY-MM-DD)
limit Integer Results per page (default: 50)
offset Integer Pagination offset

Response Format

All responses are JSON:

{
  "success": true,
  "data": [...],
  "count": 42,
  "limit": 50,
  "offset": 0
}

Error responses:

{
  "success": false,
  "error": "Rate limit exceeded",
  "code": 429
}

Rate Limiting

API calls are rate-limited based on the customer's data plan:

  • Per-minute limits prevent burst abuse
  • Per-day limits cap total daily usage
  • Exceeding limits returns HTTP 429

Technical Reference

Models

Model Technical Name Description
Saved Search grev.saved.search Customer's saved search parameters
Data Download grev.data.download Download history with credit tracking

Controllers

  • controllers/portal_main.py: Portal routes extending CustomerPortal
  • controllers/api_v1.py: REST API v1 endpoints
  • controllers/api_auth.py: Bearer token authentication decorator

Frontend Assets

  • static/src/js/chart_widget.js: OWL component wrapping Chart.js for price visualization
  • static/src/xml/chart_templates.xml: OWL component templates

See also

  • Subscription module for API key and plan management
  • Analytics Engine module for data powering the API
  • Alerting System module for alert subscriptions
  • Report Generation module for purchasable reports
Odoo Proprietary License v1.0

This software and associated files (the "Software") may only be used (executed,
modified, executed after modifications) if you have purchased a valid license
from the authors, typically via Odoo Apps, or if you have received a written
agreement from the authors of the Software (see the COPYRIGHT file).

You may develop Odoo modules that use the Software as a library (typically
by depending on it, importing it and using its resources), but without copying
any source code or material from the Software. You may distribute those
modules under the license of your choice, provided that this license is
compatible with the terms of the Odoo Proprietary License (For example:
LGPL, MIT, or proprietary licenses similar to this one).

It is forbidden to publish, distribute, sublicense, or sell copies of the Software
or modified copies of the Software.

The above copyright notice and this permission notice must be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.

Please log in to comment on this module

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author or have a question related to your purchase, please use the support page.