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.

120 lines
4.5 KiB

  1. ============
  2. NUTS Regions
  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%2Fpartner--contact-lightgray.png?logo=github
  15. :target: https://github.com/OCA/partner-contact/tree/12.0/base_location_nuts
  16. :alt: OCA/partner-contact
  17. .. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
  18. :target: https://translation.odoo-community.org/projects/partner-contact-12-0/partner-contact-12-0-base_location_nuts
  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/134/12.0
  22. :alt: Try me on Runbot
  23. |badge1| |badge2| |badge3| |badge4| |badge5|
  24. This module allows to import NUTS locations.
  25. Creates four new fields in Partner object, one per NUTS level
  26. * NUTS L1: Country level
  27. * NUTS L2: Normally state or big region level
  28. * NUTS L3: Normally substate or state level
  29. * NUTS L4: Normally small region or province level
  30. This module allows to set the flag *Not updatable* in a NUTS region so that it gets no more updated nor deleted by the import wizard.
  31. Usually NUTS regions have to stay updated with the real ones, but the user may want to update a region's field (name, parent, ...) or create a new ones.
  32. With this module, flagging such records as *Not updatable* prevents them from being overwritten or deleted by the import wizard.
  33. **Table of contents**
  34. .. contents::
  35. :local:
  36. Installation
  37. ============
  38. We recommend to install another addon (one for each country) in order to relate
  39. NUTS with states defined by each localization addon, for example:
  40. * l10n_es_location_nuts : Spanish Provinces (NUTS level 4) related to Partner State
  41. * l10n_de_location_nuts : German states (NUTS level 2) related to Partner State
  42. Configuration
  43. =============
  44. After installation, you must click at import wizard to populate NUTS items
  45. in Odoo database in:
  46. Sales > Configuration > Address Book > Import NUTS 2013
  47. This wizard will download from Europe RAMON service the metadata to
  48. build NUTS in Odoo. Each localization addon (l10n_es_location_nuts,
  49. l10n_de_location_nuts, ...) will inherit this wizard and
  50. relate each NUTS item with states. So if you install a new localization addon
  51. you must re-build NUTS clicking this wizard again.
  52. Usage
  53. =====
  54. Only Administrator can manage NUTS list (it is not neccesary because
  55. it is an European convention) but any registered user can read them,
  56. in order to allow to assign them to partner object.
  57. Bug Tracker
  58. ===========
  59. Bugs are tracked on `GitHub Issues <https://github.com/OCA/partner-contact/issues>`_.
  60. In case of trouble, please check there if your issue has already been reported.
  61. If you spotted it first, help us smashing it by providing a detailed and welcomed
  62. `feedback <https://github.com/OCA/partner-contact/issues/new?body=module:%20base_location_nuts%0Aversion:%2012.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
  63. Do not contact contributors directly about support or help with technical issues.
  64. Credits
  65. =======
  66. Authors
  67. ~~~~~~~
  68. * Tecnativa
  69. * Agile Business Group
  70. Contributors
  71. ~~~~~~~~~~~~
  72. * Rafael Blasco <rafael.blasco@tecnativa.com>
  73. * Antonio Espinosa <antonio.espinosa@tecnativa.com>
  74. * Jairo Llopis <jairo.llopis@tecnativa.com>
  75. * David Vidal <david.vidal@tecnativa.com>
  76. * Simone Rubino <simone.rubino@agilebg.com>
  77. * Alexandre Díaz <alexandre.diaz@tecnativa.com>
  78. Maintainers
  79. ~~~~~~~~~~~
  80. This module is maintained by the OCA.
  81. .. image:: https://odoo-community.org/logo.png
  82. :alt: Odoo Community Association
  83. :target: https://odoo-community.org
  84. OCA, or the Odoo Community Association, is a nonprofit organization whose
  85. mission is to support the collaborative development of Odoo features and
  86. promote its widespread use.
  87. This module is part of the `OCA/partner-contact <https://github.com/OCA/partner-contact/tree/12.0/base_location_nuts>`_ project on GitHub.
  88. You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.