@adocommercekit/id
v1.3.0-0
Published
Indonesia market extensions for Adocommerce Kit
Readme
@adocommercekit/id
Indonesia market extensions for Adocommerce Kit: kode-unik payments, importer-only administrative regions, opt-in Indonesian address validation and typeahead routes, PMK 131/2024 PPN calculation and audit export, Biteship-aware COD payout reconciliation, UU PDP consent/rights/retention mechanisms with verified identity challenges and SLA deadlines, and reviewed-key regional catalogs.
Requirements
- Node.js 24+
- AdonisJS 7 and Lucid 22
@adocommercekit/core^1.1.0(install matching lockstep versions)
Install
pnpm add @adocommercekit/id
node ace configure @adocommercekit/id
node ace migration:runConfigure publishes portable regional/PDP/COD tables plus reviewable host-owned config, validator, controller, and route stubs. When @adocommercekit/admin is present, it also publishes the Indonesia regions and logistics console extension. Publication bases and @adocommercekit/id/upgrade keep later commerce:upgrade runs reviewable.
No copyrighted region rows are bundled. Import a host-licensed JSON source:
node ace commerce:id:regions-import --file ./data/indonesia-regions.jsonNotable capabilities
| Area | Entry points |
| --- | --- |
| Kode-unik | kodeUnik(), KodeUnikPaymentProvider, KodeUnikAdminService |
| Address / regions | validateIndonesiaAddress(), IndonesiaRegionService, IndonesiaRegionImporter |
| Tax | ppnCalculator(), PpnAuditService, PPN_REGULATION |
| COD / logistics | CodRemittanceImporter, IndonesiaLogisticsService, COD_REMITTANCE_SCHEMA, COD_RECONCILIATION_SCHEMA |
| PDP | ConsentReceiptService, PdpIdentityVerificationService, PdpRightsService, PdpRetentionService |
| Catalog | idIDCatalog, enRegionalCatalog |
| Config / upgrade | defineIdConfig(), @adocommercekit/id/upgrade |
kodeUnik() allocates visible codes 001–999 with a unique key on (receiving_account, code). ppnCalculator() records the statutory rate, DPP fraction and amount, rounding, price mode, category, and tax in adjustment metadata; PPnBM is not calculated.
Public entrypoints
| Import | Contents |
| --- | --- |
| @adocommercekit/id | Indonesia drivers, services, and helpers |
| @adocommercekit/id/configure | Adonis configure hook |
| @adocommercekit/id/commands | Ace commands (regions-import, ppn-audit, cod-import, …) |
| @adocommercekit/id/id_provider | Adonis service provider |
| @adocommercekit/id/upgrade | Publication upgrade artifacts |
Documentation
License
MIT
