What’s changing at Factuarea.
Releases, contract changes and tooling updates for your integration.
Delete and archive contacts
Breaking change: DELETE /v1/contacts/{id} and POST /v1/contacts/bulk-delete now delete instead of archiving, and the deletion cannot be undone through the API. Archiving moves to POST /v1/contacts/{id}/archive, is always allowed and stays reversible. A contact.deleted webhook event is published and the contact_has_commercial_references subcode disappears.
Read updateNew endpoints1
| Endpoint | Description |
|---|---|
POST/v1/contacts/{contact}/archive | Archive a contact |
Updated endpoints3
| Endpoint | Description |
|---|---|
DEL/v1/contacts/{contact} | Delete a contact |
POST/v1/contacts/bulk-delete | Delete contacts in bulk |
POST/v1/contacts/bulk/archive | Archive contacts in bulk |
Measured purchase lines
Purchase invoice lines now record the packages received, the unit the supplier cost applies to and the real measured quantity. The contract adds a measurement block, persists line discounts, resolves the cost from the supplier offer and duplicates a purchase from an authorised source.
Read updateUpdated endpoints4Preview
| Endpoint | Description |
|---|---|
POST/v1/purchase_invoices | Create a purchase invoice |
PUT/v1/purchase_invoices/{purchase_invoice} | Update a purchase invoice |
GET/v1/purchase_invoices/{purchase_invoice} | Retrieve a purchase invoice |
PDF capabilities on the account
The Account resource and the templates endpoint expose a read-only capabilities block: what the plan allows in document branding, which templates can be set and which plan unlocks the editor. Personalization updates outside the plan now return 403.
Read updateUpdated endpoints3
| Endpoint | Description |
|---|---|
GET/v1/account | Retrieve account details |
GET/v1/account/personalization/templates | List available personalization templates |
PATCH/v1/account/personalization | Update account personalization |
Canonical contacts API
Manage one identity with cumulative customer, supplier and lead roles. The canonical API now covers bulk creation and archival, direct identifier lookup, AEAT census verification, statistics, activity and imports.
Read updateNew endpoints26Preview
| Endpoint | Description |
|---|---|
GET/v1/contacts | List contacts |
POST/v1/contacts | Create a contact |
GET/v1/contacts/options | List contact filter options |
Stores, MCP and complete response examples
Connect WooCommerce and Shopify stores, work with order snapshots and use the updated MCP transport. Every documented response now has an explicit example or the appropriate download representation.
Read updateNew endpoints7Preview
| Endpoint | Description |
|---|---|
POST/v1/stores | Connect a store |
GET/v1/stores | List connected stores |
DEL/v1/stores/{store} | Disconnect a store |
Configurable catalog selections and exact prices
Configure which product combinations can be sold and resolve exact negotiated prices. The API adds selection lookup, stock auditing and bulk price resolution.
Read updateNew endpoints8Preview
| Endpoint | Description |
|---|---|
GET/v1/products/{product}/configurations | List product commercial combinations |
GET/v1/products/{product}/options | List product option groups |
GET/v1/products/{product}/stock-movements | List stock movements of a product |
v1.13.0 — Contract parity
Product-write semantics, expanded OAuth consent, plan-derived API capacity and multiline PDF notes.
Read updateUpdated endpoints2
| Endpoint | Description |
|---|---|
POST/v1/products | Create a product |
PUT/v1/products/{product} | Update a product |
Complete product catalog and price-list coverage
Manage product presentations, variants, supplier offers and price lists. Documents keep price snapshots and make repricing explicit.
Read updateNew endpoints23Preview
| Endpoint | Description |
|---|---|
POST/v1/price-lists | Create a price list |
GET/v1/price-lists | List price lists |
POST/v1/products/{product}/presentations | Create a product presentation |
Bulk-send MCP tools now enforce the 200-id batch limit
MCP bulk-send tools now reject batches larger than 200 IDs with a clear error. REST behavior is unchanged.
Read updateAutomations
Build event-driven rules, preview their effects and inspect each execution. Eighteen operations cover rules, versions, runs, replay and usage.
Read updateNew endpoints18Preview
| Endpoint | Description |
|---|---|
POST/v1/automations/rules/{rule}/activate | Activate an automation rule |
POST/v1/automations/rules | Create an automation rule |
GET/v1/automations/rules | List your automation rules |
Tax reports: working workbook and agent tools
Tax reports use an Excel working workbook and expose nine MCP tools. Existing report endpoints now document their supported output formats precisely.
Read updateUpdated endpoints4Preview
| Endpoint | Description |
|---|---|
POST/v1/tax_reports/130 | Generate Modelo 130 |
POST/v1/tax_reports/303 | Generate Modelo 303 |
POST/v1/tax_reports/347 | Generate Modelo 347 |
Payment reversal
Reverse a payment while preserving the original record and its audit trail. The invoice balance reflects the reversal and integrations receive the corresponding event.
Read updateNew endpoints1
| Endpoint | Description |
|---|---|
POST/v1/invoices/{invoice}/payments/{payment}/reversal | Revert an invoice payment |
Time tracking (control horario)
Manage work schedules, time entries, absences, balances and presence through the API and MCP, using the same permission model as the rest of the platform.
Read updateAPI and MCP included in every plan
Public API and MCP access are included in every Factuarea plan. Request limits follow the active plan and access is also available during the trial.
Read updatePlatform launch
The public platform brings together REST API v1, official TypeScript and PHP SDKs, the CLI and MCP, with an isolated sandbox for testing integrations.
Read update