🎹 Help & Documentation

Complete guide to using the Piano Inventory Management System

🚀 Getting Started

Welcome to Piano Inventory Management

This system helps you manage your piano inventory efficiently using Paddle CRM's powerful platform and API. Your system has been pre-configured and is ready to use. Follow these steps to get started:

  1. Access the Application
    Open the main application by clicking the "Back to App" button or navigating to index.html
  2. Verify System Status
    The system automatically checks connectivity with Paddle CRM on startup
  3. Start Managing Inventory
    Begin by searching for existing pianos or creating new records

System Requirements

🌐 Browser Requirements

  • Chrome 80+
  • Firefox 75+
  • Safari 13+
  • Edge 80+

📱 Device Support

  • Desktop computers
  • Tablets
  • Mobile phones
  • Touch-enabled devices

🔧 Technical Requirements

  • Internet connection
  • Paddle CRM account access
  • System administrator setup
  • Custom object configuration
💡 Pro Tip: Bookmark the main application page for quick access. You can also add it to your home screen on mobile devices for app-like access.

📖 User Guide

Searching for Pianos

How to Find Existing Piano Records

  1. Enter the piano's serial number in the search field
  2. Click the "Search" button or press Enter
  3. If found, the piano details will load in the form
  4. If not found, you can create a new record
💡 Tip: Serial numbers are unique identifiers. Make sure to enter them exactly as they appear on the piano.

Creating New Piano Records

Adding a New Piano to Your Inventory

  1. Search for a non-existent serial number
  2. Fill in the required information in the Basic Info tab
  3. Add pricing information in the Pricing & Costs tab
  4. Include flooring details if applicable
  5. Add any notes or memos
  6. Click "Create Piano" to save the record

Updating Piano Information

Modifying Existing Records

  1. Search for and load the piano you want to update
  2. Make changes to any fields across the tabs
  3. Click "Save Changes" to update the record
  4. Only changed fields will be sent to the API
⚠️ Important: The serial number field becomes read-only after a piano is created. This prevents accidental changes to the unique identifier.

Deleting Piano Records

Removing Pianos from Inventory

  1. Search for and load the piano you want to delete
  2. Click the "Delete Piano" button
  3. Confirm the deletion in the popup dialog
  4. The piano will be permanently removed from your inventory
⚠️ Warning: Deletion is permanent and cannot be undone. Make sure you want to delete the record before confirming.

Form Navigation

Using the Tabbed Interface

The form is organized into four tabs for easy navigation:

📋 Basic Info

Essential piano details including serial number, make, model, type, condition, and location.

💰 Pricing & Costs

All financial information including prices, payment details, and cost tracking.

🏢 Flooring

Flooring company information and financing arrangements.

📝 Notes & Memos

Additional notes, memos, and internal information about the piano.

✨ Features

Core Features

🔍 Smart Search

Quickly find pianos by serial number with intelligent search functionality.

📱 Responsive Design

Works seamlessly on desktop, tablet, and mobile devices.

💾 Auto-Save

Automatic calculation of totals and intelligent data formatting.

🔄 Real-time Updates

Instant synchronization with Paddle CRM database.

🛡️ Data Validation

Built-in validation to ensure data accuracy and consistency.

📊 Comprehensive Tracking

Track all aspects of piano inventory from acquisition to sale.

Advanced Features

🔧 Developer Mode

Press Ctrl+Shift+D to enable debug mode for troubleshooting.

📈 Auto-Calculations

Automatic calculation of total price + pack and other financial totals.

📅 Date Management

Easy date selection and automatic formatting for all date fields.

💱 Currency Handling

Proper formatting and handling of all monetary values.

Mobile Features

📱 Touch Optimized

Optimized for touch interactions on mobile devices.

⬆️ Floating Action Button

Quick scroll-to-top button for easy navigation on mobile.

⌨️ Mobile Keyboard

Optimized input fields that work well with mobile keyboards.

🔧 Troubleshooting

Common Issues and Solutions

❌ "API Key not configured" Error

Problem: The application cannot connect to Paddle CRM.

Solution:
  1. Contact your system administrator to verify API configuration
  2. Check your internet connection
  3. Try refreshing the page
  4. Contact Paddle CRM support if the issue persists

❌ "Custom object not found" Error

Problem: The system cannot access your piano custom object.

Solution:
  1. Contact your system administrator to verify custom object setup
  2. Check that all required fields are present in Paddle CRM
  3. Ensure your account has proper permissions
  4. Contact Paddle CRM support if issues persist

❌ Search Not Working

Problem: Piano searches return no results or errors.

Solution:
  1. Check your internet connection
  2. Verify the serial number is entered correctly
  3. Try using the debug search feature (Ctrl+Shift+D)
  4. Contact Paddle CRM support if the issue persists

❌ Form Not Saving

Problem: Changes are not being saved to the database.

Solution:
  1. Check that you have a valid serial number
  2. Ensure you're connected to the internet
  3. Try refreshing the page and trying again
  4. Check for validation errors in form fields

❌ Mobile Display Issues

Problem: The application doesn't look right on mobile devices.

Solution:
  1. Ensure you're using a modern mobile browser
  2. Try refreshing the page
  3. Check that JavaScript is enabled
  4. Try rotating your device to landscape mode

Debug Mode

Enable debug mode to get detailed information about system operations and errors:

  1. Press Ctrl+Shift+D (or Cmd+Shift+D on Mac)
  2. A red "DEV MODE" indicator will appear
  3. A "Debug" button will appear next to the search button
  4. Use the debug button to get detailed system response information
  5. Contact Paddle CRM support with any error details you see

Quick Test Tool

For advanced troubleshooting and system validation, you can access the Quick Test Tool:

🔧 Quick Test Tool: Open Quick Test Tool
This tool provides comprehensive testing capabilities for API connections, data operations, and system validation. Use it to verify your system configuration and troubleshoot complex issues.

The Quick Test Tool includes:

  • Configuration Tests: Verify API credentials and connection settings
  • Data Operation Tests: Test creating, searching, updating, and deleting piano records
  • Validation Tests: Check data formatting, currency handling, and date processing
  • Error Handling Tests: Test system response to various error conditions
  • Automated Test Suites: Run comprehensive test scenarios

Browser Console

To access the browser console for detailed error information:

  1. Press F12 to open developer tools
  2. Click on the "Console" tab
  3. Look for any red error messages
  4. Copy error messages and contact Paddle CRM support

❓ Frequently Asked Questions

How do I add a new piano to my inventory? +

To add a new piano, search for a serial number that doesn't exist in your system. The application will automatically switch to "create mode" and allow you to fill out all the piano details. Once complete, click "Create Piano" to save the record.

Can I edit the serial number after creating a piano? +

No, the serial number becomes read-only after a piano is created. This is to maintain data integrity and prevent accidental changes to the unique identifier. If you need to change a serial number, you would need to delete the old record and create a new one.

How do I search for pianos? +

Simply enter the piano's serial number in the search field at the top of the page and click "Search" or press Enter. The system will search your entire inventory and display the piano if found, or allow you to create a new record if not found.

What happens if I lose my internet connection? +

If you lose your internet connection while using the application, you'll see an error message. The application requires an active internet connection to communicate with the Paddle CRM API. Any unsaved changes will be lost, so it's important to save your work regularly.

How do I update piano information? +

Search for the piano you want to update, make your changes to any fields, and click "Save Changes." The system will only send the modified fields to the API, making updates efficient and reducing the chance of conflicts.

Can I use this on my mobile phone? +

Yes! The application is fully responsive and works great on mobile devices. You can access it through any modern mobile browser. The interface automatically adapts to smaller screens and includes touch-optimized controls.

How do I delete a piano record? +

Search for the piano you want to delete, then click the "Delete Piano" button. You'll be prompted to confirm the deletion. Be careful - this action is permanent and cannot be undone.

What if I make a mistake while entering data? +

You can always update piano information by searching for the piano and making corrections. If you haven't saved yet, you can use the "Clear Form" button to start over. The system also includes validation to help prevent common data entry errors.

How do I know if my changes were saved? +

After saving, you'll see a green success message confirming that your changes have been saved. If there's an error, you'll see a red error message explaining what went wrong. You can also verify changes by searching for the piano again.

Can I export my piano data? +

Currently, the application focuses on managing data within Paddle CRM. For data export, you would need to use Paddle CRM's built-in export features. Contact Paddle CRM support for bulk data operations and export capabilities.

🎥 Video Tutorials

Getting Started Videos

📹 Quick Start Guide

🎬 Video: "Getting Started with Piano Inventory Management"

Duration: 5 minutes

Learn the basics of searching, creating, and managing piano records.

📹 Advanced Features

🎬 Video: "Advanced Features and Tips"

Duration: 8 minutes

Discover advanced features like auto-calculations, data validation, and mobile optimization.

📹 Troubleshooting Guide

🎬 Video: "Common Issues and How to Fix Them"

Duration: 6 minutes

Learn how to resolve common problems and use debug mode effectively.

💡 Note: Video tutorials are planned for future updates. For now, refer to the written documentation and FAQ sections for detailed guidance.

📞 Contact Support

Need Help? We're Here to Assist!

If you can't find the answer to your question in this documentation, please don't hesitate to reach out to our support team.

📧 Email Support

support@paddlecrm.com

Response within 24 hours

📞 Phone Support

1-800-PADDLE-1

Mon-Fri 9AM-6PM EST

💬 Live Chat

Available on Paddle CRM website

Real-time assistance

📋 Technical Support

tech@paddlecrm.com

For system administrators

Before Contacting Support

To help us assist you more quickly, please have the following information ready:

  • Error Messages: Copy any error messages you see
  • Steps to Reproduce: Describe exactly what you were doing when the issue occurred
  • Browser Information: Which browser and version you're using
  • Device Information: Whether you're on desktop, tablet, or mobile
  • Screenshots: If possible, include screenshots of the issue
✅ Quick Self-Help: Try using the debug mode (Ctrl+Shift+D) before contacting support. Many issues can be resolved by checking your internet connection and refreshing the page. For technical issues, contact your system administrator.