Metadata-Version: 2.1
Name: odoo-addon-l10n-nl-bsn
Version: 15.0.1.0.1.2
Summary: Burgerservicenummer (BSN) for Partners
Home-page: https://github.com/OCA/l10n-netherlands
Author: Onestein, Odoo Community Association (OCA)
Author-email: support@odoo-community.org
License: AGPL-3
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 15.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Development Status :: 5 - Production/Stable
Requires-Python: >=3.8
Requires-Dist: odoo <15.1dev,>=15.0a
Requires-Dist: python-stdnum

======================================
Burgerservicenummer (BSN) for Partners
======================================

.. 
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! This file is generated by oca-gen-addon-readme !!
   !! changes will be overwritten.                   !!
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! source digest: sha256:49e84aa62b8fb1ca8efcb9a81f5e9544fbcecaf23baa2c1d8ccd525398cc405f
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |badge1| image:: https://img.shields.io/badge/maturity-Production%2FStable-green.png
    :target: https://odoo-community.org/page/development-status
    :alt: Production/Stable
.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
    :alt: License: AGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fl10n--netherlands-lightgray.png?logo=github
    :target: https://github.com/OCA/l10n-netherlands/tree/15.0/l10n_nl_bsn
    :alt: OCA/l10n-netherlands
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/l10n-netherlands-15-0/l10n-netherlands-15-0-l10n_nl_bsn
    :alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
    :target: https://runboat.odoo-community.org/builds?repo=OCA/l10n-netherlands&target_branch=15.0
    :alt: Try me on Runboat

|badge1| |badge2| |badge3| |badge4| |badge5|

This module adds the BSN (Burgerservicenummer) field on partner forms.

The field is visible when the field ``company_type`` is set to ``Individual``.

A double check on the BSN is done when inserting/modifying its value:

- validation of the BSN (check whether the format is correct);
- check if another partner with the same BSN already exists.

In both cases, a non-blocking alert is shown.

**Table of contents**

.. contents::
   :local:

Installation
============

The module depends on the external library ``python-stdnum``.

You can install that library by using pip3:

.. code-block:: console

    $ pip3 install python-stdnum

Configuration
=============

For security reasons the BSN number should be only visible to HR related roles.
Otherwise this will be in violation to the security framework of WBP regarding
the protection of persons info.

To be able to see the BSN number, give the proper permits to the user:

* User must belong to the "Employees Officer" group

Usage
=====

To use this module, you need to:

* Open a form of a contact: flag Individual must be checked (flag "Company" must be unchecked)
* Enter a BSN number

Known issues / Roadmap
======================

* The 'ilike' search of a substring of a BSN number could not work properly in case the
  entered BSN number does not contain dots while the corresponding BSN number stored in the
  database contains dots.

Bug Tracker
===========

Bugs are tracked on `GitHub Issues <https://github.com/OCA/l10n-netherlands/issues>`_.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us to smash it by providing a detailed and welcomed
`feedback <https://github.com/OCA/l10n-netherlands/issues/new?body=module:%20l10n_nl_bsn%0Aversion:%2015.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.

Do not contact contributors directly about support or help with technical issues.

Credits
=======

Authors
~~~~~~~

* Onestein

Contributors
~~~~~~~~~~~~

* Andrea Stirpe <a.stirpe@onestein.nl>

Maintainers
~~~~~~~~~~~

This module is maintained by the OCA.

.. image:: https://odoo-community.org/logo.png
   :alt: Odoo Community Association
   :target: https://odoo-community.org

OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.

.. |maintainer-astirpe| image:: https://github.com/astirpe.png?size=40px
    :target: https://github.com/astirpe
    :alt: astirpe

Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:

|maintainer-astirpe| 

This module is part of the `OCA/l10n-netherlands <https://github.com/OCA/l10n-netherlands/tree/15.0/l10n_nl_bsn>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.


