| Sistema |
|
GET
públic
|
/ |
Aquesta pàgina d'estat (versió, taula d'endpoints) |
|
GET
públic
|
/api/health |
Estat del servidor (versió, timestamp) |
|
GET
públic
|
/api/tenant-status |
Estat de subscripció del tenant (suspès o actiu) |
|
POST
públic
|
/api/login |
Autenticació d'usuari (users_staff) — retorna JWT (cookie httpOnly + JSON) |
|
POST
públic
|
/api/logout |
Invalida la sessió i neteja la cookie |
| OCR i processament |
|
POST
JWT
|
/api/ocr |
Sync: Azure Document Intelligence + refinament Gemini |
|
POST
JWT
|
/api/ocr-queue |
Encua fitxers a ocr_pending i els processa en background |
|
GET
JWT
|
/api/ocr-pending |
Llista ítems pendents/processats de la cua OCR |
|
DELETE
JWT
|
/api/ocr-pending/:id |
Elimina un ítem de la cua OCR |
|
POST
JWT
|
/api/save |
Desa una factura/despesa extreta (+ línies i correccions) |
|
GET
JWT
|
/api/providers/lookup |
Nom i adreça canònics d'un proveïdor pel NIF |
|
GET
JWT
|
/api/documents/check-duplicate |
Comprova si un document ja existeix (número o data+import) |
|
GET
JWT
|
/api/file |
Proxy autenticat cap a Azure Blob (?store=azure) o GCS legacy |
| Facturació rebuda |
|
GET
JWT
|
/api/invoices |
Llista factures amb línies d'impostos incloses |
|
PATCH
JWT
|
/api/invoices/:id |
Actualitza camps d'una factura |
|
DELETE
JWT
|
/api/invoices/:id |
Elimina una factura + línies + impostos |
|
PUT
JWT
|
/api/invoices/:id/tax-details |
Substitueix les línies d'impost d'una factura |
|
GET
JWT
|
/api/invoices/:id/rows |
Línies de detall de producte/servei |
|
GET
JWT
|
/api/invoices/analytics |
Factures de l'any per analítica |
|
POST
JWT
|
/api/invoices/search |
Cerca avançada de factures (filtres + dates) |
| CRM — Clients |
|
GET
JWT
|
/api/clients |
Llista clients (filtres actiu/cerca) |
|
GET
JWT
|
/api/clients/:id |
Detall d'un client |
|
POST
JWT
|
/api/clients |
Crea un client (admin) |
|
PATCH
JWT
|
/api/clients/:id |
Actualitza un client (admin) |
|
DELETE
JWT
|
/api/clients/:id |
Elimina un client — soft-delete si té factures (admin) |
| Proveïdors |
|
GET
JWT
|
/api/suppliers |
Llista proveïdors de l'empresa activa |
|
GET
JWT
|
/api/suppliers/:id |
Detall d'un proveïdor |
|
POST
JWT
|
/api/suppliers |
Crea un proveïdor (admin) |
|
PATCH
JWT
|
/api/suppliers/:id |
Actualitza un proveïdor (admin) |
|
DELETE
JWT
|
/api/suppliers/:id |
Elimina un proveïdor (admin) |
| Facturació emesa + VeriFactu |
|
GET
JWT
|
/api/invoices-issued |
Llista factures emeses |
|
GET
JWT
|
/api/invoices-issued/:id |
Detall d'una factura emesa (+ línies) |
|
POST
JWT
|
/api/invoices-issued |
Crea un esborrany (admin) |
|
PATCH
JWT
|
/api/invoices-issued/:id |
Edita un esborrany — 409 si ja no és draft (admin) |
|
DELETE
JWT
|
/api/invoices-issued/:id |
Elimina un esborrany — 409 si ja no és draft (admin) |
|
GET
JWT
|
/api/invoices-issued/:id/payments |
Cobraments registrats d'una factura emesa |
|
POST
JWT
|
/api/invoices-issued/:id/payments |
Registra un cobrament (admin) |
|
DELETE
JWT
|
/api/invoices-issued/:id/payments/:paymentId |
Elimina un cobrament registrat (admin) |
|
POST
JWT
|
/api/invoices-issued/:id/emit |
Emet: numeració atòmica + hash chain + remissió AEAT (admin) |
|
POST
JWT
|
/api/invoices-issued/:id/cancel |
Anul·la una factura emesa (admin) |
|
POST
JWT
|
/api/invoices-issued/:id/rectify |
Crea una rectificativa (admin) |
|
GET
JWT
|
/api/invoices-issued/:id/pdf |
Genera el PDF (marca PROFORMA si esborrany, QR si remesa) |
|
GET
JWT
|
/api/invoices-issued/analytics |
Factures emeses de l'any per analítica |
|
GET
JWT
|
/api/verifactu/pending |
Factures pendents o en error de remissió a l'AEAT |
|
GET
JWT
|
/api/invoice-series |
Llista sèries de numeració de l'empresa activa |
|
POST
JWT
|
/api/invoice-series |
Crea una sèrie nova (admin) |
|
PATCH
JWT
|
/api/invoice-series/:id |
Edita descripció/any/sèrie per defecte (admin) |
|
DELETE
JWT
|
/api/invoice-series/:id |
Elimina una sèrie si encara no s'ha usat (admin) |
| Multiempresa i configuració |
|
GET
JWT
|
/api/companies |
Llista empreses del tenant |
|
POST
JWT
|
/api/companies |
Crea una empresa (admin, límit segons pla) |
|
PATCH
JWT
|
/api/companies/:id |
Actualitza una empresa (admin) |
|
DELETE
JWT
|
/api/companies/:id |
Elimina una empresa sense dades (admin) |
|
GET
JWT
|
/api/tenant-settings |
Dades fiscals de l'empresa activa |
|
PUT
JWT
|
/api/tenant-settings |
Actualitza les dades fiscals de l'empresa activa (admin) |
|
POST
JWT
|
/api/tenant/logo |
Puja el logo de l'empresa activa — PNG/JPG, màx 2MB (admin) |
|
DELETE
JWT
|
/api/tenant/logo |
Elimina el logo de l'empresa activa (admin) |
|
GET
JWT
|
/api/invoice-templates/:templateId/preview |
PDF de mostra d'una plantilla de factura |
|
POST
JWT
|
/api/tenant/certificate |
Puja i xifra el certificat .p12/.pfx (admin) |
|
GET
JWT
|
/api/tenant/certificate |
Metadades del certificat actiu — mai els bytes (admin) |
|
DELETE
JWT
|
/api/tenant/certificate/:id |
Elimina un certificat (admin) |
|
PATCH
JWT
|
/api/user/lang |
Desa la preferència d'idioma de l'usuari |
| Dashboard i analítica |
|
GET
JWT
|
/api/dashboard |
KPIs del mes: factures, albarans, estoc baix, top proveïdors, vendes |
|
GET
JWT
|
/api/dashboard/resum |
?mes=YYYY-MM → vendes, despeses, marge |
|
GET
JWT
|
/api/dashboard/overview |
Visió general ampliada del tauler |
|
GET
JWT
|
/api/expenses/analytics |
Despeses de l'any per analítica |
| Inventari i compres |
|
GET
JWT
|
/api/inventory/products |
Llista productes de l'inventari |
|
GET
JWT
|
/api/inventory/shops |
Llista botigues / punts de venda amb inventari |
|
GET
JWT
|
/api/inventory/stock |
Estoc actual per producte/botiga |
|
GET
JWT
|
/api/inventory/safety |
Nivells d'estoc mínim (safety stock) |
|
POST
JWT
|
/api/inventory |
Registra un moviment d'inventari |
|
POST
JWT
|
/api/inventory/safety |
Estableix l'estoc mínim d'un producte |
|
GET
JWT
|
/api/inventory/history |
Historial de moviments d'inventari |
|
GET
JWT
|
/api/purchase-proposal |
Proposta de compra basada en estoc |
| Vendes i botigues |
|
GET
JWT
|
/api/botigues |
Llista totes les botigues |
|
POST
JWT
|
/api/botigues |
Crea una botiga nova (admin) |
|
PATCH
JWT
|
/api/botigues/:id |
Actualitza una botiga (admin) |
|
DELETE
JWT
|
/api/botigues/:id |
Elimina una botiga sense dades (admin) |
|
GET
JWT
|
/api/vendes/analytics |
Vendes agregades per analítica |
|
GET
JWT
|
/api/vendes |
Llista vendes diàries |
|
POST
JWT
|
/api/vendes |
Upsert d'una venda diària |
| Despeses |
|
POST
JWT
|
/api/expenses |
Crea una despesa manual |
|
GET
JWT
|
/api/expenses |
Llista despeses amb filtres |
|
PATCH
JWT
|
/api/expenses/:id |
Actualitza una despesa |
|
DELETE
JWT
|
/api/expenses/:id |
Elimina una despesa |
|
PUT
JWT
|
/api/expenses/:id/tax-details |
Substitueix les línies d'impost d'una despesa |
|
GET
JWT
|
/api/expense-contracts |
Llista contractes recurrents (lloguers, subministraments) |
|
POST
JWT
|
/api/expense-contracts |
Crea un contracte recurrent (admin) |
|
PATCH
JWT
|
/api/expense-contracts/:id |
Actualitza un contracte recurrent (admin) |
|
DELETE
JWT
|
/api/expense-contracts/:id |
Elimina un contracte recurrent (admin) |
|
GET
JWT
|
/api/expense-alerts |
Alertes de despeses (contractes no rebuts) |
|
PATCH
JWT
|
/api/expense-alerts/:id |
Resol o descarta una alerta de despesa |
|
POST
JWT
|
/api/admin/run-expense-cron |
Dispara manualment el cron d'alertes de contractes (admin) |
| Usuaris, productes i exportació |
|
GET
JWT
|
/api/products |
Llista mestres de productes |
|
POST
JWT
|
/api/products |
Crea un producte (admin) |
|
PATCH
JWT
|
/api/products/:id |
Actualitza un producte (admin) |
|
GET
JWT
|
/api/users |
Llista usuaris del tenant (admin) |
|
POST
JWT
|
/api/users |
Crea un usuari (admin) |
|
PATCH
JWT
|
/api/users/:id |
Actualitza un usuari (admin) |
|
GET
JWT
|
/api/export |
Exporta factures + despeses a XLSX (3 pestanyes) |
| Xatbot |
|
POST
JWT
|
/api/chat/stream |
SSE: function calling Gemini + tool execution + streaming |
|
POST
JWT
|
/api/chat/audio |
Transcripció de veu (Gemini) per al xatbot |
| Telegram |
|
GET
JWT
|
/api/telegram/bot |
Estat del bot de Telegram vinculat |
|
POST
JWT
|
/api/telegram/bot |
Configura/vincula el bot de Telegram (token) |
|
DELETE
JWT
|
/api/telegram/bot |
Desvincula el bot de Telegram |
|
POST
JWT
|
/api/telegram/bot/link-code |
Genera codi de vinculació d'un xat |
|
POST
JWT
|
/api/admin/telegram/refresh-webhooks |
Refresca els webhooks de tots els bots (admin) |
|
POST
públic
|
/api/telegram/webhook |
Webhook de Telegram (públic, secret propi per bot) |
| Agent CFO |
|
GET
JWT
|
/api/agent/preferences |
Preferències de notificació (canal, freqüència, tipus) |
|
PUT
JWT
|
/api/agent/preferences |
Actualitza les preferències de notificació |
|
POST
JWT
|
/api/admin/run-agent-cron |
Dispara manualment detectors + briefing + dispatch (admin) |
| Bústia Universal (email) |
|
POST
JWT
|
/api/inbox/intake |
Ingesta manual de documents a la bústia (admin) |
|
GET
JWT
|
/api/inbox/senders |
Llista remitents coneguts (admin) |
|
PATCH
JWT
|
/api/inbox/senders/:id |
Actualitza un remitent — bloqueig/confiança (admin) |
|
DELETE
JWT
|
/api/inbox/senders/:id |
Elimina un remitent (admin) |
|
GET
JWT
|
/api/inbox/settings |
Configuració de la bústia de l'empresa activa (admin) |
|
PUT
JWT
|
/api/inbox/settings |
Actualitza la configuració de la bústia (admin) |
|
GET
JWT
|
/api/inbox/sender-memory |
Memòria de remitents (empresa/categoria apresos) |
|
GET
JWT
|
/api/inbox/metrics |
Mètriques d'ingesta de la bústia (admin) |
|
GET
JWT
|
/api/inbox/mailboxes |
Bústies IMAP configurades (admin) |
|
POST
JWT
|
/api/inbox/mailboxes |
Configura una bústia IMAP nova (admin) |
|
PATCH
JWT
|
/api/inbox/mailboxes/:id |
Actualitza una bústia IMAP (admin) |
|
DELETE
JWT
|
/api/inbox/mailboxes/:id |
Elimina una bústia IMAP (admin) |
|
POST
JWT
|
/api/inbox/mailboxes/test |
Prova la connexió IMAP abans de desar (admin) |
|
POST
JWT
|
/api/inbox/poll |
Dispara manualment el polling IMAP (admin) |
|
POST
públic
|
/api/inbox/poll-cron |
Dispara el polling (públic, X-Cron-Token — cron del sistema) |
|
POST
JWT
|
/api/inbox/purge |
Neteja documents antics processats (admin) |
|
POST
JWT
|
/api/inbox/quarantine/:id/approve |
Aprova un document en quarantena (admin) |
|
POST
JWT
|
/api/inbox/quarantine/:id/process |
Reprocessa un document en quarantena (admin) |
|
POST
JWT
|
/api/inbox/quarantine/:id/block |
Bloqueja el remitent d'un document en quarantena (admin) |
| WhatsApp (Bústia) |
|
GET
públic
|
/api/whatsapp/webhook |
Verificació del webhook (públic, hub.challenge de Meta) |
|
POST
públic
|
/api/whatsapp/webhook |
Rep missatges (públic, validat per signatura HMAC) |
|
GET
JWT
|
/api/inbox/whatsapp/settings |
Configuració del número de WhatsApp (admin) |
|
PUT
JWT
|
/api/inbox/whatsapp/settings |
Dona d'alta/actualitza el número de WhatsApp (admin) |
|
POST
JWT
|
/api/inbox/whatsapp/link-code |
Genera codi perquè un membre vinculi el seu WhatsApp (admin) |
| Stripe (cobrament online) |
|
POST
JWT
|
/api/tenant/stripe |
Desa credencials Stripe de l'empresa activa (admin) |
|
GET
JWT
|
/api/tenant/stripe |
Estat de la connexió Stripe (admin) |
|
DELETE
JWT
|
/api/tenant/stripe |
Desvincula Stripe de l'empresa activa (admin) |
|
POST
JWT
|
/api/invoices-issued/:id/send-payment-link |
Genera i envia l'enllaç de pagament d'una factura (admin) |
|
GET
públic
|
/api/pay/:tenant/:token |
Pàgina de pagament pública (Checkout) pel client final |
|
GET
públic
|
/api/pay/:tenant/:token/success |
Retorn d'èxit de Stripe Checkout (públic) |
|
GET
públic
|
/api/pay/:tenant/:token/cancelled |
Retorn de cancel·lació de Stripe Checkout (públic) |
|
POST
públic
|
/api/stripe/webhook/:tenant/:companyId |
Webhook de Stripe (públic, validat per signatura) |
| DECA (transport) |
|
GET
JWT
|
/api/deca |
Llista DECA de l'empresa activa, amb filtres |
|
POST
JWT
|
/api/deca |
Crea un esborrany DECA (admin) |
|
GET
JWT
|
/api/deca/plates |
Matrícules ja usades per l'empresa |
|
GET
JWT
|
/api/deca/:id |
Document + enviaments + versions + accessos |
|
PATCH
JWT
|
/api/deca/:id |
Edita un esborrany (admin) |
|
DELETE
JWT
|
/api/deca/:id |
Elimina un esborrany (admin) |
|
POST
JWT
|
/api/deca/:id/emit |
Emet el DECA (numera, genera el PDF v1, admin) |
|
POST
JWT
|
/api/deca/:id/modify |
Modifica un DECA emès (nova versió, motiu obligatori, admin) |
|
POST
JWT
|
/api/deca/:id/finish |
Marca la fi del servei (admin) |
|
GET
JWT
|
/api/deca/:id/versions/:n/pdf |
Descàrrega autenticada d'una versió |
|
GET
JWT
|
/api/deca/:id/access-log |
Últims 200 accessos del document (totes les versions) |
|
POST
JWT
|
/api/deca/:id/send |
Envia l'enllaç del DECA per correu al conductor (admin) |
|
POST
JWT
|
/api/admin/run-deca-cron |
Dispara manualment el sweep de desactivació/arxivat del propi tenant (admin) |
|
GET
públic
|
/api/d/:tenant/:token |
PDF públic per a inspecció (200/404/410/429) |
|
GET
públic
|
/api/d/:tenant/:token/show |
Vista mòbil del QR (públic) |
| Portal de Gestories — vista tenant |
|
GET
JWT
|
/api/gestoria/links |
Vincles i invitacions de gestories del tenant (admin) |
|
POST
JWT
|
/api/gestoria/links/:id/accept |
Accepta un vincle amb consentiment versionat (admin) |
|
POST
JWT
|
/api/gestoria/links/:id/revoke |
Revoca l'accés d'una gestoria (admin) |
|
GET
JWT
|
/api/gestoria/closures |
Períodes tancats per la gestoria (admin) |
|
GET
JWT
|
/api/gestoria/incidencies |
Incidències obertes reportades per la gestoria (admin) |
|
GET
JWT
|
/api/gestoria/audit |
Auditoria: què ha consultat la gestoria (admin) |
|
GET
JWT
|
/api/gestoria/reclamacions |
Reclamacions de documentació obertes (admin) |
|
PATCH
JWT
|
/api/gestoria/reclamacions/:id |
Marca una reclamació com a satisfeta (admin) |
| Portal de Gestories — backend gestoria |
|
POST
públic
|
/api/portal/login |
Autenticació d'un usuari de gestoria — retorna JWT del portal |
|
POST
JWT
|
/api/portal/logout |
Invalida la sessió del portal |
|
GET
JWT
|
/api/portal/dashboard |
KPIs de cartera (actius/pendents/incidències) |
|
GET
JWT
|
/api/portal/clients |
Llista de vincles (clients) de la gestoria |
|
POST
JWT
|
/api/portal/clients |
Sol·licita un client nou per NIF (envia invitació) |
|
GET
JWT
|
/api/portal/clients/:linkId/docs |
Documents (doc_index) d'un client vinculat |
|
PATCH
JWT
|
/api/portal/docs/:id/review |
Marca un document com a revisat |
|
GET
JWT
|
/api/portal/docs/:id/detail |
Desglossament d'IVA d'un document |
|
GET
JWT
|
/api/portal/vat-summary |
Agregat d'IVA suportat/repercutit d'un període |
|
GET
JWT
|
/api/portal/comments |
Comentaris/incidències (o notes internes amb ?kind=note) |
|
POST
JWT
|
/api/portal/comments |
Crea un comentari, incidència o nota interna |
|
PATCH
JWT
|
/api/portal/comments/:id |
Edita una nota, o resol/reobre una incidència |
|
DELETE
JWT
|
/api/portal/comments/:id |
Elimina una nota interna (només notes) |
|
GET
JWT
|
/api/portal/closures |
Tancaments de període d'un client |
|
POST
JWT
|
/api/portal/closures |
Tanca un període (soft, amb diff i blocatge real) |
|
PATCH
JWT
|
/api/portal/closures/:id/reopen |
Reobre un període tancat |
|
GET
JWT
|
/api/portal/analytics/health |
Semàfor operatiu de tota la cartera |
|
GET
JWT
|
/api/portal/export |
Exportació comptable parametritzada (xlsx/csv/zip) |
|
GET
JWT
|
/api/portal/export-profiles |
Perfil d'exportació (mapeig de comptes) d'un client |
|
PUT
JWT
|
/api/portal/export-profiles |
Actualitza el perfil d'exportació (només titular) |
|
GET
JWT
|
/api/portal/fiscal/models |
Catàleg de models fiscals disponibles |
|
GET
JWT
|
/api/portal/fiscal/obligations |
Models fiscals als quals està subjecte un client |
|
PUT
JWT
|
/api/portal/fiscal/obligations |
Configura els models fiscals d'un client (replace-all) |
|
GET
JWT
|
/api/portal/fiscal/checklist |
Checklist de models d'un client per exercici |
|
PUT
JWT
|
/api/portal/fiscal/tasks |
Actualitza l'estat d'un model en un període (upsert) |
|
GET
JWT
|
/api/portal/fiscal/agenda |
Agenda de venciments fiscals de tota la cartera |
|
GET
JWT
|
/api/portal/reclamations |
Reclamacions de documentació creades per la gestoria |
|
POST
JWT
|
/api/portal/reclamations |
Crea una reclamació de documentació |
|
PATCH
JWT
|
/api/portal/reclamations/:id |
Actualitza/tanca una reclamació |
|
POST
JWT
|
/api/portal/reclamations/:id/remind |
Força un recordatori immediat |
|
GET
JWT
|
/api/portal/staff |
Empleats del despatx (només titular) |
|
POST
JWT
|
/api/portal/staff |
Alta d'un empleat + assignacions (només titular) |
|
PATCH
JWT
|
/api/portal/staff/:id |
Edita/dona de baixa un empleat (només titular) |
|
POST
JWT
|
/api/portal/clients/:linkId/uploads |
Puja documents a la safata d'entrada d'un client |
|
GET
JWT
|
/api/portal/clients/:linkId/uploads |
Històric de pujades fetes a un client |
✓ Actiu
v2.1.6 · /api/health