# ERPapi

> ERPapi is a free, open-source browser extension (Chrome, Firefox, Edge) for Odoo ERP systems. It captures field metadata, debug information, model names, and technical details directly from the Odoo web interface. Supports Odoo versions 14 through 20. Available as a Manifest V3 extension and as a standalone bookmarklet. No external dependencies, pure vanilla JavaScript.

## About

ERPapi (formerly app2api / odoo-cp-values) is a smart toolkit for ERP systems and Odoo. It runs entirely in the browser and requires no server-side components. The extension injects a panel into the Odoo web client that captures and displays field-level metadata, technical model information, and debug data.

- Website: [ERPapi Homepage](https://www.erpapi.de/)
- Languages: German (de) and English (en)
- License: Free to use (donations welcome)
- Authors: [grafix.house](https://www.grafix.house/) and [digitals.direct](https://www.digitals.direct/)

## Features

- Capture Odoo field metadata (field name, type, relation, required, readonly, etc.)
- Display debug information (model name, view type, action ID)
- Automatic Odoo version detection (14 through 20) with layered fallback
- Model detection via WOWL debug (Odoo 17+) and legacy ActionManager (Odoo 14-16)
- Export and import captured field data (JSON)
- Dark mode support (follows system preference or manual toggle)
- Bookmarklet variant for use without extension installation
- Keyboard shortcuts: Alt+Shift+O (toggle panel), Alt+Shift+C (copy last value)

## Supported Browsers

- Google Chrome 88+ (primary)
- Mozilla Firefox 109+
- Microsoft Edge (Chromium-based)

## Architecture

ERPapi uses Manifest V3 and consists of:

- **Service Worker** (background.js): Icon management, message routing, script injection, keyboard shortcuts
- **Content Scripts**: Odoo detection (odoo-detect.js), field capture panel (cp-values.js)
- **Page Script** (odoo-page-world.js): Runs in MAIN world to access window.odoo
- **Popup**: Extension popup with status display and actions
- **Options Page**: Settings for protocol limit, auto-debug, dark mode

## Technology

- Pure vanilla JavaScript (ES5 strict, no build system, no npm dependencies)
- No external libraries or frameworks
- Uses chrome.storage.local for extension-wide settings
- Uses localStorage (domain-scoped, odoo_ prefix) for captured field data
- All DOM creation via createElement + appendChild (no innerHTML for XSS prevention)

## Odoo Detection

ERPapi detects Odoo instances using a layered fallback approach:

1. CSS classes (o_web_client, openerp)
2. Asset URLs (/web/static/, /web/assets/)
3. URL patterns (/web, /odoo)
4. Meta tags
5. Login form detection
6. Legacy data-main attribute

## Support

ERPapi is free to use. If you find it useful, consider supporting the project:

- PayPal: [paypal.me/grafixhouse](https://www.paypal.me/grafixhouse?locale.x=de_DE)
- Buy Me a Coffee: [buymeacoffee.com/goeko](https://buymeacoffee.com/goeko)
- Bitcoin (BTC): TODO
- Ethereum (ETH): TODO
- XRP: TODO

## Links

- [ERPapi Website](https://www.erpapi.de/)
- [Impressum](https://www.erpapi.de/#impressum)
- [Datenschutz](https://www.erpapi.de/#datenschutz)