bce-codes-to-label

Lookup labels for Belgian Crossroads Bank for Enterprises (BCE/KBO) codes.

Covers NACE codes, legal forms, joint committees, countries, postal codes, and more — with labels in French, Dutch, German, and English (where available).

Installation

pip install bce-codes-to-label

Quick start

from bce_codes_to_label import joint_committees, countries, nace, lookup

# Each registry accepts three input forms:
joint_committees("jcc:m100")   # full BCE code
joint_committees("m100")       # suffix (part after ":")
joint_committees("100")        # value only

# Filter by language
countries("BE", lang="fr")
# {'_key': 'BE', '_code': 'cty:mBE', 'label_fr': 'Belgique'}

# Global lookup — returns a result only if there is a unique match across all registries
lookup("jcc:m100")
# {'_registry': 'joint_committees', 'label_fr': '...', '_key': '100', '_code': 'jcc:m100'}

Available registries

API

Registry call

registry(query, lang=None)

• query: full BCE code ("jcc:m100"), suffix ("m100"), or value ("100")
• lang (optional): "fr", "nl", "de", or "en" — returns only that language's label
• Returns a dict with labels and metadata, a list if multiple matches, or None if not found

Global lookup

lookup(query, lang=None)

Searches all registries. Returns the match only if exactly one registry produces exactly one result. Returns None if ambiguous or not found.

Utilities

registry.all_keys()       # list all canonical keys
registry.get(query, lang) # alias for registry(query, lang)

NACE codes

NACE codes include a version prefix since both 2003 and 2008 versions are available:

from bce_codes_to_label import nace

nace("2008:01110")           # specific version + code
nace("nace:2008:m01110")     # full BCE code form

Data structure

Each data file uses an efficient keyed format:

{
  "code_prefix": "jcc:",
  "codes": {
    "100": {
      "label_fr": "Commission paritaire auxiliaire pour ouvriers",
      "label_nl": "Aanvullend PC voor de werklieden",
      "label_de": "die paritätische Hilfskommission für Arbeiter"
    }
  }
}

Rebuilding data

Source JSON files live in codes/. To regenerate the optimized data files:

python scripts/build_data.py

License

MIT