fattura24-api-js

Fattura24 API Wrapper ~ Node.js

A simple Node.js wrapper to work with the API exposed by Fattura24.

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

$ yarn install fattura24-api-js
# OR npm install fattura24-ap-js 

Require it

const Fattura24API = require('fattura24-api-js')

Use it

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 license.

(c) 2020 Daniele Lenares