1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
|
import re
from itertools import zip_longest
from stdnum import iso11649, luhn
from stdnum.iso7064 import mod_97_10
def sanitize_structured_reference(reference):
"""Removes whitespace and specific characters from Belgian structured references:
Example: ` RF18 1234 5678 9 ` -> `RF18123456789`
`+++020/3430/57642+++` -> `020343057642`
`***020/3430/57642***` -> `020343057642`
"""
ref = re.sub(r'\s', '', reference)
if re.match(r'(\+{3}|\*{3})\d{3}/\d{4}/\d{5}(\+{3}|\*{3})', ref):
return re.sub(r'[+*/]', '', ref)
return ref
def format_structured_reference_iso(number):
"""Format a string into a Structured Creditor Reference.
The Creditor Reference is an international standard (ISO 11649).
Example: `123456789` -> `RF18 1234 5678 9`
"""
check_digits = mod_97_10.calc_check_digits('{}RF'.format(number))
return 'RF{} {}'.format(
check_digits,
' '.join(''.join(x) for x in zip_longest(*[iter(str(number))]*4, fillvalue=''))
)
def is_valid_structured_reference_iso(reference):
"""Check whether the provided reference is a valid Structured Creditor Reference (ISO).
:param reference: the reference to check
"""
ref = sanitize_structured_reference(reference)
return iso11649.is_valid(ref)
def is_valid_structured_reference_be(reference):
"""Check whether the provided reference is a valid structured reference for Belgium.
:param reference: the reference to check
"""
ref = sanitize_structured_reference(reference)
be_ref = re.match(r'(\d{10})(\d{2})', ref)
return be_ref and int(be_ref.group(1)) % 97 == int(be_ref.group(2)) % 97
def is_valid_structured_reference_fi(reference):
"""Check whether the provided reference is a valid structured reference for Finland.
:param reference: the reference to check
"""
ref = sanitize_structured_reference(reference)
fi_ref = re.match(r'(\d{1,19})(\d)', ref)
if not fi_ref:
return False
total = sum((7, 3, 1)[idx % 3] * int(val) for idx, val in enumerate(fi_ref.group(1)[::-1]))
check_digit = (10 - (total % 10)) % 10
return check_digit == int(fi_ref.group(2))
def is_valid_structured_reference_no_se(reference):
"""Check whether the provided reference is a valid structured reference for Norway or Sweden.
:param reference: the reference to check
"""
ref = sanitize_structured_reference(reference)
no_se_ref = re.match(r'\d+', ref)
return no_se_ref and luhn.is_valid(ref)
def is_valid_structured_reference(reference):
"""Check whether the provided reference is a valid structured reference.
This is currently supporting SEPA enabled countries. More specifically countries covered by functions in this file.
:param reference: the reference to check
"""
reference = sanitize_structured_reference(reference or '')
return (
is_valid_structured_reference_be(reference) or
is_valid_structured_reference_fi(reference) or
is_valid_structured_reference_no_se(reference) or
is_valid_structured_reference_iso(reference)
)
|
