npmpackage.info

node-tra

1.1.2

JavaScript

32.94 kB

Installations

npm install node-tra

Developer Guide

BETA

Typescript

No

Module System

CommonJS

Node Version

12.21.0

NPM Version

6.14.11 Score

65.4

Supply Chain

97.1

Quality

Maintenance

100

Vulnerability

99.3

License

Pull Requests

Open

0

Total

0

Closed

0

Issues

Open

0

Total

1

Closed

1

Releases

Unable to fetch releases

Contributors

Unable to fetch Contributors

View all 1 contributors

Languages

JavaScript

JavaScript (100%)

Developer

husseinmkwizu

Download Statistics

Total Downloads

3,275

Last Day

Last Week

Last Month

Last Year

625

GitHub Statistics

7 Stars

22 Commits

8 Forks

1 Watching

2 Branches

1 Contributors

Bundle Size

106.47 kB

Minified

32.94 kB

Minified + Gzipped

Bundlephobia

Maintainers

Package Meta Information

Latest Version

1.1.2

Package Id

node-tra@1.1.2

Unpacked Size

29.00 kB

Size

6.05 kB

File Count

NPM Version

6.14.11

Node Version

12.21.0

Total Downloads

Cumulative downloads

Total Downloads

3,275

Last day

-50%

Compared to previous day

Last week

-63.6%

Compared to previous week

Last month

Compared to previous month

Last year

49.2%

625

Compared to previous year

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

pem xml-js

Dev Dependencies

@babel/cli @babel/core @babel/plugin-proposal-optional-chaining @babel/preset-env rimraf

Versions

node-tra

This package implements TRA (Tanzania Revenue Authority) APIs.

Install

via NPM

npm install node-tra --save

via yarn

yarn add node-tra

Load key certificate

Before calling any APIs, you will need to load your key certificate. You can use this helper function to do so.

1import { loadKeyCertificate } from "node-tra";
2
3const { key } = await loadKeyCertificate(
4  "YOUR KEY FILE PATH",
5  "YOUR KEY PASSWORD"
6);

Registration

To get details about your company you need to call registration API. You call this once. You can reuse the result in the next steps.

1import { sendRegistrationRequest } from "node-tra";
2
3//test environment details
4const hostname = "virtual.tra.go.tz";
5const path = "/efdmsRctApi/api/vfdRegReq";
6
7const response = await sendRegistrationRequest({
8  tin: "YOUR TIN",
9  certKey: "YOUR CERT KEY",
10  signKey: key, //key loaded from first step
11  certSerial: "YOUR CERT SERIAL",
12  hostname: hostname,
13  path: path,
14});
15
16//if successful, response.success == true
17const { success, data } = response;

Token

To upload receipts/invoices you will need to provide a token to TRA API. To get the token call this helper function.

1import { sendTokenRequest } from "node-tra";
2
3//test environment details
4const hostname = "virtual.tra.go.tz";
5const path = "/efdmsRctApi/vfdtoken";
6
7const response = await sendTokenRequest({
8  username: "USERNAME FROM REGISTRATION API",
9  password: "PASSWORD FROM REGISTRATION API",
10  grantType: "password",
11  hostname: hostname,
12  path: path,
13});
14
15//if successful, response.success == true
16const { success, data } = response;

Upload invoice/receipt

1import { sendUploadInvoiceRequest } from "node-tra";
2
3//test environment details
4const hostname = "virtual.tra.go.tz";
5const path = "/efdmsRctApi/api/efdmsRctInfo";
6
7const response = await sendUploadInvoiceRequest({
8  tin: "YOUR TIN",
9  signKey: key, //key loaded from first step
10  certSerial: "YOUR CERT SERIAL",
11  token: "YOUR TOKEN",
12  routingKey: "ROUTING KEY FROM REGISTRATION API",
13  hostname: hostname,
14  path: path,
15  date: "2021-02-03",
16  time: "20:52:53",
17  regId: "REGID FROM REGISTRATION API",
18  efdSerial: "EFDSERIAL FROM REGISTRATION API",
19  receiptCode: "RECEIPTCODE FROM REGISTRATION API",
20  rctNum: "10103",
21  zNum: "20210203",
22  dc: "1",
23  gc: "10103",
24  customerId: "",
25  customerIdType: "6",
26  customerName: "John Doe",
27  mobileNumber: "255755123123",
28  items: [
29    {
30      ID: 1,
31      DESC: "Product 1",
32      QTY: 1,
33      TAXCODE: 1,
34      AMT: "118000.00",
35    },
36  ],
37  totals: {
38    TOTALTAXEXCL: "100000.00",
39    TOTALTAXINCL: "118000.00",
40    DISCOUNT: "0.00",
41  },
42  payments: {
43    PMTTYPE: "EMONEY",
44    PMTAMOUNT: "118000.00",
45  },
46  vatTotals: {
47    VATRATE: "A",
48    NETTAMOUNT: "100000.00",
49    TAXAMOUNT: "18000.00",
50  },
51});
52
53//if successful, response.success == true
54const { success, data } = response;

No vulnerabilities found.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

SAST

Determines if the project uses static code analysis.

1

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

1

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

0

Maintained

Determines if the project is "actively maintained".

0

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Security-Policy

Determines if the project has published a security policy.

0

Fuzzing

Determines if the project uses fuzzing.

0

License

Determines if the project has defined a license.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

Score

3

/10

Last Scanned on 2024-12-16

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More

Other packages similar to node-tra

node-tra-sdk

0.1.4

The **TRA SDK for Node.js** makes it easy for developers to access [TRA API](#) in their Javascript code, and build robust applications.