@stackin-io/stackin-node-sdk 0.11.0 → 0.13.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 +45 -6
- package/dist/address.d.ts.map +1 -1
- package/dist/address.js +8 -0
- package/dist/address.js.map +1 -1
- package/dist/br/index.d.ts +1 -1
- package/dist/br/index.d.ts.map +1 -1
- package/dist/br/product.d.ts +2 -0
- package/dist/br/product.d.ts.map +1 -1
- package/dist/br/product.js +28 -0
- package/dist/br/product.js.map +1 -1
- package/dist/client.d.ts +40 -7
- package/dist/client.d.ts.map +1 -1
- package/dist/client.js +181 -68
- package/dist/client.js.map +1 -1
- package/dist/index.d.ts +4 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +7 -1
- package/dist/index.js.map +1 -1
- package/dist/reference.d.ts +81 -0
- package/dist/reference.d.ts.map +1 -0
- package/dist/reference.js +136 -0
- package/dist/reference.js.map +1 -0
- package/dist/taxpayer.d.ts +25 -0
- package/dist/taxpayer.d.ts.map +1 -0
- package/dist/taxpayer.js +36 -0
- package/dist/taxpayer.js.map +1 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -120,9 +120,9 @@ await client.issue({
|
|
|
120
120
|
});
|
|
121
121
|
```
|
|
122
122
|
|
|
123
|
-
`recipientAddress` is an `Address` — the buyer's address
|
|
123
|
+
`recipientAddress` is an `Address` — the buyer's address. **On an NFE it is required**, and every field with it, `cityCode` (the 7-digit IBGE municipality code) included: it becomes `enderDest` on the wire and the SEFAZ rejects a partial one. `state` is also what resolves `idDest` — a buyer in another state is emitted as an interstate operation automatically. **On an NFSE it is the tomador's address: optional, except when any item has `taxRetained: true`** (the ISSQN retained by the tomador, where the city authorizer refuses the document without it, `E0237`); then it is required with every field except `cityCode` — `street`, `number`, `neighborhood`, `city`, `state`, `zipCode`. In both cases a missing or incomplete address raises a `ValidationError` locally, before the request goes out. `street` and `neighborhood`, when given, must have at least 2 characters once trimmed — `Address` refuses a shorter one when it is built.
|
|
124
124
|
|
|
125
|
-
`items` is an array of `br.Product` — `description`/`amount` apply to any document type; `ncm`/`cfop` (plus everything else on `Product`: `cest`, tax groups, presumed credits...) are Brazil-specific and required per item for NFE, ignored for NFSE (a service isn't a physical good).
|
|
125
|
+
`items` is an array of `br.Product` — `description`/`amount` apply to any document type; `ncm`/`cfop` (plus everything else on `Product`: `cest`, tax groups, presumed credits...) are Brazil-specific and required per item for NFE, ignored for NFSE (a service isn't a physical good). `ncm` is the full 8 digits, or `00` for a service line — any other 2-digit chapter is refused with a `ValidationError` when the `Product` is built, since the SEFAZ rejects it with `777`. `barcode` (cEAN) is `"SEM GTIN"` or a GTIN of 8, 12, 13 or 14 digits whose GS1 check digit is right, also checked when the `Product` is built. On an NFE, each `description` is at most 120 characters (the layout's `xProd`), checked by `issue()`; an NFSE description has no such limit. Every text an NFE sends — item fields, `clientName`, every `recipientAddress` field, observations, purchase order — must fit ISO-8859-1 (latin1): accents like `ç`/`ã` are fine, and so are tab, newline and CR, which the API folds into a space. Anything the NF-e cannot carry (emoji, CJK, Cyrillic…) is refused, and `issue()` names the first offending field before the request goes out; typographic quotes, dashes, ellipsis, bullet, `€` and `™` are converted by the API, so they are sent as given. NFSE text is not restricted.
|
|
126
126
|
|
|
127
127
|
## Retrying safely
|
|
128
128
|
|
|
@@ -190,8 +190,16 @@ The original document does not change — the CC-e is an event attached to it, a
|
|
|
190
190
|
the authorized XML stays as it was. A document accepts at most 20 of them, and
|
|
191
191
|
they are numbered for you.
|
|
192
192
|
|
|
193
|
-
**NF-e only.** NFS-e has no correction letter
|
|
194
|
-
|
|
193
|
+
**NF-e only.** NFS-e has no correction letter — cancel and reissue an NFS-e
|
|
194
|
+
instead. The access key already tells them apart (an NF-e access key is 44
|
|
195
|
+
characters, an NFS-e key 50 digits), so `correct()` refuses a key that is not
|
|
196
|
+
an NF-e access key locally, before the call, with a `ValidationError`:
|
|
197
|
+
`correct is NFe only. NFSe has no correction letter — cancel and reissue
|
|
198
|
+
instead.` An NF-e key is all digits except the issuer CNPJ's first 12
|
|
199
|
+
positions, which may be uppercase letters once the CNPJ is alphanumeric (from
|
|
200
|
+
July 2026). What only the API can know stays an `APIError`: an NF-e key sent
|
|
201
|
+
with `documentType: DocumentType.NFSE`, or one for a document the API does not
|
|
202
|
+
hold, comes back as a `409`.
|
|
195
203
|
|
|
196
204
|
## Invalidating unused numbers
|
|
197
205
|
|
|
@@ -250,16 +258,47 @@ Realizada. Only the last one takes a reason, and it requires one — both rules
|
|
|
250
258
|
checked locally, before the request goes out, because a round trip to be told a
|
|
251
259
|
fixed rule is a round trip wasted.
|
|
252
260
|
|
|
261
|
+
## Looking up a code, or who a CNPJ belongs to
|
|
262
|
+
|
|
263
|
+
Two more clients, for the tables an issuer reads while filling a document. Neither writes anything.
|
|
264
|
+
|
|
265
|
+
```ts
|
|
266
|
+
import { FiscalReference, Taxpayer } from "@stackin-io/stackin-node-sdk";
|
|
267
|
+
|
|
268
|
+
const ref = new FiscalReference({ apiKey: "..." }); // country "BR" by default
|
|
269
|
+
|
|
270
|
+
await ref.ncm.get("84716052"); // one code
|
|
271
|
+
await ref.ncm.search({ term: "teclado", limit: 5 }); // a page of matches
|
|
272
|
+
await ref.cfop.get("5102");
|
|
273
|
+
await ref.kinds(); // what this country has
|
|
274
|
+
await ref.kind("ibs_cbs_class").get("000001"); // any kind, named or not
|
|
275
|
+
await ref.search({ term: "teclado" }); // every kind at once
|
|
276
|
+
|
|
277
|
+
await new Taxpayer({ apiKey: "..." }).get("00000000000191");
|
|
278
|
+
```
|
|
279
|
+
|
|
280
|
+
`cfop`, `ncm`, `cest`, `cst`, `csosn`, `issService`, `icmsFuel` and `ibsCbsClass` have accessors. **`kind(name)` reaches anything else**, including a classification published after this release — ask `kinds()` rather than trusting this list.
|
|
281
|
+
|
|
282
|
+
`metadata` comes back as the API sends it and differs per kind: `utrib` on an NCM, `ncm_code` on a CEST, `tax_type` on a CST, `null` on an ISS service.
|
|
283
|
+
|
|
284
|
+
Three things worth knowing before you loop:
|
|
285
|
+
|
|
286
|
+
- **These share the invoice read allowance** — 600 calls a minute per key, the same bucket `consult()`, `history()`, `received()` and `pdf()` draw from. One `search()` page beats N `get()` calls.
|
|
287
|
+
- **Ordering is fixed** (kind, then code, ascending). Unlike `history()`, `SearchQuery` has no `sortBy`/`orderBy`.
|
|
288
|
+
- **A 404 from `Taxpayer` does not mean the company does not exist.** That registry reloads monthly, so a recently registered CNPJ is simply not in it yet. Do not build a validation rule on it.
|
|
289
|
+
|
|
290
|
+
`Taxpayer` has one method and keeps one: the registry holds the names and addresses of real people, so there is no search over it, by design.
|
|
291
|
+
|
|
253
292
|
## Errors
|
|
254
293
|
|
|
255
294
|
- `APIError` — the API responded with a non-2xx status (`statusCode`, `detail`) — a 401 here means `apiKey` is missing, wrong, or was rotated.
|
|
256
295
|
- `ConnectionFailedError` — the API didn't respond (network/DNS/timeout).
|
|
257
|
-
- `ValidationError` — `issue()`'s `items` is empty, missing `ncm`/`cfop` on an item for NFE,
|
|
296
|
+
- `ValidationError` — `issue()`'s `items` is empty, missing `ncm`/`cfop` on an item for NFE, a missing/incomplete `recipientAddress` on NFE, an NFE item `description` over 120 characters, NFE text the NF-e cannot carry (outside ISO-8859-1, other than the typographic characters the API converts), a missing/incomplete `recipientAddress` on an NFSE with a `taxRetained` item, or a `correct()` access key that is not an NF-e access key (44 characters). Building a `Product` with a malformed `ncm` or `barcode`, or an `Address` with a `street`/`neighborhood` under 2 characters, raises it too.
|
|
258
297
|
|
|
259
298
|
Building the full fiscal document (issuer data, service code, tax groups, schema-accurate XML) is the API's job — configured once per company, not passed on every call.
|
|
260
299
|
|
|
261
300
|
## Examples
|
|
262
301
|
|
|
263
|
-
Runnable end-to-end scripts in [`examples/nfe/`](examples/nfe/) and [`examples/nfse/`](examples/nfse/) — one file per field variant, from the bare minimum to every field filled. `examples/consult_invoice.ts`, `examples/cancel_invoice.ts`, and `examples/reissue_invoice.ts` cover the operations that act on an already-issued document.
|
|
302
|
+
Runnable end-to-end scripts in [`examples/nfe/`](examples/nfe/) and [`examples/nfse/`](examples/nfse/) — one file per field variant, from the bare minimum to every field filled. `examples/consult_invoice.ts`, `examples/cancel_invoice.ts`, and `examples/reissue_invoice.ts` cover the operations that act on an already-issued document. `examples/lookup_fiscal_reference.ts` and `examples/lookup_taxpayer.ts` cover the two read-only clients.
|
|
264
303
|
|
|
265
304
|
Commit convention lives in [`CONTRIBUTING.md`](CONTRIBUTING.md), not here.
|
package/dist/address.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../src/address.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;
|
|
1
|
+
{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../src/address.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAUD,qBAAa,OAAO;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;gBAEN,MAAM,GAAE,aAAkB;IAYtC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAWjC"}
|
package/dist/address.js
CHANGED
|
@@ -1,6 +1,12 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
3
|
exports.Address = void 0;
|
|
4
|
+
const errors_1 = require("./errors");
|
|
5
|
+
function requireMinLength(field, value) {
|
|
6
|
+
if (value !== undefined && value !== null && value.trim().length < 2) {
|
|
7
|
+
throw new errors_1.ValidationError(`${field} must have at least 2 characters`);
|
|
8
|
+
}
|
|
9
|
+
}
|
|
4
10
|
class Address {
|
|
5
11
|
street;
|
|
6
12
|
number;
|
|
@@ -10,6 +16,8 @@ class Address {
|
|
|
10
16
|
zipCode;
|
|
11
17
|
cityCode;
|
|
12
18
|
constructor(fields = {}) {
|
|
19
|
+
requireMinLength("street", fields.street);
|
|
20
|
+
requireMinLength("neighborhood", fields.neighborhood);
|
|
13
21
|
this.street = fields.street;
|
|
14
22
|
this.number = fields.number;
|
|
15
23
|
this.neighborhood = fields.neighborhood;
|
package/dist/address.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"address.js","sourceRoot":"","sources":["../src/address.ts"],"names":[],"mappings":";;;AAUA,MAAa,OAAO;IAClB,MAAM,CAAU;IAChB,MAAM,CAAU;IAChB,YAAY,CAAU;IACtB,IAAI,CAAU;IACd,KAAK,CAAU;IACf,OAAO,CAAU;IACjB,QAAQ,CAAU;IAElB,YAAY,SAAwB,EAAE;QACpC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QACxC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAClC,CAAC;IAED,MAAM;QACJ,MAAM,GAAG,GAA2B,EAAE,CAAC;QACvC,IAAI,IAAI,CAAC,MAAM;YAAE,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1C,IAAI,IAAI,CAAC,MAAM;YAAE,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1C,IAAI,IAAI,CAAC,YAAY;YAAE,GAAG,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;QAC5D,IAAI,IAAI,CAAC,IAAI;YAAE,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACpC,IAAI,IAAI,CAAC,KAAK;YAAE,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACvC,IAAI,IAAI,CAAC,OAAO;YAAE,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC;QAC9C,IAAI,IAAI,CAAC,QAAQ;YAAE,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC;QACjD,OAAO,GAAG,CAAC;IACb,CAAC;CACF;
|
|
1
|
+
{"version":3,"file":"address.js","sourceRoot":"","sources":["../src/address.ts"],"names":[],"mappings":";;;AAUA,qCAA2C;AAE3C,SAAS,gBAAgB,CAAC,KAAa,EAAE,KAAyB;IAChE,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,wBAAe,CAAC,GAAG,KAAK,kCAAkC,CAAC,CAAC;IACxE,CAAC;AACH,CAAC;AAED,MAAa,OAAO;IAClB,MAAM,CAAU;IAChB,MAAM,CAAU;IAChB,YAAY,CAAU;IACtB,IAAI,CAAU;IACd,KAAK,CAAU;IACf,OAAO,CAAU;IACjB,QAAQ,CAAU;IAElB,YAAY,SAAwB,EAAE;QACpC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1C,gBAAgB,CAAC,cAAc,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QACxC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAClC,CAAC;IAED,MAAM;QACJ,MAAM,GAAG,GAA2B,EAAE,CAAC;QACvC,IAAI,IAAI,CAAC,MAAM;YAAE,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1C,IAAI,IAAI,CAAC,MAAM;YAAE,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1C,IAAI,IAAI,CAAC,YAAY;YAAE,GAAG,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;QAC5D,IAAI,IAAI,CAAC,IAAI;YAAE,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACpC,IAAI,IAAI,CAAC,KAAK;YAAE,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACvC,IAAI,IAAI,CAAC,OAAO;YAAE,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC;QAC9C,IAAI,IAAI,CAAC,QAAQ;YAAE,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC;QACjD,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AAhCD,0BAgCC"}
|
package/dist/br/index.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
export { Product } from "./product";
|
|
2
|
-
export type { IbsCbsFields,
|
|
2
|
+
export type { IbsCbsFields, PresumedCredit, ProductFields } from "./product";
|
|
3
3
|
export { Tax, cofinsAliq, cofinsNt, cofinsOutr, cofinsQtde, cofinsSt, icms00, icms02, icms10, icms15, icms20, icms30, icms40, icms51, icms53, icms60, icms61, icms70, icms90, icmsPart, icmsSn101, icmsSn102, icmsSn201, icmsSn202, icmsSn500, icmsSn900, icmsSt, icmsUfDest, ipi, ipiNt, ipiTrib, pisAliq, pisNt, pisOutr, pisQtde, pisSt, } from "./tax";
|
|
4
4
|
export type { CofinsAliqFields, CofinsNtFields, CofinsOutrFields, CofinsQtdeFields, CofinsStFields, Icms00Fields, Icms02Fields, Icms10Fields, Icms15Fields, Icms20Fields, Icms30Fields, Icms40Fields, Icms51Fields, Icms53Fields, Icms60Fields, Icms61Fields, Icms70Fields, Icms90Fields, IcmsPartFields, IcmsSn101Fields, IcmsSn102Fields, IcmsSn201Fields, IcmsSn202Fields, IcmsSn500Fields, IcmsSn900Fields, IcmsStFields, IcmsUfDestFields, IpiFields, IpiNtFields, IpiTribFields, PisAliqFields, PisNtFields, PisOutrFields, PisQtdeFields, PisStFields, TaxFields, TaxGroup, } from "./tax";
|
|
5
5
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/br/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/br/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,YAAY,EAAE,
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/br/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC7E,OAAO,EACL,GAAG,EACH,UAAU,EACV,QAAQ,EACR,UAAU,EACV,UAAU,EACV,QAAQ,EACR,MAAM,EACN,MAAM,EACN,MAAM,EACN,MAAM,EACN,MAAM,EACN,MAAM,EACN,MAAM,EACN,MAAM,EACN,MAAM,EACN,MAAM,EACN,MAAM,EACN,MAAM,EACN,MAAM,EACN,QAAQ,EACR,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,MAAM,EACN,UAAU,EACV,GAAG,EACH,KAAK,EACL,OAAO,EACP,OAAO,EACP,KAAK,EACL,OAAO,EACP,OAAO,EACP,KAAK,GACN,MAAM,OAAO,CAAC;AACf,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,SAAS,EACT,WAAW,EACX,aAAa,EACb,aAAa,EACb,WAAW,EACX,aAAa,EACb,aAAa,EACb,WAAW,EACX,SAAS,EACT,QAAQ,GACT,MAAM,OAAO,CAAC"}
|
package/dist/br/product.d.ts
CHANGED
|
@@ -18,6 +18,7 @@ export interface ProductFields {
|
|
|
18
18
|
unitPrice?: number;
|
|
19
19
|
unit?: string;
|
|
20
20
|
quantity?: number;
|
|
21
|
+
/** cEAN: "SEM GTIN" or a GTIN of 8, 12, 13 or 14 digits with a valid check digit. */
|
|
21
22
|
barcode?: string;
|
|
22
23
|
freight?: number;
|
|
23
24
|
insurance?: number;
|
|
@@ -26,6 +27,7 @@ export interface ProductFields {
|
|
|
26
27
|
usedMovableAsset?: boolean;
|
|
27
28
|
purchaseOrder?: string;
|
|
28
29
|
purchaseOrderItem?: string;
|
|
30
|
+
/** The full 8 digits, or 00 for a service line; SEFAZ rejects any other short code with 777. */
|
|
29
31
|
ncm?: string;
|
|
30
32
|
cfop?: string;
|
|
31
33
|
cest?: string;
|
package/dist/br/product.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"product.d.ts","sourceRoot":"","sources":["../../src/br/product.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"product.d.ts","sourceRoot":"","sources":["../../src/br/product.ts"],"names":[],"mappings":"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"}
|
package/dist/br/product.js
CHANGED
|
@@ -1,6 +1,22 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
3
|
exports.Product = void 0;
|
|
4
|
+
const errors_1 = require("../errors");
|
|
5
|
+
const NCM_PATTERN = /^(00|\d{8})$/;
|
|
6
|
+
const BARCODE_PATTERN = /^(SEM GTIN|\d{8}|\d{12,14})$/;
|
|
7
|
+
/**
|
|
8
|
+
* GS1 modulo-10: from the rightmost digit before the check digit,
|
|
9
|
+
* weights alternate 3, 1, 3, 1...; the check digit closes the sum to
|
|
10
|
+
* the next multiple of 10.
|
|
11
|
+
*/
|
|
12
|
+
function hasValidGtinCheckDigit(gtin) {
|
|
13
|
+
const digits = [...gtin].map(Number);
|
|
14
|
+
const check = digits.pop();
|
|
15
|
+
const sum = digits
|
|
16
|
+
.reverse()
|
|
17
|
+
.reduce((total, digit, index) => total + digit * (index % 2 === 0 ? 3 : 1), 0);
|
|
18
|
+
return (10 - (sum % 10)) % 10 === check;
|
|
19
|
+
}
|
|
4
20
|
const BR_KEYS = [
|
|
5
21
|
"ncm",
|
|
6
22
|
"cfop",
|
|
@@ -95,6 +111,18 @@ class Product {
|
|
|
95
111
|
if (fields.unitPrice !== undefined && !(fields.unitPrice > 0)) {
|
|
96
112
|
throw new Error("unitPrice must be greater than 0");
|
|
97
113
|
}
|
|
114
|
+
if (fields.ncm !== undefined && !NCM_PATTERN.test(fields.ncm)) {
|
|
115
|
+
throw new errors_1.ValidationError("ncm must be the full 8 digits, or 00 for a service line; SEFAZ rejects any other short code with 777");
|
|
116
|
+
}
|
|
117
|
+
if (fields.barcode !== undefined &&
|
|
118
|
+
!BARCODE_PATTERN.test(fields.barcode)) {
|
|
119
|
+
throw new errors_1.ValidationError('barcode must be "SEM GTIN" or a GTIN of 8, 12, 13 or 14 digits');
|
|
120
|
+
}
|
|
121
|
+
if (fields.barcode !== undefined &&
|
|
122
|
+
fields.barcode !== "SEM GTIN" &&
|
|
123
|
+
!hasValidGtinCheckDigit(fields.barcode)) {
|
|
124
|
+
throw new errors_1.ValidationError("barcode has an invalid GTIN check digit");
|
|
125
|
+
}
|
|
98
126
|
this.description = fields.description;
|
|
99
127
|
this.amount = fields.amount;
|
|
100
128
|
this.unitPrice = fields.unitPrice;
|
package/dist/br/product.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"product.js","sourceRoot":"","sources":["../../src/br/product.ts"],"names":[],"mappings":";;;
|
|
1
|
+
{"version":3,"file":"product.js","sourceRoot":"","sources":["../../src/br/product.ts"],"names":[],"mappings":"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"}
|
package/dist/client.d.ts
CHANGED
|
@@ -2,13 +2,20 @@ import { Address } from "./address";
|
|
|
2
2
|
import { Product } from "./br/product";
|
|
3
3
|
import { DocumentType, Environment, Manifestation } from "./types";
|
|
4
4
|
export declare const DEFAULT_BASE_URL = "https://sdk.stackin.io";
|
|
5
|
-
export interface
|
|
5
|
+
export interface ClientOptions {
|
|
6
6
|
apiKey?: string;
|
|
7
7
|
baseUrl?: string;
|
|
8
8
|
environment?: Environment;
|
|
9
9
|
timeoutMs?: number;
|
|
10
10
|
fetch?: typeof fetch;
|
|
11
|
+
/**
|
|
12
|
+
* ISO 3166-1 alpha-2 code FiscalReference and Taxpayer look codes up
|
|
13
|
+
* under. Defaults to BR. Invoice ignores it: a fiscal document
|
|
14
|
+
* carries its issuer's country already.
|
|
15
|
+
*/
|
|
16
|
+
country?: string;
|
|
11
17
|
}
|
|
18
|
+
export type InvoiceOptions = ClientOptions;
|
|
12
19
|
export interface IssueRequest {
|
|
13
20
|
documentType: DocumentType;
|
|
14
21
|
clientName: string;
|
|
@@ -25,12 +32,32 @@ export interface IssueRequest {
|
|
|
25
32
|
*/
|
|
26
33
|
idempotencyKey?: string;
|
|
27
34
|
}
|
|
28
|
-
|
|
35
|
+
/**
|
|
36
|
+
* Where an api key becomes an HTTP call, for every entry point.
|
|
37
|
+
*
|
|
38
|
+
* Not re-exported from the package index: a caller instantiates
|
|
39
|
+
* Invoice, FiscalReference or Taxpayer, never this.
|
|
40
|
+
*/
|
|
41
|
+
export declare class Client {
|
|
29
42
|
readonly baseUrl: string;
|
|
30
43
|
readonly apiKey?: string;
|
|
31
44
|
readonly timeoutMs: number;
|
|
32
|
-
|
|
33
|
-
|
|
45
|
+
readonly country: string;
|
|
46
|
+
protected readonly fetchImpl: typeof fetch;
|
|
47
|
+
constructor(options?: ClientOptions);
|
|
48
|
+
protected headers(idempotencyKey?: string): Record<string, string>;
|
|
49
|
+
protected request(method: string, path: string, opts?: {
|
|
50
|
+
body?: unknown;
|
|
51
|
+
query?: Record<string, string>;
|
|
52
|
+
idempotencyKey?: string;
|
|
53
|
+
}): Promise<Record<string, unknown>>;
|
|
54
|
+
protected send(method: string, path: string, opts?: {
|
|
55
|
+
body?: unknown;
|
|
56
|
+
query?: Record<string, string>;
|
|
57
|
+
idempotencyKey?: string;
|
|
58
|
+
}): Promise<Response>;
|
|
59
|
+
}
|
|
60
|
+
export declare class Invoice extends Client {
|
|
34
61
|
issue(request: IssueRequest): Promise<Record<string, unknown>>;
|
|
35
62
|
consult(accessKey: string, options: {
|
|
36
63
|
documentType: DocumentType;
|
|
@@ -56,6 +83,15 @@ export declare class Invoice {
|
|
|
56
83
|
numberEnd: number;
|
|
57
84
|
reason: string;
|
|
58
85
|
}): Promise<Record<string, unknown>>;
|
|
86
|
+
/**
|
|
87
|
+
* Files a correction letter (CC-e) against an authorized NF-e.
|
|
88
|
+
*
|
|
89
|
+
* NF-e only. A key that is not an NF-e access key (44 characters;
|
|
90
|
+
* an NFS-e key has 50 digits) is refused locally with a
|
|
91
|
+
* ValidationError, before the call. An NF-e key sent with
|
|
92
|
+
* documentType NFSE, or one for a document the API does not hold,
|
|
93
|
+
* still comes back from the API as a 409 APIError.
|
|
94
|
+
*/
|
|
59
95
|
correct(accessKey: string, options: {
|
|
60
96
|
documentType: DocumentType;
|
|
61
97
|
correction: string;
|
|
@@ -63,7 +99,6 @@ export declare class Invoice {
|
|
|
63
99
|
reissue(invoiceId: string, options?: {
|
|
64
100
|
idempotencyKey?: string;
|
|
65
101
|
}): Promise<Record<string, unknown>>;
|
|
66
|
-
private headers;
|
|
67
102
|
/**
|
|
68
103
|
* Documents other companies issued against this one.
|
|
69
104
|
*
|
|
@@ -112,7 +147,6 @@ export declare class Invoice {
|
|
|
112
147
|
pdf(accessKey: string, options: {
|
|
113
148
|
documentType: DocumentType;
|
|
114
149
|
}): Promise<Uint8Array>;
|
|
115
|
-
private request;
|
|
116
150
|
/**
|
|
117
151
|
* Every attempt made for one invoice, with what the authorizer answered.
|
|
118
152
|
*
|
|
@@ -121,6 +155,5 @@ export declare class Invoice {
|
|
|
121
155
|
* has no access key to look it up by.
|
|
122
156
|
*/
|
|
123
157
|
submissions(invoiceId: string): Promise<Array<Record<string, unknown>>>;
|
|
124
|
-
private send;
|
|
125
158
|
}
|
|
126
159
|
//# sourceMappingURL=client.d.ts.map
|
package/dist/client.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAOvC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEnE,eAAO,MAAM,gBAAgB,2BAA2B,CAAC;
|
|
1
|
+
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
|
package/dist/client.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.Invoice = exports.DEFAULT_BASE_URL = void 0;
|
|
3
|
+
exports.Invoice = exports.Client = exports.DEFAULT_BASE_URL = void 0;
|
|
4
4
|
const errors_1 = require("./errors");
|
|
5
5
|
const types_1 = require("./types");
|
|
6
6
|
exports.DEFAULT_BASE_URL = "https://sdk.stackin.io";
|
|
@@ -18,6 +18,8 @@ const NFE_ADDRESS_FIELDS = [
|
|
|
18
18
|
"zipCode",
|
|
19
19
|
"cityCode",
|
|
20
20
|
];
|
|
21
|
+
/** On an NFS-e the API resolves cityCode from city + state. */
|
|
22
|
+
const NFSE_RETAINED_ADDRESS_FIELDS = NFE_ADDRESS_FIELDS.filter((field) => field !== "cityCode");
|
|
21
23
|
function resolveBaseUrl(baseUrl, environment) {
|
|
22
24
|
if (baseUrl)
|
|
23
25
|
return baseUrl;
|
|
@@ -31,26 +33,183 @@ function resolveBaseUrl(baseUrl, environment) {
|
|
|
31
33
|
return ENVIRONMENT_URLS[envName];
|
|
32
34
|
return exports.DEFAULT_BASE_URL;
|
|
33
35
|
}
|
|
36
|
+
const NFE_DESCRIPTION_MAX = 120;
|
|
37
|
+
function validateNfeDescriptions(items) {
|
|
38
|
+
items.forEach((item, index) => {
|
|
39
|
+
if ([...item.description].length > NFE_DESCRIPTION_MAX) {
|
|
40
|
+
throw new errors_1.ValidationError(`items[${index}].description exceeds ${NFE_DESCRIPTION_MAX} characters (NF-e xProd limit)`);
|
|
41
|
+
}
|
|
42
|
+
});
|
|
43
|
+
}
|
|
44
|
+
/**
|
|
45
|
+
* Typographic characters the API converts before its own latin1 check
|
|
46
|
+
* (quotes, dashes, ellipsis, bullet, euro, trademark), so they are not
|
|
47
|
+
* refused here. The SDK sends them as given; the API translates them.
|
|
48
|
+
*/
|
|
49
|
+
const API_CONVERTED = new Set([
|
|
50
|
+
"\u2018",
|
|
51
|
+
"\u2019",
|
|
52
|
+
"\u201A",
|
|
53
|
+
"\u201C",
|
|
54
|
+
"\u201D",
|
|
55
|
+
"\u201E",
|
|
56
|
+
"\u2013",
|
|
57
|
+
"\u2014",
|
|
58
|
+
"\u2212",
|
|
59
|
+
"\u2026",
|
|
60
|
+
"\u2022",
|
|
61
|
+
"\u20AC",
|
|
62
|
+
"\u2122",
|
|
63
|
+
]);
|
|
64
|
+
/**
|
|
65
|
+
* NF-e 4.00 is ISO-8859-1. Matches what the API accepts, no stricter:
|
|
66
|
+
* anything up to U+00FF passes (tab, newline and CR included, which
|
|
67
|
+
* the API folds into a space), as do the characters in API_CONVERTED;
|
|
68
|
+
* any other code point above U+00FF is refused. Walks what is actually
|
|
69
|
+
* sent, so the path names the payload key — items[0].description,
|
|
70
|
+
* client_name, recipient_address.street — and the first offender is
|
|
71
|
+
* reported.
|
|
72
|
+
*/
|
|
73
|
+
function validateLatin1(value, path) {
|
|
74
|
+
if (typeof value === "string") {
|
|
75
|
+
for (const char of value) {
|
|
76
|
+
const code = char.codePointAt(0);
|
|
77
|
+
if (code > 0xff && !API_CONVERTED.has(char)) {
|
|
78
|
+
throw new errors_1.ValidationError(`${path} contains a character outside ISO-8859-1 (latin1), which NF-e does not accept: '${char}'`);
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
else if (Array.isArray(value)) {
|
|
83
|
+
value.forEach((entry, index) => validateLatin1(entry, `${path}[${index}]`));
|
|
84
|
+
}
|
|
85
|
+
else if (value !== null && typeof value === "object") {
|
|
86
|
+
for (const [key, entry] of Object.entries(value)) {
|
|
87
|
+
validateLatin1(entry, path ? `${path}.${key}` : key);
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
/**
|
|
92
|
+
* An NF-e access key: 44 characters, digits except the issuer CNPJ's
|
|
93
|
+
* first 12 positions, which may be uppercase letters once the CNPJ is
|
|
94
|
+
* alphanumeric (from July 2026). Same pattern the API checks.
|
|
95
|
+
*/
|
|
96
|
+
const NFE_ACCESS_KEY = /^[0-9]{6}[0-9A-Z]{12}[0-9]{26}$/;
|
|
97
|
+
function missingAddressFields(address, fields) {
|
|
98
|
+
return fields.filter((field) => !address[field]);
|
|
99
|
+
}
|
|
100
|
+
/**
|
|
101
|
+
* ISSQN retained by the tomador: the city authorizer refuses the
|
|
102
|
+
* NFS-e without the tomador's address (E0237), and the API needs every
|
|
103
|
+
* field of it except cityCode.
|
|
104
|
+
*/
|
|
105
|
+
function validateNfseRetainedAddress(request) {
|
|
106
|
+
if (!request.items.some((item) => item.taxRetained))
|
|
107
|
+
return;
|
|
108
|
+
const address = request.recipientAddress;
|
|
109
|
+
if (!address) {
|
|
110
|
+
throw new errors_1.ValidationError("recipient_address is required on an NFS-e when any item has tax_retained=true (ISSQN retained by the tomador)");
|
|
111
|
+
}
|
|
112
|
+
const missing = missingAddressFields(address, NFSE_RETAINED_ADDRESS_FIELDS);
|
|
113
|
+
if (missing.length > 0) {
|
|
114
|
+
throw new errors_1.ValidationError(`recipientAddress is missing required fields for NFSE with tax_retained=true: ${missing.join(", ")}`);
|
|
115
|
+
}
|
|
116
|
+
}
|
|
34
117
|
function validateNfeAddress(address) {
|
|
35
118
|
if (!address) {
|
|
36
119
|
throw new errors_1.ValidationError("recipientAddress is required for NFE");
|
|
37
120
|
}
|
|
38
|
-
const missing =
|
|
121
|
+
const missing = missingAddressFields(address, NFE_ADDRESS_FIELDS);
|
|
39
122
|
if (missing.length > 0) {
|
|
40
123
|
throw new errors_1.ValidationError(`recipientAddress is missing required fields for NFE: ${missing.join(", ")}`);
|
|
41
124
|
}
|
|
42
125
|
}
|
|
43
|
-
|
|
126
|
+
/**
|
|
127
|
+
* Where an api key becomes an HTTP call, for every entry point.
|
|
128
|
+
*
|
|
129
|
+
* Not re-exported from the package index: a caller instantiates
|
|
130
|
+
* Invoice, FiscalReference or Taxpayer, never this.
|
|
131
|
+
*/
|
|
132
|
+
class Client {
|
|
44
133
|
baseUrl;
|
|
45
134
|
apiKey;
|
|
46
135
|
timeoutMs;
|
|
136
|
+
country;
|
|
47
137
|
fetchImpl;
|
|
48
138
|
constructor(options = {}) {
|
|
49
139
|
this.baseUrl = resolveBaseUrl(options.baseUrl, options.environment).replace(/\/+$/, "");
|
|
50
140
|
this.apiKey = options.apiKey ?? process.env.STACKIN_API_KEY;
|
|
51
141
|
this.timeoutMs = options.timeoutMs ?? 30_000;
|
|
142
|
+
this.country = options.country ?? "BR";
|
|
52
143
|
this.fetchImpl = options.fetch ?? fetch;
|
|
53
144
|
}
|
|
145
|
+
headers(idempotencyKey) {
|
|
146
|
+
const headers = {
|
|
147
|
+
"Content-Type": "application/json",
|
|
148
|
+
};
|
|
149
|
+
if (this.apiKey) {
|
|
150
|
+
headers.Authorization = `Bearer ${this.apiKey}`;
|
|
151
|
+
}
|
|
152
|
+
if (idempotencyKey) {
|
|
153
|
+
headers["Idempotency-Key"] = idempotencyKey;
|
|
154
|
+
}
|
|
155
|
+
return headers;
|
|
156
|
+
}
|
|
157
|
+
async request(method, path, opts = {}) {
|
|
158
|
+
const response = await this.send(method, path, opts);
|
|
159
|
+
let body = {};
|
|
160
|
+
const text = await response.text();
|
|
161
|
+
if (text) {
|
|
162
|
+
try {
|
|
163
|
+
body = JSON.parse(text);
|
|
164
|
+
}
|
|
165
|
+
catch {
|
|
166
|
+
body = {};
|
|
167
|
+
}
|
|
168
|
+
}
|
|
169
|
+
return body.result ?? body;
|
|
170
|
+
}
|
|
171
|
+
async send(method, path, opts = {}) {
|
|
172
|
+
let url = `${this.baseUrl}/api/v1${path}`;
|
|
173
|
+
if (opts.query) {
|
|
174
|
+
const params = new URLSearchParams(opts.query);
|
|
175
|
+
url += `?${params.toString()}`;
|
|
176
|
+
}
|
|
177
|
+
const controller = new AbortController();
|
|
178
|
+
const timer = setTimeout(() => controller.abort(), this.timeoutMs);
|
|
179
|
+
let response;
|
|
180
|
+
try {
|
|
181
|
+
response = await this.fetchImpl(url, {
|
|
182
|
+
method,
|
|
183
|
+
headers: this.headers(opts.idempotencyKey),
|
|
184
|
+
body: opts.body !== undefined ? JSON.stringify(opts.body) : undefined,
|
|
185
|
+
signal: controller.signal,
|
|
186
|
+
});
|
|
187
|
+
}
|
|
188
|
+
catch (err) {
|
|
189
|
+
throw new errors_1.ConnectionFailedError(err instanceof Error ? err.message : String(err));
|
|
190
|
+
}
|
|
191
|
+
finally {
|
|
192
|
+
clearTimeout(timer);
|
|
193
|
+
}
|
|
194
|
+
if (!response.ok) {
|
|
195
|
+
const text = await response.text();
|
|
196
|
+
let body = {};
|
|
197
|
+
if (text) {
|
|
198
|
+
try {
|
|
199
|
+
body = JSON.parse(text);
|
|
200
|
+
}
|
|
201
|
+
catch {
|
|
202
|
+
body = {};
|
|
203
|
+
}
|
|
204
|
+
}
|
|
205
|
+
const detail = typeof body.detail === "string" ? body.detail : text;
|
|
206
|
+
throw new errors_1.APIError(response.status, detail);
|
|
207
|
+
}
|
|
208
|
+
return response;
|
|
209
|
+
}
|
|
210
|
+
}
|
|
211
|
+
exports.Client = Client;
|
|
212
|
+
class Invoice extends Client {
|
|
54
213
|
async issue(request) {
|
|
55
214
|
if (!request.items || request.items.length === 0) {
|
|
56
215
|
throw new errors_1.ValidationError("items can't be empty");
|
|
@@ -65,6 +224,10 @@ class Invoice {
|
|
|
65
224
|
}
|
|
66
225
|
});
|
|
67
226
|
validateNfeAddress(request.recipientAddress);
|
|
227
|
+
validateNfeDescriptions(request.items);
|
|
228
|
+
}
|
|
229
|
+
if (request.documentType === types_1.DocumentType.NFSE) {
|
|
230
|
+
validateNfseRetainedAddress(request);
|
|
68
231
|
}
|
|
69
232
|
const payload = {
|
|
70
233
|
document_type: request.documentType,
|
|
@@ -79,6 +242,9 @@ class Invoice {
|
|
|
79
242
|
payload.series = request.series;
|
|
80
243
|
if (request.number)
|
|
81
244
|
payload.number = request.number;
|
|
245
|
+
if (request.documentType === types_1.DocumentType.NFE) {
|
|
246
|
+
validateLatin1(payload, "");
|
|
247
|
+
}
|
|
82
248
|
return this.request("POST", "/invoices", {
|
|
83
249
|
body: payload,
|
|
84
250
|
idempotencyKey: request.idempotencyKey,
|
|
@@ -125,7 +291,19 @@ class Invoice {
|
|
|
125
291
|
},
|
|
126
292
|
});
|
|
127
293
|
}
|
|
294
|
+
/**
|
|
295
|
+
* Files a correction letter (CC-e) against an authorized NF-e.
|
|
296
|
+
*
|
|
297
|
+
* NF-e only. A key that is not an NF-e access key (44 characters;
|
|
298
|
+
* an NFS-e key has 50 digits) is refused locally with a
|
|
299
|
+
* ValidationError, before the call. An NF-e key sent with
|
|
300
|
+
* documentType NFSE, or one for a document the API does not hold,
|
|
301
|
+
* still comes back from the API as a 409 APIError.
|
|
302
|
+
*/
|
|
128
303
|
async correct(accessKey, options) {
|
|
304
|
+
if (!NFE_ACCESS_KEY.test(accessKey ?? "")) {
|
|
305
|
+
throw new errors_1.ValidationError("correct is NFe only. NFSe has no correction letter — cancel and reissue instead.");
|
|
306
|
+
}
|
|
129
307
|
const length = options.correction?.length ?? 0;
|
|
130
308
|
if (length < 15 || length > 1000) {
|
|
131
309
|
throw new errors_1.ValidationError("correction must be 15 to 1000 characters");
|
|
@@ -142,18 +320,6 @@ class Invoice {
|
|
|
142
320
|
idempotencyKey: options.idempotencyKey,
|
|
143
321
|
});
|
|
144
322
|
}
|
|
145
|
-
headers(idempotencyKey) {
|
|
146
|
-
const headers = {
|
|
147
|
-
"Content-Type": "application/json",
|
|
148
|
-
};
|
|
149
|
-
if (this.apiKey) {
|
|
150
|
-
headers.Authorization = `Bearer ${this.apiKey}`;
|
|
151
|
-
}
|
|
152
|
-
if (idempotencyKey) {
|
|
153
|
-
headers["Idempotency-Key"] = idempotencyKey;
|
|
154
|
-
}
|
|
155
|
-
return headers;
|
|
156
|
-
}
|
|
157
323
|
/**
|
|
158
324
|
* Documents other companies issued against this one.
|
|
159
325
|
*
|
|
@@ -228,20 +394,6 @@ class Invoice {
|
|
|
228
394
|
});
|
|
229
395
|
return new Uint8Array(await response.arrayBuffer());
|
|
230
396
|
}
|
|
231
|
-
async request(method, path, opts = {}) {
|
|
232
|
-
const response = await this.send(method, path, opts);
|
|
233
|
-
let body = {};
|
|
234
|
-
const text = await response.text();
|
|
235
|
-
if (text) {
|
|
236
|
-
try {
|
|
237
|
-
body = JSON.parse(text);
|
|
238
|
-
}
|
|
239
|
-
catch {
|
|
240
|
-
body = {};
|
|
241
|
-
}
|
|
242
|
-
}
|
|
243
|
-
return body.result ?? body;
|
|
244
|
-
}
|
|
245
397
|
/**
|
|
246
398
|
* Every attempt made for one invoice, with what the authorizer answered.
|
|
247
399
|
*
|
|
@@ -260,45 +412,6 @@ class Invoice {
|
|
|
260
412
|
}
|
|
261
413
|
return body;
|
|
262
414
|
}
|
|
263
|
-
async send(method, path, opts = {}) {
|
|
264
|
-
let url = `${this.baseUrl}/api/v1${path}`;
|
|
265
|
-
if (opts.query) {
|
|
266
|
-
const params = new URLSearchParams(opts.query);
|
|
267
|
-
url += `?${params.toString()}`;
|
|
268
|
-
}
|
|
269
|
-
const controller = new AbortController();
|
|
270
|
-
const timer = setTimeout(() => controller.abort(), this.timeoutMs);
|
|
271
|
-
let response;
|
|
272
|
-
try {
|
|
273
|
-
response = await this.fetchImpl(url, {
|
|
274
|
-
method,
|
|
275
|
-
headers: this.headers(opts.idempotencyKey),
|
|
276
|
-
body: opts.body !== undefined ? JSON.stringify(opts.body) : undefined,
|
|
277
|
-
signal: controller.signal,
|
|
278
|
-
});
|
|
279
|
-
}
|
|
280
|
-
catch (err) {
|
|
281
|
-
throw new errors_1.ConnectionFailedError(err instanceof Error ? err.message : String(err));
|
|
282
|
-
}
|
|
283
|
-
finally {
|
|
284
|
-
clearTimeout(timer);
|
|
285
|
-
}
|
|
286
|
-
if (!response.ok) {
|
|
287
|
-
const text = await response.text();
|
|
288
|
-
let body = {};
|
|
289
|
-
if (text) {
|
|
290
|
-
try {
|
|
291
|
-
body = JSON.parse(text);
|
|
292
|
-
}
|
|
293
|
-
catch {
|
|
294
|
-
body = {};
|
|
295
|
-
}
|
|
296
|
-
}
|
|
297
|
-
const detail = typeof body.detail === "string" ? body.detail : text;
|
|
298
|
-
throw new errors_1.APIError(response.status, detail);
|
|
299
|
-
}
|
|
300
|
-
return response;
|
|
301
|
-
}
|
|
302
415
|
}
|
|
303
416
|
exports.Invoice = Invoice;
|
|
304
417
|
//# sourceMappingURL=client.js.map
|
package/dist/client.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
|
package/dist/index.d.ts
CHANGED
|
@@ -1,5 +1,8 @@
|
|
|
1
1
|
export { Invoice, DEFAULT_BASE_URL } from "./client";
|
|
2
|
-
export type { InvoiceOptions, IssueRequest } from "./client";
|
|
2
|
+
export type { ClientOptions, InvoiceOptions, IssueRequest } from "./client";
|
|
3
|
+
export { FiscalReference, Kind, KINDS } from "./reference";
|
|
4
|
+
export type { SearchQuery } from "./reference";
|
|
5
|
+
export { Taxpayer } from "./taxpayer";
|
|
3
6
|
export { Address } from "./address";
|
|
4
7
|
export type { AddressFields } from "./address";
|
|
5
8
|
export { DocumentType, Environment, Manifestation } from "./types";
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACrD,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACrD,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC3D,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnE,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,qBAAqB,EACrB,eAAe,GAChB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,MAAM,MAAM,CAAC"}
|
package/dist/index.js
CHANGED
|
@@ -33,10 +33,16 @@ var __importStar = (this && this.__importStar) || (function () {
|
|
|
33
33
|
};
|
|
34
34
|
})();
|
|
35
35
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
36
|
-
exports.br = exports.ValidationError = exports.ConnectionFailedError = exports.APIError = exports.InvoiceError = exports.Manifestation = exports.Environment = exports.DocumentType = exports.Address = exports.DEFAULT_BASE_URL = exports.Invoice = void 0;
|
|
36
|
+
exports.br = exports.ValidationError = exports.ConnectionFailedError = exports.APIError = exports.InvoiceError = exports.Manifestation = exports.Environment = exports.DocumentType = exports.Address = exports.Taxpayer = exports.KINDS = exports.Kind = exports.FiscalReference = exports.DEFAULT_BASE_URL = exports.Invoice = void 0;
|
|
37
37
|
var client_1 = require("./client");
|
|
38
38
|
Object.defineProperty(exports, "Invoice", { enumerable: true, get: function () { return client_1.Invoice; } });
|
|
39
39
|
Object.defineProperty(exports, "DEFAULT_BASE_URL", { enumerable: true, get: function () { return client_1.DEFAULT_BASE_URL; } });
|
|
40
|
+
var reference_1 = require("./reference");
|
|
41
|
+
Object.defineProperty(exports, "FiscalReference", { enumerable: true, get: function () { return reference_1.FiscalReference; } });
|
|
42
|
+
Object.defineProperty(exports, "Kind", { enumerable: true, get: function () { return reference_1.Kind; } });
|
|
43
|
+
Object.defineProperty(exports, "KINDS", { enumerable: true, get: function () { return reference_1.KINDS; } });
|
|
44
|
+
var taxpayer_1 = require("./taxpayer");
|
|
45
|
+
Object.defineProperty(exports, "Taxpayer", { enumerable: true, get: function () { return taxpayer_1.Taxpayer; } });
|
|
40
46
|
var address_1 = require("./address");
|
|
41
47
|
Object.defineProperty(exports, "Address", { enumerable: true, get: function () { return address_1.Address; } });
|
|
42
48
|
var types_1 = require("./types");
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,mCAAqD;AAA5C,iGAAA,OAAO,OAAA;AAAE,0GAAA,gBAAgB,OAAA;AAElC,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAEhB,iCAAmE;AAA1D,qGAAA,YAAY,OAAA;AAAE,oGAAA,WAAW,OAAA;AAAE,sGAAA,aAAa,OAAA;AACjD,mCAKkB;AAJhB,sGAAA,YAAY,OAAA;AACZ,kGAAA,QAAQ,OAAA;AACR,+GAAA,qBAAqB,OAAA;AACrB,yGAAA,eAAe,OAAA;AAEjB,2CAA2B"}
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,mCAAqD;AAA5C,iGAAA,OAAO,OAAA;AAAE,0GAAA,gBAAgB,OAAA;AAElC,yCAA2D;AAAlD,4GAAA,eAAe,OAAA;AAAE,iGAAA,IAAI,OAAA;AAAE,kGAAA,KAAK,OAAA;AAErC,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA;AACjB,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAEhB,iCAAmE;AAA1D,qGAAA,YAAY,OAAA;AAAE,oGAAA,WAAW,OAAA;AAAE,sGAAA,aAAa,OAAA;AACjD,mCAKkB;AAJhB,sGAAA,YAAY,OAAA;AACZ,kGAAA,QAAQ,OAAA;AACR,+GAAA,qBAAqB,OAAA;AACrB,yGAAA,eAAe,OAAA;AAEjB,2CAA2B"}
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
import { Client, ClientOptions } from "./client";
|
|
2
|
+
/**
|
|
3
|
+
* One path segment, escaped, refusing the ones that would leave it.
|
|
4
|
+
*
|
|
5
|
+
* encodeURIComponent leaves "." alone — RFC 3986 calls it unreserved —
|
|
6
|
+
* so the dot segments have to be refused rather than escaped, or the
|
|
7
|
+
* HTTP client collapses ".." into a different endpoint.
|
|
8
|
+
*/
|
|
9
|
+
export declare function segment(value: string): string;
|
|
10
|
+
/**
|
|
11
|
+
* The classifications with a named accessor on FiscalReference.
|
|
12
|
+
*
|
|
13
|
+
* Not the whole truth and not meant to be: ask kinds() for what the API
|
|
14
|
+
* actually has, because a classification published after this release
|
|
15
|
+
* is reachable through kind() with no release at all.
|
|
16
|
+
*/
|
|
17
|
+
export declare const KINDS: readonly ["cfop", "ncm", "cest", "cst", "csosn", "iss_service", "icms_fuel", "ibs_cbs_class"];
|
|
18
|
+
/**
|
|
19
|
+
* Narrows a classification listing.
|
|
20
|
+
*
|
|
21
|
+
* There is no sortBy or orderBy: the route accepts both and discards
|
|
22
|
+
* them, so rows always come back ordered by kind then code. history()
|
|
23
|
+
* on Invoice does honour them, which is why the difference is spelled
|
|
24
|
+
* out here rather than left to be discovered.
|
|
25
|
+
*/
|
|
26
|
+
export interface SearchQuery {
|
|
27
|
+
term?: string;
|
|
28
|
+
country?: string;
|
|
29
|
+
limit?: number;
|
|
30
|
+
offset?: number;
|
|
31
|
+
}
|
|
32
|
+
type Call = (path: string, query: Record<string, string>) => Promise<Record<string, unknown>>;
|
|
33
|
+
/** One classification, bound to a country. */
|
|
34
|
+
export declare class Kind {
|
|
35
|
+
private readonly call;
|
|
36
|
+
readonly name: string;
|
|
37
|
+
readonly country: string;
|
|
38
|
+
constructor(call: Call, name: string, country: string);
|
|
39
|
+
/**
|
|
40
|
+
* One code. A code that does not exist is a 404, which arrives as an
|
|
41
|
+
* APIError — there is no separate not-found type.
|
|
42
|
+
*/
|
|
43
|
+
get(code: string, country?: string): Promise<Record<string, unknown>>;
|
|
44
|
+
/**
|
|
45
|
+
* A page of this classification, filtered by the query's term when it
|
|
46
|
+
* has one. An empty term is no term: the route rejects search="" with
|
|
47
|
+
* a 422, and sending it would invent a failure the caller cannot read.
|
|
48
|
+
*/
|
|
49
|
+
search(query?: SearchQuery): Promise<Record<string, unknown>>;
|
|
50
|
+
}
|
|
51
|
+
/**
|
|
52
|
+
* Reads the published classification tables. Nothing here is the
|
|
53
|
+
* company's own data and nothing here is writable.
|
|
54
|
+
*/
|
|
55
|
+
export declare class FiscalReference extends Client {
|
|
56
|
+
readonly cfop: Kind;
|
|
57
|
+
readonly ncm: Kind;
|
|
58
|
+
readonly cest: Kind;
|
|
59
|
+
readonly cst: Kind;
|
|
60
|
+
readonly csosn: Kind;
|
|
61
|
+
readonly issService: Kind;
|
|
62
|
+
readonly icmsFuel: Kind;
|
|
63
|
+
readonly ibsCbsClass: Kind;
|
|
64
|
+
constructor(options?: ClientOptions);
|
|
65
|
+
/**
|
|
66
|
+
* Which classifications this country has rows for. The only honest
|
|
67
|
+
* answer to "what else is there" — a hard-coded list goes stale the
|
|
68
|
+
* next time the ETL grows one.
|
|
69
|
+
*/
|
|
70
|
+
kinds(country?: string): Promise<string[]>;
|
|
71
|
+
/** Any classification by name, including one with no accessor. */
|
|
72
|
+
kind(name: string, country?: string): Kind;
|
|
73
|
+
/**
|
|
74
|
+
* Every classification at once, which no accessor can express. The
|
|
75
|
+
* most expensive call the endpoint accepts: the whole country's
|
|
76
|
+
* tables, not one of them.
|
|
77
|
+
*/
|
|
78
|
+
search(query?: SearchQuery): Promise<Record<string, unknown>>;
|
|
79
|
+
}
|
|
80
|
+
export {};
|
|
81
|
+
//# sourceMappingURL=reference.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../src/reference.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGjD;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAK7C;AAED;;;;;;GAMG;AACH,eAAO,MAAM,KAAK,+FASR,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAiBD,KAAK,IAAI,GAAG,CACV,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC1B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEtC,8CAA8C;AAC9C,qBAAa,IAAI;IAEb,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM;gBAFP,IAAI,EAAE,IAAI,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM;IAG1B;;;OAGG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAO3E;;;;OAIG;IACG,MAAM,CAAC,KAAK,GAAE,WAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAMxE;AAED;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,MAAM;IACzC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;gBAEf,OAAO,GAAE,aAAkB;IAavC;;;;OAIG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAehD,kEAAkE;IAClE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAQ1C;;;;OAIG;IACG,MAAM,CAAC,KAAK,GAAE,WAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAKxE"}
|
|
@@ -0,0 +1,136 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.FiscalReference = exports.Kind = exports.KINDS = void 0;
|
|
4
|
+
exports.segment = segment;
|
|
5
|
+
const client_1 = require("./client");
|
|
6
|
+
const errors_1 = require("./errors");
|
|
7
|
+
/**
|
|
8
|
+
* One path segment, escaped, refusing the ones that would leave it.
|
|
9
|
+
*
|
|
10
|
+
* encodeURIComponent leaves "." alone — RFC 3986 calls it unreserved —
|
|
11
|
+
* so the dot segments have to be refused rather than escaped, or the
|
|
12
|
+
* HTTP client collapses ".." into a different endpoint.
|
|
13
|
+
*/
|
|
14
|
+
function segment(value) {
|
|
15
|
+
if (value === "" || value === "." || value === "..") {
|
|
16
|
+
throw new errors_1.ValidationError(`"${value}" is not a usable path segment`);
|
|
17
|
+
}
|
|
18
|
+
return encodeURIComponent(value);
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* The classifications with a named accessor on FiscalReference.
|
|
22
|
+
*
|
|
23
|
+
* Not the whole truth and not meant to be: ask kinds() for what the API
|
|
24
|
+
* actually has, because a classification published after this release
|
|
25
|
+
* is reachable through kind() with no release at all.
|
|
26
|
+
*/
|
|
27
|
+
exports.KINDS = [
|
|
28
|
+
"cfop",
|
|
29
|
+
"ncm",
|
|
30
|
+
"cest",
|
|
31
|
+
"cst",
|
|
32
|
+
"csosn",
|
|
33
|
+
"iss_service",
|
|
34
|
+
"icms_fuel",
|
|
35
|
+
"ibs_cbs_class",
|
|
36
|
+
];
|
|
37
|
+
function searchParams(kind, fallback, query) {
|
|
38
|
+
const params = {
|
|
39
|
+
country: query.country ?? fallback,
|
|
40
|
+
};
|
|
41
|
+
if (kind)
|
|
42
|
+
params.kind = kind;
|
|
43
|
+
if (query.term)
|
|
44
|
+
params.search = query.term;
|
|
45
|
+
if (query.limit !== undefined)
|
|
46
|
+
params.limit = String(query.limit);
|
|
47
|
+
if (query.offset !== undefined)
|
|
48
|
+
params.offset = String(query.offset);
|
|
49
|
+
return params;
|
|
50
|
+
}
|
|
51
|
+
/** One classification, bound to a country. */
|
|
52
|
+
class Kind {
|
|
53
|
+
call;
|
|
54
|
+
name;
|
|
55
|
+
country;
|
|
56
|
+
constructor(call, name, country) {
|
|
57
|
+
this.call = call;
|
|
58
|
+
this.name = name;
|
|
59
|
+
this.country = country;
|
|
60
|
+
}
|
|
61
|
+
/**
|
|
62
|
+
* One code. A code that does not exist is a 404, which arrives as an
|
|
63
|
+
* APIError — there is no separate not-found type.
|
|
64
|
+
*/
|
|
65
|
+
async get(code, country) {
|
|
66
|
+
return this.call(`/fiscal-references/${segment(this.name)}/${segment(code)}`, { country: country ?? this.country });
|
|
67
|
+
}
|
|
68
|
+
/**
|
|
69
|
+
* A page of this classification, filtered by the query's term when it
|
|
70
|
+
* has one. An empty term is no term: the route rejects search="" with
|
|
71
|
+
* a 422, and sending it would invent a failure the caller cannot read.
|
|
72
|
+
*/
|
|
73
|
+
async search(query = {}) {
|
|
74
|
+
return this.call("/fiscal-references", searchParams(this.name, this.country, query));
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
exports.Kind = Kind;
|
|
78
|
+
/**
|
|
79
|
+
* Reads the published classification tables. Nothing here is the
|
|
80
|
+
* company's own data and nothing here is writable.
|
|
81
|
+
*/
|
|
82
|
+
class FiscalReference extends client_1.Client {
|
|
83
|
+
cfop;
|
|
84
|
+
ncm;
|
|
85
|
+
cest;
|
|
86
|
+
cst;
|
|
87
|
+
csosn;
|
|
88
|
+
issService;
|
|
89
|
+
icmsFuel;
|
|
90
|
+
ibsCbsClass;
|
|
91
|
+
constructor(options = {}) {
|
|
92
|
+
super(options);
|
|
93
|
+
this.cfop = this.kind("cfop");
|
|
94
|
+
this.ncm = this.kind("ncm");
|
|
95
|
+
this.cest = this.kind("cest");
|
|
96
|
+
this.cst = this.kind("cst");
|
|
97
|
+
this.csosn = this.kind("csosn");
|
|
98
|
+
this.issService = this.kind("iss_service");
|
|
99
|
+
this.icmsFuel = this.kind("icms_fuel");
|
|
100
|
+
this.ibsCbsClass = this.kind("ibs_cbs_class");
|
|
101
|
+
}
|
|
102
|
+
/**
|
|
103
|
+
* Which classifications this country has rows for. The only honest
|
|
104
|
+
* answer to "what else is there" — a hard-coded list goes stale the
|
|
105
|
+
* next time the ETL grows one.
|
|
106
|
+
*/
|
|
107
|
+
async kinds(country) {
|
|
108
|
+
const response = await this.send("GET", "/fiscal-references/kinds", {
|
|
109
|
+
query: { country: country ?? this.country },
|
|
110
|
+
});
|
|
111
|
+
const text = await response.text();
|
|
112
|
+
if (!text)
|
|
113
|
+
return [];
|
|
114
|
+
const body = JSON.parse(text);
|
|
115
|
+
if (!Array.isArray(body)) {
|
|
116
|
+
throw new Error("unexpected response shape: expected a list");
|
|
117
|
+
}
|
|
118
|
+
return body;
|
|
119
|
+
}
|
|
120
|
+
/** Any classification by name, including one with no accessor. */
|
|
121
|
+
kind(name, country) {
|
|
122
|
+
return new Kind((path, query) => this.request("GET", path, { query }), name, country ?? this.country);
|
|
123
|
+
}
|
|
124
|
+
/**
|
|
125
|
+
* Every classification at once, which no accessor can express. The
|
|
126
|
+
* most expensive call the endpoint accepts: the whole country's
|
|
127
|
+
* tables, not one of them.
|
|
128
|
+
*/
|
|
129
|
+
async search(query = {}) {
|
|
130
|
+
return this.request("GET", "/fiscal-references", {
|
|
131
|
+
query: searchParams(null, this.country, query),
|
|
132
|
+
});
|
|
133
|
+
}
|
|
134
|
+
}
|
|
135
|
+
exports.FiscalReference = FiscalReference;
|
|
136
|
+
//# sourceMappingURL=reference.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"reference.js","sourceRoot":"","sources":["../src/reference.ts"],"names":[],"mappings":";;;AAUA,0BAKC;AAfD,qCAAiD;AACjD,qCAA2C;AAE3C;;;;;;GAMG;AACH,SAAgB,OAAO,CAAC,KAAa;IACnC,IAAI,KAAK,KAAK,EAAE,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACpD,MAAM,IAAI,wBAAe,CAAC,IAAI,KAAK,gCAAgC,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;GAMG;AACU,QAAA,KAAK,GAAG;IACnB,MAAM;IACN,KAAK;IACL,MAAM;IACN,KAAK;IACL,OAAO;IACP,aAAa;IACb,WAAW;IACX,eAAe;CACP,CAAC;AAiBX,SAAS,YAAY,CACnB,IAAmB,EACnB,QAAgB,EAChB,KAAkB;IAElB,MAAM,MAAM,GAA2B;QACrC,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,QAAQ;KACnC,CAAC;IACF,IAAI,IAAI;QAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;IAC7B,IAAI,KAAK,CAAC,IAAI;QAAE,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC;IAC3C,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;QAAE,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAClE,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;QAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACrE,OAAO,MAAM,CAAC;AAChB,CAAC;AAOD,8CAA8C;AAC9C,MAAa,IAAI;IAEI;IACR;IACA;IAHX,YACmB,IAAU,EAClB,IAAY,EACZ,OAAe;QAFP,SAAI,GAAJ,IAAI,CAAM;QAClB,SAAI,GAAJ,IAAI,CAAQ;QACZ,YAAO,GAAP,OAAO,CAAQ;IACvB,CAAC;IAEJ;;;OAGG;IACH,KAAK,CAAC,GAAG,CAAC,IAAY,EAAE,OAAgB;QACtC,OAAO,IAAI,CAAC,IAAI,CACd,sBAAsB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,EAAE,EAC3D,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC,OAAO,EAAE,CACrC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,QAAqB,EAAE;QAClC,OAAO,IAAI,CAAC,IAAI,CACd,oBAAoB,EACpB,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAC7C,CAAC;IACJ,CAAC;CACF;AA7BD,oBA6BC;AAED;;;GAGG;AACH,MAAa,eAAgB,SAAQ,eAAM;IAChC,IAAI,CAAO;IACX,GAAG,CAAO;IACV,IAAI,CAAO;IACX,GAAG,CAAO;IACV,KAAK,CAAO;IACZ,UAAU,CAAO;IACjB,QAAQ,CAAO;IACf,WAAW,CAAO;IAE3B,YAAY,UAAyB,EAAE;QACrC,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9B,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9B,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC3C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACvC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAChD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK,CAAC,OAAgB;QAC1B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,0BAA0B,EAAE;YAClE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC,OAAO,EAAE;SAC5C,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,CAAC,IAAI;YAAE,OAAO,EAAE,CAAC;QAErB,MAAM,IAAI,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,IAAgB,CAAC;IAC1B,CAAC;IAED,kEAAkE;IAClE,IAAI,CAAC,IAAY,EAAE,OAAgB;QACjC,OAAO,IAAI,IAAI,CACb,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,EACrD,IAAI,EACJ,OAAO,IAAI,IAAI,CAAC,OAAO,CACxB,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,QAAqB,EAAE;QAClC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,oBAAoB,EAAE;YAC/C,KAAK,EAAE,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC;SAC/C,CAAC,CAAC;IACL,CAAC;CACF;AA9DD,0CA8DC"}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import { Client, ClientOptions } from "./client";
|
|
2
|
+
/**
|
|
3
|
+
* Reads the taxpayer registry, one tax id at a time.
|
|
4
|
+
*
|
|
5
|
+
* One method, and it stays one method. The registry names and addresses
|
|
6
|
+
* real people and companies: an exact lookup answers the question an
|
|
7
|
+
* issuer has — who is this CNPJ I am about to invoice — and answers
|
|
8
|
+
* nothing else. A prefix or wildcard search over the same table is a
|
|
9
|
+
* bulk export wearing the costume of a query. Do not add one, not for
|
|
10
|
+
* parity with FiscalReference, not "just by name", not "just within one
|
|
11
|
+
* state".
|
|
12
|
+
*/
|
|
13
|
+
export declare class Taxpayer extends Client {
|
|
14
|
+
constructor(options?: ClientOptions);
|
|
15
|
+
/**
|
|
16
|
+
* One taxpayer, by exact tax id.
|
|
17
|
+
*
|
|
18
|
+
* A 404 arrives as an APIError and does not mean the taxpayer does
|
|
19
|
+
* not exist: the registry reloads monthly, so a company registered in
|
|
20
|
+
* the last few weeks is simply not in it yet. Never build a
|
|
21
|
+
* validation rule on top of it.
|
|
22
|
+
*/
|
|
23
|
+
get(taxId: string, country?: string): Promise<Record<string, unknown>>;
|
|
24
|
+
}
|
|
25
|
+
//# sourceMappingURL=taxpayer.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"taxpayer.d.ts","sourceRoot":"","sources":["../src/taxpayer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGjD;;;;;;;;;;GAUG;AACH,qBAAa,QAAS,SAAQ,MAAM;gBACtB,OAAO,GAAE,aAAkB;IAIvC;;;;;;;OAOG;IACG,GAAG,CACP,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAKpC"}
|
package/dist/taxpayer.js
ADDED
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.Taxpayer = void 0;
|
|
4
|
+
const client_1 = require("./client");
|
|
5
|
+
const reference_1 = require("./reference");
|
|
6
|
+
/**
|
|
7
|
+
* Reads the taxpayer registry, one tax id at a time.
|
|
8
|
+
*
|
|
9
|
+
* One method, and it stays one method. The registry names and addresses
|
|
10
|
+
* real people and companies: an exact lookup answers the question an
|
|
11
|
+
* issuer has — who is this CNPJ I am about to invoice — and answers
|
|
12
|
+
* nothing else. A prefix or wildcard search over the same table is a
|
|
13
|
+
* bulk export wearing the costume of a query. Do not add one, not for
|
|
14
|
+
* parity with FiscalReference, not "just by name", not "just within one
|
|
15
|
+
* state".
|
|
16
|
+
*/
|
|
17
|
+
class Taxpayer extends client_1.Client {
|
|
18
|
+
constructor(options = {}) {
|
|
19
|
+
super(options);
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
* One taxpayer, by exact tax id.
|
|
23
|
+
*
|
|
24
|
+
* A 404 arrives as an APIError and does not mean the taxpayer does
|
|
25
|
+
* not exist: the registry reloads monthly, so a company registered in
|
|
26
|
+
* the last few weeks is simply not in it yet. Never build a
|
|
27
|
+
* validation rule on top of it.
|
|
28
|
+
*/
|
|
29
|
+
async get(taxId, country) {
|
|
30
|
+
return this.request("GET", `/taxpayers/${(0, reference_1.segment)(taxId)}`, {
|
|
31
|
+
query: { country: country ?? this.country },
|
|
32
|
+
});
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
exports.Taxpayer = Taxpayer;
|
|
36
|
+
//# sourceMappingURL=taxpayer.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"taxpayer.js","sourceRoot":"","sources":["../src/taxpayer.ts"],"names":[],"mappings":";;;AAAA,qCAAiD;AACjD,2CAAsC;AAEtC;;;;;;;;;;GAUG;AACH,MAAa,QAAS,SAAQ,eAAM;IAClC,YAAY,UAAyB,EAAE;QACrC,KAAK,CAAC,OAAO,CAAC,CAAC;IACjB,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,GAAG,CACP,KAAa,EACb,OAAgB;QAEhB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,cAAc,IAAA,mBAAO,EAAC,KAAK,CAAC,EAAE,EAAE;YACzD,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC,OAAO,EAAE;SAC5C,CAAC,CAAC;IACL,CAAC;CACF;AArBD,4BAqBC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@stackin-io/stackin-node-sdk",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.13.0",
|
|
4
4
|
"description": "Node/TypeScript SDK for stackin — issue, consult and cancel Brazilian fiscal documents (NF-e, NFS-e) via a single Invoice client. No certificates, XML or SOAP.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"stackin",
|