bcgov / bcgov/entity

Handling Postal Code Exemptions for International Addresses

Open
#31,826 2 comments 0 reactions 0 assignees View on GitHub
Entities Team
Dominant language
JavaScript
Stars
23
Forks
62
Avg merge
24m
Merged PRs (30d)
1

Description

**Problem Statement:**
- In mid year 2025, as part of the Data Migration work, it was observed that there were records coming from COLIN that were missing the Postal Code value.
- It was determined that there is a list of countries for which the Postal Code should be optional.

**To Do List for this Epic:**
- [ ] Identify all the filings affected by this work.
- [ ] Create all the tickets required.
- [ ] Complete these tickets.

**Requirements:**
- [ ] Where an international Director address is for a country included in an exception list, postal code field becomes optional.
- [ ] See work done previously here https://github.com/bcgov/entity/issues/28496
- [ ] List of exemptions:
- [ ] NO_POSTAL_CODE_COUNTRY_CODES = {
"AO", "AG", "AW", "BS", "BZ", "BJ", "BM", "BO", "BQ", "BW", "BF", "BI",
"CM", "CF", "TD", "KM", "CG", "CD", "CK", "CI", "CW", "DJ", "DM", "GQ",
"ER", "FJ", "TF", "GA", "GM", "GH", "GD", "GY", "HM", "HK",
"KI", "KP", "LY", "MO", "MW", "ML", "MR", "NR",
"AN", "NU", "QA", "RW", "KN", "ST", "SC", "SL", "SX", "SB", "SO", "SR", "SY",
"TL", "TG", "TK", "TO", "TT", "TV", "UG", "AE", "VU", "YE", "ZW"}
- [ ] Impacts: Corps and Coops

**Investigation:**
- Annual Report - Affected - ticket below
- Director Change - Affected - ticket below
- Alteration - Not affected
- Address Change - Not Affected - Addresses need to be in BC
- Bootstrap Filings - Incorporation - Tested - Affected by Directors' addresses
- Bootstrap Filings - Amalgamation - Tested - Affected by Directors' addresses
- Bootstrap Filings - Continuation In - Tested - Affected by Directors' addresses
- Restorations - - Affected by Directors' addresses
- Correction - Affected
- Continuation Out (two filings) - TBD
- Amalgamation Out (two filings) - TBD

Contributor guide

No contributing guide indexed for this repository

Research direction

Start by reviewing issue #28496 and the affected filing categories listed here, especially Annual Report, Director Change, bootstrap filings, Restorations, and Correction. Trace how director international addresses validate postal codes, then verify that the listed country codes permit a missing postal code while other countries retain the requirement. Confirm the unresolved Continuation Out and Amalgamation Out cases before considering the work done.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
backend
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.