@rantalainen/fennoa-api-client v0.1.0

fennoa-api-client

FennoaApiClient is a third party Fennoa API client.

:warning: This tool is in early stages and is subject to change.

Installation

Add to project's package.json:

npm install @rantalainen/fennoa-api-client

Setup

Import to NodeJS project

const { FennoaApiClient } = require('@rantalainen/fennoa-api-client');

Import to TypeScript project

import { FennoaApiClient } from '@rantalainen/fennoa-api-client';

Setup client with options

In order to obtain an API key, please contact Fennoa Sales or Fennoa Support. An API key is needed to access all API functions.

const fennoa = new FennoaApiClient({
  // Mandatory options:
  fennoaUser: 'selected_company_identifier',
  fennoaPassword: 'api_key',

  // Optional options (and default values):
  apiBaseUrl: 'https://app.fennoa.com/api',
  timeout: 120000
});

Implemented methods

The following api methods have been implemented:

• customers Customers
• sales Sales invoices

Getter examples

Each resource type has getAll() and getById(1234) getters (below examples with customers):

const customers = await fennoa.customers.getAll(); // array of customers
const customer = await fennoa.customers.getById(1234); // single customer

Sales examples

Here is an example of creating, approving and sending a new sales invoice to a customer:

const invoice = {
  name: 'Customer Inc',
  address: 'Mariankatu 2',
  postalcode: '00170',
  city: 'Helsinki',
  country: 'FI',
  invoice_date: '2018-12-12',
  due_date: '2018-12-26',
  row: [
    {
      name: 'My product',
      description: 'Describe product here',
      price: 14.5,
      quantity: 3,
      vatpercent: 14
    },
    {
      name: 'My service',
      description: 'Describe service here',
      price: 56.66,
      quantity: 12.5,
      vatpercent: 24
    }
  ]
};

// Create a new sales invoice to Fennoa
const newInvoiceId = await fennoa.sales.createInvoice(invoice);
console.log(`Sales invoice #${newInvoiceId} created`);

// Approve created sales invoice and send it to customer
await fennoa.sales.approveInvoice(newInvoiceId);
await fennoa.sales.sendInvoice(newInvoiceId);
console.log(`Sales invoice #${newInvoiceId} approved and sent to customer`);

Create a new sales invoice using FORM DATA:

const newInvoiceId = await fennoa.sales.createInvoiceByFormData(formData);

Create a new sales invoice from Finvoice XML data:

const newInvoiceId = await fennoa.sales.createInvoiceByFinvoiceXML(xml);

Purchases examples

Here is an example of fetching all purchase invoices from approval queue:

const purchases = await fennoa.purchases.getApprovalQueue();

Fetch single purchase invoice by ID:

const purchaseInvoice = await fennoa.purchases.getPurchaseInvoiceById(12);

Approve purchase invoice by approval ID with an optional comment:

fennoa.purchases.approvePurchaseInvoice(2, 'Approved by automation');

Add payment to purchase invoice:

const paymentInfo = {
  purchase_invoice_id: 2,
  sum: 100,
  payment_date: '2025-03-01',
  description: 'Paid by automation'
};

await fennoa.purchases.addPurchasePayment(paymentInfo);

Resources

• Fennoa website: https://www.fennoa.com/
• Fennoa API Documentation: https://www.fennoa.com/api-documentation/
• Fennoa login page: https://app.fennoa.com/login