Skip to main content
Bangladesh VAT Compliance (Mushak) — A build-to-order ERPNext app that automates NBR Bangladesh VAT compliance — Mushak 6 — 1/1Illustrative preview

A build-to-order ERPNext app that automates NBR Bangladesh VAT compliance

— Mushak 6.3 challan generation, Mushak 9.1 return reports, VAT/SD tax templates, and bilingual Bangla/English invoicing.

ECOSIRE scopes, builds, installs, and supports it for your bench.

What is Bangladesh VAT Compliance (Mushak)?

A build-to-order ERPNext app that automates NBR Bangladesh VAT compliance — Mushak 6.3 challan generation, Mushak 9.1 return reports, VAT/SD tax templates, and bilingual Bangla/English invoicing. ECOSIRE scopes, builds, installs, and supports it for your bench. Built to order by ECOSIRE for ERPNext v15, v16 — indicative price from $999.00 USD; request a quote for a scoped proposal.

Key Features

Mushak 6.3 tax challan (challanpatra) as a dedicated Frappe DocType with NBR reference numbering via a gapless naming series
Mushak 9.1 VAT return generated as a Query Report reconciling output VAT, input VAT rebate, and net payable per return period
VAT and Supplementary Duty (SD) tax templates wired to your chart of accounts, item tax categories, and item tax templates
hooks.py doc events (on_submit / on_cancel / validate) auto-create and reverse the 6.3 challan from the Sales Invoice lifecycle
Bilingual Bangla/English print formats rendered from a single submitted invoice via Jinja print format and translatable labels
Withholding VAT (VDS) capture at source with deducted-VAT accounting entries and supplier VDS certificate output
Server-side controller methods for VAT/SD computation and NBR rounding rules, kept out of fragile UI logic
Client scripts for in-form validation — BIN capture, rate selection, and blocking submit on incomplete VAT data
Whitelisted REST API methods so POS, e-commerce, or external billing can post transactions and read challan data
Sales register and purchase register Query Reports filtered by NBR return period for return preparation and audit trail
Scheduler event that assembles period-end return figures and flags output-VAT vs challan-issued mismatches before filing
Role profiles and permission rules controlling who can raise, submit, and cancel VAT documents
BIN (Business Identification Number) fields on Company and Customer/Supplier with validation for NBR document headers
Debit/credit note handling that issues the corresponding Mushak adjustment documents and reverses VAT correctly

Built to order, done for you

No DIY setup — a working app, built, installed and supported by ECOSIRE.

  1. 1

    You order

    Start with a one-time build price. We scope it with you at kickoff.

  2. 2

    We build & install

    ECOSIRE builds, configures and installs it on your ERPNext.

  3. 3

    Go live + support

    You go live in about one working week, with two weeks of go-live support. Defects in the code we deliver are fixed free of charge.

Technical Specifications

ERPNext Compatibility
—
License
Licence confirmation required
Python Requirement
Python 3.10+
Database
MariaDB 10.6+

About this Product

Bangladeshi finance teams running ERPNext hit the same wall every month: the National Board of Revenue (NBR) expects VAT documents in prescribed Mushak formats — the Mushak 6.3 tax challan (challanpatra), the Mushak 9.1 VAT return, purchase and sales registers, and withholding (VDS) certificates — and stock ERPNext knows nothing about any of them. Out of the box you get generic Sales Taxes and Charges templates and a plain Sales Invoice print format; you do not get an NBR-numbered 6.3 challan, you do not get a return that ties output and input VAT to the return period, and you certainly do not get the Bangla/English bilingual layout the VAT circle expects. Teams paper over the gap with parallel Excel workbooks, manual re-keying, and hand-drawn print formats that drift out of compliance whenever a circular changes.

ECOSIRE builds a dedicated Frappe app — a proper installable app with its own module, not a pile of loose customizations — that makes ERPNext speak NBR VAT natively. We add DocTypes for the Mushak 6.3 challan and the Mushak 9.1 return, each with the fields, child tables, and NBR reference numbering the format requires, plus VAT/SD (supplementary duty) tax templates wired to your chart of accounts and item tax categories. Document generation is driven by hooks.py doc events (on_submit, on_cancel, validate) so that submitting a Sales Invoice can create or update the corresponding 6.3 challan automatically, and a naming series keeps challan numbers gapless and auditable. Bilingual print formats render the same invoice in Bangla and English from one submitted record, and withholding-VAT logic captures deducted VAT at source with the certificate output your suppliers and the VAT authority need.

Under the hood the app uses the patterns a senior Frappe engineer would expect: server scripts and Python controller methods for the tax and rounding math, client scripts for in-form validation and field automation, whitelisted methods exposed over the Frappe REST API so a POS or external billing system can post transactions and pull challan data, and Query Reports (with optional Report Builder views) for the Mushak 9.1 return, sales register, and purchase register filtered by return period. Role profiles and permission rules scope who can raise, submit, and cancel VAT documents; scheduler events can assemble period-end return figures and flag mismatches between output VAT booked and challans issued before you file. Everything targets ERPNext and Frappe v15 and v16 and is delivered as versioned source you own.

Because this is build-to-order, nothing ships until we agree on scope. We start with a short scoping call to confirm your NBR return cadence, VAT/SD rates, VDS scenarios, and which documents you actually file, then build against your requirements, run UAT on a staging bench, and install on your production bench with a rollback plan. Typical delivery is one working week from confirmed scope. You receive the Git repository, installable source, technical and user documentation, a training session, and a post-go-live support window — so your finance officer owns a compliant, maintainable ERPNext, not a black box.

What you get

  • Installable source code for your version of the app, packaged as a proper Frappe app with its own module
  • Installation and configuration on your ERPNext bench (staging and production), including tax templates and naming series
  • Technical documentation — DocType schemas, hooks, whitelisted API methods, and configuration reference
  • User guide plus a live training session for your finance team on raising challans and preparing the 9.1 return
  • Post-go-live support window for defect fixes and configuration questions
  • UAT on a staging bench with sign-off, plus a documented rollback plan for the production install
  • Handover of the Git repository so you own and can maintain or extend the codebase
  • Sample data and test cases covering standard VAT, SD, and withholding-VAT scenarios

Who this is for

NBR VAT & Mushak finance officer

Owns monthly VAT filing and needs Mushak 6.3 challans and the 9.1 return produced directly from ERPNext transactions, without maintaining a shadow Excel workbook or re-keying figures the night before the deadline.

Finance manager / controller at a Bangladeshi SME

Wants output VAT, input rebate, and VDS to reconcile automatically against issued challans, with an audit trail and role-based controls over who can submit or cancel VAT documents before filing.

ERPNext administrator / bench maintainer

Runs the company's Frappe/ERPNext v15/v16 bench and needs a clean installable app with documented DocTypes, hooks, and API methods — not ad-hoc customizations that break on the next migrate or upgrade.

Bangla-market distributor or manufacturer with SD liability

Deals in supplementary-duty goods and bilingual invoicing, and needs SD-aware tax templates plus Bangla/English challans that satisfy the local VAT circle and trading partners.

How Bangladesh VAT Compliance (Mushak) Compares

CriterionECOSIRECustom BuildCompetitorERPNext Native
Mushak 6.3 / 9.1 documentsPurpose-built DocTypes and reports for the NBR formats you filePossible, but you design the formats and numbering from scratchOften a subset — challan only, or a generic templateNone — only generic tax rows and a plain invoice print
Withholding VAT (VDS)Deduction-at-source logic plus VDS certificate outputBuilt only if you specify and fund itRarely covered end-to-endNot modeled at all
Bilingual Bangla/English invoicingBoth languages from one submitted record via Jinja print formatHand-built print format you maintain yourselfUsually English-only or partial BanglaSingle-language generic print format
Fit to your NBR workflowScoped to your rates, SD categories, and return cadenceFully bespoke but slow and expensive to buildGeneric — you bend your process to the appNo VAT-specific workflow
Upgrade & migrate safetyProper Frappe app, tested on v15/v16, staging UAT firstDepends entirely on your team's disciplineVaries by vendor; may lag ERPNext releasesCore-safe but simply lacks the features
Source & ownershipFull Git repo and installable source handed overYou own it, but you also built and must maintain itOften closed-source or licensed, not ownedN/A
Delivery timeone working week from confirmed scopeMonths of in-house effort and iterationInstant install, but gaps surface laterImmediate, because there is nothing VAT-specific
Support after go-liveDefined post-go-live support window plus optional updatesOnly your internal teamGeneric vendor support, if anyCommunity forums only

Frequently Asked Questions about Bangladesh VAT Compliance

Is this an existing app I can download and install today?

No. This is a build-to-order engagement. ECOSIRE scopes, builds, installs, and supports the app for your specific NBR filing needs and ERPNext setup — there is no instant download. You receive the source and Git repository at handover, so you own what we build.

How long does delivery take?

Typical delivery is one working week from confirmed scope. The clock starts once we finish the scoping call and agree on your VAT/SD rates, VDS scenarios, return cadence, and the exact Mushak documents you file. Larger scopes (many SD categories, external POS integrations) can extend this, and we tell you before we start.

Which ERPNext and Frappe versions are supported?

We target and test against Frappe/ERPNext v15 and v16. During scoping we confirm your exact bench version and whether you are self-hosted or on Frappe Cloud, and we build the app to install cleanly on that environment via bench get-app / install-app.

Does it handle the Mushak 9.1 return and withholding VAT (VDS), or only challans?

Both. Beyond the Mushak 6.3 challan, the app produces the Mushak 9.1 return as a period-filtered report reconciling output and input VAT, and it captures withholding VAT deducted at source with the corresponding accounting entries and VDS certificate output. Exactly which documents we implement is fixed in the scoping call.

What about support and updates after go-live?

Every engagement includes a post-go-live support window for defect fixes and configuration questions. Because you receive the Git repository and installable source, your own team can also maintain and extend it. If NBR changes a format or you upgrade ERPNext major versions, we can quote a follow-on update engagement.

Will it break when I run bench migrate or upgrade ERPNext?

We deliver a proper Frappe app with its own DocTypes, fixtures, and hooks — not loose in-site customizations — precisely so it survives migrate and version upgrades. We run UAT on a staging bench first and provide a rollback plan before touching production.

Can our POS or external billing system post transactions into it?

Yes. We expose whitelisted methods over the Frappe REST API so a POS, e-commerce store, or external billing system can post transactions and read challan data. The specific endpoints and payloads are defined during scoping to match your integration.

Request a quote

Bangladesh VAT Compliance

A build-to-order ERPNext app that automates NBR Bangladesh VAT compliance — Mushak 6.3 challan generation, Mushak 9.1 return reports, VAT/SD tax templates, and bilingual Bangla/English invoicing. ECOSIRE scopes, builds, installs, and supports it for your bench.

  • Mushak 6.3 tax challan (challanpatra) as a dedicated Frappe DocType with NBR reference numbering via a gapless naming series
  • Mushak 9.1 VAT return generated as a Query Report reconciling output VAT, input VAT rebate, and net payable per return period
  • VAT and Supplementary Duty (SD) tax templates wired to your chart of accounts, item tax categories, and item tax templates
  • hooks.py doc events (on_submit / on_cancel / validate) auto-create and reverse the 6.3 challan from the Sales Invoice lifecycle

Request a Quotation

Tell us about your Bangladesh VAT Compliance requirements and we'll send pricing, licensing options and a tailored proposal — usually within one business day.

No payment now. This sends a quote request to our team — we'll follow up by email with pricing and next steps.