(feat): process to generate vat3 kra returns

[emmanuel-mwendwa]

VAT3 Returns

Overview

The VAT3 Returns Doctype is used to generate KRA VAT3 Reports for specific date ranges, typically on a monthly basis. The document allows users to fetch either Sales Invoices or Purchase Invoices, depending on the selection of the Selling or Buying checkbox. Once the document is submitted, the invoices in the child table will be marked as filed.

Fields

Main Fields

• Company (Mandatory):

  • Linked to the Company Doctype.

• From Date (Mandatory):

  • The start date for fetching invoices.

• To Date (Mandatory):

  • The end date for fetching invoices.

• Selling (Checkbox):

  • Default value: 1. If checked, it will fetch Sales Invoices for the specified date range.

• Buying (Checkbox):

  • Default value: 0. If checked, it will fetch Purchase Invoices for the specified date range.

• Fetch Invoices (Button):

  • When clicked, it fetches the Sales Invoices or Purchase Invoices based on the selected checkboxes (Selling or Buying).

Child Table: Invoices (Child Table)

• Document Type:

  • The type of the invoice (Sales or Purchase).

• Invoice Date:

  • The date when the invoice was posted.

• Invoice Number:

  • The number of the invoice.

• ETR Serial Number:

  • The serial number from the ETR (Electronic Tax Register).

• Tax Rate:

  • The tax rate applicable to the invoice.

• Taxable Value:

  • The taxable value of the invoice.

• Pin Number:

  • The tax PIN number of the customer or supplier.

• Supplier Name:

  • The name of the supplier or customer, depending on the invoice type.

Usage

1. Create a VAT3 Returns Document:

   • Select the Company for which you wish to generate the VAT3 return report.
     

   • Define the date range by selecting the From Date and To Date.
     

   • Choose whether to fetch Sales Invoices or Purchase Invoices by selecting the appropriate checkbox (Selling or Buying).

2. Fetch Invoices:

   • Click the Fetch Invoices button. Based on the selected checkbox:
     • If Selling is selected, it fetches Sales Invoices for the specified date range.
     • If Buying is selected, it fetches Purchase Invoices for the specified date range.

3. Invoices Child Table:
   • Once the invoices are fetched, the details of each invoice are added to the Invoices child table, including fields like Invoice Number, Tax Rate, Taxable Value, Pin Number, and Supplier Name.

4. Submit VAT3 Returns:
   • After reviewing the fetched invoices, submit the VAT3 Returns document. Upon submission, the invoices in the child table will be marked as filed.

Notes

• The Selling checkbox should be selected if you are looking to generate a report based on Sales Invoices.
• The Buying checkbox should be selected if you are looking to generate a report based on Purchase Invoices.
• Invoices in the child table are filed once the document is submitted, marking them as processed for VAT reporting purposes.

Example Workflow

1. Create a VAT3 Returns document.
2. Select the Company, From Date, and To Date.
3. Choose either Selling or Buying depending on the invoice type you want to fetch.
4. Click Fetch Invoices to fetch the corresponding invoices for the selected date range.
5. Review the fetched invoices in the Invoices child table.
6. Submit the VAT3 Returns document to mark the invoices as filed.

Conclusion

The VAT3 Returns Doctype simplifies the process of generating KRA VAT3 Reports by fetching the necessary invoices and providing an easy way to track and file them for the reporting period.