Import letter of credit management for ERPNext v16—from purchase order to landed cost.
ERPNext manages purchase orders, receipts, invoices and accounting. Import LC adds the documentary-credit record between those steps, so teams can keep commercial terms, bank fields and landed-cost inputs together instead of rebuilding the same information across spreadsheets and files.
Scope: Import LC records and maps LC data inside ERPNext. It does not connect to a bank, transmit SWIFT messages or replace bank approval and document-checking procedures.
Purchase Order
│
▼
Import Proforma Invoice
│
▼
Import LC ─────► Journal Entry for LC margin or expense
│
├────────► Purchase Invoice
└────────► Purchase Receipt ─────► Landed Cost Voucher
| Task | How Import LC helps |
|---|---|
| Start from approved purchasing data | Create an Import Proforma Invoice from a Purchase Order and carry forward items, currency and commercial details. |
| Maintain the documentary credit | Record the Import LC with applicant, beneficiary, bank, value, dates, tolerance and shipment/document terms. |
| Post finance entries | Prepare Journal Entries for LC margin and LC-related expenses from the Import LC. |
| Continue procurement | Create a Purchase Invoice or Purchase Receipt from the Import LC instead of re-entering the transaction. |
| Build landed cost | Create a Landed Cost Voucher using submitted Purchase Receipts plus freight, insurance and LC-related charges. |
| Review activity visually | Use the Import LC workspace, shortcuts and progress chart for a faster operational view. |
The Import LC form includes commonly used documentary-credit fields such as reference number (F20), issue and expiry dates (F31C/F31D), credit form (F40A/F40E), applicant and beneficiary (F50/F59), tolerance (F39A), partial shipment and transshipment (F43P/F43T), latest shipment date (F44C), goods and documents (F45A/F46A), additional conditions (F47A), charges (F71D) and instructions (F78).
These fields help structure LC information; they do not claim automatic SWIFT MT700 generation or transmission.
| Import Proforma Invoice | Import LC record |
|---|---|
 |
 |
| Use case | Choose this app |
|---|---|
| You open an LC to buy goods, materials or machinery from a supplier | Import LC THIS REPOSITORY |
| A buyer opens an LC in your favour and you ship against it | Explore Export LC → |
Businesses that handle both directions can install both apps. In the current version-16 repositories, the apps manage their respective workflows; they do not automatically create a master export LC/back-to-back import LC relationship across apps.
The simplest setup for managed installations.
Use an existing Frappe/ERPNext v16 bench:
bench get-app https://github.com/invento-software-limited/import-lc.git --branch version-16
bench --site your-site.example install-app import_lc
bench --site your-site.example migrate
bench build --app import_lcAfter installation, open Import LC from the ERPNext app switcher. Setting up a new bench or site? Start with the official Frappe installation guide.
- Frappe and ERPNext: v16 (
>=16.0.0-dev, <17.0.0-dev) - Runtime: Python 3.10 or newer · App branch:
version-16
Read the user guide → · View the product overview → · Browse all documentation →
Need help? Open a reproducible issue.
When reporting a problem, include your Frappe and ERPNext versions, the affected document type, steps to reproduce and a redacted screenshot where useful. Never include LC numbers, bank credentials or confidential trade documents in a public issue.
Contributions are welcome. Install the repository's pre-commit hooks before opening a pull request:
cd apps/import_lc
pre-commit install
pre-commit run --all-filesThe project uses Ruff, ESLint, Prettier and Semgrep alongside its CI checks.
Built and maintained by Invento Software Limited, an ERPNext partner in Bangladesh.
MIT. See license.txt.