Merge branch '17.0' of https://github.com/vialaurea/documentation int…

…o 17.0

content/via_laurea_modules.rst

@@ -14,4 +14,5 @@ Explore our modules tailored for Via Laurea applications, designed to enhance ef
 
     via_laurea_modules/accounting
     via_laurea_modules/inventory
-    via_laurea_modules/payroll
+    via_laurea_modules/payroll
+    via_laurea_modules/maintenance

content/via_laurea_modules/accounting/fixed_assets.rst

@@ -7,5 +7,4 @@ Explore the various payment mechanisms within our system, including cash handlin
    :maxdepth: 2
 
    fixed_assets/fixed_assets_reports
-   fixed_assets/fixed_assets_inventory_act
-   fixed_assets/low-value_asset_act
+   fixed_assets/fixed_assets_inventory_act

content/via_laurea_modules/accounting/fixed_assets/fixed_assets_reports.rst

@@ -1,63 +1,94 @@
-Fixed assets reports
-====================
+Long-term Asset Report Instruction
+==================================
 
 Introduction
 ------------
 
-UAB Via Laurea has developed special fixed asset reports for the Lithuanian market, which can be found in the reports section of the Accounting module:
+- The module enhances Odoo's long-term asset functionality, allowing you to assign asset objects to employees, enter additional asset information, and print various reports.
 
-.. image:: fixed_assets_reports/img01.jpg
-    :alt: Accounting module reports section
+Installation and Configuration
+------------------------------
 
-By selecting this section and Via Laurea fixed asset reports, you can choose the Asset Card, Commissioning Act, and Write-off Act in the opened window:
+- Install the modules ``l10n_lt_account_asset`` and ``account_asset_enterprise_extended``.
 
-.. image:: fixed_assets_reports/img02.jpg
-    :alt: Fixed asset reports selection
+Asset Assignment to an Employee
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+- Go to the Long-term Assets module.
+- Select the asset you want to assign and open it for editing. The status of the asset (active, draft, or closed) does not matter.
+- In the "Assigned to Employee" field, select the employee from the list. Save the changes.
+
+  .. image:: fixed_assets_reports/image01.jpg
+
+Additional Asset Information
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+- Go to the Long-term Assets module.
+- Select the asset and open it for editing. The status of the asset (active, draft, or closed) does not matter.
+- Enter the following additional information:
+  - **Inventory Number**: Enter the inventory number of the asset.
+  - **Supplier Invoice Reference**: Enter the reference to the related supplier invoice.
+  - **Commissioning Date**: Select the date when the asset was commissioned.
+
+  .. image:: fixed_assets_reports/image02.jpg
+
+Main Features
+-------------
+
+- If an employee to whom the asset is assigned leaves the company or is assigned another asset, you should update the long-term asset record by removing or changing the "Assigned to Employee" field.
+
+Reports
+-------
+
+- Via laurea has developed special long-term asset reports for the Lithuanian market, which can be found in the Accounting module under Accounting >> Reports >> Via laurea long-term asset reports.
+- In the report window, you can choose from three different reports: Asset Card, Commissioning Act, and Write-off Act.
+
+  .. image:: fixed_assets_reports/image03.jpg
 
 Daily Use Scenarios
 -------------------
 
-### Asset Card
+Asset Card
+~~~~~~~~~~
+
+- To print an asset card, select the appropriate report, choose the specific asset from the list, and set the date for which the card will be generated.
 
-To print the asset card, select the required report, choose the specific asset from the asset list, and set the date for which the card will be generated.
+  .. image:: fixed_assets_reports/image04.jpg
 
-.. image:: fixed_assets_reports/img03.jpg
-    :alt: Select asset and set date
+- Choose the format in which you want to generate the card. The system will generate an asset card with all the data related to the selected asset.
 
-Choose the format in which you want to generate the card. An asset card with all data related to the selected asset will be generated for you.
+  .. image:: fixed_assets_reports/image05.jpg
 
-.. image:: fixed_assets_reports/img04.jpg
-    :alt: Asset card format selection
+- **Important**: You can select multiple assets, and the system will generate a combined file with asset cards for all selected items.
 
-Important: You can select not just one asset but several. In this case, a single file with cards for all selected assets will be generated at once.
+Commissioning Act
+~~~~~~~~~~~~~~~~~
 
-### Commissioning Act
+- The Commissioning Act is created when an asset starts being used in the company's operations. To print it, enter the act number, select the specific asset from the list, date, and order number in the opened window. Assign the materially responsible person. Select the commission chairman and members from the list.
 
-The commissioning act is prepared when the asset starts being used in the company's activities. To print it, enter the act number in the opened window, select the specific asset from the list, set the date, and enter the order number. Assign the materially responsible person. Choose the chairman of the commission and commission members from the list.
+  .. image:: fixed_assets_reports/image06.jpg
 
-.. image:: fixed_assets_reports/img05.jpg
-    :alt: Commissioning Act details
+- After filling in all the fields, choose the document format you want to generate. The data related to the asset will be pulled into the printable document from the asset card.
 
-After filling in all fields, choose the document format in which you want to generate the report. Data about the asset itself is uploaded to the printed document from the asset card.
+  .. image:: fixed_assets_reports/image07.jpg
 
-.. image:: fixed_assets_reports/img06.jpg
-    :alt: Select document format
+- **Important**: Similar to the previous form, if you select multiple assets, commissioning acts will be generated for all selected items at once.
 
-Important: As with the previous forms, if you select several assets at once, commissioning acts will be generated for the selected units at once.
+Write-off Act
+~~~~~~~~~~~~~
 
-### Write-off Act
+- The Write-off Act is used to generate a document for writing off an asset. Select the appropriate asset report from the list, enter the act number, document and decommissioning dates, and select the commission chairman and members. In the decommissioning and commission proposal fields, you can enter the necessary text that will be displayed in the document. Generate the document in the required format.
 
-The write-off act is used to generate a document for writing off an asset. Select the appropriate asset report from the list, enter the act number, document and decommissioning dates, choose the chairman and members of the commission. In the decommissioning and commission proposal sections, you can enter the necessary text to be displayed in the document. Generate the document in the required format.
+  .. image:: fixed_assets_reports/image08.jpg
 
-.. image:: fixed_assets_reports/img07.jpg
-    :alt: Write-off Act details
+- The appropriate document is generated:
 
-The corresponding document is generated:
+  .. image:: fixed_assets_reports/image09.jpg
+  .. image:: fixed_assets_reports/image10.jpg
 
-.. image:: fixed_assets_reports/img08.jpg
-    :alt: Generated document
+- **Important**: If you select multiple assets in this form, a single document will be generated, and all the written-off items will be listed in the table in the appendix.
 
-.. image:: fixed_assets_reports/img09.jpg
-    :alt: Generated document details
+Updates and Version Control
+----------------------------
 
-Important: If you select several assets in this printing form, separate documents will not be generated for each, but a single document will be formed, listing all the written-off units in an attached table.
+- The module is updated with each new version of Odoo.

content/via_laurea_modules/accounting/fuel_accounting.rst

@@ -1,10 +1,143 @@
-Fuel Accounting
-===============
+Fuel Registration by Car
+========================
 
-Explore the various payment mechanisms within our system, including cash handling, advance registrations, and electronic payment processing. This section details procedures and guidelines for managing and recording all types of payments.
+1. Introduction
+----------------
 
-.. toctree::
-   :maxdepth: 2
+This module is designed to manage vehicle fleets, conduct fuel accounting, and monitor and analyze other expenses related to vehicles. 
+It contributes to compliance with Lithuanian accounting standards in the Odoo system.
 
-   fuel_accounting/fuel_registration_by_car
-   fuel_accounting/fuel_report
+2. Installation and Configuration
+----------------------------------
+
+**Installation Instructions:** Necessary steps for installing the module.
+
+**Initial Configuration:** Before using this module, specific settings need to be configured. Go to "Vehicle Park" -> Configuration -> Settings:
+
+.. image:: fuel_accounting/number1.jpg
+   :alt: Configuration settings window
+
+Open configuration fields:
+
+- Specify the debit/credit fuel account.
+- Choose the fuel products.
+- Fuel journal: Either use the standard "various operations" or create a specialized one specifically for fuel accounting (for how to create a journal, see the "Starting with Odoo" instructions).
+
+3. Main Features
+----------------
+
+Create a vehicle card and enter all necessary information:
+
+- Click "New":
+
+.. image:: fuel_accounting/number2.jpg
+   :alt: Vehicle card creation interface
+
+- Select a template (vehicle make) from the provided list.
+- Enter the registration number.
+- If needed, input information about the driver.
+- Fill in the relevant fields about the vehicle.
+- Fill in the required information in the tax information field.
+- Specify the debit/credit account for fuel accounting.
+
+.. image:: fuel_accounting/number3.jpg
+   :alt: Additional vehicle information fields
+
+After filling in the tax information, proceed to input additional vehicle details:
+
+.. image:: fuel_accounting/number4.jpg
+   :alt: Inputting additional vehicle details
+
+Once the vehicle card is completed and filled out, it is possible to register operations related to the specific vehicle.
+
+When registering invoices, the necessary vehicle is assigned in the lines:
+
+.. image:: fuel_accounting/number5.jpg
+   :alt: Assigning vehicles in invoice registration
+
+If services related to the vehicle were purchased, the information is displayed here on the vehicle card:
+
+.. image:: fuel_accounting/number6.jpg
+   :alt: Services related information display on vehicle card
+
+When purchasing fuel:
+
+- Clicking this button opens a window with the entire fuel history:
+
+.. image:: fuel_accounting/number7.jpg
+   :alt: Fuel history window
+
+In the opened window, the purchased quantity, write-offs, and remaining fuel balance are displayed.
+
+Fuel write-off is performed on the vehicle card by clicking the button:
+
+.. image:: fuel_accounting/number8.jpg
+   :alt: Fuel write-off interface
+
+A window opens:
+
+- Select a vehicle.
+- Specify the date for the fuel write-off.
+- Enter the amount of fuel to be written off.
+- Click "Write off".
+
+.. image:: fuel_accounting/number9.jpg
+   :alt: Details of fuel write-off
+
+After forming the fuel write-off record, go to the "Fuel Journal":
+
+.. image:: fuel_accounting/number10.jpg
+   :alt: Accessing the fuel journal
+
+Here, draft entries are created, which need to be registered to ensure that the data and figures are recorded in the general ledger:
+
+Before registering, by clicking on the desired line, you can check the correspondence that will register:
+
+.. image:: fuel_accounting/number11.jpg
+   :alt: Checking draft entries
+
+If everything is correct, return to the Fuel Journals, mark the entry you want to register, and click Action -> Post Entries.
+
+.. image:: fuel_accounting/number12.jpg
+   :alt: Finalizing entries in the fuel journal
+
+4. Reports and Documentation
+-----------------------------
+
+How to generate reports using the module.
+
+Instructions for document management and archiving.
+
+.. image:: fuel_accounting/number13.jpg
+   :alt: Document management and archiving instructions
+
+5. Integrations and Connection with Other Modules
+------------------------------------------------
+
+How this module integrates with other Odoo modules or external systems.
+
+Special integration instructions if needed.
+
+.. image:: fuel_accounting/number14.jpg
+   :alt: Integration with other modules
+
+6. Troubleshooting and FAQ
+--------------------------
+
+Frequent problems and their solutions.
+
+Answers to frequently asked questions about this module.
+
+7. Updates and Version Management
+---------------------------------
+
+How to update the module.
+
+Version management practices.
+
+8. Appendices
+-------------
+
+Screenshots and visual instructions.
+
+Useful links and additional resources.