Skip to main content

Auto-download supplier invoices with Weboob

Project description

License: AGPL-3

Account Invoice Download Weboob

This module adds a weboob backend to the account_invoice_download module. Weboob (Web Outside of Browsers) is an opensource project that provides several applications to interact with websites without requiring to open them in a Web browser. It connects to websites via web-scrapping or APIs. Weboob provides several APIs per topic: banking, job, cinema, weather, radio, etc. This Odoo module uses the bill API of Weboob to automatically download invoices from the websites of our suppliers and import them as vendors bills in Odoo. Weboob has a lot of modules (one per supported website), but only a small part of those modules provide the bill API. As of August 2018, Weboob has 26 modules that provide the bill API. Weboob welcomes the contribution of additionnal modules to support more websites. The weboob project was started by french developers, so the majority of modules to download invoices are for french suppliers (EDF, Orange, Bouygues Telecom, Free, etc.), but you are invited to develop and contribute new Weboob modules to add support for the main suppliers of your country. The developer documentation of Weboob has a section named Write a new module!

Installation

Install the weboob library (TODO: check that it works with the stable version weboob 1.3 and not just the development version weboob 1.4):

sudo pip install weboob

Some Weboob modules require additionnal Python libraries. For example, the Weboob module for Bouygues Telecom requires:

sudo pip install python-jose

Weboob requires MuPDF. If you use Debian/Ubuntu, run:

sudo apt install mupdf-tools

Configuration

First, install the Weboob modules that you plan to use:

  • Go to the menu Accounting > Configuration > Import Vendor Bills > Update Weboob Modules List.

  • Then, in the list of Weboob modules, click on each Weboob module that you plan to use and install it.

In the menu Accounting > Configuration > Import Vendor Bills > Download Bills, when you edit a Download Bill Configuration, you will now be able to select Weboob as Backend, and then you will see a new field Weboob Module that allows you to select the weboob module corresponding to the supplier.

Usage

Try me on Runbot

Known issues / Roadmap

  • Add support for Captcha solving (via CapCaptchaSolver ?)

Bug Tracker

Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us smashing it by providing a detailed and welcomed feedback.

Credits

Contributors

Maintainer

Odoo Community Association

This module is maintained by the OCA.

OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.

To contribute to this module, please visit https://odoo-community.org.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page