You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

129 lines
4.9 KiB

  1. ================================
  2. Recurring - Contracts Management
  3. ================================
  4. .. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  5. !! This file is generated by oca-gen-addon-readme !!
  6. !! changes will be overwritten. !!
  7. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  8. .. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
  9. :target: https://odoo-community.org/page/development-status
  10. :alt: Beta
  11. .. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
  12. :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
  13. :alt: License: AGPL-3
  14. .. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fcontract-lightgray.png?logo=github
  15. :target: https://github.com/OCA/contract/tree/12.0/contract
  16. :alt: OCA/contract
  17. .. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
  18. :target: https://translation.odoo-community.org/projects/contract-12-0/contract-12-0-contract
  19. :alt: Translate me on Weblate
  20. .. |badge5| image:: https://img.shields.io/badge/runbot-Try%20me-875A7B.png
  21. :target: https://runbot.odoo-community.org/runbot/110/12.0
  22. :alt: Try me on Runbot
  23. |badge1| |badge2| |badge3| |badge4| |badge5|
  24. This module enables contracts management with recurring
  25. invoicing functions. Also you can print and send by email contract report.
  26. It works for customer contract and supplier contracts.
  27. **Table of contents**
  28. .. contents::
  29. :local:
  30. Configuration
  31. =============
  32. To view discount field in contract line, you need to set *Discount on lines* in
  33. user access rights.
  34. Usage
  35. =====
  36. #. Contracts are in Invoicing -> Customers -> Customer and Invoicing -> Vendors -> Supplier Contracts
  37. #. When creating a contract, fill fields for selecting the invoicing parameters:
  38. * a journal
  39. * a price list (optional)
  40. #. And add the lines to be invoiced with:
  41. * the product with a description, a quantity and a price
  42. * the recurrence parameters: interval (days, weeks, months, months last day or years),
  43. start date, date of next invoice (automatically computed, can be modified) and end date (optional)
  44. * auto-price, for having a price automatically obtained from the price list
  45. * #START# or #END# in the description field to display the start/end date of
  46. the invoiced period in the invoice line description
  47. * pre-paid (invoice at period start) or post-paid (invoice at start of next period)
  48. #. The "Generate Recurring Invoices from Contracts" cron runs daily to generate the invoices.
  49. If you are in debug mode, you can click on the invoice creation button.
  50. #. The *Show recurring invoices* shortcut on contracts shows all invoices created from the
  51. contract.
  52. #. The contract report can be printed from the Print menu
  53. #. The contract can be sent by email with the *Send by Email* button
  54. #. Contract templates can be created from the Configuration -> Contracts -> Contract Templates menu.
  55. They allow to define default journal, price list and lines when creating a contract.
  56. To use it, just select the template on the contract and fields will be filled automatically.
  57. Known issues / Roadmap
  58. ======================
  59. * Recover states and others functional fields in Contracts.
  60. Bug Tracker
  61. ===========
  62. Bugs are tracked on `GitHub Issues <https://github.com/OCA/contract/issues>`_.
  63. In case of trouble, please check there if your issue has already been reported.
  64. If you spotted it first, help us smashing it by providing a detailed and welcomed
  65. `feedback <https://github.com/OCA/contract/issues/new?body=module:%20contract%0Aversion:%2012.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
  66. Do not contact contributors directly about support or help with technical issues.
  67. Credits
  68. =======
  69. Authors
  70. ~~~~~~~
  71. * OpenERP SA
  72. * Tecnativa
  73. * LasLabs
  74. Contributors
  75. ~~~~~~~~~~~~
  76. * Pedro M. Baeza <pedro.baeza@tecnativa.com>
  77. * Carlos Dauden <carlos.dauden@tecnativa.com>
  78. * Angel Moya <angel.moya@domatix.com>
  79. * Dave Lasley <dave@laslabs.com>
  80. * Vicent Cubells <vicent.cubells@tecnativa.com>
  81. * Miquel Raïch <miquel.raich@eficent.com>
  82. * Souheil Bejaoui <souheil.bejaoui@acsone.eu>
  83. * Thomas Binsfeld <thomas.binsfeld@acsone.eu>
  84. * Rafael Blasco <rafael.blasco@tecnativa.com>
  85. * Guillaume Vandamme <guillaume.vandamme@acsone.eu>
  86. * Raphaël Reverdy <raphael.reverdy@akretion.com>
  87. Maintainers
  88. ~~~~~~~~~~~
  89. This module is maintained by the OCA.
  90. .. image:: https://odoo-community.org/logo.png
  91. :alt: Odoo Community Association
  92. :target: https://odoo-community.org
  93. OCA, or the Odoo Community Association, is a nonprofit organization whose
  94. mission is to support the collaborative development of Odoo features and
  95. promote its widespread use.
  96. This module is part of the `OCA/contract <https://github.com/OCA/contract/tree/12.0/contract>`_ project on GitHub.
  97. You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.