L'aplicació dels tècnics, el portal de comandes o la botiga en línia necessiten els clients, els articles i l'estoc de l'ERP, i l'ERP necessita el que aquestes aplicacions generen. Connectar-los bé estalvia hores de tecleig; connectar-los malament crea comandes duplicades, estocs que no quadren i errors que ningú no veu. Aquesta és una guia tècnica, escrita per fabricants d'ERP, sobre les tres vies d'integració, com sincronitzar les dades i què fer quan el teu ERP no té API.
Resum ràpid
| Pregunta | Resposta curta |
|---|---|
| Millor via? | L'API de l'ERP, si existeix i cobreix el que necessites |
| I si no hi ha API? | Lectura de la base de dades, taules intermèdies o fitxers programats |
| Escriure directament a les taules de l'ERP? | No, tret que el fabricant ho controli |
| A l'instant o cada cert temps? | A l'instant el que veu el client; cada cert temps, la resta |
| El més important? | Un amo per a cada dada, sense duplicats i amb avís si alguna cosa falla |
| Facturar des de l'aplicació? | Millor que facturi l'ERP, ja adaptat a Verifactu |
Què és integrar un ERP amb una aplicació pròpia
Integrar un ERP amb una aplicació pròpia és fer que els dos programes intercanviïn dades sols i de manera fiable: l'aplicació llegeix de l'ERP clients, articles, preus o estoc, i li retorna comandes, parts o lectures. Es fa per API, per la base de dades o amb fitxers, amb control d'errors i sense duplicar informació.
A la pàgina d'integració de l'ERP expliquem què connectem i com treballem. Aquí entrem en el detall tècnic: com funciona cada via per dins, quines decisions de disseny eviten problemes i què preguntar a qui hagi de fer la integració. Si estàs pensant en l'aplicació en si, comença per programes a mida.
Les integracions més habituals en una pime són aquestes:
Cinc preguntes abans de triar la via d'integració
La via tècnica és l'última decisió, no la primera. Abans cal respondre això:
| Pregunta | Exemple de resposta | Per què importa |
|---|---|---|
| 1. Quines dades viatgen? | Clients, articles, preus, estoc, comandes | Defineix l'abast i l'esforç |
| 2. En quin sentit? | Articles de l'ERP a l'aplicació; comandes de l'aplicació a l'ERP | Un sentit és molt més senzill que dos |
| 3. Cada quant? | Estoc a l'instant; tarifes cada nit | Decideix si cal API o n'hi ha prou amb fitxers |
| 4. Quantes? | Unes poques comandes al dia o milers de lectures per hora | Afecta el rendiment i el disseny |
| 5. Qui mana sobre cada dada? | El preu el mana l'ERP; la signatura del part, l'aplicació | Evita que un programa trepitgi el que ha fet l'altre |
La cinquena és la més important. Cada dada ha de tenir un únic programa «amo», l'únic on es crea i es modifica. Els altres només la llegeixen. Quan dos programes poden canviar la mateixa dada (per exemple, el telèfon d'un client a l'ERP i a l'aplicació), tard o d'hora apareixen conflictes que ningú no sap resoldre.
Via 1: connectar amb l'API de l'ERP
Una API (Application Programming Interface) és una porta que l'ERP obre a altres programes. L'aplicació no toca les taules de l'ERP: li fa peticions («dona'm l'estoc de l'article A-100», «crea aquesta comanda») i l'ERP respon aplicant les seves pròpies regles, igual que si la comanda s'hagués introduït per pantalla.
Avui, el normal és una API de serveis web que intercanvia dades en format JSON a través d'HTTPS. Aquests són els conceptes que convé conèixer:
- Autenticació: l'aplicació s'identifica amb un usuari tècnic, una clau o un testimoni (token). Mai amb l'usuari d'una persona.
- Permisos: aquest usuari tècnic només pot fer el que la integració necessita. Si només crea comandes, no hauria de poder esborrar clients.
- Validació: l'ERP comprova cada operació (client existent, article actiu, preu correcte) i la rebutja amb un missatge clar si alguna cosa no quadra.
- Versions: una API versionada permet que l'ERP evolucioni sense trencar les integracions que ja funcionen.
- Límits: algunes API limiten el nombre de peticions per minut; cal tenir-ho en compte en integracions amb molt de volum.
- Avisos (webhooks): algunes API poden avisar l'aplicació quan alguna cosa canvia, en lloc que l'aplicació pregunti constantment.
Així viatja, per exemple, una comanda des d'una aplicació pròpia fins a l'ERP. Les dades són fictícies:
| Camp enviat | Valor d'exemple | Què comprova l'ERP |
|---|---|---|
| Identificador d'origen | APP-2026-000154 | Que no existeixi ja: evita duplicats |
| Client | Codi 4300125 | Que existeixi i no estigui bloquejat |
| Línia 1 | A-100 · 12 unitats | Article actiu i estoc disponible |
| Preu | El calcula l'ERP | Tarifa i descomptes del client |
| Data de lliurament | 14/11/2026 | Data vàlida i dia laborable |
| Resposta de l'ERP | Comanda PV-26-03318 creada | L'aplicació desa el número per consultar-lo després |
Fixa't en la fila del preu: l'aplicació no envia el preu, el calcula l'ERP. És un exemple de la regla de l'amo: si les tarifes viuen a l'ERP, cap altre programa no hauria de decidir el preu.
Via 2: connectar a través de la base de dades
Quan l'ERP no ofereix API, o la que ofereix no cobreix el que cal, la integració pot treballar amb la seva base de dades. Aquí cal distingir clarament entre llegir i escriure.
| Operació | Com es fa bé | Risc si es fa malament |
|---|---|---|
| Llegir | Usuari de només lectura i vistes preparades amb les dades justes | Consultes pesades que alenteixen l'ERP en hores punta |
| Escriure | A taules intermèdies que l'ERP valida i processa amb la seva pròpia lògica | Saltar-se validacions: estoc, comptabilitat o numeració descuadrats |
| Escriure directament a les taules de l'ERP | Només el fabricant, que sap quines altres taules depenen de cada dada | Dades incoherents i pèrdua del suport del fabricant |
Un exemple de per què no s'ha d'escriure a cegues: crear un albarà en un ERP no és inserir una fila. Sol implicar moure estoc, actualitzar el pendent de la comanda, calcular preus i descomptes, reservar numeració i, més endavant, comptabilitzar. Si l'aplicació només insereix la capçalera i les línies, l'albarà «existeix», però la resta de l'ERP no se n'ha assabentat.
Per això, com a fabricants de l'ERP Praxis des de 1988, insistim tant en aquest punt: llegir de la base de dades és una via ràpida i molt útil per a consultes i informes; escriure s'ha de fer sempre a través de processos que l'ERP mateix controla.
Via 3: l'intercanvi de fitxers
És la via més antiga i la més universal: un programa deixa un fitxer en una carpeta o en un servidor, i l'altre el recull i el processa. Funciona amb gairebé qualsevol programa, inclosos els que no tenen API ni permeten accedir a la seva base de dades.
Una integració per fitxers fiable necessita quatre coses: noms únics (amb data, hora i número), moure cada fitxer a «processats» o «amb errors» per no llegir-lo dues vegades, un format acordat per escrit (separador, decimals, codificació de caràcters) i un avís quan un fitxer no arriba o no es pot processar. El seu límit és que no és a l'instant: les dades viatgen cada cert temps.
Estudiem què permet el teu ERP i et diem amb claredat quina via és viable i segura.
Comparativa: API, base de dades o fitxers
| Criteri | API | Base de dades | Fitxers |
|---|---|---|---|
| Rapidesa de les dades | A l'instant | A l'instant per llegir | Cada cert temps |
| Validacions de l'ERP | Sí, les de l'ERP mateix | Només amb taules intermèdies | Les del procés d'importació |
| Seguretat | Alta, amb usuari i permisos | Bona amb només lectura | Bona amb servidor xifrat |
| Resistència a actualitzacions de l'ERP | Alta si està versionada | Pot necessitar ajustos | Alta si el format no canvia |
| Requisit | Que l'ERP tingui API | Conèixer l'ERP per dins | Gairebé cap |
| Ideal per a | Comandes, estoc, portals, apps mòbils | Informes, quadres de comandament, consultes | Tarifes, catàlegs, EDI, programes antics |
A la pràctica, moltes integracions combinen vies: l'aplicació llegeix el catàleg d'una vista de la base de dades, consulta l'estoc a l'instant per API i rep les tarifes de la nova temporada en un fitxer.
Com i quan sincronitzar les dades
A més de la via, cal decidir el moment en què viatgen les dades. Hi ha quatre patrons:
| Patró | Com funciona | Quan fer-lo servir |
|---|---|---|
| Consulta a l'instant | L'aplicació pregunta a l'ERP quan ho necessita | Estoc, risc d'un client, estat d'una comanda |
| Avís per esdeveniment | L'ERP avisa quan alguna cosa canvia (webhook o cua de missatges) | Canvis que l'aplicació ha de conèixer de seguida |
| Sondeig periòdic | Cada pocs minuts, l'aplicació demana «el que ha canviat des de l'última vegada» | Quan l'ERP no pot avisar |
| Lots programats | Un cop al dia o a la nit s'envia tot un bloc | Catàlegs, tarifes, informes |
El sondeig periòdic necessita que cada registre tingui una data d'última modificació fiable: així l'aplicació només demana el que és nou i no ha de baixar-ho tot cada vegada. Si l'ERP no la té, l'alternativa és comparar, cosa que és més lenta.
Aquest és el recorregut complet d'una comanda ben integrada:
- 1. Comanda a l'aplicacióamb un identificador únic d'origen
- 2. Cua d'enviamentla comanda queda desada encara que falli la connexió
- 3. Enviament a l'ERPper API o taula intermèdia, amb usuari tècnic
- 4. Validació de l'ERPclient, articles, estoc, preus i duplicats
- 5. Registre i respostanúmero de comanda de l'ERP o motiu del rebuig
- 6. Confirmaciól'aplicació mostra l'estat; si hi ha error, s'avisa una persona
Duplicats, errors i reintents: el que separa una bona integració
La majoria de les integracions que fallen ho fan en silenci. Aquestes són les decisions de disseny que ho eviten:
- Identificador únic d'origen. Cada comanda, part o lectura porta un codi propi de l'aplicació. Abans de crear res, l'ERP comprova si ja el té. Així, enviar dues vegades el mateix no crea dos documents.
- Taula de correspondències. L'aplicació i l'ERP no sempre fan servir els mateixos codis. Una taula relaciona cada codi d'un programa amb el de l'altre, i es manté sola.
- Cua i reintents. Si l'ERP no respon (còpia de seguretat, actualització, tall de xarxa), l'operació es desa i es reintenta. No es perd res.
- Errors amb nom i cognoms. «Article A-100 donat de baixa» es pot resoldre; «Error 500», no. El missatge ha de dir què falla i en quin document.
- Registre de cada intercanvi. Què s'ha enviat, quan, què ha respost l'ERP. És el primer que es mira quan algú diu «aquesta comanda no ha arribat».
- Avís a una persona. El que no es pot resoldre sol, arriba per correu o a una safata d'incidències, no es queda amagat en un registre.
Què fer si el teu ERP no té API
És més habitual del que sembla, sobretot amb programes que fa anys que són a l'empresa. Les opcions, de la més recomanable a la menys:
| Opció | Com funciona | A tenir en compte |
|---|---|---|
| Demanar la connexió al fabricant | El fabricant de l'ERP desenvolupa l'API o el procés d'importació | La més segura, però depèn de la seva disposició i dels seus terminis |
| Lectura + taules intermèdies | Es llegeix amb només lectura; s'escriu en taules que l'ERP processa | Necessita que l'ERP tingui, o permeti, aquest procés d'importació |
| Fitxers programats | Es fan servir les importacions i exportacions que ja té l'ERP | No és a l'instant, però és robusta |
| Un programa intermedi | Una peça a mida tradueix entre l'aplicació i l'ERP i centralitza errors i registres | Afegeix una peça, però aïlla l'aplicació dels canvis de l'ERP |
| Automatitzar les pantalles | Un robot introdueix les dades a les pantalles de l'ERP com una persona | Últim recurs: fràgil davant de qualsevol canvi de pantalla |
Si arribes a l'última fila, convé preguntar-se si el problema és la integració o l'ERP. De vegades, la resposta honesta és que cal canviar d'ERP sense aturar l'empresa.
Seguretat, dades personals i Verifactu
I Verifactu? El Reial decret 1007/2023, el reglament de Verifactu, afecta els programes amb els quals s'emeten factures. Si la teva aplicació pròpia emet factures, també és un sistema de facturació i ho ha de complir. Per això, en la majoria dels casos recomanem que l'aplicació enviï comandes, albarans o parts a l'ERP, i que sigui l'ERP, ja adaptat, qui facturi. Te'n parlem a la guia completa de Verifactu.
Llista de comprovació abans de posar en marxa una integració
- Està escrit quines dades viatgen, en quin sentit, cada quant i qui mana sobre cadascuna?
- La via triada fa servir les validacions de l'ERP, o les reprodueix?
- Cada operació porta un identificador únic que impedeix duplicats?
- Hi ha cua i reintents si l'ERP no respon?
- Els errors diuen què falla i en quin document?
- Hi ha registre de cada intercanvi i algú que rep els avisos?
- L'usuari tècnic només té els permisos necessaris?
- S'ha provat amb una còpia de les dades, inclosos casos estranys (client bloquejat, article de baixa, sense estoc)?
- Està documentada, perquè no depengui d'una sola persona?
- Qui la manté quan s'actualitzi l'ERP o l'aplicació?
Glossari ràpid
- API: interfície que un programa ofereix perquè uns altres li demanin dades o li enviïn operacions.
- Servei web: API a la qual s'accedeix a través d'internet o de la xarxa, normalment amb HTTPS.
- JSON: format de text per intercanviar dades estructurades entre programes.
- Webhook: avís automàtic que un programa envia a un altre quan alguna cosa canvia.
- Taula intermèdia: taula on una aplicació deixa dades perquè l'ERP les validi i les processi.
- Idempotència: propietat d'una operació que, repetida, no produeix efectes duplicats.
- EDI: intercanvi electrònic de documents comercials en formats estàndard.
Preguntes freqüents sobre la integració de l'ERP
Què és l'API d'un ERP?
És una porta d'entrada que l'ERP ofereix a altres programes per demanar-li dades o enviar-li operacions de manera controlada, normalment a través de serveis web, amb usuari, permisos i validacions pròpies de l'ERP.
Es pot integrar un ERP que no té API?
Gairebé sempre. Es pot llegir de la base de dades amb un usuari de només lectura, escriure a través de taules intermèdies que l'ERP processa, intercanviar fitxers programats o demanar al fabricant que desenvolupi la connexió.
És perillós que una aplicació escrigui directament a la base de dades de l'ERP?
Sí, si es fa sense conèixer l'ERP per dins: es poden saltar validacions, descuadrar l'estoc o la comptabilitat i perdre la garantia del fabricant. El segur és escriure a través de l'API o de processos controlats que l'ERP mateix valida.
Què és millor, sincronitzar a l'instant o cada cert temps?
Depèn de la dada. L'estoc o la disponibilitat que veu un client convé consultar-los a l'instant. Catàlegs, tarifes o informes es poden sincronitzar cada cert temps, cosa que redueix la càrrega i simplifica la integració.
Com s'eviten les comandes duplicades en una integració?
Cada operació porta un identificador únic d'origen, per exemple el número de comanda de l'aplicació. Abans de crear el document, l'ERP comprova si aquest identificador ja existeix; si existeix, no el torna a crear.
Què passa si la connexió falla a mig enviament?
Una integració ben feta desa l'operació pendent, la reintenta i, si continua fallant, avisa una persona. Gràcies a l'identificador únic, el reintent no crea duplicats.
La meva aplicació pròpia pot emetre factures amb Verifactu?
Si l'aplicació emet factures, és un sistema de facturació i ha de complir el reglament de Verifactu. El més senzill sol ser que l'aplicació enviï comandes, albarans o parts a l'ERP i que sigui l'ERP, ja adaptat, qui facturi.
Quant costa integrar un ERP amb una altra aplicació?
Depèn de la via disponible, del nombre de dades que viatgen, dels sentits de la comunicació i del control d'errors necessari. El raonable és un estudi tècnic previ i un pressupost tancat.
Es trenca la integració quan s'actualitza l'ERP?
Una integració per API versionada sol resistir les actualitzacions. Les que llegeixen la base de dades o depenen de fitxers poden necessitar ajustos, per això convé un manteniment i avisos que detectin la fallada a l'instant.
Integreu l'ERP Praxis amb aplicacions pròpies?
Sí. Com a fabricants de Praxis des de 1988 en coneixem l'estructura i triem en cada cas la via més segura. També estudiem integracions amb altres ERP.
Integració de l'ERP amb CSI
A CSI som fabricants d'ERP i desenvolupem les aplicacions que s'hi connecten, així que coneixem els dos costats de la integració. Estudiem què permet el teu ERP, triem la via més segura i la programem amb control d'errors, registre i avisos. Mira què connectem a integració de l'ERP, quines aplicacions podem fer a programes a mida, o casos concrets com un portal de comandes B2B, una app de parts de treball o el nostre lector OCR de factures, un projecte real.
Article informatiu elaborat per CSI el novembre de 2026. Les dades dels exemples són fictícies. La normativa de Verifactu pot canviar: consulta el teu cas amb el teu assessor fiscal.