DEV Community

Cover image for Como validar NUIT, BI e CEP de Moçambique em 1 linha de código (TypeScript, Python, PHP, Dart, Kotlin)
Edmilson Muacigarro
Edmilson Muacigarro

Posted on

Como validar NUIT, BI e CEP de Moçambique em 1 linha de código (TypeScript, Python, PHP, Dart, Kotlin)

#typescript #python #opensource #mozambique

Se já teve de desenvolver um software, um site e-commerce ou uma aplicação móvel para Moçambique, provavelmente já esbarrou no mesmo pesadelo de sempre: Como garantir que os dados do utilizador são autênticos?

Validar se um NUIT (Número Único de Identificação Tributária) obedece ao algoritmo oficial do Módulo 11 da Autoridade Tributária, ou se o BI, DIRE ou a Carta de Condução são genuínos, geralmente requer horas a vasculhar fóruns antigos à procura de RegEx que acabam por falhar na produção.

Foi exactamente para resolver esta dor que criei a moz-utils.

O que é a moz-utils?
É a biblioteca Open-Source definitiva para lidar com o ecossistema digital e geográfico de Moçambique. O mais interessante? Foi escrita de raiz para estar disponível em 5 ecossistemas nativos simultaneamente:

🟦 TypeScript (NPM)
🐍 Python (PyPI)
🐘 PHP (Packagist)
💙 Dart / Flutter (Pub.dev)
☕ Kotlin / Android (JitPack)
Funcionalidades Core 🚀
Com apenas um simples import, ganha acesso offline a:

  1. Validação de Identidade: NUIT, Bilhete de Identidade (BI), Passaportes, DIRE e Cartas de Condução (INATRO). 
ts
import { isValidNUIT, isValidBI } from 'moz-utils';
isValidNUIT("400123456"); // true (Algoritmo Módulo 11 real)
isValidBI("123456789123A"); // true
Enter fullscreen mode Exit fullscreen mode
  1. Inteligência de Telecomunicações: Sabe aquele momento em que precisa de saber que carteira móvel (M-Pesa, e-Mola, mKesh) associar a um número de telefone? 
python
from moz_utils import get_mobile_operator, get_mobile_wallet
get_mobile_operator("841234567") # "Vodacom"
get_mobile_wallet("861234567")   # "e-Mola"
Enter fullscreen mode Exit fullscreen mode
  1. O Novo Sistema CEP (Códigos Postais): A biblioteca inclui um conversor inteligente que faz o mapeamento dos códigos postais clássicos (4 dígitos) para o Novo CEP Nacional (6 dígitos). 
php
use MozUtils\MozUtils;
MozUtils::isValidNewCEP("110203"); // true
MozUtils::getCEPProvince("110203"); // "Maputo Cidade"
Enter fullscreen mode Exit fullscreen mode
  1. Base de Dados Geográfica Offline: Precisa de preencher dropdowns num formulário com Províncias, Distritos, Postos Administrativos e Bairros (ex: Nampula ECP, Namutequeliua, Anchilo)? Está tudo incluído na biblioteca e sem fazer qualquer pedido a uma API externa!

Porque deve usar hoje?
A moz-utils é rigorosamente testada (Zero Dependencies), extremamente leve, tem 0 falhas de segurança conhecidas e inclui documentação robusta (Inglês e Português).

Se o seu projecto lida com clientes ou sistemas no mercado moçambicano, esta biblioteca vai poupar-lhe semanas de testes de validação.

🔗 Site Oficial e Documentação Interactiva: https://mozutils.edmilsonmuacigarro.com

⭐ Gosta do projecto? Todo o código é Open-Source. Dê uma vista de olhos no repositório, deixe uma ⭐️ (Star) para ajudar a comunidade a crescer e sinta-se livre para contribuir! 👉 Repositório no GitHub

Top comments (0)