python-stdnum branch master updated. 1.17-50-ga218032

[Commits of the python-stdnum project <python-stdnum-commits [at] lists.arthurdejong.org>]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "python-stdnum".

The branch, master has been updated
       via  a2180326ed1ae201400bed1b4ea5074847841957 (commit)
      from  1364e1917750b1515cb1b1662c24bc1080c4ecbf (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
https://arthurdejong.org/git/python-stdnum/commit/?id=a2180326ed1ae201400bed1b4ea5074847841957

commit a2180326ed1ae201400bed1b4ea5074847841957
Author: Arthur de Jong <arthur@arthurdejong.org>
Date:   Sat Nov 12 17:47:52 2022 +0100

    Add a check_uid() function to the stdnum.ch.uid module
    
    This function can be used to performa a lookup of organisation
    information by the Swiss Federal Statistical Office web service.
    
    Related to https://github.com/arthurdejong/python-stdnum/issues/336

diff --git a/stdnum/ch/uid.py b/stdnum/ch/uid.py
index 0e5fb2c..28a8a0e 100644
--- a/stdnum/ch/uid.py
+++ b/stdnum/ch/uid.py
@@ -1,7 +1,7 @@
 # uid.py - functions for handling Swiss business identifiers
 # coding: utf-8
 #
-# Copyright (C) 2015 Arthur de Jong
+# Copyright (C) 2015-2022 Arthur de Jong
 #
 # This library is free software; you can redistribute it and/or
 # modify it under the terms of the GNU Lesser General Public
@@ -43,7 +43,7 @@ InvalidChecksum: ...
 """
 
 from stdnum.exceptions import *
-from stdnum.util import clean, isdigits
+from stdnum.util import clean, get_soap_client, isdigits
 
 
 def compact(number):
@@ -88,3 +88,60 @@ def format(number):
     number = compact(number)
     return number[:3] + '-' + '.'.join(
         number[i:i + 3] for i in range(3, len(number), 3))
+
+
+uid_wsdl = 'https://www.uid-wse.admin.ch/V5.0/PublicServices.svc?wsdl'
+
+
+def check_uid(number, timeout=30):  # pragma: no cover
+    """Look up information via the Swiss Federal Statistical Office web 
service.
+
+    This uses the UID registry web service run by the the Swiss Federal
+    Statistical Office to provide more details on the provided number.
+
+    Returns a dict-like object for valid numbers with the following structure::
+
+        {
+            'organisation': {
+                'organisationIdentification': {
+                    'uid': {'uidOrganisationIdCategorie': 'CHE', 
'uidOrganisationId': 113690319},
+                    'OtherOrganisationId': [
+                        {'organisationIdCategory': 'CH.ESTVID', 
'organisationId': '052.0111.1006'},
+                    ],
+                    'organisationName': 'Staatssekretariat für Migration SEM 
Vermietung von Parkplätzen',
+                    'legalForm': '0220',
+                },
+                'address': [
+                    {
+                        'addressCategory': 'LEGAL',
+                        'street': 'Quellenweg',
+                        'houseNumber': '6',
+                        'town': 'Wabern',
+                        'countryIdISO2': 'CH',
+                    },
+                ],
+            },
+            'uidregInformation': {
+                'uidregStatusEnterpriseDetail': '3',
+                ...
+            },
+            'vatRegisterInformation': {
+                'vatStatus': '2',
+                'vatEntryStatus': '1',
+                ...
+            },
+        }
+
+    See the following document for more details on the GetByUID return value
+    
https://www.bfs.admin.ch/bfs/en/home/registers/enterprise-register/enterprise-identification/uid-register/uid-interfaces.html
+    """
+    # this function isn't always tested because it would require network access
+    # for the tests and might unnecessarily load the web service
+    number = compact(number)
+    client = get_soap_client(uid_wsdl, timeout)
+    try:
+        return client.GetByUID(uid={'uidOrganisationIdCategorie': number[:3], 
'uidOrganisationId': number[3:]})[0]
+    except Exception:  # noqa: B902 (excpetion type depends on SOAP client)
+        # Error responses by the server seem to result in exceptions raised
+        # by the SOAP client implementation
+        return
diff --git a/tests/test_ch_uid.py b/tests/test_ch_uid.py
new file mode 100644
index 0000000..4f73893
--- /dev/null
+++ b/tests/test_ch_uid.py
@@ -0,0 +1,45 @@
+# test_eu_vat.py - functions for testing the UID Webservice
+# coding: utf-8
+#
+# Copyright (C) 2022 Arthur de Jong
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
+# 02110-1301 USA
+
+# This is a separate test file because it should not be run regularly
+# because it could negatively impact the VIES service.
+
+"""Extra tests for the stdnum.ch.uid module."""
+
+import os
+import unittest
+
+from stdnum.ch import uid
+
+
+@unittest.skipIf(
+    not os.environ.get('ONLINE_TESTS'),
+    'Do not overload online services')
+class TestUid(unittest.TestCase):
+    """Test the UID Webservice provided by the Swiss Federal Statistical
+    Office for validating UID numbers."""
+
+    def test_check_uid(self):
+        """Test stdnum.ch.uid.check_uid()"""
+        result = uid.check_uid('CHE113690319')
+        self.assertTrue(result)
+        
self.assertEqual(result['organisation']['organisationIdentification']['uid']['uidOrganisationId'],
 113690319)
+        
self.assertEqual(result['organisation']['organisationIdentification']['legalForm'],
 '0220')
+        self.assertEqual(result['vatRegisterInformation']['vatStatus'], '2')

-----------------------------------------------------------------------

Summary of changes:
 stdnum/ch/uid.py                         | 61 ++++++++++++++++++++++++++++++--
 tests/{test_eu_vat.py => test_ch_uid.py} | 36 ++++++++-----------
 2 files changed, 74 insertions(+), 23 deletions(-)
 copy tests/{test_eu_vat.py => test_ch_uid.py} (51%)


hooks/post-receive
-- 
python-stdnum