[javorosas]

Document country, tax-regime, CFDI-use, and Mexican postal-code searches plus postal-code details with neighborhoods, with authentication requirements in both OpenAPI locales.

Postal search uses numeric queries as full codes/prefixes and textual queries as neighborhood, locality/city, municipality, or state names. Text ignores case and diacritics, exact names rank ahead of partial matches, and each postal code appears once. The state filter applies in both modes. Each postal row includes all neighborhoods as {key, description} entries, and postal detail uses the same ZipCode shape; pages, forward/backward cursors, and capped textual totals are documented.

Match the optional-query contract for Carta Porte, Comercio Exterior, and payroll searches; empty specialized queries return no matches.

Validation: both OpenAPI locale checks pass for 132 operations, including references, generated type contracts, and structural parity.

[Copilot]

🟡 Changes recommended

The five new catalog operations lack security requirements in both locale specifications, allowing generated clients to omit required bearer tokens and receive 401 responses.

1 open issue

• Add bearer-token security to all new catalog operations · New

What changed in this PR

Expands the bilingual OpenAPI reference with address and fiscal catalog endpoints for API consumers.

Changes:

• Adds country, tax-regime, CFDI-use, and Mexican postal-code searches, plus postal-code details with neighborhoods.
• Defines shared response models and postal-code page/cursor pagination.
• Makes q optional on 13 existing Carta Porte catalog searches in both locales.

File	Description
website/​openapi_v2.yaml	Adds Spanish endpoint documentation and response schemas; updates query requirements.
website/​openapi_v2.en.yaml	Mirrors the endpoint, schema, and query-requirement changes in English.

_{Review effort: Balanced}