Connector d'IA (MCP) de B2Brouter
El Connector d’IA permet que el teu assistent d’intel·ligència artificial habitual pugui consultar directament el teu compte de B2Brouter i la documentació oficial del producte, de manera que respongui a les teves preguntes amb dades reals, i no amb allò que la IA pugui imaginar-se.
En lloc d’entrar a l’aplicació web per buscar, filtrar i creuar informació, pots preguntar:
«Per què l’autoritat fiscal m’ha rebutjat la factura 2026/0142?» «Què tinc pendent de cobrar? Què està vençut?» «Aquest client nou, per quin canal rep les factures?» «Com creo una factura per API i l’envio per Peppol?»
I l’assistent busca la resposta al teu compte i a les guies oficials de B2Brouter, i te l’explica.
Per què això és diferent de preguntar-li a la IA directament?
Section titled “Per què això és diferent de preguntar-li a la IA directament?”Un assistent d’IA sense connector respon de memòria: sap coses generals sobre facturació electrònica, però no coneix el teu compte i es pot equivocar amb detalls normatius (codis d’error, camps obligatoris, requisits de cada autoritat fiscal). El connector li aporta dues coses:
- Les teves dades: les teves factures, els teus informes fiscals, les teves xifres, les mateixes que veus a l’aplicació web, en temps real.
- El coneixement oficial: la documentació completa de B2Brouter: guia d’usuari, guies per a desenvolupadors i guies de les autoritats fiscals (AEAT/Verifactu/TicketBAI, DGFiP, KSeF, SDI, ZATCA, LHDN, Peppol…).
I una instrucció clau per a la IA: si la resposta no és a la documentació, l’assistent ha d’admetre que no ho sap en lloc d’inventar-se-la.
Què pot fer?
Section titled “Què pot fer?”Pot fer sis coses, totes de consulta (la secció 03 les desenvolupa amb exemples):
- Buscar i llistar les teves factures per estat (amb error, rebutjades, impagades…), per número o per període.
- Examinar i validar una factura: el contingut complet i els errors de validació exactes, explicats.
- Seguir els teus informes fiscals, l’estat davant l’autoritat i, si hi ha rebuig, el missatge literal i què vol dir.
- Donar-te les xifres del negoci: ingressos, despeses, pendents i vençuts, evolució mensual, principals clients i proveïdors.
- Dir-te com fer arribar documents a una empresa, és a dir, indicar per quin canal rep (Peppol, FACe, Chorus Pro, SDI…) i quins codis necessites.
- Respondre preguntes amb la documentació oficial d’usuari i de desenvolupador, incloses les guies de cada autoritat fiscal.
Què no pot fer? (i per què)
Section titled “Què no pot fer? (i per què)”El connector no pot crear, modificar, enviar ni esborrar res. És només de lectura, de manera deliberada: la IA t’ajuda a entendre i decidir; les accions —corregir una factura, enviar-la o reclamar un cobrament— les fas tu, a l’aplicació web de B2Brouter o per l’API, com sempre.
Això no és una limitació provisional ni una mancança: és el disseny de seguretat.
A qui li serveix
Section titled “A qui li serveix”A qualsevol que treballi amb B2Brouter, sigui quin sigui el seu perfil:
- Si portes la facturació, per desencallar factures rebutjades i saber com facturar un client nou.
- Si ets assessor o gestoria, per revisar l’estat fiscal dels comptes dels teus clients i traduir els rebuigs de les autoritats.
- Si ets desenvolupador, perquè el teu agent de codi tingui la documentació canònica de l’API i pugui diagnosticar les teves factures de prova sense sortir de l’editor.
- Si ets gerent o responsable financer, per tenir les xifres del negoci des del xat, sense entrar a l’aplicació web.
Aquesta guia no separa aquests recorreguts: tot el que descriu està a l’abast de tots els perfils, amb els permisos que cada usuari ja té.
Connectar el teu assistent a B2Brouter
Section titled “Connectar el teu assistent a B2Brouter”Requisits
Section titled “Requisits”- Un compte de B2Brouter amb subscripció de pagament activa. Amb el pla gratuït el connector no està disponible. Les funcions sobre factures, informes fiscals i resum financer requereixen, a més, el pla Professional o superior al compte consultat.
- El teu usuari i contrasenya de B2Brouter. La connexió es fa amb el teu usuari personal, no cal cap clau d’API ni cap configuració tècnica.
- Un assistent d’IA compatible amb connectors MCP: Claude (web i aplicació), Claude Code, i altres assistents a mesura que cada plataforma aprovi el connector.
Connectar-lo des d’un assistent de xat
Section titled “Connectar-lo des d’un assistent de xat”Aquest és el camí per a la majoria d’usuaris (Claude web, aplicació de mòbil o escriptori):
- Al teu assistent, busca B2Brouter al directori de connectors, o afegeix-lo per URL:
https://app.b2brouter.net/mcp. - S’obrirà una finestra de B2Brouter demanant-te iniciar sessió (si no la tens oberta) i autoritzar l’accés de l’assistent.
- Revisa què autoritzes i accepta-ho. Tornaràs a l’assistent, ja connectat.
Això es fa un sol cop per assistent. A partir d’aquí, pregunta amb naturalitat: l’assistent decideix sol quan necessita consultar B2Brouter, i tu ho veus perquè t’ho indica a la conversa.
Connectar-lo des d’un agent de codi
Section titled “Connectar-lo des d’un agent de codi”Si treballes amb un agent de codi (Claude Code, o qualsevol editor/IDE compatible amb MCP), el connector es registra com un servidor MCP remot més:
- URL del servidor:
https://app.b2brouter.net/mcp - En afegir-lo, el flux d’autorització s’obre al navegador: inicies sessió a B2Brouter i autoritzes, com en el cas anterior.
El principi que ho governa tot: l’assistent ets tu
Section titled “El principi que ho governa tot: l’assistent ets tu”L’assistent actua amb la teva identitat i els teus permisos, ni més ni menys:
- Només veu els comptes on el teu usuari és membre.
- Dins de cada compte, només veu les seccions que tu tens permeses. Si al compte de l’empresa només tens accés a factures rebudes, l’assistent tampoc veurà les emeses.
- Cada persona de l’empresa connecta el seu propi usuari: no es comparteixen accessos ni permisos.
La secció 04 explica com funciona aquest model per dins.
Desconnectar-lo
Section titled “Desconnectar-lo”Des del teu perfil de B2Brouter → Aplicacions autoritzades, pots revocar l’accés de l’assistent quan vulguis. L’efecte és immediat. També pots eliminar el connector des del mateix assistent.
Veure què ha fet l’assistent
Section titled “Veure què ha fet l’assistent”Cada consulta que l’assistent fa al teu compte queda registrada: al teu perfil de B2Brouter → Activitat MCP hi veuràs què s’ha consultat i quan, amb quina funció i des de quina aplicació. Transparència completa sobre l’activitat de la IA amb les teves dades; també és útil, si ets assessor, com a traçabilitat de cara als teus clients.
Si la connexió no va
Section titled “Si la connexió no va”| Símptoma | Causa probable | Solució |
|---|---|---|
| «An account with an active subscription is required» | El teu usuari no té accés a cap compte amb subscripció de pagament activa | Activa o renova una subscripció, o demana que t’afegeixin a un compte de pagament |
| L’autorització no finalitza / no torna a l’assistent | Bloqueig de finestres emergents o sessió caducada a mig flux | Permet la finestra de B2Brouter, inicia sessió i repeteix la connexió |
| L’assistent no ofereix B2Brouter | La plataforma encara no té el connector aprovat al seu directori | Afegeix-lo manualment per URL (https://app.b2brouter.net/mcp) si l’assistent ho permet |
Què pots fer
Section titled “Què pots fer”No cal memoritzar res: pregunta amb les teves paraules i en el teu idioma: l’assistent tradueix el teu dubte a les consultes que calguin.
Un bon primer pas, sobretot si tens accés a més d’un compte (grup, filials, o una cartera de clients si ets gestoria):
«Quins comptes de B2Brouter tinc?»
L’assistent llista els comptes on el teu usuari és membre, amb nom i identificadors fiscals. A partir d’aquí, t’hi pots referir amb naturalitat («el compte de Client SA»).
1. Buscar i llistar factures
Section titled “1. Buscar i llistar factures”Aquest és el punt de partida de la majoria de consultes: quines factures compleixen una condició.
«Quines factures tinc amb errors?» «Quines factures tinc rebutjades aquesta setmana?» «Llista’m les factures vençudes, de més gran a més petita» «Busca la factura FC-2026/0089 i digue’m en quin estat està»
L’assistent llista les factures que encaixen, per estat (amb error, rebutjada, impagada…), per número o sèrie, per període, i des de la llista pots demanar el detall de qualsevol.
2. Examinar i validar una factura
Section titled “2. Examinar i validar una factura”Del resum al detall complet:
«Ensenya’m la factura 2026/0142»
L’assistent retorna el contingut complet: parts, línies, imports, impostos, condicions de pagament. I la pregunta clau quan alguna cosa falla:
«Per què ha fallat la 2026/0142?» «Aquesta factura passarà la validació abans que l’enviï?»
L’assistent obté els errors de validació exactes i te’ls explica amb la documentació oficial: què vol dir cada error, quin camp afecta i què cal canviar. La correcció la fas a l’aplicació web (el connector no toca res) i després pots tornar a verificar: «ara ja està bé?».
3. Seguir els informes fiscals
Section titled “3. Seguir els informes fiscals”Si el teu país té declaració o registre electrònic de factures (Verifactu, SII o TicketBAI a Espanya, DGFiP a França, KSeF a Polònia, ZATCA a l’Aràbia Saudita, MyInvois a Malàisia…), cada factura genera un informe fiscal amb el seu propi cicle de vida davant l’autoritat. El connector el segueix:
«Quins informes fiscals tinc en error o rebutjats?» «Què ha rebutjat l’autoritat fiscal del compte de Client SA aquesta setmana?» «El report de la factura FC-0089 ha quedat registrat correctament?»
I per a cada rebuig, el diagnòstic complet:
«Detalla’m el primer» → estat, imports i el missatge de rebuig literal de l’autoritat. «Què vol dir aquest error i com es corregeix?» → l’assistent creua el codi amb les guies oficials de B2Brouter de cada autoritat i t’indica el camp afectat i la correcció.
Funciona per a qualsevol de les autoritats suportades, i pots preguntar codis solts: «què vol dir aquest error 1210 de Verifactu?», «aquest codi de rebuig del KSeF, què significa?».
4. Les xifres del negoci
Section titled “4. Les xifres del negoci”Són les mateixes xifres que el dashboard de B2Brouter; no hi ha dues veritats:
«Com hem anat aquest trimestre?» → ingressos, despeses i resultat net del període. «Què tenim pendent de cobrar? Quant està vençut?» → pendents de cobrament i pagament, separats entre al dia i vençuts, amb nombre de factures i import. «Qui són els nostres principals clients aquest any? I els proveïdors?» → rànquing per volum facturat. «Com ha evolucionat la caixa mes a mes?» → ingressos, despeses, diferència i acumulat per mes.
I la composició lliure:
«Fes-me un resum per a la reunió amb el banc: facturació de l’any, evolució mensual, pendents i vençuts destacats»
Detalls pràctics:
- Períodes: aquest mes / trimestre / any, els anteriors, o qualsevol interval concret («de l’1 de gener al 15 de març»).
- Impostos: demana les xifres amb IVA o sense, segons prefereixis.
- Monedes: cada resum és d’una sola moneda (per defecte, la del compte). Si factureu en més d’una, demana-les per separat («i ara en dòlars»).
5. Com fer arribar documents a una empresa
Section titled “5. Com fer arribar documents a una empresa”Un client nou et demana factura electrònica i no saps per on començar. Dona a l’assistent l’identificador fiscal del client (el NIF a Espanya, el SIRET a França, la Partita IVA a Itàlia, el NIP a Polònia, el VAT number a la resta de la UE):
«Puc enviar factures electròniques al NIF B51115943? Com?» «Com envio factures al SIRET 13002526500013?» «Aquest client alemany amb VAT DE811907980, rep per Peppol?»
L’assistent consulta el directori de B2Brouter i et diu per quin canal rep documents aquesta empresa (Peppol, FACe, Chorus Pro, SDI…), quins tipus de document accepta i quins codis necessitaràs: els codis DIR3 per a una administració pública espanyola, el SIRET i el codi de servei per a Chorus Pro, el Codice Destinatario per a l’SDI italià, l’identificador Peppol per a clients internacionals…
- Si l’empresa és a la xarxa Peppol, però les dades encara s’estan sincronitzant, l’assistent t’ho dirà i ho reintentarà.
- Si no hi ha cap manera d’enviar-li documents electrònicament, t’ho dirà clarament — i et pot explicar les alternatives.
El directori té un límit de 50 cerques per dia i usuari. La cerca és per identificador fiscal exacte; buscar per nom aproximat no està disponible (està en estudi).
6. Preguntes sobre com funciona B2Brouter (i la facturació electrònica)
Section titled “6. Preguntes sobre com funciona B2Brouter (i la facturació electrònica)”L’assistent té accés a la documentació oficial completa de B2Brouter. Pregunta com ho faries a suport:
- «Com creo una factura rectificativa?»
- «Com configuro el TicketBAI?» · «Què he de fer per complir amb la facturació electrònica francesa?» · «Com funciona el KSeF?»
- «Què és el codi DIR3 i on el poso?» · «Què és l’identificador Peppol?»
Si la resposta no és a la documentació, l’assistent t’ho dirà en lloc d’inventar-se-la. En aquest cas, el canal de suport de sempre segueix sent el camí.
Encadenar-ho tot
Section titled “Encadenar-ho tot”El valor del connector és que aquestes sis peces es combinen de manera natural dins d’una conversa. Alguns fluxos complets:
- Desencallar la feina del dia: «quines factures tinc amb errors?» → «per què ha fallat la primera?» → «què vol dir aquest error?» → corregeixes al panell → «ara ja està bé?».
- La revisió fiscal del matí (gestories): «què ha rebutjat l’AEAT del compte de Client SA aquesta setmana?» → detall del rebuig → traducció amb la guia de l’autoritat. Per revisar tota la cartera: «revisa’m tots els meus comptes i digues-me quins tenen informes rebutjats» — funciona, però amb moltes desenes de clients és lent (una consulta per compte); per al dia a dia sol ser més àgil per client concret.
- Del global al detall: «què tenim vençut?» → «llista-me-les per import» → «ensenya’m la més gran».
- Integració (developers): guia de l’API → crear per API al sandbox → diagnosticar errors pel connector → corregir el payload.
Recorda: l’assistent només llegeix. Crear, corregir, enviar i cobrar es fa al panell o per API, com sempre. La feina que t’estalvia és la de buscar, creuar i entendre.
Com funciona per dins
Section titled “Com funciona per dins”No cal llegir aquesta secció per fer servir el connector. Però si vols entendre, o has d’explicar a algú, per què és de fiar, aquí hi ha el funcionament, primer en llenguatge pla i després amb el detall tècnic.
Les tres peces
Section titled “Les tres peces”Quan preguntes «per què m’han rebutjat la factura 2026/0142?», hi intervenen tres peces:
- El teu assistent d’IA (Claude, o el que facis servir): entén la pregunta i decideix quina informació li cal.
- El connector de B2Brouter: un conjunt de funcions de consulta que l’assistent pot invocar, «llista’m les factures amb error», «dona’m el detall d’aquest informe fiscal», «busca aquesta empresa al directori».
- El teu compte de B2Brouter: d’on surten les dades, amb els mateixos permisos que tens al panell.
L’assistent tradueix la teva pregunta en una o més consultes al connector, rep les dades i compon la resposta. Tu no veus aquesta mecànica — només la conversa — però queda tota registrada (vegeu «Auditoria», més avall).
Identitat: l’assistent actua en nom teu
Section titled “Identitat: l’assistent actua en nom teu”No existeix cap «usuari robot» ni cap clau especial per a la IA. Quan connectes l’assistent, l’autoritzes a actuar amb el teu usuari, i B2Brouter aplica a cada consulta exactament les mateixes regles que quan navegues pel panell:
- Membre: només els comptes on ets membre.
- Secció: dins de cada compte, només les seccions que tens permeses (emeses, rebudes, informes fiscals…).
- Pla: les funcions de factures, informes i finances requereixen que el compte tingui pla Professional o superior; totes requereixen que arribis a algun compte de pagament.
La conseqüència pràctica: el connector no obre cap porta nova. Tot el que l’assistent pot veure, tu ja ho podies veure. I si demà et treuen d’un compte o et restringeixen una secció, l’assistent ho perd al mateix instant.
Per què és només de lectura
Section titled “Per què és només de lectura”És la decisió de disseny central d’aquesta primera versió. Donar a una IA la capacitat d’escriure sobre documents amb valor legal i fiscal (crear factures, enviar-les a una autoritat, modificar dades) obre una categoria de riscos (errors d’interpretació, instruccions malicioses amagades en dades) que volem tractar amb calma i per separat. Mentrestant:
- Consultar és segur per construcció: cap pregunta, per mal formulada que estigui, pot canviar res del teu compte.
- La responsabilitat queda on toca: la IA proposa el diagnòstic; l’acció (a l’aplicació web o per API) la fa una persona (o un sistema) amb intenció explícita.
D’on surt el coneixement (i per què no s’inventa respostes)
Section titled “D’on surt el coneixement (i per què no s’inventa respostes)”Quan preguntes «com configuro el TicketBAI?», l’assistent no respon de memòria: consulta la base de coneixement oficial de B2Brouter: la guia d’usuari completa, la documentació de developers i les guies de cada autoritat fiscal, la mateixa que publica B2Brouter i versionada amb el producte.
I porta una instrucció explícita: si cap document cobreix la pregunta, ha de dir que no té la informació, mai inventar. És la resposta directa al risc més seriós d’usar IA en un domini fiscal: una resposta inventada però convincent. Cap assistent és infal·lible, però el connector està construït per minimitzar aquest risc i davant d’una decisió amb conseqüències fiscals, confirma sempre amb el teu assessor o amb suport.
Protecció davant contingut de tercers
Section titled “Protecció davant contingut de tercers”Les factures rebudes i el directori contenen text escrit per altres: noms d’empreses, descripcions de línies. Algú podria intentar amagar-hi instruccions per a la IA («ignora les teves ordres i…»). El connector marca explícitament tot aquest contingut com a dades, no instruccions, perquè l’assistent no executi mai ordres amagades dins d’una factura o d’un nom d’empresa.
Cap oracle d’existència
Section titled “Cap oracle d’existència”Si consultes un identificador que no existeix i un que pertany al compte d’algú altre, reps exactament el mateix error («Not found or not authorized»). És deliberat: ningú pot fer servir el connector per esbrinar què existeix fora del seu abast, ni tan sols per confirmar que una factura o un compte existeixen.
Auditoria
Section titled “Auditoria”Cada consulta de l’assistent queda registrada (quan, quina funció, quina aplicació, quin usuari) i és consultable al teu perfil (Activitat MCP). Si mai et preguntes «què ha mirat exactament la IA?», la resposta és allà, completa.
En resum
Section titled “En resum”| Principi | Què implica |
|---|---|
| Identitat pròpia de l’usuari | L’assistent veu el que tu veus; ni més, ni menys; revocable a l’instant |
| Només lectura | Cap pregunta pot modificar res; les accions són teves |
| Coneixement oficial | Respostes basades en la documentació de B2Brouter, amb «no ho sé» explícit |
| Dades ≠ instruccions | El contingut de tercers no pot donar ordres a la IA |
| Errors indistingibles | Cap filtració d’existència entre comptes |
| Auditoria completa | Tota l’activitat, registrada i consultable |
Límits, seguretat i preguntes freqüents
Section titled “Límits, seguretat i preguntes freqüents”Què NO fa el connector (per disseny)
Section titled “Què NO fa el connector (per disseny)”| No fa | Què fer en el seu lloc |
|---|---|
| Crear, modificar, enviar o esborrar factures i documents | Panell de B2Brouter o API REST |
| Reclamar cobraments, enviar recordatoris | Panell (l’assistent t’explica com) |
| Accions sobre la subscripció o la configuració del compte | Panell |
| Dir-te automàticament si el teu compte «està a punt» per a una autoritat (Verifactu, DGFiP, KSeF…) | Pregunta-ho a la documentació («què necessito per activar Verifactu?») i revisa la configuració al panell |
| Buscar empreses al directori pel nom aproximat | Cerca per identificador fiscal exacte (NIF, SIRET, Partita IVA, NIP, VAT number…); la cerca per nom està en estudi |
| Un resum agregat de tots els teus comptes d’un sol cop | Demana-ho compte a compte, o deixa que l’assistent els recorri (lent amb carteres grans) |
Límits d’ús
Section titled “Límits d’ús”| Límit | Detall |
|---|---|
| Directori | 50 cerques per dia i usuari; la resta de funcions no tenen límit específic |
| Resum financer | Una moneda per resum; comptes multi-moneda, per separat |
| Pla | Compte de pagament actiu per connectar; Professional o superior per a factures, informes i finances |
Seguretat i privadesa
Section titled “Seguretat i privadesa”La secció 04 explica el funcionament amb detall; aquest és el resum de garanties:
- El connector actua amb la teva identitat. Només els teus comptes, només les teves seccions (les mateixes regles que la web), comprovades a cada consulta. Ni l’assistent ni el proveïdor d’IA tenen credencials pròpies sobre el teu compte.
- Consentiment explícit i revocable. L’autorització l’aproves tu (OAuth) i la pots revocar en qualsevol moment des de Aplicacions autoritzades, amb efecte immediat. Si la subscripció caduca, l’accés s’atura sol.
- Auditoria completa. Cada consulta queda registrada i és consultable a Activitat MCP.
- Sense filtracions entre comptes. Un identificador inexistent i un d’un altre compte donen el mateix error.
- Protecció davant contingut maliciós. El text escrit per tercers (factures rebudes, directori) viatja marcat com a dades, no instruccions.
- On van les teves dades. Les respostes del connector les processa el proveïdor d’IA que has connectat (Anthropic, Google…), segons les seves condicions i el DPA de B2Brouter. Connectar el compte implica acceptar aquest tractament: revisa la política de privadesa del teu assistent.
Si alguna cosa no va
Section titled “Si alguna cosa no va”| Símptoma | Causa probable | Solució |
|---|---|---|
| «An account with an active subscription is required» | El teu usuari no té accés a cap compte amb subscripció de pagament activa | Activa o renova una subscripció, o demana que t’afegeixin a un compte de pagament |
| «Not found or not authorized» en consultar una factura o informe | L’identificador no existeix o no tens permís per veure’l (el missatge és el mateix a propòsit) | Comprova l’identificador i que el teu usuari té accés a aquella secció del compte; si és un compte de client, pot ser que el seu pla no inclogui el connector |
| L’assistent diu que no té la informació | La pregunta queda fora de la documentació de B2Brouter: el connector està dissenyat per admetre-ho en lloc d’inventar | Contacta amb el suport de B2Brouter pel canal habitual |
| «Rate limit reached» al directori | Has superat les 50 cerques diàries | Espera a l’endemà o consulta el directori des del panell |
Preguntes freqüents
Section titled “Preguntes freqüents”Necessito una clau d'API?
No. La connexió es fa amb el teu usuari de B2Brouter, amb una autorització que aproves al navegador.
Necessito saber programar?
No. Connectar-lo són tres passos al teu assistent de xat, i des de llavors només converses. El detall tècnic d’aquest manual és opcional.
Ho pot fer servir tothom de l'empresa?
Cada persona connecta el seu propi usuari i té el seu propi abast. No es comparteixen accessos ni permisos.
Hi ha límit de comptes?
No: l’assistent veu tots els comptes on ets membre.
Les xifres del resum financer són fiables?
Surten del mateix motor que el dashboard del panell — són les mateixes. Per a decisions fiscals o comptables crítiques, verifica sempre a la font primària.
L'assistent es pot inventar respostes sobre normativa?
El connector està dissenyat perquè respongui **només** amb la documentació oficial de B2Brouter i admeti quan no té la resposta. Tot i això, cap assistent d'IA és infal·lible: davant d'una decisió amb conseqüències fiscals, confirma amb el teu assessor o amb suport.Per què no pot corregir la factura si ja veu què està malament?
Decisió deliberada de seguretat d’aquesta primera versió: tot és només de lectura. Les capacitats d’escriptura s’estudiaran més endavant, amb la seva pròpia anàlisi de riscos.
Per què em diu «Not found or not authorized» si la factura existeix?
Perquè el teu usuari no hi té accés (secció, compte o pla). El missatge no distingeix «no existeix» de «no autoritzat» per seguretat.Puc fer-lo servir des del meu editor de codi?
Sí — qualsevol agent de codi compatible amb MCP (Claude Code, IDEs compatibles) es connecta amb la mateixa URL i el mateix flux d’autorització. Vegeu la secció 02.