bench get-app https://github.com/sagarrgarg/business_needed_solutions

[![Listed on Frappe Gems](https://frappegems.com/api/method/frappe_gems.seo.badge?app=sagarrgarg%2Fbusiness_needed_solutions)](https://frappegems.com/gems/apps/sagarrgarg/business_needed_solutions)

Business Needed Solutions (BNS) - Enterprise Business Management Suite

🏢 Transform Your ERPNext Experience

Business Needed Solutions is a comprehensive enterprise-grade application that enhances ERPNext with advanced business controls, compliance features, and professional printing capabilities. Designed specifically for Indian businesses and organizations requiring sophisticated workflow management.

---

🚀 Key Features

📋 Document Submission Control

• Centralized Permission Management: Control who can submit critical documents across your organization
• Smart Categorization: Automatically categorizes documents into Stock, Transaction, and Order types
• Role-Based Overrides: Grant specific roles permission to bypass restrictions
• Audit Trail: Complete tracking of all submission activities

🏦 Indian Business Compliance

• PAN Uniqueness Validation: Ensure unique PAN numbers across customers and suppliers
• GST Compliance: Built-in GST validation and reporting features
• e-Invoice Integration: Seamless integration with e-invoice and e-waybill systems
• Tax Calculation: Advanced tax calculation and reporting

🖨️ Professional Print Formats

• Dynamic Print Templates: Configurable print formats for all document types
• Company Branding: Automatic inclusion of company logos and branding
• Bank Details: Default bank account information on all invoices
• Multi-Copy Support: Generate multiple invoice copies with different formats
• Direct Printing: One-click printing with keyboard shortcuts

🔄 Internal Transfer Management

• Inter-Company Transfers: Seamless internal customer/supplier management
• Automatic Document Creation: Generate Purchase Receipts from Delivery Notes
• GST Validation: Automatic GSTIN comparison and validation
• Status Tracking: Real-time status updates for internal transfers

📊 Advanced Reporting

• Custom Reports: Specialized reports for various business needs
• Almonds Sorting Report: Industry-specific reporting for food processing
• Financial Reports: Enhanced financial reporting capabilities
• Compliance Reports: Built-in compliance and audit reports

---

🛠️ Getting Started

Installation

1. Install the app in your ERPNext environment
2. Run the migration script
3. Configure BNS Settings
4. Set up your print formats

Initial Configuration

1. Navigate to BNS Settings in your ERPNext desk
2. Configure your business preferences
3. Set up print format mappings
4. Configure submission restrictions
5. Set up validation rules

---

📄 Print Format Features

Available Print Formats

1. Sales Invoice Formats

• BNS SI Dynamic V1: Professional sales invoice with e-invoice support
• Features:
  • Company logo and branding
  • Bank account details
  • GST summary tables
  • e-Invoice QR codes
  • Multiple copy support
  • Payment terms display

2. Delivery Note Formats

• BNS DN Dynamic V1: Comprehensive delivery note format
• Features:
  • Vehicle and transporter details
  • e-Waybill integration
  • Shipping and dispatch information
  • Terms of delivery
  • Professional layout

3. Purchase Order Formats

• BNS PO Dynamic V1: Professional purchase order format
• BNS PO V1: Standard purchase order format
• Features:
  • Supplier information
  • Delivery terms
  • Payment terms
  • Professional branding

4. Sales Order Formats

• BNS SO Dynamic V1: Professional sales order format
• Features:
  • Customer information
  • Delivery schedules
  • Professional layout
  • Company branding

Print Format Configuration

Setting Up Company Logo

1. Upload Logo: Go to Company settings
2. Add Logo: Upload your company logo (recommended size: 200x200px)
3. Logo Field: Set the logo in the "Logo for Printing" field
4. Automatic Display: Logo will automatically appear on all print formats

Configuring Bank Details

1. Bank Account Setup: Create bank accounts in Chart of Accounts
2. Default Account: Mark one account as default for the company
3. Account Information: Fill in complete bank details:
   • Account name
   • Bank name
   • Account number
   • IFSC code
   • Branch details
4. Automatic Display: Bank details appear on all invoices

Print Format Settings

1. BNS Settings: Navigate to BNS Settings
2. Print Format Tab: Go to the Print Options tab
3. Format Mapping: Map document types to specific print formats
4. Rate Display: Configure rate display options:
   • Rate (Incl Tax)
   • Rate (Excl Tax)
   • Secondary rate display
5. Discount Configuration: Set up discount display options

Advanced Print Features

Rate Display Options

• Inclusive Tax: Show rates including tax
• Exclusive Tax: Show rates excluding tax
• Secondary Rates: Display additional rate information
• UOM Conversion: Show rates in different units of measurement
• Weight-based Rates: Display rates per kilogram

Discount Management

• Single Discount: Standard single discount percentage
• Triple Compounded: Advanced triple discount system
• Automatic Calculation: Automatic discount calculations
• Field Visibility: Dynamic field showing/hiding

Document Copy Support

• Multiple Copies: Generate different invoice copies
• Copy Types: Original, Duplicate, Triplicate, etc.
• Format Variations: Different formats for different copies
• Automatic Labeling: Automatic copy labeling

---

🔧 Configuration Guide

BNS Settings Configuration

1. General Settings

• Discount Type: Choose between Single or Triple Compounded discounts
• PAN Uniqueness: Enable/disable PAN uniqueness validation
• Stock Update Validation: Control stock update requirements

2. Submission Control

• Restrict Document Submission: Enable global submission restrictions
• Override Roles: Assign roles that can bypass restrictions
• Document Categories: Automatic categorization of documents

3. Print Options

• Rate Display: Configure how rates are displayed
• Print Format Mapping: Map document types to print formats
• Secondary Rate Display: Configure additional rate information

4. Validation Settings

• Expense Account Validation: Require expense accounts for non-stock items
• Stock Reference Validation: Validate stock references when updates disabled

Document Submission Control

How It Works

1. Enable Restriction: Check "Restrict Document Submission" in BNS Settings
2. Assign Override Roles: Add roles that can submit documents
3. Automatic Enforcement: System automatically restricts submissions
4. Role-Based Access: Only assigned roles can submit documents

Document Categories

• Stock Documents: Stock Entry, Stock Reconciliation, etc.
• Transaction Documents: Sales Invoice, Purchase Invoice, etc.
• Order Documents: Sales Order, Purchase Order, etc.

Override Permissions

• System Manager: Always has override permissions
• Custom Roles: Assign specific roles for override
• Granular Control: Fine-tune permissions by document type

Internal Transfer Setup

Customer/Supplier Configuration

1. Internal Customer: Create customer with "Is Internal Customer" checked
2. Company Assignment: Assign the company the customer represents
3. GSTIN Setup: Configure GSTIN for internal transfers
4. Address Configuration: Set up proper addresses for transfers

Transfer Process

1. Create Delivery Note: Create delivery note for internal customer
2. Generate Purchase Receipt: Use "Create Purchase Receipt" button
3. Automatic Mapping: System automatically maps all details
4. Status Updates: Automatic status updates for both documents

---

📊 Reports and Analytics

Available Reports

1. Almonds Sorting Report

• Purpose: Track sorting and processing activities
• Features:
  • Batch-wise tracking
  • Quality metrics
  • Processing efficiency
  • Cost analysis

2. Financial Reports

• Bank GL Report: Comprehensive bank ledger reports
• Party GL Report: Customer and supplier ledger reports
• Accounts Payable Summary: Enhanced payable reporting
• Accounts Receivable Summary: Enhanced receivable reporting

3. Compliance Reports

• PAN Validation Report: Track PAN uniqueness compliance
• GST Compliance Report: GST-related compliance reporting
• Document Submission Report: Track submission activities

Report Configuration

1. Access Reports: Navigate to Reports section
2. Select Report: Choose the required report
3. Set Filters: Configure report filters and parameters
4. Generate Report: Generate and export reports

---

🔒 Security and Compliance

Data Security

• Role-Based Access: Granular permission control
• Audit Trail: Complete activity logging
• Data Validation: Multiple validation layers
• Secure Storage: Encrypted data storage

Compliance Features

• Indian Tax Compliance: Built-in GST and tax compliance
• PAN Validation: Automatic PAN uniqueness checking
• Document Control: Submission restriction and approval workflows
• Audit Support: Comprehensive audit trail and reporting

---

🎯 Use Cases

Manufacturing Companies

• Internal Transfers: Manage inter-department transfers
• Quality Control: Track sorting and processing activities
• Compliance: Ensure tax and regulatory compliance
• Document Control: Control critical document submissions

Trading Companies

• Customer Management: Advanced customer validation
• Supplier Management: Supplier compliance tracking
• Document Control: Submission approval workflows
• Professional Printing: Branded invoice and document formats

Service Companies

• Project Management: Internal project transfers
• Client Management: Advanced client validation
• Document Control: Submission restriction and approval
• Professional Branding: Company-branded documents

---

📞 Support and Contact

Technical Support

• Email: sagar1ratan1garg1@gmail.com
• Documentation: Comprehensive user guides and tutorials
• Training: Available training sessions and workshops

Commercial Licensing

• License Types: Available for different business sizes
• Pricing: Contact for pricing information
• Customization: Available custom development services

---

📋 System Requirements

ERPNext Version

• Minimum: ERPNext 15.0
• Recommended: Latest ERPNext version
• Compatibility: Compatible with most ERPNext configurations

Browser Requirements

• Chrome: Version 90+
• Firefox: Version 88+
• Safari: Version 14+
• Edge: Version 90+

---

🔄 Updates and Maintenance

Regular Updates

• Feature Updates: Regular new feature releases
• Bug Fixes: Continuous bug fix and improvement updates
• Security Updates: Regular security patches and updates
• Compliance Updates: Updates for changing regulations

Maintenance Support

• Technical Support: Available technical support
• Customization: Custom development services
• Training: User training and workshops
• Consulting: Business process consulting

---

Transform your ERPNext experience with Business Needed Solutions - The complete enterprise business management suite for modern organizations.

For commercial licensing and support, contact: sagar1ratan1garg1@gmail.com