Check Run

Enterprise payables management and check printing for ERPNext

Explore the docs »

Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Features
5. Contributing
6. License
7. Contact

About The Project

Check Run is a powerful ERPNext extension that provides payables-related utilities including a single-page payment mechanism, check printing, and bank-friendly reports for enterprise-grade payables management.

Key Features:

• Single-Page Payment Processing: Collect and process all outstanding payables for a company in one streamlined interface
• Professional Check Printing: Customizable check formats with voucher support
• ACH File Generation: Generate NACHA-compliant ACH files for electronic payments
• Bank-Friendly Reports: Positive Pay reports for fraud prevention and reconciliation
• Payment Scheduling: Support for complex payment terms and schedules
• Multi-Mode Payments: Support for checks, ACH, wire transfers, and more
• Returns Handling: Process debit notes and returns against purchase invoices
• Keyboard Navigation: Full keyboard shortcuts support for efficient data entry

The Check Run feature collects all outstanding payables for a given company and account head, defaulting to payables up to the current date (adjustable as needed). Users select invoices to pay and payment methods, then on submission, it creates payment entries and provides options for check printing and ACH file generation.

(back to top)

Built With

(back to top)

Getting Started

Check Run requires an existing ERPNext installation. For detailed installation instructions for both production and development environments, see our installation guide.

Prerequisites

• ERPNext Version 14
• Python 3.10+
• Node.js 16+
• Frappe Framework

Installation

1. Get the app from GitHub

   bench get-app check_run https://github.com/agritheory/check_run

2. Install the app to your site

   bench --site {{ site name }} install-app check_run

3. Configure your bank accounts and payment methods

   # See configuration guide for detailed setup

For complete development setup instructions, see our installation guide.

(back to top)

Usage

Quick Start

1. Search for "Check Run List" in the AwesomeBar
2. Click the Add Check Run button
3. In the dialogue box, select:
   • Company
   • Bank account (Paid From)
   • Payables account head
4. Review the returned list of outstanding payables
5. Check which invoices to pay and select payment methods for each
6. Use keyboard shortcuts for efficiency:
   • Arrow keys to navigate rows
   • Spacebar to select/deselect payments
   • Type letters to auto-complete Mode of Payment
7. Submit and choose to print checks or generate ACH files

Example Workflow

# Optional: Install demo data to test functionality
bench execute 'check_run.tests.setup.before_test'

For detailed examples and configuration, please refer to the Documentation or visit the official Check Run documentation

(back to top)

Features

• Single-Page Payment Processing - Process multiple payables in one streamlined operation
• Professional Check Printing - Customizable check formats with voucher support
• ACH File Generation - NACHA-compliant electronic payments
• Bank-Friendly Reports - Positive Pay reports for fraud prevention
• Payment Scheduling - Support for complex payment terms and schedules
• Returns Handling - Process debit notes against purchase invoices
• Keyboard Navigation - Full keyboard shortcuts for efficient data entry
• Multi-Currency Support - Handle international payments
• Approval Workflows - Configurable approval processes

See the official documentation or local docs for complete details.

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Development Setup

# Install pre-commit hooks
pre-commit install

# Run type checking
source env/bin/activate
mypy ./apps/check_run/check_run --ignore-missing-imports

(back to top)

License

Distributed under the MIT License. See license.txt for more information.

(back to top)

Contact

Want to reach out? - Contact Us

AgriTheory - @agritheory

Repo: https://github.com/agritheory/check_run

(back to top)