@veroao/node 1.0.0 → 1.0.1

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
@@ -259,6 +259,12 @@ unitPrice: 150_050 // 1 500,50 AOA
259
259
  | `VERO_API_KEY` | Chave secreta da API (recomendado) |
260
260
  | `VERO_SECRET_KEY` | Alias legado - usado só se `VERO_API_KEY` não estiver definida |
261
261
 
262
+ ## A implementar com Claude Code ou outro agente de IA?
263
+
264
+ Aponta o teu assistente para [vero.ao/vero-skill.md](https://vero.ao/vero-skill.md) - um skill
265
+ com o essencial da API da Vero (autenticação, endpoints, formatos e erros comuns) pronto a
266
+ carregar, sem teres de colar documentação à mão.
267
+
262
268
  ## O teu backend não é Node?
263
269
 
264
270
  Este pacote é só uma comodidade - por baixo é tudo pedidos HTTPS normais (`Authorization: Bearer
package/dist/types.d.ts CHANGED
@@ -27,9 +27,15 @@ export interface InvoiceItem {
27
27
  quantity: number;
28
28
  /** Preço unitário em kwanzas × 100 (ex: 10000 = 100 AOA) */
29
29
  unitPrice: number;
30
- /** Taxa IVA Angola: 0 = isento, 5 = reduzida, 14 = normal (default: 14) */
30
+ /**
31
+ * Taxa IVA Angola: 0 = isento, 5 = reduzida, 14 = normal. Opcional - se
32
+ * omitida, o servidor resolve-a a partir do regime de IVA configurado na
33
+ * organização (default 14% se a organização não tiver regime configurado).
34
+ * Organizações em regime isento/simplificado rejeitam (422) qualquer
35
+ * taxRate enviado que não seja 0.
36
+ */
31
37
  taxRate?: 0 | 5 | 14;
32
- /** Obrigatório junto da AGT quando taxRate = 0 (máx. 4 caracteres, ex: "M19") */
38
+ /** Obrigatório junto da AGT quando taxRate resultar em 0 (máx. 4 caracteres, ex: "M19") */
33
39
  taxExemptionCode?: string;
34
40
  /** ID do produto do catálogo (opcional) */
35
41
  productId?: string;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@veroao/node",
3
- "version": "1.0.0",
3
+ "version": "1.0.1",
4
4
  "description": "Vero SDK for Node.js — faturação certificada AGT para Angola",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",