https://github.com/startxfr/siren2tva
Node module to convert siren /siret code into French VAT Number
https://github.com/startxfr/siren2tva
Last synced: 2 months ago
JSON representation
Node module to convert siren /siret code into French VAT Number
- Host: GitHub
- URL: https://github.com/startxfr/siren2tva
- Owner: startxfr
- License: apache-2.0
- Created: 2018-01-26T10:23:58.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-05-28T22:06:57.000Z (12 months ago)
- Last Synced: 2024-05-29T13:04:40.527Z (12 months ago)
- Language: JavaScript
- Size: 92.8 KB
- Stars: 4
- Watchers: 2
- Forks: 1
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# siren2tva  [](https://github.com/startxfr/siren2tva) [](https://github.com/startxfr/siren2tva) [](https://siren2tva.readthedocs.io)
NodeJS module to manipulate French SIREN / SIRET or VAT Number in either way.
This module will also retrieve legals informations such as legal form, company name, capital
and adress from valid SIRET, SIREN or VAT numbers using French State OpenData Api.
Features included :
- Convert SIRET to VAT number
- Convert SIREN to VAT number
- Convert VAT number to SIREN
- Clean SIRET / Siret or VAT number form space between numbers
- Check if a number is a valid SIRET
- Check if a number is a valid SIREN
- Check if a number is a valid VAT number
- Return legals informations about the company coresponding to a given SIREN / SIRET or VAT number
- Return the name of the company coresponding to a given SIREN / SIRET or VAT number
- Return the adress of the company coresponding to a given SIREN / SIRET or VAT number
- Return the capital amount of the company coresponding to a given SIREN / SIRET or VAT number
- Return the legal form of the company coresponding to a given SIREN / SIRET or VAT number
- Return the last update recorded for the company coresponding to a given SIREN / SIRET or VAT number
## Installation
```bash
npm install siren2tva --save
```
## Usage example
```js
var siren2tva = require('siren2tva');
siren2tva({ longCode: true });
console.log(siren2tva.siret2tva('44997052400038'));
// Return FR26449970524
```
## Documentation
You can find example of all siren2tva function like siren2tva, tva2siren, check.isSIRET, check.isSIREN, check.isTVA, getInfoNom
, getInfoAdress, getInfoCapital, getInfoLegal, getInfoLastUpdate, getInfo in the [siren2tva full documentation](https://siren2tva.readthedocs.io/).
## Troubleshooting
If you run into difficulties installing or running siren2tva, you can [create an issue](https://github.com/startxfr/siren2tva/issues/new).
## Built With
- [Node.js](https://nodejs.org/) - Runtime environement
- [npm](https://www.npmjs.com/) - Packet manager
- [siret module](https://github.com/steevelefort/siret) - SIRET module by Steeve LEFORT
- [OpenData GovFr](https://entreprise.data.gouv.fr) - Opendata platform fro the French State database
## Contributing
Read the [contributing guide](https://github.com/startxfr/sxapi-core/tree/master/docs/5.Contribute.md) for details on our code of conduct, and the process for submitting pull requests to us.
## Authors
This project is mainly developped by the [startx](https://www.startx.fr) dev team. You can see the complete list of contributors who participated in this project by reading [CONTRIBUTORS.md](https://github.com/startxfr/sxapi-core/tree/master/docs/CONTRIBUTORS.md).
## License
This project is licensed under the Apache License Version 2.0 - see the [LICENSE](https://github.com/startxfr/siren2tva/tree/master/LICENSE) file for details