@br-validators/cli 1.3.0 → 1.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -88,6 +88,70 @@ br-validators generate placa --format mercosul --seed 3
88
88
 
89
89
  ---
90
90
 
91
+ ## Reference data lookup
92
+
93
+ Offline embedded datasets — delegates to `@br-validators/core/*`.
94
+
95
+ ### Bacen banks
96
+
97
+ ```bash
98
+ br-validators bancos lookup 001 --json
99
+ br-validators bancos lookup 18236120 --verbose
100
+ br-validators bancos list --limit 20 --json
101
+ ```
102
+
103
+ ### Fiscal (26c)
104
+
105
+ ```bash
106
+ br-validators natureza-juridica lookup 2062 --json
107
+ br-validators nbs lookup 1.1502.50.00 --verbose
108
+ br-validators cest lookup 0302100 --json
109
+ br-validators cnae lookup 6201501 --json
110
+ br-validators cnae search "web design" --limit 5
111
+ br-validators cfop lookup 1102 --json
112
+ br-validators cfop search compra --limit 5
113
+ br-validators ncm lookup 12011000 --json
114
+ br-validators ncm search soja --limit 5
115
+ br-validators cbo lookup 212405 --json
116
+ br-validators cbo search analista --limit 5
117
+ ```
118
+
119
+ ### Geography & calendar (27d)
120
+
121
+ ```bash
122
+ br-validators ibge lookup 3550308 --json
123
+ br-validators ibge list estados --limit 5
124
+ br-validators ibge list municipios --uf SP --limit 10 --json
125
+ br-validators tse-municipios lookup 71072 --verbose
126
+ br-validators feriados list --year 2026 --json
127
+ br-validators cep faixa 01310 --json
128
+ br-validators ddd lookup 11 --verbose
129
+ ```
130
+
131
+ ### Trade (26d)
132
+
133
+ ```bash
134
+ br-validators moedas lookup BRL --json
135
+ br-validators paises-bacen lookup 1058 --verbose
136
+ br-validators incoterms lookup FOB --json
137
+ ```
138
+
139
+ ### Logistics (26e)
140
+
141
+ ```bash
142
+ br-validators portos lookup BRSSZ --json
143
+ br-validators aeroportos lookup GRU --verbose
144
+ br-validators aeroportos lookup SBGR --json
145
+ ```
146
+
147
+ | Exit code | Meaning |
148
+ |-----------|---------|
149
+ | `0` | Record found |
150
+ | `1` | Not found |
151
+ | `2` | Usage error |
152
+
153
+ ---
154
+
91
155
  ## Flags
92
156
 
93
157
  | Flag | Description |
@@ -96,7 +160,7 @@ br-validators generate placa --format mercosul --seed 3
96
160
  | `--quiet` / `-q` | Exit code only (CI) |
97
161
  | `--file` / `-f` | Read value from file |
98
162
  | `--source` | Print official source URL (per-type) |
99
- | `--uf` | Required for IE / detect / sanitize IE |
163
+ | `--uf` | Required for IE / detect / sanitize IE; optional filter for `ibge list municipios` |
100
164
 
101
165
  ### CI
102
166