• Bearer Token Authentication: Industry-standard token-based security for modern applications
• Basic Authentication: Traditional username/password authentication for legacy systems
• Configurable Credentials: Easy setup through Odoo's settings interface
• Authorization Header Support: Standard HTTP authorization headers for maximum compatibility

• JSON Output: Modern, lightweight format perfect for web applications and modern integrations
• XML Output: Traditional format ideal for enterprise systems and legacy applications
• Automatic Format Detection: Content negotiation based on request headers
• Well-Structured Data: Consistent, predictable data structures for easy parsing

• Transaction Details: Complete sales and return transaction information
• Line Item Data: Individual product details with quantities, prices, and categories
• Tax Information: Detailed tax calculations with inclusive/exclusive support
• Payment Methods: Multi-tender support (CASH, CARD, WALLET, OTHERS)
• Currency Support: Currency codes and exchange rate information
• Discount Tracking: Transaction and line-item level discount data

• Date Range Filtering: Query transactions between specific dates (FromDt and ToDt parameters)
• Multiple Date Formats: Support for YYYY-MM-DD, DD-Mon-YYYY, and other common formats
• Location Filtering: Filter by specific POS locations or branches (LOCATION_CODE parameter)
• Real-time Access: Data available immediately after POS session closure

• Sales Tracking: Complete sales transaction details with invoice amounts
• Return Handling: Separate tracking and reporting of return transactions
• Receipt Information: Receipt numbers, dates, and timestamps
• Status Indicators: Clear SALE/RETURN transaction type indicators

1. Navigate to Settings → General Settings
2. Scroll to the Pathfinder Integra API section
3. Configure the following authentication settings:

Authentication Configuration

Option 1: Bearer Token Authentication (Recommended)
- Generate or set a secure Bearer Token
- This token will be used in the Authorization: Bearer <token> header
- Example: Authorization: Bearer abc123xyz456

Option 2: Basic Authentication
- Set a Username for API access
- Set a Password for API access
- Credentials will be used in the Authorization: Basic <base64(username:password)> header
- Example: Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=

4. Click Save to apply your settings

1. Navigate to Point of Sale → Configuration → Point of Sale
2. Select the POS configuration you want to expose via the API

3. In the Pathfinder Integra tab, you can configure:
   - Location codes for filtering
   - Any POS-specific API settings

4. Save the configuration

The main configuration screen where you set up authentication credentials for the Pathfinder Integra API. Choose between Bearer Token or Basic Authentication methods.

Point of Sale configuration screen showing how to configure location codes and POS-specific settings for API data export.

Example of the JSON format response returned by the API, showing transaction data including sales, line items, taxes, and payment information.

Example of the XML format response returned by the API, demonstrating the same comprehensive data structure in XML format for legacy system integration.

The module exposes a REST API endpoint at:

GET /api/integra/pos-data

Include one of the following authentication headers in your request:

Bearer Token:

Authorization: Bearer your_token_here

Basic Authentication:

Authorization: Basic base64(username:password)

• FromDt: Start date for transaction filtering
• Formats: YYYY-MM-DD, DD-Mon-YYYY, etc.

• Example: 2024-01-01 or 01-Jan-2024

• ToDt: End date for transaction filtering

• Formats: YYYY-MM-DD, DD-Mon-YYYY, etc.
• Example: 2024-01-31 or 31-Jan-2024

• LOCATION_CODE: Filter transactions by POS Config's location_id field
• Example: 12

JSON Format (default):

curl -X GET "https://your-odoo-instance.com/api/integra/pos-data?FromDt=2024-01-01&ToDt=2024-01-31&LOCATION_CODE=12" \
  -H "Authorization: Bearer your_token_here" \
  -H "Accept: application/json"

XML Format:

curl -X GET "https://your-odoo-instance.com/api/integra/pos-data?FromDt=2024-01-01&ToDt=2024-01-31" \
  -H "Authorization: Bearer your_token_here" \
  -H "Accept: application/xml"

Transaction Level Data

• Receipt number and details
• Transaction date and time
• Invoice amount and total tax
• Transaction type (SALE/RETURN)
• Currency information
• Discount amounts

Line Item Level Data

• Product code and name
• Product category
• Quantity and unit price
• Line total amounts
• Tax details per item

Payment Level Data

• Payment method type
• Tender amount
• Currency code
• Payment timestamp