TypeScript SDK for Aruba Electronic Invoicing

Integrate Aruba Electronic Invoicing API v2 into your Node.js project. Send and receive electronic invoices, manage SDI notifications and AdE communications with a modern, type-safe API.

Get Started Quick Start

Features

Everything you need for electronic invoicing

A complete and modular SDK covering the entire lifecycle of Italian electronic invoices.

Invoice Management

Send outbound invoices to SDI and receive inbound ones. Advanced search, XML download, dry-run validation and delivery monitoring.

SDI Notifications

Monitor invoice status in real-time. RC, MC, NS, DT and all Sistema di Interscambio notifications.

OAuth2 Authentication

Secure login with automatic token refresh. Multi-company support for intermediaries and accountants.

AdE Communications

Periodic VAT settlements and invoice data communications to the Revenue Agency.

XML Builder

Generate FatturaPA XML with type-safe fluent API. Automatic validation and full standard support.

Nuxt Module

Native Nuxt 3 integration. Auto-imported server-side composables and simplified configuration.

Architecture

Modular by design

Install only the packages you need. No unnecessary dependencies in your bundle.

@fatturazione-elettronica-aruba/core

HTTP client, OAuth2 authentication and token management. Foundation for all packages.

@fatturazione-elettronica-aruba/invoices

Send and receive invoices, advanced search and XML download.

@fatturazione-elettronica-aruba/notifications

SDI notifications: delivery, rejection, failed delivery and expiration.

@fatturazione-elettronica-aruba/communications

VAT settlements and invoice data communications to AdE.

@fatturazione-elettronica-aruba/utils

Pure utilities: base64 encoding, date formatting, validation.

@fatturazione-elettronica-aruba/xml-builder

Generate FatturaPA XML with type-safe fluent API and validation.

Developer Experience

Built for developers

Modern API with everything you need to develop with confidence.

TypeScript First

Full end-to-end typing. Intelligent autocompletion and safe refactoring.

ESM & CommonJS

Compatible with any setup. Works everywhere without configuration.

Zero Dependencies

No runtime dependencies. Minimal bundle size and no conflicts.

Demo & Production

Switch from sandbox to production by changing a single configuration.

Typed Errors

Each error has its class with code, message and structured details.

Documentation

Complete guides, practical examples and detailed API reference.

Ready to get started?

Install the SDK and send your first electronic invoice in minutes.

Get Started GitHub