Per Iniziare

Quick Start

Inizia rapidamente con l'SDK

Quick Start

Guida rapida per inviare la prima fattura elettronica.

1. Autenticazione

import { ArubaClient } from '@fatturazione-elettronica-aruba/core';

const client = new ArubaClient({
  environment: 'demo',
});

// Login
await client.auth.signin('username', 'password');

// Info utente
const userInfo = await client.auth.getUserInfo();
console.log('P.IVA:', userInfo.vatCode);

2. Invio Fattura

import { InvoicesClient } from '@fatturazione-elettronica-aruba/invoices';
import { encodeBase64 } from '@fatturazione-elettronica-aruba/utils';
import { readFileSync } from 'fs';

const invoices = new InvoicesClient(client.http);

// Leggi XML fattura
const xml = readFileSync('fattura.xml', 'utf-8');

// Invia
const result = await invoices.upload({
  dataFile: encodeBase64(xml),
});

console.log('Filename:', result.uploadFileName);

3. Verifica Stato

const sent = await invoices.findSent({
  creationStartDate: '2024-01-01T00:00:00.000Z',
  creationEndDate: '2024-01-02T00:00:00.000Z',
});

for (const invoice of sent.content) {
  console.log(`${invoice.filename}: ${invoice.invoices[0]?.status}`);
}

4. Notifiche

import { NotificationsClient } from '@fatturazione-elettronica-aruba/notifications';

const notifications = new NotificationsClient(client.http);

const notifs = await notifications.getSentNotifications({
  invoiceFilename: 'IT01234567890_00001.xml',
});

for (const n of notifs.notifications) {
  console.log(`${n.docType}: ${n.filename}`);
}

Prossimi Passi