Author: |
Compassion CH, Odoo Community Association (OCA) |
License: |
AGPL-3 |
Branch: |
11.0 |
Repository: |
brain-tec/l10n-switzerland |
Dependencies: |
account |
Languages: |
PO File (22876, 94.2%),
Python (931, 3.8%),
XML (389, 1.6%),
and
reStructuredText (78, 0.3%) |
Other branches: |
10.0,
10.0-ocabot-merge-pr-512-by-yvaucher-bump-minor,
10.0.project_BR_155,
10.0.project_DU_240,
10.0.project_GR_233,
10.0.project_LA_123,
10.0.t117833,
10.0.t118004,
11.0.t117833,
8.0,
8.0.project_PA_199,
8.0.project_SI_149,
8.0.project_VA_170,
8.0.project_VA_170.t118003,
8.0.project_VA_t9202,
8.0.t117833,
8.0.t117898,
8.0.t117900,
8.0.t117995,
8.0.t118004,
8.0.t118006,
8.0.t118167,
8.0.t118203,
8.0.t118268,
8.0.t118270,
9.0,
9.0.0t118267,
9.0.project_DE_107,
9.0.project_EB_212,
9.0.project_FE_125,
9.0.t117341,
9.0.t117833,
9.0.t117835,
9.0.t117899,
9.0.t117900,
9.0.t117903,
9.0.t118006,
9.0.t118033,
9.0.t118123,
9.0.t118125,
9.0.t118267,
9.0.t118273,
9.0.t118365,
9.0.t118942,
9.0_copy,
9.0_fix_dta_cumulativ,
9.0_oca,
BT_2900,
and
yvaucher-try-except-wand |
Other repositories: |
BT-nleutenegger/l10n-switzerland,
BT-tpiric/l10n-switzerland,
CompassionCH/l10n-switzerland,
Darknroses/l10n-switzerland,
Glue-Software-Engineering-AG/l10n-switzerland,
Martronic-SA/l10n-switzerland,
MaxyMoos/l10n-switzerland,
Nooka10/l10n-switzerland,
OCA/l10n-switzerland,
SimoRubi/l10n-switzerland,
TDu/l10n-switzerland,
Timo17100-c2c/l10n-switzerland,
Tonow-c2c/l10n-switzerland,
UniteIT/l10n-switzerland,
WalterPepeka/l10n-switzerland,
abaghirli/l10n-switzerland,
akretion/l10n-switzerland,
ap-wtioit/l10n-switzerland,
apetbiz/l10n-switzerland,
bodi000/l10n-switzerland,
camptocamp/l10n-switzerland,
citronpower/l10n-switzerland,
coobyHQ/l10n-switzerland,
coopiteasy/l10n-switzerland,
damdam-s/l10n-switzerland,
daramousk/l10n-switzerland,
davidwul/l10n-switzerland,
dcoopennet/l10n-switzerland,
dev00007/l10n-switzerland,
dootix-jean/l10n-switzerland,
eLBati/l10n-switzerland,
eicher31/l10n-switzerland,
gnovotny/l10n-switzerland,
grindtildeath/l10n-switzerland,
guewen/l10n-switzerland,
gurneyalex/l10n-switzerland,
haublang/l10n-switzerland,
hustlercoder/l10n-switzerland,
i-vyshnevska/l10n-switzerland,
jamotion/l10n-switzerland,
jcoux/l10n-switzerland,
jeffallen/l10n-switzerland,
jmvandel/l10n-switzerland,
johannbelet/l10n-switzerland,
josueBulle/l10n-switzerland,
kittiu/l10n-switzerland,
labaggio/l10n-switzerland,
lbeopennet/l10n-switzerland,
leNeo/l10n-switzerland,
learn-different/l10n-switzerland,
leemannd/l10n-switzerland,
lfr-opennet/l10n-switzerland,
lideritjnma/l10n-switzerland,
linkitspa/l10n-switzerland,
lszt/l10n-switzerland,
lucienrey/l10n-switzerland,
magneticlab-ch/l10n-switzerland,
mdietrichc2c/l10n-switzerland,
mpanarin/l10n-switzerland,
open-net-jba/l10n-switzerland,
open-net-sarl/l10n-switzerland,
p-tombez/l10n-switzerland,
pegonzalezs/l10n-switzerland,
pegonzalezspesol/l10n-switzerland,
pegonzalezsredcor/l10n-switzerland,
philhug/l10n-switzerland,
philippepfeiffer/l10n-switzerland,
prakashatredcor/l10n-switzerland,
pscloud/l10n-switzerland,
redcor/l10n-switzerland,
royalline1/l10n-switzerland,
sebalix/l10n-switzerland,
simahawk/l10n-switzerland,
sp4tz/l10n-switzerland,
stephanamann/l10n-switzerland,
tafaRU/l10n-switzerland,
takinobori/oca-l10n-switzerland,
tschanzt/account-reconcile,
tschanzt/l10n-switzerland,
twanda/l10n-switzerland,
uropro/l10n-switzerland,
vernichon/l10n-switzerland,
vrenaville/l10n-switzerland,
wwwebweber/l10n-switzerland,
xeha-gmbh/l10n-switzerland,
xpansa/l10n-switzerland,
and
yvaucher/l10n-switzerland |
<a class="reference external image-reference" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.svg">
</a>
<a name="postfinance-file-delivery-services"></a>
<h2>Postfinance File Delivery Services</h2>
<p>The file delivery services (FDS) is a service offered by Postfinance AG Technology unit service.</p>
<p>FDS acts as a gateway between external networks and the Post CH SA. It enables mutual exchange of files between partners and Post CH applications.</p>
<p>This module allows Odoo users to import files from their FDS PostFinance and convert imported files to bank statment.</p>
<a name="features"></a>
<h3>Features</h3>
<ul class="simple">
<li>Manage FDS Account users</li>
<li>Generate authentication key pairs for new FDS users</li>
<li>Import existing authentication key pairs for FDS</li>
<li>Download files from FDS PostFinance SFTP and import them to Bank Statements</li>
</ul>
<a name="additional-addons"></a>
<h3>additional addons:</h3>
<ul class="simple">
<li>upload PostFinance Direct Debit generate file to FDS PostFinance</li>
<li>upload SEPA generate file to FDS PostFinance</li>
</ul>
<a name="installation"></a>
<h4>Installation</h4>
<p>In order to be able to use the module, you need to have a Postfinance FDS
Account. You can generate authentication key pairs for your users (to allow
them using the service) from the module.</p>
<p>To generate a new private key in the database, you need to launch odoo with
the option --ssh_pwd=your_password or add it to your config file:
ssh_pwd = your_password</p>
<a name="external-dependencies"></a>
<h3>external dependencies:</h3>
<ul class="simple">
<li>python module: pysftp</li>
<li>python module: pycryptodome</li>
</ul>
<a name="configuration"></a>
<h4>Configuration</h4>
<p>To configure this module, you need to:</p>
<ul>
<li><p class="first">Setup your FDS Postfinance Account
(menu: Accounting/Configuration/Accounts/FDS Postfinance Account)</p>
<blockquote>
<ul class="simple">
<li>hostname: the hostname of FDS Postfinance (fds.post.ch)</li>
<li>username: username for SFTP given by Postfinance</li>
<li>postfinance_email: the public key must be sent to this mail (<a class="reference external" href="mailto:fds@post.ch">fds@post.ch</a>)</li>
<li>user_id: the public key must be sent by the contact person of the company concerned (or appear in the exchange of mail)</li>
</ul>
</blockquote>
</li>
<li><p class="first">Import or generate new authentication keys for each user that should have access to FDS files</p>
</li>
<li><p class="first">Verify the SFTP connection</p>
</li>
<li><p class="first">Configure directories access rights</p>
</li>
</ul>
<a name="usage"></a>
<h4>Usage</h4>
<p>To import files as bank statement:</p>
<ul class="simple">
<li>Go to Accounting/Bank and Cash/FDS PostFinance files</li>
<li>Select an Account</li>
<li>Click on More to download files from the SFTP server</li>
<li>In case of error, the file is kept and you can import it manually</li>
</ul>
<a class="reference external image-reference" href="https://runbot.odoo-community.org/runbot/125/8.0"><img alt="Try me on Runbot" src="https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas" /></a>
<a name="known-issues-roadmap"></a>
<h4>Known issues / Roadmap</h4>
<ul class="simple">
<li>[not implemented yet] send authentication key to FDS Postfiance by e-mail
(for now, download public key and send the email to postfinance manually)</li>
<li>[not implemented yet] CRON job to automatically import download files from FDS PostFinance SFTP to Bank Statement</li>
</ul>
<a name="bug-tracker"></a>
<h4>Bug Tracker</h4>
<p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/l10n-switzerland/issues">GitHub Issues</a>. 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 <a class="reference external" href="https://github.com/OCA/l10n-switzerland/issues/new?body=module:%20l10n_ch_fds_postfinance%0Aversion:%208.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**">feedback</a>.</p>
<a name="credits"></a>
<h4>Credits</h4>
<a name="images"></a>
<h3>Images</h3>
<ul class="simple">
<li>Odoo Community Association: <a class="reference external" href="https://github.com/OCA/maintainer-tools/blob/master/template/module/static/description/icon.svg">Icon</a>.</li>
</ul>
<a name="contributors"></a>
<h3>Contributors</h3>
<ul class="simple">
<li>Nicolas Tran <<a class="reference external" href="mailto:nox.tran@gmail.com">nox.tran@gmail.com</a>></li>
<li>Emanuel Cino <<a class="reference external" href="mailto:ecino@compassion.ch">ecino@compassion.ch</a>></li>
</ul>
<a name="maintainer"></a>
<h3>Maintainer</h3>
<a class="reference external image-reference" href="https://odoo-community.org"><img alt="Odoo Community Association" src="https://odoo-community.org/logo.png" /></a>
<p>This module is maintained by the OCA.</p>
<p>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.</p>
<p>To contribute to this module, please visit <a class="reference external" href="https://odoo-community.org">https://odoo-community.org</a>.</p>