fattura24-api-js
Version:
Fattura24 API wrapper for Node.js
97 lines (86 loc) • 2.6 kB
Markdown
[](https://www.npmjs.com/package/fattura24-api-js)
[](https://opensource.org/licenses/MIT)
[](http://standardjs.com/)
# Fattura24 API Wrapper ~ Node.js
A simple Node.js wrapper to work with the API exposed by [Fattura24](https://www.fattura24.com/api-documentazione/).
## Usage
This package in simply a wrapper for the Fattura24 API. It's a collection of methods that reflects all the API endpoints. The main advantage is the avoidance of the xml manipulation because all the input and output payloads are JSON objects.
#### Install it
```bash
$ yarn install fattura24-api-js
# OR npm install fattura24-ap-js
```
#### Require it
```javascript
const Fattura24API = require('fattura24-api-js')
```
#### Use it
```javascript
const fattura24 = new Fattura24API('InSert4PIKeyHeRe')
// Create or update a customer
await fattura24.saveCustomer({
CustomerName: 'Marta Bianchi',
CustomerCountry: 'IT',
CustomerVatCode: '000000000'
})
// Create a new document (ie. invoice)
await fattura24.saveDocument({
DocumentType: 'I',
CustomerName: 'Mario Rossi',
CustomerAddress: 'Via Milano, 10',
CustomerPostcode: 24040,
CustomerCity: 'Bergamo',
CustomerProvince: 'BG',
CustomerCountry: 'IT',
CustomerVatCode: '000000000',
CustomerCellPhone: '0000000000',
DeliveryName: 'Mario Rossi',
TotalWithoutTax: 900,
VatAmount: 198,
Total: 1098,
F24OrderId: 12345,
Payments: [
{
Payment: {
Date: '2020-01-01',
Amount: 100,
Paid: true
}
},
{
Payment: {
Date: '2020-01-02',
Amount: 100,
Paid: false
}
}
],
Rows: [
{
Row: {
Code: 'B100',
Description: 'Work test - 1',
Qty: 2,
Price: 300,
VatCode: 22,
VatDescription: '22%'
}
}
]
})
```
## Changelog
### [0.0.5] - 2020-08-25
- Deps update
### [0.0.4] - 2020-03-22
- Deps update
### [0.0.3] - 2020-03-22
- Removed customer error
- Add dynamic methods to eliminate duplicate code
### [0.0.2] - 2020-03-21
- Added Helpers class for XML building
### [0.0.1] - 2020-03-21
- First release
## License and Copyright
Licensed under [MIT](http://www.opensource.org/licenses/mit-license.php) license.
(c) 2020 [Daniele Lenares](https://dnlnrs.dev)