Which integration options does Factuarea provide?

The official TypeScript and PHP SDKs include retries, idempotency, pagination and webhook verification. The OpenAPI 3.1 specification is also public for generating and maintaining your own client.

How do I test without touching anything real?

Generate a fact_test_ key to use the isolated sandbox company. Fiscal submissions and emails are blocked; external webhooks are limited to ping. To work with real data, use a fact_live_ key generated for production.

Can a retry duplicate an invoice?

The SDK preserves the Idempotency-Key across retries of a request. If your application invokes the operation again, pass the same custom key so the API recognizes it. A new call with another key represents another operation.

Can I call the SDK from the browser?

No. The key is a secret and whoever holds it can invoice in your name: the SDK belongs on your server. Not in an SPA, not in a mobile app, not in any public client.

Official Factuarea SDKs

Invoicing SDKs for Node.js, TypeScript and PHP

Bring invoices, contacts and payments into your application with the official packages. Install the SDK, connect your key and use the Factuarea API from your backend.

Start free The SDK guide

Node.js 20+ and PHP 8.2+
Install with npm or Composer
Sandbox key available

Compatible integrations and formats

SDK · Official SDKs

$ npm install @factuarea/sdk

invoices.ts

import { Factuarea } from "@factuarea/sdk";

const factuarea = new Factuarea({
  apiKey: process.env.FACTUAREA_API_KEY!,
});

const invoices = await factuarea.invoices.list();

for await (const item of invoices) {
  const invoice = item as { id: string };
  console.log(invoice.id);
}

The SDK follows each page; your code works with each invoice.

GET /v1/invoicesYour invoices, from code

Retrieve documents to reconcile them, sync them with your ERP or prepare a report.

F-2026-142Estudio Ribera

F-2026-143Taller Norte

F-2026-144Nexo Digital

has_more: trueNext page

v0.9.0npm

Integrate with Node.js

Less infrastructure, more product

What your integration needs after the first 200

Fetching an invoice is only the beginning. The SDKs include tools for traversing data, handling responses and verifying notifications without rebuilding each piece.

Retries with a stable identity

Configurable retries for 429 and 5xx responses. In TypeScript 0.6.0, Retry-After is capped at 32 seconds by default; if the API requests longer, handle that wait in your integration. Keep your Idempotency-Key when repeating an operation.

429200 OKIdempotency-Key: order_1042

Prevent duplicate operations

From one page to the whole list

TypeScript provides async iteration; PHP includes PageIterator. Traverse invoices and other cursor-based lists without maintaining a manual request loop.

Understand pagination

Verify who sent the event

Both SDKs verify the HMAC signature, message age and signatures during rotation. Your receiver preserves the raw body and decides how to handle the event.

HMAC-SHA256raw body + signature + secret

Connect webhooks

One API, several business processes

Bring invoicing into the work you already do

The SDKs access the public API resources. Your key’s permissions, plan and company settings determine which operations are available.

From order to invoice

Create a draft with a customer, series and lines. Assign its number through the dedicated operation, download the PDF and check its fiscal status when applicable.

Explore the invoicing flow 02

Contacts and catalog in sync

Connect customers, suppliers, products and price lists to your software. Use external IDs to link each resource to its record in your system.

Explore API resources 03

Payments linked to their documents

Check outstanding amounts, record payments and retrieve invoice status. Bring that information into your reconciliation and follow-up processes.

Explore payment management 04

Workflows that respond to changes

Combine SDK calls with webhooks: an approved quote can start your sales process and a received payment can update your CRM. You define the logic.

Design an event-driven flow

Choose with the contract in view

Two languages. The same invoicing API

Each SDK follows its language’s conventions. For Python, Go, Java or C#, call REST directly or generate a client from OpenAPI and add the runtime behavior your integration needs.

Open the OpenAPI contract

OpenAPI 3.1api.factuarea.com/v1

LanguageTypeScriptPHP

Methodsinvoices.list()publicApiV1InvoicesList()

Paginationfor await…ofPageIterator

ErrorsValidationError
RateLimitErrorApiException

ResponsesSome results require an explicit type.Generated response models.

0.x releases: review the changelog, pin dependencies and validate updates before production.

Choose your connection

An integration that fits your stack

Work with an SDK, explore the API contract or connect your assistant. Choose your tool to find the right starting point and documentation.

Compatible technologies and clients

Your tool → Factuarea

Official SDK

Your integration, in TypeScript

Install the official SDK to work with the API from Node.js. Includes retries, pagination and webhook signature verification.

npm install @factuarea/sdkConnect TypeScript

API operations: 595
resources: 50
MCP tools: 581
documentation pages: 1306

Questions

What people ask before pinning the dependency

You can integrate it in production. Before version 1.0.0, minor updates may include breaking changes: pin the dependency, review the changelog and validate updates. You can also pin Factuarea-Version to control the API version.

A more connected business

Your next integration starts in code

Create an account and generate a sandbox key. Once you have validated the flow, use a production key with the permissions your application needs.

Start free See the quickstart