PHPackages devtally/tally-xml - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Parsing & Serialization](/categories/parsing) 4. / 5. devtally/tally-xml ActiveLibrary[Parsing & Serialization](/categories/parsing) devtally/tally-xml ================== Convert JSON data to Tally-compatible XML for direct import into Tally v1.0.0(5mo ago)02MITPHPPHP ^7.4|^8.0 Since Dec 1Pushed 5mo agoCompare [ Source](https://github.com/Vanan2610/tally-xml)[ Packagist](https://packagist.org/packages/devtally/tally-xml)[ RSS](/packages/devtally-tally-xml/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (1)Dependencies (1)Versions (2)Used By (0) Tally XML Converter =================== [](#tally-xml-converter) [![License: MIT](https://camo.githubusercontent.com/fdf2982b9f5d7489dcf44570e714e3a15fce6253e0cc6b5aa61a075aac2ff71b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d79656c6c6f772e737667)](https://opensource.org/licenses/MIT) Convert JSON data to Tally-compatible XML for direct import into Tally ERP. Comprehensive support for vouchers, master data, GST, inventory, and more. Installation ------------ [](#installation) Install via Composer: ``` composer require devtally/tally-xml ``` Features -------- [](#features) - 🔄 **JSON to Tally XML Conversion** - Direct conversion from your JSON data - 📝 **Fluent Builder Pattern** - Easy, readable code with method chaining - 💼 **Master Data Support** - Create ledgers, stock items, and units - 📊 **Complete Voucher Support** - Sales, Purchase, Payment, Receipt, Returns - 💰 **GST Ready** - Full GST support with automatic CGST/SGST/IGST handling - 📦 **Inventory Management** - Stock items with batch allocation - ✅ **Well Tested** - Comprehensive test suite - 🎯 **Simple API** - Intuitive and easy to use Quick Start ----------- [](#quick-start) ### Convert JSON to Tally XML [](#convert-json-to-tally-xml) The easiest way to get started is using the JSON converters: ``` use Devtally\TallyXml\Converters\JsonToVoucherConverter; $json = [ 'company_name' => 'My Company Ltd', 'voucher' => [ 'voucher_type' => 'Sale', 'voucher_number' => 'INV-001', 'voucher_date' => '2023-12-01', 'ledger_name' => 'Customer Name', 'narration' => 'Sale of goods', 'total' => 11800, 'voucher_items' => [ [ 'ledger_name' => 'Sales Account', 'stock_item_name' => 'Product A', 'unit' => 'Nos', 'price' => 1000, 'qty' => 10, 'discount' => 0 ] ], 'tax_details' => [ ['name' => 'CGST @ 9%', 'amount' => 900], ['name' => 'SGST @ 9%', 'amount' => 900] ], 'additional_charges' => [], 'round_off' => ['name' => 'Round Off', 'amount' => 0] ] ]; $converter = new JsonToVoucherConverter(); $xml = $converter->convert($json); // Save or send to Tally file_put_contents('voucher.xml', $xml); ``` Usage Guide ----------- [](#usage-guide) ### 1. Master Data - Create Ledgers [](#1-master-data---create-ledgers) ``` use Devtally\TallyXml\Builders\LedgerBuilder; use Devtally\TallyXml\TallyXmlConverter; // Create a customer ledger $ledger = LedgerBuilder::customer('ABC Corporation') -> address('123 Business Park') ->state('Tamil Nadu') ->country('India') ->pincode('600001') ->gstRegistrationType('Regular') ->gstin('33ABCDE1234F1Z5') ->build(); // Convert to XML $converter = new TallyXmlConverter(); $xml = $converter->convert($ledger); ``` **Other Ledger Types:** ``` // Supplier $supplier = LedgerBuilder::supplier('XYZ Supplies')->build(); // Sales Account $sales = LedgerBuilder::salesAccount('Local Sales')->build(); // Purchase Account $purchase = LedgerBuilder::purchaseAccount('Local Purchases')->build(); // Custom ledger with parent $ledger = LedgerBuilder::create('Transport Charges', 'Indirect Expenses')->build(); ``` ### 2. Master Data - Create Stock Items [](#2-master-data---create-stock-items) ``` use Devtally\TallyXml\Builders\StockItemBuilder; $stockItem = StockItemBuilder::create('Laptop HP Pavilion', 'Nos') ->gstApplicable(true) ->gstSupplyType('Goods') ->gstDetails('84713000', 18, 45000) // HSN, GST%, Price ->build(); $xml = $converter->convert($stockItem); ``` ### 3. Master Data - Create Units [](#3-master-data---create-units) ``` use Devtally\TallyXml\Builders\UnitBuilder; $unit = UnitBuilder::create('Boxes', 'BOX') ->decimalPlaces(2) ->build(); $xml = $converter->convert($unit); ``` ### 4. Create Vouchers - Sales Invoice [](#4-create-vouchers---sales-invoice) ``` use Devtally\TallyXml\Builders\VoucherBuilder; $voucher = VoucherBuilder::sales('INV-2024-001', '2024-01-15') ->partyName('ABC Corporation') ->partyAddress('123 Business Street') ->partyAddress('Bangalore, Karnataka') ->partyState('Karnataka') ->partyCountry('India') ->partyPincode('560001') ->partyGstRegistrationType('Regular') ->partyGstin('29ABCDE1234F1Z5') ->placeOfSupply('Karnataka') ->narration('Sale of laptops and accessories') ->reference('PO-ABC-456') // Add items ->addVoucherItem('Sales Account', 'Laptop HP Pavilion', 'Nos', 45000, 2, 0) ->addVoucherItem('Sales Account', 'Wireless Mouse', 'Nos', 500, 10, 0) // Add taxes ->addTax('CGST @ 9%', 8550) ->addTax('SGST @ 9%', 8550) // Round off ->roundOff('Round Off', 0.50) // Party total amount ->partyAmount('ABC Corporation', 112600.50) ->build(); $xml = $converter->convert($voucher); ``` ### 5. Create Vouchers - Purchase [](#5-create-vouchers---purchase) ``` $voucher = VoucherBuilder::purchase('PUR-001', '2024-01-15') ->partyName('Supplier XYZ') ->narration('Purchase of raw materials') ->addVoucherItem('Purchase Account', 'Raw Material A', 'Kgs', 100, 50, 0) ->addTax('CGST @ 6%', 300) ->addTax('SGST @ 6%', 300) ->partyAmount('Supplier XYZ', 5600) ->build(); ``` ### 6. Create Vouchers - Payment [](#6-create-vouchers---payment) ``` $voucher = VoucherBuilder::payment('PAY-001', '2024-01-15') ->partyLedger('Supplier XYZ') ->narration('Payment for invoice PUR-001') ->reference('PUR-001') ->addLedgerEntry('Supplier XYZ', -5600, false) // Credit ->addLedgerEntry('Cash', 5600, true) // Debit ->build(); ``` ### 7. Create Vouchers - Sale Return [](#7-create-vouchers---sale-return) ``` $voucher = VoucherBuilder::saleReturn('SR-001', '2024-01-15') ->partyName('ABC Corporation') ->narration('Return of defective items') ->addVoucherItem('Sales Account', 'Laptop HP Pavilion', 'Nos', 45000, 1, 0) ->addTax('CGST @ 9%', -4050) ->addTax('SGST @ 9%', -4050) ->partyAmount('ABC Corporation', -53100) ->build(); ``` Complete JSON Structure Examples -------------------------------- [](#complete-json-structure-examples) ### Purchase Voucher JSON [](#purchase-voucher-json) ``` { "company_name": "My Company Ltd", "units": [ { "name": "Boxes", "uqc_name": "BOX", "decimal_point": 2 } ], "ledgers": [ { "name": "Supplier ABC", "parent": "Sundry Creditors", "address": "456 Supply Street", "country": "India", "state": "Tamil Nadu", "pincode": "600002", "gst_registration_type": "Regular", "gst_in": "33XYZAB5678G1H2" } ], "stock_item": [ { "name": "Product X", "hsn": "84713000", "unit": "Nos", "gst_percentage": 18, "gst_applicable": true, "gst_supply_type": "Goods", "price": 1000 } ], "voucher": { "voucher_type": "Purchase", "voucher_number": "PUR-001", "voucher_date": "2024-01-15", "place_of_supply": "Tamil Nadu", "ledger_name": "Supplier ABC", "address_line_1": "456 Supply Street", "address_line_2": "Near Central Station", "country": "India", "state": "Tamil Nadu", "pincode": "600002", "gst_registration_type": "Regular", "gst_in": "33XYZAB5678G1H2", "narration": "Purchase of goods", "total": 11800, "voucher_items": [ { "ledger_name": "Purchase Account", "stock_item_name": "Product X", "unit": "Nos", "price": 1000, "qty": 10, "discount": 0 } ], "tax_details": [ {"name": "CGST @ 9%", "amount": 900}, {"name": "SGST @ 9%", "amount": 900} ], "additional_charges": [ {"name": "Transport Charges", "amount": 500} ], "round_off": { "name": "Round Off", "amount": -0.50 } } } ``` ### Master Data JSON [](#master-data-json) ``` { "company_name": "My Company Ltd", "ledger": [ { "name": "Customer ABC", "parent": "Sundry Debtors", "address": "123 Customer Street", "country": "India", "state": "Karnataka", "pincode": "560001", "gst_registration_type": "Regular", "gst_in": "29ABCDE1234F1Z5", "gst_duty_head": "CGST", "gst_percentage": 9 } ], "download": true } ``` Supported Voucher Types ----------------------- [](#supported-voucher-types) - **Sale** / **Sales** - Sales invoices - **Purchase** - Purchase invoices - **Sale Return** - Sales returns/credit notes - **Purchase Return** - Purchase returns/debit notes - **Payment** - Payment vouchers - **Receipt** - Receipt vouchers - **Journal** - Journal entries - **Contra** - Contra entries GST Support ----------- [](#gst-support) The package automatically handles: - ✅ CGST/SGST split for intra-state transactions - ✅ IGST for inter-state transactions - ✅ GST registration types (Regular/Unregistered/Consumer) - ✅ GSTIN validation format - ✅ Place of supply - ✅ HSN codes for stock items Date Formats ------------ [](#date-formats) Tally uses `YYYYMMDD` format. The package automatically converts: - `'2024-01-15'` → `'20240115'` - `'15-01-2024'` → `'20240115'` - Any PHP `strtotime()` compatible format Testing ------- [](#testing) Run the test suite: ``` composer install vendor/bin/phpunit ``` Requirements ------------ [](#requirements) - PHP 7.4 or higher - ext-dom (usually included by default) Examples Directory ------------------ [](#examples-directory) Check the `examples/` directory for more complete working examples: - Creating master data - Sales/Purchase vouchers with GST - Payment/Receipt vouchers - Batch imports Contributing ------------ [](#contributing) Contributions are welcome! Please feel free to submit a Pull Request. License ------- [](#license) This package is open-sourced software licensed under the [MIT license](LICENSE). Support ------- [](#support) If you encounter any issues or have questions: 1. Check the examples directory 2. Review the tests for usage patterns 3. Open an issue on GitHub Changelog --------- [](#changelog) ### Version 2.0.0 (Enhanced) [](#version-200-enhanced) - ✨ Added comprehensive master data builders (Ledger, StockItem, Unit) - ✨ Enhanced VoucherBuilder with full GST support - ✨ Added JSON to XML converters for direct integration - ✨ Support for inventory items with batch allocation - ✨ Tax entries, additional charges, and round-off support - ✨ Sale Return and Purchase Return voucher types - ✨ Automatic debit/credit calculation based on voucher type - 📚 Comprehensive documentation and examples ### Version 1.0.0 [](#version-100) - Initial release with basic converter and voucher builder ### Health Score 31 — LowBetter than 68% of packages Maintenance70 Regular maintenance activity Popularity2 Limited adoption so far Community6 Small or concentrated contributor base Maturity40 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 168d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/f6c53e7a94b44f4afe828db84535cc9241bbc7b100650fc5ceca93b7fce34e2b?d=identicon)[Vanan2610](/maintainers/Vanan2610) --- Top Contributors [![Vanan2610](https://avatars.githubusercontent.com/u/88567747?v=4)](https://github.com/Vanan2610 "Vanan2610 (3 commits)") ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/devtally-tally-xml/health.svg) ``` [![Health](https://phpackages.com/badges/devtally-tally-xml/health.svg)](https://phpackages.com/packages/devtally-tally-xml) ``` ### Alternatives [masterminds/html5 An HTML5 parser and serializer. 1.8k242.8M229](/packages/masterminds-html5)[sabberworm/php-css-parser Parser for CSS Files written in PHP 1.8k191.2M65](/packages/sabberworm-php-css-parser)[jms/metadata Class/method/property metadata management in PHP 1.8k152.8M88](/packages/jms-metadata)[jms/serializer-bundle Allows you to easily serialize, and deserialize data of any complexity 1.8k89.3M627](/packages/jms-serializer-bundle)[hassankhan/config Lightweight configuration file loader that supports PHP, INI, XML, JSON, and YAML files 97513.5M170](/packages/hassankhan-config)[meyfa/php-svg Read, edit, write, and render SVG files with PHP 54613.9M42](/packages/meyfa-php-svg) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)