Què canvia a Factuarea.
Versions, canvis de contracte i novetats de les eines per a la teva integració.
Ofertes i preu anterior
Posa productes i packs en oferta amb dates i canals. Les lectures exposen l'oferta i el preu anterior legal, i la resolució de preus admet data, canal i el client de la web.
Llegeix la novetatNous endpoints6Vista prèvia
| Endpoint | Descripció |
|---|---|
GET/v1/companies/{company}/promotions | Llistar totes les ofertes |
POST/v1/companies/{company}/promotions | Crear una oferta |
GET/v1/companies/{company}/promotions/{promotion} | Consultar una oferta |
Endpoints actualitzats67Vista prèvia
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/pdf-templates/{template}/archive | Arxivar una plantilla PDF |
POST/v1/companies/{company}/invoices/bulk-create | Crear factures en bloc |
POST/v1/accounts/{account}/webhooks | Crear un webhook endpoint de compte |
Packs i un aparador comú per a productes
Els packs tenen la seva pròpia API amb imatges i vista d'aparador, els productes es poden publicar a la web amb preu amb i sense IVA, i les factures admeten línies de pack amb el preu cobrat.
Llegeix la novetatNous endpoints12Vista prèvia
| Endpoint | Descripció |
|---|---|
GET/v1/companies/{company}/packs | Llistar tots els packs |
POST/v1/companies/{company}/packs | Crear un pack |
GET/v1/companies/{company}/packs/{pack} | Consultar un pack |
Endpoints actualitzats104Vista prèvia
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/invoices/bulk-create | Crear factures en bloc |
POST/v1/accounts/{account}/webhooks | Crear un webhook endpoint de compte |
POST/v1/accounts/{account}/api-keys | Crear una API key |
Raó social i nom comercial d'una empresa
name és el nom amb què es coneix una empresa i business_name la seva raó social quan és diferent. Les respostes segueixen aquest contracte a totes les empreses, l'edició parcial es resol sobre els noms actuals i tots dos camps admeten fins a 100 caràcters.
Llegeix la novetatEndpoints actualitzats8Vista prèvia
| Endpoint | Descripció |
|---|---|
POST/v1/accounts/{account}/companies | Registrar un NIF al compte |
PATCH/v1/accounts/{account}/companies/{company} | Actualitzar un NIF del compte |
GET/v1/accounts/{account}/companies/{company} | Obtenir un NIF del compte |
Un empleat donat de baixa és de només lectura
Fitxar l'entrada, assignar un horari o una política d'absències, aprovar una absència que passa de la baixa i convidar al portal un empleat donat de baixa responen 422 amb el subcode employee_inactive. El resum d'equip llista tot empleat d'alta durant el mes, tingui horari o no.
Llegeix la novetatEndpoints actualitzats7Vista prèvia
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/time-entries/clock-in | Fitxar l'entrada d'un empleat |
POST/v1/companies/{company}/work-schedules/{schedule}/assign | Assignar un horari a un empleat |
POST/v1/companies/{company}/absence-policies/{absence_policy}/assign | Assignar una política a empleats |
Places contractades, paquets d'oferta i prova
La factura segueix les places que contractes: crear un empleat ocupa una plaça lliure, reduir té efecte a la renovació sense abonament i tries a qui es desactiva. Quatre operacions noves fixen i previsualitzen les places, l'API REST i el MCP compren soles les places que falten, els paquets d'oferta conserven els seus preus mentre es mantenen els seus mínims i la prova respon amb el seu propi motiu.
Llegeix la novetatNous endpoints4Vista prèvia
| Endpoint | Descripció |
|---|---|
GET/v1/accounts/{account}/additional-nif-seats | Obtenir les places de NIF addicional |
PATCH/v1/accounts/{account}/additional-nif-seats | Fixar les places de NIF addicional contractades |
PATCH/v1/accounts/{account}/employee-seats | Fixar les places d'empleat contractades |
Endpoints actualitzats98Vista prèvia
| Endpoint | Descripció |
|---|---|
POST/v1/accounts/{account}/nif-transfers/accept | Acceptar un traspàs de NIF |
POST/v1/accounts/{account}/companies/activate | Activar diversos NIF del compte |
POST/v1/accounts/{account}/companies/{company}/activate | Activar un NIF del compte |
Pagaments anticipats i validació de la data de pagament
Una data de pagament anterior a la d'emissió s'accepta ara com a pagament anticipat, i una data de pagament posterior a avui respon 422. Afecta vendes i despeses, marcar com a pagada i registrar un pagament.
Llegeix la novetatEndpoints actualitzats4Vista prèvia
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/invoices/{invoice}/mark-paid | Marca la factura com a pagada |
POST/v1/companies/{company}/invoices/{invoice}/payments | Registrar un pagament |
POST/v1/companies/{company}/purchase-invoices/{purchase_invoice}/mark-paid | Marca la despesa com a pagada |
Envia cada factura automàtica a qui paga
Els comptes connectats de Stripe accepten email_invoice_to_payer, que envia per correu cada factura que Factuarea emet automàticament a l'adreça que arriba amb el cobrament. Tres operacions actualitzades i una tool MCP actualitzada.
Llegeix la novetatEndpoints actualitzats3
| Endpoint | Descripció |
|---|---|
GET/v1/companies/{company}/connected-accounts | Llistar comptes Stripe connectats |
GET/v1/companies/{company}/connected-accounts/{account} | Obtenir un compte Stripe connectat |
PATCH/v1/companies/{company}/connected-accounts/{account} | Actualitzar un compte Stripe connectat |
Coherència de la causa d'exempció i conflicte en generar recurrents
Canvien tres operacions: la vista prèvia de la factura accepta un exemption_reason opcional, desar o emetre una factura amb causa de capçalera sense IVA i línies amb IVA respon 422 exemption_cause_contradicts_taxed_lines, i generar una factura recurrent pot respondre un 409 reintentable recurring_presentation_activation_changed.
Llegeix la novetatEndpoints actualitzats6Vista prèvia
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/pdf-template-previews | Crear una vista prèvia de plantilla PDF |
POST/v1/companies/{company}/recurring-invoices/{recurring_invoice}/generate | Genera una factura a partir d'una plantilla recurrent |
PATCH/v1/companies/{company}/invoices/{invoice} | Actualitzar una factura |
Biblioteca de plantilles PDF i factures estructurades
Gestiona plantilles PDF i identitats de marca, tria la presentació de cada document, prepara artefactes PDF exactes i porta calendaris de pagaments, referències i centres DIR3 a les factures. Cinquanta operacions noves, els scopes pdf_templates i un bloc pdf_output_state a cada document.
Llegeix la novetatNous endpoints50Vista prèvia
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/pdf-commercial-identities/{identity}/archive | Arxivar una identitat comercial de PDF |
POST/v1/companies/{company}/pdf-templates/{template}/archive | Arxivar una plantilla PDF |
GET/v1/companies/{company}/delivery-notes/{delivery_note}/presentation | Obtenir la presentació de l'albarà |
Endpoints actualitzats137Vista prèvia
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/proformas/{proforma}/accept | Acceptar una proforma |
POST/v1/companies/{company}/quotes/{quote}/accept | Acceptar un pressupost |
POST/v1/companies/{company}/recurring-invoices/{recurring_invoice}/activate | Activar factura recurrent |
Els documents de control utilitzen la biblioteca de plantilles PDF
El PDF del document de control de transport (DeCA) pren el disseny de la biblioteca de plantilles. El valor per defecte de documents de control es fixa a PATCH /v1/companies/{company}/pdf-templates/defaults i a la tool MCP, i cada versió del DeCA informa del disseny amb què es va pintar a versions[].presentation.
Llegeix la novetatEndpoints actualitzats15Vista prèvia
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/transport-documents/{transport_document}/cancel | Anul·lar un document de control |
POST/v1/companies/{company}/transport-documents/{transport_document}/close | Tancar un document de control |
GET/v1/companies/{company}/transport-documents | Llistar tots els documents de control |
Les plantilles de documents de control tenen el seu propi tipus
Les plantilles PDF i les seves revisions informen de document_kind (commercial o transport-document). Crear i duplicar l'accepten, el llistat filtra per ell, i el valor per defecte de documents de control a PATCH /v1/companies/{company}/pdf-templates/defaults només accepta plantilles del tipus transport-document.
Llegeix la novetatEndpoints actualitzats5Vista prèvia
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/pdf-templates | Crear una plantilla PDF |
POST/v1/companies/{company}/pdf-templates/{template}/duplicate | Duplicar una plantilla PDF |
GET/v1/companies/{company}/pdf-templates | Llistar les plantilles PDF |
Opcions de maquetació de les plantilles PDF
La configuració de les plantilles PDF incorpora les claus de schema_version 2: capçalera i costat del logo, estil i concepte de la taula de línies, peu legal, densitat de pàgina, mida de lletra per zona, colors de realç i de superfície, text de privadesa, condicions generals, títols opcionals de bloc, la mida de marca xl i la columna d'import amb impost. Les revisions informen schema_version.
Llegeix la novetatEndpoints actualitzats10Vista prèvia
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/pdf-templates | Crear una plantilla PDF |
POST/v1/companies/{company}/pdf-templates/{template}/revisions | Publicar una revisió de plantilla PDF |
POST/v1/companies/{company}/pdf-template-previews | Crear una vista prèvia de plantilla PDF |
La personalització s'aplica a la plantilla principal
A les empreses que ja usen la biblioteca de plantilles PDF, PATCH /v1/companies/{company}/personalization i update_account_personalization apliquen el disseny i el color d'accent a la plantilla principal, i personalization llegeix els seus valors efectius. El contracte no canvia; l'error nou és 409 pdf_main_template_required.
Llegeix la novetatEndpoints actualitzats1
| Endpoint | Descripció |
|---|---|
PATCH/v1/companies/{company}/personalization | Actualitza la personalització del compte |
Comissions de Stripe com a despesa i una liquidació més detallada
Els comptes de Stripe connectats poden registrar cada mes les seves comissions de Stripe com a despesa, els payouts detallen ara tots els moviments que liquiden i les despeses que autoliquiden el seu IVA ja no el compten al total. Nou operacions actualitzades, tres camps nous al compte, tres camps nous al payout i un mètode de connexió nou.
Llegeix la novetatEndpoints actualitzats9Vista prèvia
| Endpoint | Descripció |
|---|---|
GET/v1/companies/{company}/connected-accounts | Llistar comptes Stripe connectats |
GET/v1/companies/{company}/connected-accounts/{account} | Obtenir un compte Stripe connectat |
PATCH/v1/companies/{company}/connected-accounts/{account} | Actualitzar un compte Stripe connectat |
Les persones amb accés operate poden rebre tasques
El llistat d'usuaris i l'usuari actual inclouen ara les persones d'altres comptes que arriben a l'empresa amb accés operate, i se'ls pot assignar una tasca. Tres operacions actualitzades; cap camp canvia.
Llegeix la novetatEndpoints actualitzats3
| Endpoint | Descripció |
|---|---|
GET/v1/companies/{company}/users | Llistar usuaris |
GET/v1/companies/{company}/users/me | Obtenir l'usuari actual |
POST/v1/companies/{company}/tasks/{task}/assign | Assignar una tasca |
Un justificant per a cada cobrament
Els justificants s'emeten per cobrament, també els parcials: les operacions de justificant de factures i despeses accepten un payment_id opcional i les seves tools MCP retornen el número del justificant. Els PDF de documents mostren l'IBAN de l'emissor només amb formes de pagament bancàries i fan servir 9 pt de mida base per defecte. Dues operacions i dues tools MCP actualitzades.
Llegeix la novetatEndpoints actualitzats2
| Endpoint | Descripció |
|---|---|
GET/v1/companies/{company}/invoices/{invoice}/payment-receipt | Descarregar el PDF del justificant d'un cobrament |
GET/v1/companies/{company}/purchase-invoices/{purchase_invoice}/payment-receipt | Descarregar el PDF del justificant d'un pagament d'una despesa |
Unitats comptades, pes per peces i substitució per canvi d'unitat base
Ven en paquets, caixes o peces un producte mesurat en quilos o litres, registra les peces a les línies de pes variable, substitueix un producte per un altre amb una altra unitat base amb vista prèvia i execució irreversible, i llegeix la unitat real a FacturaE i UBL. Dues operacions noves, dues tools MCP, l'esdeveniment product.replaced i camps nous a productes i línies de document.
Llegeix la novetatNous endpoints2
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/products/{product}/base-unit-replacement/preview | Vista prèvia de la substitució per canvi d'unitat base |
POST/v1/companies/{company}/products/{product}/base-unit-replacement | Substituir un producte canviant la seva unitat base |
Endpoints actualitzats103Vista prèvia
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/proformas/{proforma}/accept | Acceptar una proforma |
POST/v1/companies/{company}/quotes/{quote}/accept | Acceptar un pressupost |
POST/v1/companies/{company}/recurring-invoices/{recurring_invoice}/activate | Activar factura recurrent |
Consentiment OAuth: compte, nivell i permisos que ja no es concedeixen
La pantalla de consentiment del MCP demana triar compte i empresa, no concedeix escriptura amb nivell Veure ni els permisos de mòduls vetats a Proves, i la sol·licitud caduca als 5 minuts.
Llegeix la novetatVista prèvia de l'alta i detalls de compte
Una operació nova, la vista prèvia del que costaria un compte gestionat nou, i camps nous a empreses, traspassos de NIF, comptes gestionats, canvi de pla, importació massiva i consolidat de RR. HH., i una caducitat del val que ara es retorna sempre en reemetre.
Llegeix la novetatNous endpoints1
| Endpoint | Descripció |
|---|---|
GET/v1/accounts/provisioning-preview | Previsualitzar l'alta d'un compte gestionat |
Endpoints actualitzats22Vista prèvia
| Endpoint | Descripció |
|---|---|
GET/v1/accounts/{account}/companies | Llistar els NIF del teu compte |
GET/v1/accounts/{account}/companies/{company} | Obtenir un NIF del compte |
POST/v1/accounts/{account}/companies | Registrar un NIF al compte |
Document de control (DeCA) i pes de transport
Nou recurs transport_documents amb 17 endpoints per emetre, modificar, compartir i conservar el document de control digital del transport de mercaderies per carretera, obligatori des del 5 d'octubre de 2026; 15 tools MCP, 10 esdeveniments transport_document.*, 24 codis d'error i pes brut de transport en productes, variants, presentacions i albarans.
Llegeix la novetatNous endpoints17Vista prèvia
| Endpoint | Descripció |
|---|---|
GET/v1/companies/{company}/transport-documents | Llistar tots els documents de control |
GET/v1/companies/{company}/transport-documents/statuses | Llistar els estats del document de control |
GET/v1/companies/{company}/transport-documents/{transport_document} | Obtenir un document de control |
Endpoints actualitzats21Vista prèvia
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/products | Crear un producte |
PATCH/v1/companies/{company}/products/{product} | Actualitzar un producte |
GET/v1/companies/{company}/products/{product} | Obtenir un producte |
Equip, claus i logs a l'eix de compte
Una operació nova, l'ús diari d'una API key, i camps nous a claus, membres, invitacions, logs de peticions i dominis de retorn de Stripe Connect, a més de la correcció sobre reactivar un endpoint de webhook de compte desactivat.
Llegeix la novetatNous endpoints1
| Endpoint | Descripció |
|---|---|
GET/v1/accounts/{account}/api-keys/{api_key}/usage | Consultar l'ús diari d'una clau d'API |
Endpoints actualitzats19Vista prèvia
| Endpoint | Descripció |
|---|---|
GET/v1/accounts/{account}/api-keys | Llistar les teves API keys |
GET/v1/accounts/{account}/api-keys/{api_key} | Recuperar una API key |
POST/v1/accounts/{account}/api-keys | Crear una API key |
Devolucions i import net dels cobraments no facturats
Els cobraments de Stripe que no es facturen porten les seves devolucions i l'import net que es queda el comerç, es poden filtrar per data i arriben a la gestoria en l'enviament trimestral com a CSV. Quatre operacions actualitzades i tres tools MCP actualitzades.
Llegeix la novetatEndpoints actualitzats4Vista prèvia
| Endpoint | Descripció |
|---|---|
GET/v1/companies/{company}/connected-accounts/{account}/non-invoiced-charges | Llistar els cobraments sense facturar d'un compte de Stripe connectat |
GET/v1/companies/{company}/invoices/quarterly/available-quarters | Llistar els trimestres exportables |
POST/v1/companies/{company}/invoices/quarterly/download-zip | Generar arxiu ZIP trimestral |
Impostos propis de l'empresa
Crea, edita i elimina els teus propis impostos al costat del catàleg de Factuarea, que és de només lectura, distingeix-los amb el nou camp ownership i fixa els predeterminats només per a la teva empresa. Dues eines MCP noves, un scope OAuth nou i dos codis d'error nous.
Llegeix la novetatEndpoints actualitzats14Vista prèvia
| Endpoint | Descripció |
|---|---|
GET/v1/companies/{company}/taxes | Llistar tots els impostos |
POST/v1/companies/{company}/taxes | Crear un impost |
GET/v1/companies/{company}/taxes/{tax} | Obtenir un impost |
Nota configurable a les factures automàtiques
Els comptes connectats i les botigues accepten una invoice_note que Factuarea escriu a les notes de les factures que emet automàticament, i aquestes factures vencen als 30 dies per defecte. Set operacions actualitzades i dues tools MCP actualitzades.
Llegeix la novetatEndpoints actualitzats7Vista prèvia
| Endpoint | Descripció |
|---|---|
GET/v1/companies/{company}/connected-accounts | Llistar comptes Stripe connectats |
GET/v1/companies/{company}/connected-accounts/{account} | Obtenir un compte Stripe connectat |
PATCH/v1/companies/{company}/connected-accounts/{account} | Actualitzar un compte Stripe connectat |
Places d'empleat cobrades sempre que el pla factura
Donar d'alta o reactivar un empleat cobra una plaça sempre que el pla factura, també en past_due i en plans concedits; els empleats de la prova es desactiven quan comença el cobrament, hi ha un 503 nou amb els lots activats i les ofertes de places sobre una subscripció activa comencen a la renovació següent. Vuit operacions actualitzades.
Llegeix la novetatEndpoints actualitzats8Vista prèvia
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/employees | Crear un empleat |
POST/v1/companies/{company}/employees/{employee}/reactivate | Reactivar un empleat |
POST/v1/companies/{company}/employee-seat-offer-redemptions | Preparar un bescanvi d’oferta de places d’empleats |
Ajustos del contracte de comptes
Correccions del contracte v1 després de la revisió del 6 d’octubre, compres duradores a l’eix d’empresa i la forma final dels comptes gestionats, el NIF addicional i el topall d’usuaris.
Llegeix la novetatEndpoints actualitzats45Vista prèvia
| Endpoint | Descripció |
|---|---|
GET/v1/companies/{company}/employee-batches | Llistar un lot d’empleats |
GET/v1/companies/{company}/employee-batches/{id} | Consultar un lot d’empleats |
POST/v1/companies/{company}/employee-batches | Preparar un lot d’empleats |
Comptes de Stripe existents i regles de cobrament
Connecta un compte de Stripe que ja tens, decideix per compte quins cobraments es facturen i quins no, i consulta els cobraments que han quedat fora. Sis operacions noves, tres camps nous als comptes connectats i cinc motius nous a la safata.
Llegeix la novetatNous endpoints6Vista prèvia
| Endpoint | Descripció |
|---|---|
GET/v1/companies/{company}/connected-accounts/{account}/charge-rules | Llistar les regles de tractament de cobraments d'un compte de Stripe connectat |
POST/v1/companies/{company}/connected-accounts/{account}/charge-rules | Crear una regla de tractament de cobraments |
PUT/v1/companies/{company}/connected-accounts/{account}/charge-rules/order | Reordenar les regles de tractament de cobraments |
Endpoints actualitzats3
| Endpoint | Descripció |
|---|---|
GET/v1/companies/{company}/connected-accounts | Llistar comptes Stripe connectats |
GET/v1/companies/{company}/connected-accounts/{account} | Obtenir un compte Stripe connectat |
PATCH/v1/companies/{company}/connected-accounts/{account} | Actualitzar un compte Stripe connectat |
Les operacions recents passen a l'eix
Les operacions publicades des del 21 de setembre —projectes i tasques, l'escàner de despeses, notificacions, usuaris, la representació VeriFactu, emetre sense enviar i l'edició de sèries— viuen sota /v1/companies/{company}, i vuit actualitzacions parcials passen de PUT a PATCH.
Llegeix la novetatEndpoints actualitzats113Vista prèvia
| Endpoint | Descripció |
|---|---|
GET/v1/companies/{company}/agenda | Llistar elements de l'agenda |
POST/v1/companies/{company}/contacts/import | Importar contactes |
GET/v1/companies/{company}/contacts/import/template | Descarregar la plantilla d’importació de contactes |
Stripe Connect en marca blanca
Quatre operacions i quatre codis d'error nous perquè els teus clients connectin el seu propi compte de Stripe des del teu producte, amb dominis de retorn que controles tu.
Llegeix la novetatNous endpoints4Vista prèvia
| Endpoint | Descripció |
|---|---|
POST/v1/accounts/{account}/connected-accounts/return-domains | Afegir un domini de retorn de Stripe Connect |
DEL/v1/accounts/{account}/connected-accounts/return-domains/{return_domain} | Eliminar un domini de retorn de Stripe Connect |
GET/v1/accounts/{account}/connected-accounts/return-domains | Llistar els dominis de retorn de Stripe Connect |
Lots d’empleats i ofertes privades de seients
Noves operacions duradores per a lots d’empleats i ofertes de seients d’empleats o empreses gestionades dirigides a una empresa.
Llegeix la novetatNous endpoints18Vista prèvia
| Endpoint | Descripció |
|---|---|
GET/v1/companies/{company}/employee-batches | Llistar un lot d’empleats |
POST/v1/companies/{company}/employee-batches | Preparar un lot d’empleats |
GET/v1/companies/{company}/employee-batches/{id} | Consultar un lot d’empleats |
Endpoints actualitzats4Vista prèvia
| Endpoint | Descripció |
|---|---|
GET/v1/accounts/{account}/companies/seat-charge-preview | Previsualitza el càrrec per plaça d'afegir una empresa |
POST/v1/accounts/{account}/companies | Registrar un NIF al compte |
POST/v1/accounts/{account}/companies/{company}/activate | Activar un NIF del compte |
Resultats d’importació, reintents de tasques i camps nous
La importació de contactes informa de files actualitzades, avisos i del motiu de cada fila omesa; la de tasques es reintenta sense duplicar; les factures exposen origin; pressupostos i proformes exposen operation_regime.
Llegeix la novetatEndpoints actualitzats48Vista prèvia
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/contacts/import/preview | Previsualitzar una importació de contactes |
POST/v1/companies/{company}/contacts/import | Importar contactes |
GET/v1/companies/{company}/contacts/imports/{id} | Consultar una importació de contactes |
Emplena les plantilles de contactes abans d’importar
Previsualitza plantilles buides conservant les columnes i gestiona empty_import abans d’aplicar una importació.
Llegeix la novetatEndpoints actualitzats2
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/contacts/import/preview | Previsualitzar una importació de contactes |
POST/v1/companies/{company}/contacts/import | Importar contactes |
Edita sèries de numeració
Actualitza una sèrie amb PUT /v1/series/{series} i la tool MCP update_series, sota les mateixes guardes fiscals que l’aplicació web.
Llegeix la novetatNous endpoints1
| Endpoint | Descripció |
|---|---|
PATCH/v1/companies/{company}/series/{series} | Actualitzar una sèrie |
Endpoints actualitzats3
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/series | Crea una sèrie |
GET/v1/companies/{company}/series/{series} | Obtenir una sèrie |
POST/v1/companies/{company}/series/{series}/archive | Arxivar una sèrie |
Activitat de la factura: resultats de l’AEAT, correu i cobraments
La línia de temps de la factura afegeix el resultat de cada enviament a l’AEAT, els correus no lliurats, la primera visita diària a l’enllaç públic i els esdeveniments de cobrament, cadascun amb un contracte exacte de metadata.
Llegeix la novetatEndpoints actualitzats8Vista prèvia
| Endpoint | Descripció |
|---|---|
GET/v1/companies/{company}/invoices/{invoice}/activities | Llistar l'activitat de la factura |
GET/v1/companies/{company}/invoices/{invoice}/verifactu | Recupera el registre VeriFactu de la factura |
POST/v1/companies/{company}/invoices/{invoice}/verifactu | Forçar la creació del registre VeriFactu d'una factura |
Seguiment i resultats íntegres d’importacions de contactes
Previsualitza fitxers de contactes, consulta resultats confirmats per fila i descarrega informes d’errors autoritzats.
Llegeix la novetatNous endpoints2
| Endpoint | Descripció |
|---|---|
GET/v1/companies/{company}/contacts/imports/{id} | Consultar una importació de contactes |
GET/v1/companies/{company}/contacts/imports/{id}/errors.csv | Descarregar errors d’importació de contactes |
Endpoints actualitzats2
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/contacts/import/preview | Previsualitzar una importació de contactes |
POST/v1/companies/{company}/contacts/import | Importar contactes |
Facturació des de terminals desatesos
Una factura simplificada ja cobrada des d'un caixer en una sola crida idempotent, la remissió de VeriFactu a través de Factuarea, l'esmena de registres acceptats i errors per línia. Tres canvis que trenquen: una línia sense tipus ja no pren el 21 %, emetre es rebutja quan el registre no cap a l'esquema de l'AEAT i, en mode NO VERI*FACTU, cal un certificat utilitzable. POST /v1/verifactu/records/{id}/retry ja no respon max_retries_exceeded.
Llegeix la novetatNous endpoints4Vista prèvia
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/verifactu/records/retry-blocked | Reintentar tots els registres VeriFactu bloquejats |
GET/v1/companies/{company}/verifactu/representation | Recuperar la representació vigent |
POST/v1/companies/{company}/verifactu/representation | Registrar una representació |
Endpoints actualitzats32Vista prèvia
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/invoices | Crea una factura |
PATCH/v1/companies/{company}/invoices/{invoice} | Actualitzar una factura |
POST/v1/companies/{company}/invoices/bulk-create | Crear factures en bloc |
MCP: errors més clars, accés des de ChatGPT i llistes de tools més estables
Les tools MCP tornen a informar dels errors de negoci, OAuth admet private_key_jwt per a clients com ChatGPT, els cursors de tools/list duren 24 hores i quatre noms antics de contactes es retiren el 15 de novembre de 2026.
Llegeix la novetatEscala de plans: Esencial, Profesional, Avanzado i Enterprise
Nous noms comercials i Avanzado al contracte de compte, amb capacitat d’API inclosa en cada pla.
Llegeix la novetatEndpoints actualitzats2
| Endpoint | Descripció |
|---|---|
GET/v1/me | Obtenir la credencial que crida |
GET/v1/companies/{company}/billing | Obtenir els detalls de facturació del compte |
Una sola finestra de ruptura: eix i payload
Els recursos d'empresa i de compte passen a la URL, els imports viatgen com a cadenes decimals, la data de cobrament canvia de nom, X-Active-Profile es rebutja i el compte passa a ser el client. Totes les operacions que toca la finestra —519— recurs a recurs.
Llegeix la novetatNous endpoints16Vista prèvia
| Endpoint | Descripció |
|---|---|
DEL/v1/accounts/{account}/invitations/{invitation} | Revocar una invitació de compte |
POST/v1/accounts/{account}/invitations | Enviar una invitació de compte |
GET/v1/accounts/{account}/invitations | Llistar les invitacions del compte |
Endpoints actualitzats455Vista prèvia
| Endpoint | Descripció |
|---|---|
GET/v1/companies/{company}/absence-balances | Llistar tots els saldos d'absències |
GET/v1/companies/{company}/absence-balances/{absence_balance} | Obtenir un saldo d'absències |
GET/v1/companies/{company}/absence-calendar | Obtenir el calendari d'absències de l'equip |
Model de comptes
Comptes, NIF, membres, accés cedit, comptes gestionats, importació massiva, webhooks de compte i les operacions i camps que afegeixen o reanomenen.
Llegeix la novetatNous endpoints33Vista prèvia
| Endpoint | Descripció |
|---|---|
PATCH/v1/accounts/{account}/api-keys/{api_key}/nif-scope | Canviar els NIF als quals arriba una API key |
GET/v1/accounts/{account}/invitations/{invitation} | Consultar una invitació de compte |
DEL/v1/accounts/{account}/members/{member}/grants/{company} | Revocar un grant d'un membre del compte |
Endpoints actualitzats39Vista prèvia
| Endpoint | Descripció |
|---|---|
POST/v1/accounts/{account}/api-keys | Crear una API key |
GET/v1/accounts/{account}/api-keys | Llistar les teves API keys |
POST/v1/accounts/{account}/api-keys/{api_key}/revoke | Revocar una API key |
Límit d'automatitzacions actives
El límit d'actives, l'error d'activació i el consum active_rules a API i MCP.
Llegeix la novetatEndpoints actualitzats2
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/automations/rules/{rule}/activate | Activar una regla d'automatització |
GET/v1/companies/{company}/automations/usage | Obtenir el consum d'automatitzacions |
Topall anual de documents a l’API i MCP
El topall anual, les operacions v1 afectades (14 en total), els errors MCP i l’emissió automàtica.
Llegeix la novetatEndpoints actualitzats14Vista prèvia
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/invoices | Crea una factura |
POST/v1/companies/{company}/invoices/{invoice}/duplicate | Duplicar una factura |
POST/v1/companies/{company}/invoices/{invoice}/corrective | Generar factura rectificativa |
Ús del compte: missatge d'error genèric
El missatge i la guia de storage_quota_exceeded remeten ara a suport sense xifres d'ús.
Llegeix la novetatEndpoints actualitzats3
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/purchase-invoices/{purchase_invoice}/attach-file | Adjuntar un fitxer a una despesa |
POST/v1/companies/{company}/verifactu/certificates | Puja un certificat d'empresa |
POST/v1/companies/{company}/delivery-notes/{delivery_note}/sign | Signar un albarà |
Ajustos de Tasques
Límits més precisos i errors més clars a Projectes i Tasques: descripció de tasca de fins a 400.000 caràcters, tarifa per hora de fins a 99.999.999,99, vincles que respecten els scopes, id de la tasca a les notificacions, esborrats bloquejats per hores facturades i facturació d'hores idempotent. users:read passa a ser un scope sensible.
Llegeix la novetatEndpoints actualitzats15Vista prèvia
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/tasks | Crear una tasca |
PATCH/v1/companies/{company}/tasks/{task} | Actualitzar una tasca |
POST/v1/companies/{company}/tasks/bulk-delete | Eliminació massiva de tasques |
Projectes i tasques
El mòdul de tasques arriba a l'API: projectes amb el seu tauler, tasques, etiquetes, temporitzadors, usuaris, notificacions i l'agenda — 80 endpoints nous, 21 esdeveniments, 80 tools MCP i quatre accions d'automatització.
Llegeix la novetatNous endpoints80Vista prèvia
| Endpoint | Descripció |
|---|---|
GET/v1/companies/{company}/projects | Llistar projectes |
POST/v1/companies/{company}/projects | Crear un projecte |
GET/v1/companies/{company}/projects/{project} | Obtenir un projecte |
Escàner de despeses: original no disponible
Reintentar, convertir i restaurar identifiquen ara quan ja no es conserva l’arxiu original de l’escaneig.
Llegeix la novetatEndpoints actualitzats3
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/purchase-scans/{purchase_scan}/retry | Reintentar un escaneig de compra fallit |
POST/v1/companies/{company}/purchase-scans/{purchase_scan}/convert | Crear la despesa d’un escaneig |
POST/v1/companies/{company}/purchase-scans/{purchase_scan}/restore | Restaurar un escaneig de compra arxivat |
Despeses i Factures: nous noms de producte
Les factures de compra passen a dir-se Despeses i les factures de venda, Factures. Les integracions conserven les interfícies.
Llegeix la novetatEndpoints actualitzats45Vista prèvia
| Endpoint | Descripció |
|---|---|
POST/v1/accounts/{account}/companies/{company}/activate | Activar un NIF del compte |
POST/v1/accounts/{account}/companies/activate | Activar diversos NIF del compte |
POST/v1/accounts/{account}/companies | Registrar un NIF al compte |
Emesa no vol dir enviada: versió de l’API 2026-10-01
Les factures separen l’emissió del lliurament. La versió opcional 2026-10-01 publica l’estat issued amb issued_at, is_sent i sent_via; nou POST /v1/invoices/{invoice}/issue; mark-sent registra un lliurament manual des d’aquesta versió; nous esdeveniments invoice.issued, invoice.marked_sent i invoice.unsent, amb invoice.sent com a àlies deprecat; payloads de webhook versionats per endpoint; les factures recurrents guanyen generation_mode. La versió predeterminada no canvia.
Llegeix la novetatNous endpoints1
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/invoices/{invoice}/issue | Emet una factura |
Endpoints actualitzats20Vista prèvia
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/invoices/{invoice}/mark-sent | Marca una factura com a enviada |
POST/v1/companies/{company}/invoices/{invoice}/unsend | Anul·lar l'enviament d'una factura |
POST/v1/companies/{company}/invoices/{invoice}/send | Envia la factura per email |
El control horari respecta el període d’alta
Canvi que trenca: fitxar abans de la data d’alta d’un empleat o després de la seva data de baixa respon ara 422 amb el subcode clocking_outside_employment_period. Els saldos diaris afegeixen is_unscheduled i is_outside_employment, el full mensual i el resum d’equip afegeixen un bloc to_date amb els dies tancats, l’horari de l’empleat accepta una data, hire_date passa a ser editable, i reassignar o desassignar un horari que encara no ha començat l’anul·la.
Llegeix la novetatEndpoints actualitzats13Vista prèvia
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/time-entries/clock-in | Fitxar l'entrada d'un empleat |
POST/v1/companies/{company}/time-entries/manual | Registrar una entrada manual retroactiva |
POST/v1/companies/{company}/time-corrections | Sol·licitar una correcció de fitxatge |
Escanejos de compra: historial acotat, OCR ajornat i faceta de proveïdors
El detall de l’escaneig retorna ara els 50 intents i esdeveniments d’auditoria més recents amb els seus totals, els escanejos que esperen la quota diària d’OCR ho indiquen i les estadístiques afegeixen una faceta per proveïdor.
Llegeix la novetatEndpoints actualitzats3
| Endpoint | Descripció |
|---|---|
GET/v1/companies/{company}/purchase-scans | Llistar escaneigs de compres |
GET/v1/companies/{company}/purchase-scans/{purchase_scan} | Consultar un escaneig de compra |
GET/v1/companies/{company}/purchase-scans/stats | Consultar indicadors de l’escàner de compres |
Escàner de compres: API pública i MCP
Puja, revisa, resol duplicats i converteix escanejos de compra des de l'API pública i MCP. Tretze operacions cobreixen tot el flux, la bústia de l'escàner i les categories de despesa.
Llegeix la novetatNous endpoints13Vista prèvia
| Endpoint | Descripció |
|---|---|
GET/v1/companies/{company}/purchase-invoices/expense-categories | Llistar categories de despeses |
GET/v1/companies/{company}/purchase-scan-emails | Llistar correus de l’escàner de compres |
DEL/v1/companies/{company}/purchase-scans/{purchase_scan} | Arxivar un escaneig de compra |
Endpoints actualitzats2
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/purchase-invoices | Crea una despesa |
PATCH/v1/companies/{company}/purchase-invoices/{purchase_invoice} | Actualitzar una despesa |
Pausar i reprendre factures recurrents en bloc
Nova operació POST /v1/recurring_invoices/bulk-status: mou fins a 50 factures recurrents a active o paused amb èxit parcial, amb l'eina MCP bulk_change_recurring_invoice_status com a mirall. Reprendre una recurrència completada respon ara 422 recurring_invoice_completed_cannot_resume.
Llegeix la novetatNous endpoints1
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/recurring-invoices/bulk-status | Canviar en bloc l'estat de factures recurrents |
Endpoints actualitzats2
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/recurring-invoices/{recurring_invoice}/resume | Reprendre factura recurrent |
POST/v1/companies/{company}/recurring-invoices/{recurring_invoice}/activate | Activar factura recurrent |
Eliminar i arxivar contactes
Canvi que trenca: DELETE /v1/contacts/{id} i POST /v1/contacts/bulk-delete eliminen en lloc d’arxivar, i l’eliminació no es pot desfer des de l’API. Arxivar passa a POST /v1/contacts/{id}/archive, està sempre permès i continua sent reversible. Es publica l’esdeveniment webhook contact.deleted i desapareix el subcode contact_has_commercial_references.
Llegeix la novetatNous endpoints1
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/contacts/{contact}/archive | Arxivar un contacte |
Endpoints actualitzats3
| Endpoint | Descripció |
|---|---|
DEL/v1/companies/{company}/contacts/{contact} | Eliminar un contacte |
POST/v1/companies/{company}/contacts/bulk-delete | Eliminar contactes en lot |
POST/v1/companies/{company}/contacts/bulk/archive | Arxivar contactes en lot |
Línies de compra mesurades
Les línies de factura de compra registren ja els embalums rebuts, la unitat a la qual s’aplica el cost del proveïdor i la mesura real. El contracte afegeix un bloc de mesura, persisteix el descompte de línia, resol el cost des de l’oferta del proveïdor i duplica una compra des d’un origen autoritzat.
Llegeix la novetatEndpoints actualitzats4Vista prèvia
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/purchase-invoices | Crea una despesa |
PATCH/v1/companies/{company}/purchase-invoices/{purchase_invoice} | Actualitzar una despesa |
GET/v1/companies/{company}/purchase-invoices/{purchase_invoice} | Obtenir una despesa |
Capacitats PDF al compte
El recurs Account i l’endpoint de plantilles exposen un bloc de capacitats només de lectura: què permet el pla en la marca dels documents, quines plantilles es poden fixar i quin pla desbloqueja l’editor. Les actualitzacions de personalització fora del pla retornen ja 403.
Llegeix la novetatEndpoints actualitzats3
| Endpoint | Descripció |
|---|---|
GET/v1/me | Obtenir la credencial que crida |
GET/v1/companies/{company}/personalization/templates | Llista les plantilles de personalització disponibles |
PATCH/v1/companies/{company}/personalization | Actualitza la personalització del compte |
API de contactes
Gestiona una sola identitat amb rols acumulables de client, proveïdor i lead. L’API canònica ja cobreix creació i arxivament en lot, cerca per identificadors, verificació censal AEAT, estadístiques, activitat i importacions.
Llegeix la novetatNous endpoints26Vista prèvia
| Endpoint | Descripció |
|---|---|
GET/v1/companies/{company}/contacts | Llistar contactes |
POST/v1/companies/{company}/contacts | Crear un contacte |
GET/v1/companies/{company}/contacts/options | Llistar opcions dels filtres de contactes |
Botigues, MCP i exemples complets de resposta
Connecta botigues WooCommerce i Shopify, treballa amb snapshots de comandes i utilitza el transport MCP actualitzat. Cada resposta documentada té un exemple explícit o la representació de descàrrega adequada.
Llegeix la novetatNous endpoints7Vista prèvia
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/stores | Connectar una botiga |
GET/v1/companies/{company}/stores | Llistar botigues connectades |
DEL/v1/companies/{company}/stores/{store} | Desconnectar una botiga |
Seleccions configurables i preus exactes de catàleg
Configura quines combinacions de producte es poden vendre i resol preus negociats exactes. La API incorpora consulta de seleccions, auditoria d’estoc i resolució de preus en lot.
Llegeix la novetatNous endpoints8Vista prèvia
| Endpoint | Descripció |
|---|---|
GET/v1/companies/{company}/products/{product}/configurations | Llistar combinacions comercials d'un producte |
GET/v1/companies/{company}/products/{product}/options | Llistar grups d'opcions d'un producte |
GET/v1/companies/{company}/products/{product}/stock-movements | Llistar moviments d'estoc d'un producte |
v1.13.0 — Paritat de contracte
Semàntica d'escriptura de producte, consentiment OAuth ampliat, capacitat API derivada del pla i notes multilínia en PDF.
Llegeix la novetatEndpoints actualitzats2
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/products | Crear un producte |
PATCH/v1/companies/{company}/products/{product} | Actualitzar un producte |
Cobertura completa de catàleg i tarifes
Gestiona presentacions, variants, ofertes de proveïdors i tarifes. Els documents conserven snapshots de preu i fan explícita l’actualització de preus.
Llegeix la novetatNous endpoints23Vista prèvia
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/price-lists | Crear una tarifa |
GET/v1/companies/{company}/price-lists | Llistar tarifes |
POST/v1/companies/{company}/products/{product}/presentations | Crear una presentació de producte |
Les tools MCP d'enviament massiu ja apliquen el límit de 200 ids per lot
Les tools MCP d’enviament massiu rebutgen els lots de més de 200 IDs amb un error clar. El comportament REST es manté.
Llegeix la novetatAutomatitzacions
Crea regles a partir d’esdeveniments, previsualitza’n els efectes i consulta cada execució. Divuit operacions cobreixen regles, versions, execucions, rellançament i consum.
Llegeix la novetatNous endpoints18Vista prèvia
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/automations/rules/{rule}/activate | Activar una regla d'automatització |
POST/v1/companies/{company}/automations/rules | Crear una regla d'automatització |
GET/v1/companies/{company}/automations/rules | Llistar les teves regles d'automatització |
Informes fiscals: llibre de treball i tools per a agents
Els informes fiscals fan servir un llibre de treball Excel i exposen nou tools MCP. Els endpoints existents documenten amb precisió els formats de sortida admesos.
Llegeix la novetatEndpoints actualitzats4Vista prèvia
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/tax-reports/130 | Generar Model 130 |
POST/v1/companies/{company}/tax-reports/303 | Generar Modelo 303 |
POST/v1/companies/{company}/tax-reports/347 | Generar Modelo 347 |
Anul·lació de cobraments
Anul·la un cobrament conservant el registre original i la seva traçabilitat. El saldo de la factura reflecteix l’anul·lació i les integracions reben l’esdeveniment corresponent.
Llegeix la novetatNous endpoints1
| Endpoint | Descripció |
|---|---|
POST/v1/companies/{company}/invoices/{invoice}/payments/{payment}/reversal | Anul·lar un pagament d'una factura |
Control horari
Gestiona horaris, fitxatges, absències, balanços i presència des de la API i MCP, amb el mateix model de permisos que la resta de la plataforma.
Llegeix la novetatAPI i MCP inclosos en tots els plans
L’accés a la API pública i MCP està inclòs en tots els plans de Factuarea. Els límits de peticions segueixen el pla actiu i també hi ha accés durant el trial.
Llegeix la novetatLlançament de la plataforma
La plataforma pública reuneix la API REST v1, els SDKs oficials de TypeScript i PHP, el CLI i MCP, amb un sandbox aïllat per provar integracions.
Llegeix la novetat