Lancement d'une idée un peu folle ... obapi!

Développer avec Dolibarr
1

Bonsoir les dev et la communauté,
ça fait longtemps que je tricote l’idée, peut-être que ça existe déjà et que je n’ai pas trouvé le pointeur web qui m’y amènerait … si ça existe déjà et que vous connaissez merci de me donner le lien !

Le contexte en quelques lignes:

  • La plaie : devoir se connecter sur 20 sites (ou plus) pour télécharger les PDF des factures fournisseurs tous les mois
  • Le souhait : ne pas passer par un prestataire « relais » pour des questions évidentes (dépendance, confidentialité, sécurité etc.)
  • L’expérience : woob, les scrapper de sites webs etc.

Mon rêve serait qu’une instance officielle force les entreprises à fournir une API normée pour que tout le monde puisse télécharger ses factures sans avoir à perdre de temps.

1ere étape : proposer cette « norme » d’API, d’autres l’ont fait avant nous pour d’autres domaines (RSS, JSON etc.) alors pourquoi pas ?

En résumé: je veux ma facture de janvier de doliscan → https://api.doliscan.fr/factures/janvier, je veux celle de cap-rel ? https://api.cap-rel.fr/factures/janvier, celle de scaninvoices ? https://api.scaninvoices.fr/factures/janvier … vous avez capté l’idée ? C’est bien car ça sera un chouilla plus compliqué dans la réalité (mais pas tant que ça, promis).

Alors ? ça vous tente ?

Le nom ? je propose obapi comme OpenBusinessAPI. Le domaine obapi.org est libre je viens de le déposer pour y envoyer le brouillon de documentation dès que …

Pour être très concret, ça se présenterait comme ceci dans votre dolibarr « en tant que client » : sur la fiche d’un fournisseur j’aurais l’information « fournisseur compatible obapi v1 », entrez votre login/passwd de connexion à son API pour pouvoir télécharger automatiquement vos factures.

Maintenant comme certains d’entre vous sont clients chez moi par exemple, sur mon dolibarr « fournisseur » j’aurais rien à faire d’autre qu’activer l’option « je veux que mon serveur dolibarr soit fournisseur obapi v1 », j’aurais alors sur la fiche de mes clients une information « obapi » actif (avec le mail de l’entreprise qui serait l’id de connexion).

Alors ? on commence par écrire la spec ? si vous voulez jouer avec moi j’ai ouvert un espace pour commencer ici : OpenBusinessAPI / OpenBusinessAPI - Documentation · GitLab

L’objectif est:

  1. écrire la spec
  2. créer un plugin dolibarr « serveur » conforme à la spec
  3. créer un plugin dolibarr « client » conforme à la spec
  4. corriger / améliorer la spec en fonction de ces tests et 1er retours réels
  5. intégrer ça dans le coeur de dolibarr si c’est validé :slight_smile:
  6. faire un max de bruit autour de cette spec pour que d’autres projets logiciels (libres) l’implémentent et pourquoi pas « faire bouger » les lignes …

PS: oui vous avez raison de me prendre pour un dingue mais c’est pas la 1ere fois que ne sachant pas que c’était impossible un naïf qui marche irait plus loin qu’une bande d’instruits assis (adaptation perso dédicacée à Audiard)

PPS: bonne année !

6 « J'aime »
2

Bonjour,

N’est-ce pas ce qu’on aura d’office d’ici peu avec la généralisation de la facture électronique et le passage obligé par une plateforme de dématérialisation ?

1 « J'aime »
3

hello @pascal_z oui et non, la « conséquence » sera peu ou prou la même pour les pro (ie ne plus perdre de temps à chercher les factures vu qu’elles devraient « arriver » toutes seules…humm) … mais quid pour les particuliers ?

De mémoire (ayant implémenté le plugin factur-x et peppol) l’échéance (facture électronique) a déjà été repoussée plusieurs fois donc la aussi on peut s’asseoir et attendre ou avancer … perso je préfère bouger et proposer des alternatives :slight_smile:

1 « J'aime »
4

Bonjour :slightly_smiling_face:
L’idée est intéressante.
Pour les critères il serait bien de se baser sur de l’existant comme

exemples

pour janvier :

pour facture

etc

5

Hello,

Ces serait bien aussi de proposer un truc pour l’international, j’aurai peur que le gouvernement français ne se focalise que sur son marché interieur.

L’idée est bonne, mais est ce que ça concerne uniquement la facturation ou est-ce que cela s’étendra ça au rapporchement bancaire ?

Bonne année

7

Alors comme j’aime avancer pas à pas … voici ce que ça donne avec un client obapi en ligne de commande codé en php rapidos qui se connecte sur mon dolibarr 16 prototype:

08:44 $ php client.php 
Connexion sur votre serveur Dolibarr:
  http://192.168.16.183/16/obapi/v1/invoices

Liste de vos factures : 
+-------------+------------+--------------+--------------+
| Ref         | Date       | HT           | TTC          |
+-------------+------------+--------------+--------------+
| FA1812-0006 | 2018-12-14 | ....1 527,00 | ....1 832,40 |
| FA1812-0007 | 2018-12-10 | ....1 527,00 | ....1 832,40 |
| FA1812-0008 | 2018-12-10 | ....1 527,00 | ....1 832,40 |
| FA1812-0009 | 2018-12-10 | ....1 527,00 | ....1 832,40 |
| FA1812-0010 | 2018-12-10 | ....1 527,00 | ....1 832,40 |
| FA1901-0016 | 2019-01-09 | ....1 527,00 | ....1 832,40 |
| FA1902-0018 | 2019-02-19 | ....1 527,00 | ....1 832,40 |
| FA1903-0023 | 2019-03-11 | ....1 527,00 | ....1 832,40 |
| FA1904-0029 | 2019-04-19 | ....1 527,00 | ....1 832,40 |
| FA1905-0035 | 2019-05-17 | ....1 527,00 | ....1 832,40 |
| FA1906-0039 | 2019-06-17 | ....1 527,00 | ....1 832,40 |
| FA1907-0041 | 2019-07-17 | ....1 527,00 | ....1 832,40 |
| FA1908-0044 | 2019-08-16 | ....1 527,00 | ....1 832,40 |
| FA1909-0047 | 2019-09-16 | ....1 527,00 | ....1 832,40 |
| FA1910-0049 | 2019-10-17 | ....1 527,00 | ....1 832,40 |
| FA1911-0050 | 2019-11-19 | ....1 527,00 | ....1 832,40 |
| FA1912-0053 | 2019-12-12 | ....1 527,00 | ....1 832,40 |
| FA2001-0002 | 2020-01-22 | ....1 527,00 | ....1 832,40 |
| FA2001-0004 | 2020-01-31 | ...12 500,00 | ...15 000,00 |
| FA2002-0006 | 2020-02-21 | ....1 527,00 | ....1 832,40 |
| FA2003-0011 | 2020-03-19 | ....1 527,00 | ....1 832,40 |
| FA2004-0014 | 2020-04-18 | ....1 527,00 | ....1 832,40 |
| FA2005-0021 | 2020-05-19 | ....1 527,00 | ....1 832,40 |
| FA2006-0025 | 2020-06-18 | ....1 527,00 | ....1 832,40 |
| FA2012-0041 | 2020-12-06 | ....1 527,00 | ....1 832,40 |
| FA2209-0646 | 2022-09-09 | ....1 527,00 | ....1 832,40 |
| FA2212-0842 | 2022-12-06 | ....1 527,00 | ....1 832,40 |
+-------------+------------+--------------+--------------+
✔ ~/dev/obapi/client-php [master L|✚ 2…1]

Vous allez me dire ça apporte quoi par rapport à la connexion sur l’api actuelle de dolibarr ? rien du point de vue résultat final mais par contre le « client obapi » sera directement compatible avec tous les autres serveurs qui implémenteront obapi et ça c’est l’énorme valeur ajoutée de respecter une norme commune …

Pour tester l’idée je vais implémenter l’api obapi sur un serveur non dolibarr pour voir

8

Bonjour :slightly_smiling_face:

Simpa tout ca :+1:

Pourquoi je pas faire un forum sur votre domaine directement et inviter également les utilisateurs d’autres plateformes (boutiques, en lignes erp, etc)?

1 « J'aime »
9

Salut, normalement l’objectif de chorus était celui-ci à terme, toutes les entités y auront un espace et on pourra émettre et sécuriser nos paiements de factures… Donc le factureX devrait être le format d’échange

1 « J'aime »
10

Bonjour,

Il n’y aurait pas plus simple en créant des adresses emails de réception du type « @scaninvoice.fr » de facture qui pointe vers scan invoice ? Ainsi les factures sont transmises par email vers l’adresse, le pdf est extrait puis passé dans scaninvoice. Mais c’est effectivement de plus en plus compliqué de récupérer les factures en pièces jointes.

Sinon, il y a déjà cette API (non Opensource) chez Powens, l’API Bill qui possède des connecteurs vers les grands comptes afin de rapatrier les factures dès que disponible. Je ne connais pas le coût pour chaque connecteur utilisé. Le module de suivi bancaire d’Open-DSI utilisant lui l’API Bank de Powens.

Bonne journée,

1 « J'aime »
11

Hello @aspangaro-Easya et @norbert-oscss
la 1ere étape / démonstration pour obapi concerne les factures, problème qui sera partiellement couvert par factur-x et les portails … partiellement car européen ou français et uniquement pour le B2B, les particuliers ne semblent pas exister.

mais vous me connaissez, j’avance un pied après l’autre, l’objectif est globalement de standardiser / normaliser les chemins d’accès aux objets « business », factures, notes de frais, frais, devis etc.

je parle d’interopérabilité au niveau api et donc c’est beaucoup plus vaste que chorus/facturx … pardon de ne pas avoir été plus clair en ce sens dès le début

12

moi perso j’adore l’idée, si tout le monde avait une API le monde serait plus simple (informatiquement parlant).
Mais quand tu sais qu’a peine 20% des TPE/PME utilisent un système plus ou moins informatisé pour leur gestion (malgré la bonne direction et intention de la réforme de l’économie), il y a vraiment le temps que ta proposition devienne mâture avant que suffisamment d’entreprises l’utilisent !

1 « J'aime »
13

Excellente idée car le besoin est plus que là car c’est une véritable torture que de gérer ces factures fournisseurs notamment pour toutes les petites entreprises.

14

Bonjour Pascal,

J’essaie d’anticiper ce sujet épineux.
Sais tu si Dolibarr doit être adapté sur ce sujet de la facture électronique.
Si tu es intéressé on peut partager
[email protected]
Cdlt