ERPNext Digital Signature Integration
Digitally sign Sales Orders, Invoices, Purchase Orders using a visible PFX certificate signature.
⚠️ Problem Statement
In many ERPNext implementations, signing documents like Sales Orders, Invoices, or Purchase Orders digitally is a manual, multi-step process:
- Download PDF from ERPNext manually
- Open the document in a third-party tool like Adobe Acrobat, eSigner, or DSC software
- Apply digital signature using USB token or PFX file
- Save and re-upload the signed PDF back into ERPNext
This process is:
- Time-consuming and inefficient
- Prone to human error
- Not auditable or tracked within the ERP system
- Not scalable for organizations with high document volume
✅ Our Solution
This app eliminates that problem by enabling automated and visible digital signatures inside ERPNext:
- One-click digital signing using `.pfx` file
- Signature placement via coordinate selection
- Signed PDF automatically replaces the original and is attached to the document
- Full signing process is tracked inside ERPNext
What is a PFX File?
A PFX file (also called PKCS#12 file) is a binary file format used to store a certificate (public key) along with its private key and optionally a chain of trusted certificates. It's commonly used to import and export certificates and private keys securely. Full form: Personal Information Exchange Purpose: Securely bundle private key and certificate(s) in one file Use cases: SSL/TLS certificates, code signing, email encryption, and digital signatures.
How to Obtain a PFX File?
- From a Certificate Authority (CA):
When you purchase an SSL certificate or a digital signing certificate, the CA usually provides a .pfx file after you complete the validation process.
Intended usage PFX: Sign transaction, Sign document, Client Authentication, 1.3.6.1.4.1.311.10.3.12, 1.3.6.1.4.1.311.20.2.2, Acrobat Authentic Documents.
🔧 Features
- Digitally sign submitted Sales Order, Sales Invoices, Purchase Order, and Purchase Invoice using your `.pfx` certificate
- Choose the exact signature position by clicking on a PDF preview
- Automatically attaches the signed PDF to the respective Sales Order, Sales Invoices, Purchase Order, and Purchase Invoice.
- Supports visible signatures on any page
- Secure password input for PFX files
- Intended usage PFX: Sign transaction, Sign document, Client Authentication, 1.3.6.1.4.1.311.10.3.12, 1.3.6.1.4.1.311.20.2.2, Acrobat Authentic Documents etc.
✅ Version Compatibility
| ERPNext Version | Frappe Version | Compatibility |
|---|---|---|
| v14.x | v14.x | ✅ Fully Compatible |
| v15.x | v15.x | ✅ Fully Compatible |
⚙️ Setup Instructions
🔧 Document Sign Setting Configuration
To use digital signing, configure the Document Sign Setting in ERPNext:
- Go to "Document Sign Setting" via the awesome bar
- Fill in the following fields:
| Field | Description |
|---|---|
| ✅ PFX File Use | Enable this if you're using a `.pfx` file for signing |
| PFX File | Upload your `.pfx` certificate file (stored in `private/files/`) |
| DSC Password | Password for your `.pfx` file |
| Sign Address | Your signing location (e.g., Pune Maharashtra, India) |
| URL | The server URL that signs the PDF (e.g., `https://your-site.frappe.cloud/app`) |
| Location | Coordinates for signature in format `(x1, y1, x2, y2)` Example: `(345, 50, 545, 100)` |
🔍 Signature Placement Preview
Sample Signature on Sales Invoice
Sample Signature validity on Sales Invoice
Digital Signature: How It Works - Demo
Professional Tax Calculation State Wise
This app enables automated Professional Tax calculation in Salary Slip based on custom formulas defined at the state level.
🔧 Features
- Define tax slabs per state using Python-style formulas
- Works with both manual and Payroll Entry-generated Salary Slips
- Automatically injects a State field in the Employee Doctype
- No dependency on India Compliance — lightweight & standalone
✅ Version Compatibility
| ERPNext Version | Frappe Version | Compatibility |
|---|---|---|
| v14.x | v14.x | ✅ Fully Compatible |
| v15.x | v15.x | ✅ Fully Compatible |