<h1 class="title">Recording External Revenue Account</h1> <p>Generate journal entries for recording external revenues.</p> <div class="contents topic" id="table-of-contents"> <p class="topic-title">Table of Contents</p> <ul class="simple"> <li><a class="reference internal" href="#context" id="id1">Context</a></li> <li><a class="reference internal" href="#overview" id="id2">Overview</a></li> <li><a class="reference internal" href="#configuration" id="id3">Configuration</a></li> <li><a class="reference internal" href="#usage" id="id4">Usage</a></li> <li><a class="reference internal" href="#how-does-it-work" id="id5">How Does It Work</a><ul> <li><a class="reference internal" href="#fiscal-position" id="id6">Fiscal Position</a></li> <li><a class="reference internal" href="#payment-terms" id="id7">Payment Terms</a></li> <li><a class="reference internal" href="#currencies" id="id8">Currencies</a></li> <li><a class="reference internal" href="#other-constraints" id="id9">Other Constraints</a></li> </ul> </li> <li><a class="reference internal" href="#contributors" id="id10">Contributors</a></li> </ul> </div> <a name="context"></a> <h2><a class="toc-backref" href="#id1">Context</a></h2> <p>The module <code>recording_external_revenue</code> allows to import recording revenues from external sources.</p> <a name="overview"></a> <h2><a class="toc-backref" href="#id2">Overview</a></h2> <p>This module allows to convert revenues into journal entries.</p> <img alt="static/description/revenue_list.png" src="static/description/revenue_list.png" /> <img alt="static/description/journal_entry_list.png" src="static/description/journal_entry_list.png" /> <a name="configuration"></a> <h2 class="with-subtitle"><a class="toc-backref" href="#id3">Configuration</a></h2> <h2 class="section-subtitle" id="journal-mapping"><span class="section-subtitle">Journal Mapping</span></h2> <p>Under <code>Recording / Mapping / Journals</code>, I find the mapping table used to identify which accounting journal to use when posting revenues.</p> <img alt="static/description/journal_mapping.png" src="static/description/journal_mapping.png" /> <p>It allows to define one journal per currency and company.</p> <a name="usage"></a> <h2><a class="toc-backref" href="#id4">Usage</a></h2> <p>In the <code>Recording</code> application, I find a new menu entry <code>Generate Journal Entries</code>.</p> <img alt="static/description/generate_journal_entries_menu_item.png" src="static/description/generate_journal_entries_menu_item.png" /> <p>After clicking on the button, one job is created for each revenue of the current company.</p> <img alt="static/description/queue_job_list.png" src="static/description/queue_job_list.png" /> <p>Once the jobs have passed, I find a new journal entry for each revenue.</p> <img alt="static/description/journal_entry_list.png" src="static/description/journal_entry_list.png" /> <a name="how-does-it-work"></a> <h2><a class="toc-backref" href="#id5">How Does It Work</a></h2> <a name="fiscal-position"></a> <h3><a class="toc-backref" href="#id6">Fiscal Position</a></h3> <p>There are 2 options for identifying the fiscal position of a revenue line.</p> <ul class="simple"> <li>Partner: based on the partner defined on the revenue.</li> <li>Revenue: based on the country and state defined on the revenue itself.</li> </ul> <img alt="static/description/revenue_fiscal_position.png" src="static/description/revenue_fiscal_position.png" /> <p>When posting a revenue, the fiscal position is used to map the taxes and the revenue account. This works the same way as for a customer invoice.</p> <p>If the fiscal position is not found for a given revenue, the job will fail with a detailed error message.</p> <a name="payment-terms"></a> <h3><a class="toc-backref" href="#id7">Payment Terms</a></h3> <p>The sales payment terms of the partner are used to determinate the due date.</p> <p>The <code>Period End Date</code> defined on the revenue is used as date of reference to compute the due date.</p> <img alt="static/description/revenue_period_end_date.png" src="static/description/revenue_period_end_date.png" /> <p>If a partner has no sales payment term, the <code>Period End Date</code> is used as due date.</p> <a name="currencies"></a> <h3><a class="toc-backref" href="#id8">Currencies</a></h3> <p>The <code>Date of Operation</code> defined on the revenue is used to determine the currency rate to apply in the journal entry.</p> <a name="other-constraints"></a> <h3><a class="toc-backref" href="#id9">Other Constraints</a></h3> <p>If a journal account used for posting a revenue is deprecated, the job will fail with a detailed error message.</p> <a name="contributors"></a> <h2><a class="toc-backref" href="#id10">Contributors</a></h2> <ul class="simple"> <li>Numigi (tm) and all its contributors (<a class="reference external" href="https://bit.ly/numigiens">https://bit.ly/numigiens</a>)</li> </ul>