=== CatCode TallyPrime Export for WooCommerce ===
Contributors: catcodestudio
Tags: tally, tallyprime, gst, india, accounting
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

WooCommerce orders as TallyPrime sales vouchers in XML, with CGST and SGST or IGST by place of supply and customer ledgers with GSTIN.

== Description ==

For an Indian WooCommerce store that keeps its books in TallyPrime. Pick a date range, check the figures on screen, download two files and import them in TallyPrime: the masters (ledgers) first, then the vouchers. No retyping of online orders, and no outside service: the files are made on your site.

TallyPrime is a product of Tally Solutions Pvt. Ltd. This plugin is not made or endorsed by Tally Solutions. It writes the XML import format that TallyHelp (Developer Reference, XML Integration and Sample XML) describes.

= Vouchers =

* One sales voucher per order, as an accounting invoice: party ledger, sales ledgers, shipping and fee ledgers, GST ledgers and round off.
* The GST is what WooCommerce charged, as rounded on the order. The party line is the order total. The paise between the two go to the round-off ledger, so every voucher balances.
* Sales ledgers by supply and rate, for example "Local Sales 18%" and "Interstate Sales 5%". GST ledgers by rate, for example "CGST 9%". Or one ledger whatever the rate: you choose the names.
* A bill reference (New Ref) with the voucher number on the party line.
* A unique remote ID per voucher.
* Party name, address, State, place of supply, GSTIN and registration type in the voucher, plus your own GSTIN.
* Voucher number from the order number with your own pattern, or the GST invoice number from our plugin GST Invoice and GSTR-1 for WooCommerce, if it is active.
* Order date or payment date as the voucher date.
* Orders not in Indian rupees are shown and left out.

= Place of supply =

* Goods: the State the order is shipped to.
* Orders with nothing to ship: the State in a registered buyer's GSTIN, otherwise the billing State.
* Outside India: an export, to its own sales ledger.
* Same State as your store: CGST and SGST, or UTGST in a Union territory without a legislature. Another State: IGST.
* WooCommerce tax rates named CGST, SGST, UTGST, IGST or Cess are taken as named. A rate with another name (just "GST") is split by place of supply. If WooCommerce charged a kind of GST that does not fit the place of supply, the screen says so before you import.

= Customers =

* One common ledger for all buyers, or one for each buyer.
* Buyers with a GSTIN can get a ledger of their own either way, under Sundry Debtors, with address, State and GSTIN, in the layout of TallyPrime 3.0 and later or of 2.1 and earlier.
* The GSTIN is read from our GST Invoice and GSTR-1 plugin, from the usual billing_gstin field, or from a field you name. It must pass the GSTIN check digit.

= Masters file =

* The party, sales, shipping, fee and round-off ledgers the vouchers name, under the groups you choose (Sundry Debtors, Sales Accounts, Indirect Expenses by default).
* GST ledgers are not in the file on purpose: their duty head is set in TallyPrime. The screen lists the exact names to create under Duties & Taxes.

= On screen =

* Every voucher of the range with date, number, party, place of supply, taxable value, CGST, SGST/UTGST, IGST, round off and total, with the totals of the range.
* A line under each voucher that needs a look: no State in the address, a kind of GST that does not fit, more than one rupee of rounding.
* Vouchers are marked as sent, so the next file can hold only the new ones.
* A box on each order with its voucher and its own file.

= Pro =

* Credit notes for refunds, as Credit Note vouchers against the sale (Agst Ref), with the GST reversed line by line. A refund of a plain amount is spread over the order lines in proportion.
* Item invoices: stock items with quantity, rate, godown and the sales ledger as accounting allocation, and the unit and stock items in the masters file.
* Direct sending to TallyPrime over XML/HTTP (TallyPrime acting as a server, port 9000 by default): a connection check that reads the ledger list of the company, missing party and sales ledgers created first, missing GST ledgers named, each order in a chosen status and each refund sent by itself in the background, tried again when TallyPrime is closed, and a log of what TallyPrime answered.
* Updates from catcode.com.ua in the WordPress Updates screen.
* Pro is a yearly license for two sites (your store and its test copy), with a 7-day trial from the License tab.

== Installation ==

1. Install and activate the plugin. WooCommerce must be active.
2. Open WooCommerce > TallyPrime Export > Settings. Enter the company name as TallyPrime shows it, your store State or GSTIN, and the ledger names you use in TallyPrime.
3. On the Export tab, choose the dates and press Show.
4. Download the masters file and the vouchers file.
5. In TallyPrime, open the company. Press Alt+O (Import) > Masters and choose the masters file. Then Alt+O (Import) > Transactions with the vouchers file.
6. Check the Day Book or the Sales Register.

== Frequently Asked Questions ==

= Which TallyPrime releases? =

The XML import is the one TallyHelp documents for TallyPrime. The party GSTIN goes into the GST registration details of the ledger for release 3.0 and later, and on the ledger itself for 2.1 and earlier: choose your release in Settings.

= Does it make the GST ledgers? =

No. Create CGST, SGST (or UTGST) and IGST ledgers under Duties & Taxes with Type of Duty/Tax GST, as TallyHelp shows in "Set Up Tax Ledgers". The Export tab lists the names the vouchers use.

= What if I import the same vouchers twice? =

Each voucher carries a unique remote ID, and the plugin marks what was sent so the next file holds only new vouchers. TallyPrime has its own option for vouchers that already exist (Alt+O > Configuration); check it before importing a file again.

= Is this tax advice? =

No. The plugin moves what WooCommerce charged into TallyPrime. Check the figures with your accountant.

== Changelog ==

= 1.0.0 =
* First release: sales vouchers with CGST, SGST, UTGST, IGST and Cess, customer ledgers with GSTIN, masters file, date ranges, marks of what was sent, order box.
* Pro: credit notes, item invoices, direct sending to TallyPrime over XML/HTTP with a log, updates from catcode.com.ua.
