📦 Acumatica Inventory Scanner

Scan barcodes, fetch live Acumatica inventory, and see per-warehouse stock—manual setup today, guided onboarding coming soon.

Developed by AcuPower LTD - Acumatica Implementation Experts

✨ Features

• 📷 Real-time Barcode Scanning - Fast camera-based barcode detection
• 🔍 Inventory Lookup - Instantly search and view stock item details
• 🔐 OAuth 2.0 Authentication - Secure API access to Acumatica
• 💾 Settings Persistence - Save credentials for quick re-login
• 🎨 Modern Dark Theme - Industrial-inspired UI design
• 📱 Cross-Platform - Works on Android and iOS

---

📋 Prerequisites

Before using this app, ensure you have:

1. Acumatica ERP Instance (version 20.2 or later)
2. User Account with API access permissions
3. OAuth Connected Application configured in Acumatica

---

🔧 Acumatica Configuration

Step 1: Create an OAuth Connected Application

The app requires OAuth credentials for secure API access. Follow these steps:

1. Navigate to Connected Applications

   • In Acumatica, go to: System → Integration → Connected Applications
   • Or use the screen ID: SM303010

   

2. Create New Application

   • Click the "+" button to create a new record
   • Fill in the following fields:

   | Field | Value | |-------|-------| | Client Name | InventoryScanner (or your preferred name) | | Active | ✅ Checked | | Flow | Resource Owner Password Credentials | | Plug-In | No Plug-In |

   

3. Add a Client Secret

   • Click "Add Shared Secret" in the Secrets tab
   • Enter a description (e.g., "Mobile App Secret")
   • ⚠️ IMPORTANT: Copy and save the generated secret value immediately!
     • The secret is only shown once and cannot be retrieved later
   • Click OK to add the secret

   

4. Save and Note Credentials

   • Press Ctrl+S to save
   • Note the following values:
     • Client ID (e.g., C6ECE655-8FE3-5C1F-C7C8-3309E724BA61@Company)
     • Client Secret (the value you copied in step 3)

   

---

Step 2: Find Your API Version

The app needs to know which API version your Acumatica instance supports:

1. Check Available Endpoints

   • Open your browser and navigate to:

     https://your-instance.acumatica.com/YourSite/entity
     

   • This returns a JSON list of available API endpoints

2. Note the Version

   • Look for entries with "name": "Default"
   • Common versions: 24.200.001, 23.200.001, 22.200.001
   • Use the latest version available for your instance

---

📱 App Configuration

First Launch Setup

1. Open the App

   • Launch the Acumatica Inventory Scanner on your device

2. Enter Connection Details

   | Field | Description | Example | |-------|-------------|---------| | Instance URL | Your Acumatica site URL | https://mycompany.acumatica.com/MySite | | Username | Your Acumatica username | admin | | Password | Your Acumatica password | **** | | Tenant | Optional - leave empty for single-tenant | | | API Version | From Step 2 above | 24.200.001 | | Client ID | OAuth Client ID from Step 1 | GUID@Company | | Client Secret | OAuth Secret from Step 1 | your-secret-key |

3. Test Connection

   • Tap "Test Connection" to verify settings
   • A green success message confirms API access

4. Save Settings

   • Tap "Save Settings" to persist for future use
   • Enable "Remember credentials" for auto-fill on next launch

---

🎯 Using the Scanner

Scanning Barcodes

1. Point camera at barcode - Position within the scanning frame
2. Hold steady - The red scanning line indicates detection area
3. Automatic detection - Barcode is recognized and searched automatically

Search Results

After scanning, the app displays:

• Item ID - Acumatica Inventory ID
• Description - Item description
• Availability - Current stock levels
• Warehouse Location - Where the item is stored

---

⚙️ Settings

Access settings anytime via the Settings tab:

Connection Settings

• Edit Acumatica URL and credentials
• Change API version
• Update OAuth credentials

App Preferences

• Play sound on scan - Audio feedback
• Vibrate on scan - Haptic feedback
• Auto-search after scan - Immediate lookup
• Remember credentials - Save login info

Reset

• Reset All Settings - Clear all saved data and start fresh

---

🔒 Security Notes

1. OAuth is Required - Cookie-based auth is not supported for REST API
2. Credentials Storage - Passwords are stored in platform-secure storage
3. Token Expiration - OAuth tokens expire after 1 hour; re-login if needed
4. HTTPS Only - Always use secure connections

---

🐛 Troubleshooting

"401 Unauthorized" Error

• OAuth credentials may be incorrect or expired
• Verify Client ID and Secret in Acumatica
• Check that the Connected Application is Active

"404 Not Found" Error

• API version mismatch
• The endpoint uses StockItem, not InventoryItem
• Try a different API version from the /entity endpoint

"Connection Failed"

• Check network connectivity
• Verify the instance URL is correct
• Ensure no VPN or firewall is blocking access

Scanner Not Detecting

• Ensure camera permissions are granted
• Hold device steady with good lighting
• Barcode must be within the scanning frame

---

🏷️ Barcode Generator Utility

This repository includes a Windows desktop application for generating test barcodes. Located in the BarcodeGenerator/ folder.

Features

• Generate multiple barcode formats
• Batch generation (semicolon-separated codes)
• Customizable dimensions
• Export to PNG, JPEG, BMP, or PDF
• Real-time preview

Supported Barcode Formats

| Format | Characters | Length Requirements | Best For | |--------|------------|---------------------|----------| | Code 128 | Alphanumeric + special | Any length | ✅ Inventory IDs (recommended) | | QR Code | Any text, URLs | Any length | URLs, long text | | Data Matrix | Any text | Any length | Small items, high density | | PDF417 | Any text | Any length | Documents, IDs | | EAN-13 | Digits only | 12-13 digits | Retail products (worldwide) | | EAN-8 | Digits only | 7-8 digits | Small retail products | | UPC-A | Digits only | 11-12 digits | Retail products (US/Canada) | | UPC-E | Digits only | 7-8 digits | Small packages (US) | | ITF | Digits only | Even number of digits | Shipping cartons | | Codabar | 0-9, A-D, -, $, :, /, ., + | Any length | Libraries, blood banks |

Barcode Format Rules

Alphanumeric Formats (Flexible)

Code 128 - Most versatile, recommended for Acumatica Inventory IDs

✅ AALEGO500
✅ ITEM-001-A
✅ Any alphanumeric string

QR Code / Data Matrix / PDF417 - Can encode any text

✅ https://acupowererp.com
✅ Long product descriptions
✅ Special characters: @#$%^&*

Numeric-Only Formats (Strict Rules)

EAN-13 (European Article Number)

✅ 5901234123457  (13 digits)
✅ 590123412345   (12 digits - checksum auto-added)
❌ AALEGO500      (letters not allowed)
❌ 12345          (too short)

EAN-8 (Short EAN)

✅ 96385074  (8 digits)
✅ 9638507   (7 digits - checksum auto-added)
❌ 123456789 (too long)

UPC-A (Universal Product Code - North America)

✅ 012345678905  (12 digits)
✅ 01234567890   (11 digits - checksum auto-added)
❌ 1234567890    (too short)

UPC-E (Compressed UPC)

✅ 01234565  (8 digits)
✅ 0123456   (7 digits - checksum auto-added)
❌ 012345678 (too long)

ITF (Interleaved 2 of 5)

✅ 1234567890  (10 digits - even count)
✅ 12345678    (8 digits - even count)
❌ 123456789   (9 digits - odd count not allowed)

Usage

1. Run the application: Open BarcodeGenerator.exe or build from source
2. Enter code(s): Type inventory IDs (use ; for multiple)

   AALEGO500; WIDGET001; PART-123
   

3. Select format: Choose barcode type from dropdown
4. Set dimensions: Adjust width/height (default: 300×150)
5. Generate: Click "Generate Barcode"
6. Save: Export as image (PNG/JPEG/BMP) or PDF

Integration with Mobile Scanner

Use the Barcode Generator to:

1. Create barcodes with your Acumatica Inventory IDs
2. Print them or display on screen
3. Scan with the mobile app to test the integration
4. Verify API connectivity and item lookup

Building from Source

cd BarcodeGenerator
dotnet build
dotnet run

Requirements: .NET 8.0, Windows

---

📞 Support

Created by AcuPower LTD

• 🌐 Website: acupowererp.com
• 📧 Email: support@acupowererp.com

---

📄 License

This project is licensed under the MIT License - a permissive open source license.

You are free to:

• ✅ Use commercially
• ✅ Modify
• ✅ Distribute
• ✅ Use privately
• ✅ Sublicense

See the LICENSE file for full details.

MIT License
Copyright (c) 2024-2026 AcuPower LTD (https://acupowererp.com)

---

🔄 Version History

| Version | Date | Changes | |---------|------|---------| | 1.0.0 | 2024 | Initial release with barcode scanning | | 1.1.0 | 2025 | Added OAuth support, Settings page | | 1.2.0 | 2026 | Modern UI redesign, persistent settings |