보고서 사용자 지정하기¶
Odoo comes with a powerful and easy-to-use reporting framework. The engine allows you to create new reports, such as tax reports, or balance sheets and income statements with specific groupings and layouts.
중요
Activate the developer mode to access the accounting report creation interface.
To create a new report, open the Accounting app and navigate to . From here, you can either create a root report or a variant.
루트 보고서¶
루트 보고서는 일반이자 중립적인 회계 보고서라고 할 수 있습니다. 이는 국내용 회계 버전을 구축하는 모델 역할을 합니다. 보고서에 루트 보고서가 없으면 해당 보고서 자체가 루트 보고서로 간주됩니다.
Example
벨기에 및 미국에서 세금계산서는 모두 동일한 일반 버전을 기본으로 사용하고 이를 국내 규정에 맞게 조정합니다.
When creating a new root report, you need to create a menu item for it. To do so, open the report and, on that same report, click the (Actions) icon, then select Create Menu Item. Refresh the page; the report is now available under .
참고
국가에 있는 세무 당국에서 특정 유형의 신규 보고서를 요구하는 경우와 같이, 새로운 루트 보고서를 작성해야 하는 경우는 드뭅니다.
세부선택¶
변형은 루트 보고서의 국가별 버전이므로 항상 루트 보고서를 참조합니다. 변형 생성을 하려면 새 보고서를 생성할 때 루트 보고서 필드에서 일반 (루트) 보고서를 선택하세요.
When a root report is opened from one of the accounting app’s main menus, all its variants are displayed in the variant selector in the top right corner of the view.
Example
In the following image, VAT Report (BE) is the variant of the root Generic Tax report.
Report lines¶
After having created a report (either root or variant), you need to fill it with report lines. You can either create a new one by clicking on Add a line, or modify an existing report line by clicking on it. All report lines require a Name, and can have an optional additional Code (of your choice) if you wish to use their value in formulas.
표현식¶
Each report line can contain one or multiple expressions. Expressions can be seen as sub-variables needed by a report line. To create an expression, click on Add a line within a report line.
When creating an expression, you must attribute a Label used to refer to that expression. Therefore, it has to be unique among the expressions of each line. Both a Computation Engine and a Formula must also be indicated. The engine defines how your formula(s) and subformula(s) are interpreted. It is possible to mix expressions using different computation engines under the same line if you need to.
참고
엔진에 따라 :guilabel:`하위 수식`이 필요할 수도 있습니다.
‘Odoo Domain’ engine¶
With this engine, a formula is interpreted as an Odoo domain
targeting account.move.line objects.
하위 수식을 사용하면 도메인과 일치하는 이동 줄이 표현식 값을 계산하는 방법을 정의할 수 있습니다.
sum결과는 작업 줄에서 일치하는 모든 잔액의 합계입니다.
sum_if_pos이 금액이 양수이면 결과는 일치하는 작업 줄에 있는 모든 잔액의 합계가 됩니다. 그렇지 않으면 ‘0’입니다.
sum_if_neg이 금액이 음수인 경우 결과는 일치하는 작업 줄에 있는 의 모든 잔액의 합계가 됩니다. 그렇지 않으면 ‘0’입니다.
count_rowsThe result is the number of sub-lines of this expression. If the report line has a group-by value, this will correspond to the number of distinct grouping keys in the matched move lines. Otherwise, it will be the number of matched move lines.
You can also put a - sign at the beginning of the subformula to reverse the sign of the
result.
‘Aggregate Other Formulas’ engine¶
Use this engine when you need to perform arithmetic operations on the amounts obtained for other
expressions. Formulas here are composed of references to expressions separated by one of the four
basic arithmetic operators (addition +, subtraction -, division /, and multiplication *). To
refer to an expression, type in its report line’s code followed by a period . and the
expression’s label (ex. code.label).
다음은 **하위 수식**에 대한 내용입니다:
if_above(CUR(amount))산술 표현식의 값이 제공된 한도보다 큰 경우에만 반환됩니다. 그렇지 않은 경우, 결과는 `0`이 됩니다.
if_below(CUR(amount))산술 표현식의 값이 제공된 한도보다 작은 경우에만 반환됩니다. 그렇지 않은 경우, 결과는 `0`이 됩니다.
if_between(CUR1(amount1), CUR2(amount2))산술 표현식의 값이 제공된 범위 사이에 있는 경우에만 반환됩니다. 그렇지 않은 경우, 가장 가까운 한도로 되돌아갑니다.
if_other_expr_above(LINE_CODE.EXPRESSION_LABEL, CUR(amount))산술 표현식의 값은 제공된 줄 코드와 표현식 레이블로 표시된 표현식의 값이 제공된 한도보다 큰 경우에만 반환됩니다. 그렇지 않은 경우, 결과는 `0`이 됩니다.
if_other_expr_below(LINE_CODE.EXPRESSION_LABEL, CUR(amount))제공된 줄 코드와 표현식 레이블로 표시된 표현식의 값이 제공된 한도보다 작은 경우에만 산술 표현식의 값이 반환됩니다. 그렇지 않은 경우, 결과는 `0`이 됩니다.
`CUR’은 대문자로 된 통화 코드이고, ‘amount’는 해당 통화로 표시되는 한도 금액입니다.
cross_report(xml_id | report_id)xml_id 또는 보고서 ID 자체로 대상이 지정된 다른 보고서의 표현식과 일치시키는 데 사용됩니다.
‘Prefix of Account Codes’ engine¶
This engine is used to match amounts made on accounts using the prefixes of these accounts’ codes as variables in an arithmetic expression.
Example
21Example
21 + 10 - 5하위 접두사를 선택하지 않을 수도 있습니다.
Example
21 + 10\(101, 102) - 5\(57)‘C’ 및 ‘D’ 접미사를 사용하여 대변 및 차변 에 ‘하위 필터’ 를 적용할 수 있습니다. 이 경우, 계정은 접두사가 일치하고 동시에 이 계정에서 진행 작업 줄의 총 잔액이 대변/차변 인 경우에만 적용됩니다.
Example
‘210001’ 계정의 잔액은 -42이고 ‘210002’ 계정 잔액은 25입니다. 수식 ‘21D’와 일치하는 계정은 ‘210002’ 뿐이므로 25를 반환합니다. 대변 잔액이므로, ‘210001’은 일치하지 않습니다.
접두사를 빼고 ‘C’ 및 ‘D’ 접미어를 사용할 수 있습니다.
Example
접두사 C 또는 `D`를 접미사로 사용하지 않고 일치시키려면 `()`로 비워두어 제외시킵니다.
Example
21D\()코드 접두사를 계정을 활용하는 방법 외에 계정 태그 를 사용하여 매칭을 시키는 방법도 있습니다. 이 기능은 예를 들어 표준화된 계정과목표가 없는 국가에서 회사마다 다른 용도로 동일한 접두사를 사용하는 경우에 특히 유용합니다.
Example
tag(25)If the tag you reference is defined in a data file, an xmlid can be used instead of the id.
Example
tag(my_module.my_tag)태그와 함께 산술 표현식을 사용할 수도 있으며, 접두사를 선택하여 결합할 수도 있습니다.
Example
‘C’ 및 ‘D’ 접미어는 태그와 같은 방식으로 사용할 수 있습니다.
Example
tag(my_module.my_tag)C태그에서도 접두사를 사용하지 않을 수 있습니다.
Example
tag(my_module.my_tag)\(10)‘External Value’ engine¶
The ‘external value’ engine is used to refer to manual and carryover values. Those values
are not stored using account.move.line, but with account.report.external.value. Each of these
objects directly points to the expression it impacts, so very little needs to be done about their
selection here.
다음은 **수식**에 대한 내용입니다:
sum결과가 반드시 해당 기간 중 모든 외부 값의 합계여야 하는 경우.
most_recent결과가 반드시 해당 기간 중 가장 최근인 외부 값의 합계여야 하는 경우.
또한 **하위 수식**은 두 가지 방법으로 사용할 수 있습니다.
rounding=X‘X’를 숫자로 변경할 경우, 금액을 X 소수점 이하 자릿수로 반올림하라는 뜻입니다.
editable이 표현식을 직접 편집할 수 있다는 의미이며, 보고서에 아이콘 표시로 연결되어 사용자가 작업할 수 있게 됩니다.
참고
보고서에서 현재 선택된 ‘date_to’에 수기 값이 생성됩니다.
두 하위 공식을 `;`로 구분하여 같이 사용할 수 있습니다.
Example
editable;rounding=2‘Custom Python Function’ engine¶
This engine is a means for developers to introduce custom computation of expressions on a case-by-case basis. The formula is the name of a python function to call, and the subformula is a key to fetch in the dictionary returned by this function. Use it only if you are making a custom module of your own.
열¶
보고서에는 불확정 숫자 열이 표시될 수 있습니다. 각 열은 줄**에 선언되어 있는 **표현식**에서 값을 가져옵니다. 열의 :guilabel:`expression_label` 필드는 값이 표시되는 표현식의 라벨을 표시합니다. 해당 필드에 **표현식**이 없는 줄이 있으면 이 열에는 아무 것도 표시되지 않습니다. 열이 여러 개 있어야 하는 경우 서로 다른 **표현식 라벨을 사용해야 합니다.
회계 보고서의 옵션 탭에 있는 기간 비교 기능을 사용하면, 기간마다 모든 열이 반복됩니다.
줄 그룹화¶
비표준 그룹화는 분개 항목 모델에 기존 필드를 추가하거나 사용하여 가능하며, 필드가 관련되어 있고 저장되지 않은 경우에 한합니다.
참고
그룹화 라인을 사용하려면 보고서에 편집할 수 있는 명시적인 보고서 라인이 있어야 합니다. 예를 들어 이연 보고서는 생성된 동적 라인을 사용하므로 그룹화 라인을 지원하지 않습니다.
전표 항목에 새 필드 생성하기¶
분개 항목 모델에서 저장되지 않은 관련 필드를 만들려면 먼저으로 이동하여(버그)아이콘을 클릭한 다음필드를 클릭하십시오.새로 만들기를 클릭하여 새 필드를 만들고 다음 필드를 완성하십시오:
필드 이름: 필드의 기술적인 명칭입니다
필드 라벨: 필드에 표시될 라벨입니다.
필드 유형: 이 관련 필드가 가리켜야 하는 필드의 유형
저장됨: 저장되지 않은 필드만 라인을 그룹화하는 데 사용할 수 있으므로 이 필드를 선택하지 않은 상태로 두십시오.
관련 모델: 필드 유형이one2many,many2many또는many2one인 경우 그룹화할 원본 필드의 모델을 선택하십시오.
관련 필드 정의: 그룹화하려는 필드에 대한 기술적 경로
Example
상업 파트너의 판매 팀별로 그룹화하려면 관련 필드 정의를 `move_id.team_id`로 설정하십시오.
줄 그룹 만들기¶
To group lines, go to the Lines tab of the desired report, click on the line you want to group, and edit the Group by field. Enter the technical name (Field Name) of the field to use as the grouping key.
팁
모델의 모든 필드와 기술 이름 목록을 찾으려면으로 이동하여 (버그)아이콘을 클릭한 다음필드를 클릭하십시오. 각 필드의 기술 이름은필드 이름열에 나열됩니다.
더 보기:
Custom tax report setup¶
Report configuration¶
팁
All technical terms and functions of Odoo’s reports engine are explained in the previous sections of this page. We strongly recommend reading these sections before setting up a custom tax report.
To create a custom tax report, open the Accounting app, navigate to , then click New:
Enter a name for your report.
Select a Root Report.
Under the Availability field, select Country Matches, then select the Country matching your company.
Next, create a report line by clicking the Add a line. Once created, click that report line to configure it:
Click Add a line again to create an Expression and name it.
In the Definition tab, select a Computation Engine for that expression depending on the following scenarios:
In this scenario, your company uses tax grids:
Select Tax Tags as the computation engine. Odoo uses this field to link the report line to your taxes.
In the Formula field, type your short grid identifier (e.g.,
vat_sales_base). Odoo automatically generates the+and-variants of this tag for you to map inside .In the Subformula field, enter either
baseto report the untaxed amount, ortaxto report the actual tax amount collected/paid.
Repeat this process as necessary. Then, Save & Close.
Alternatively, you can:
Select Aggregate Other Formulas as the computation engine. Odoo uses this field to perform math on lines already present in the report rather than scanning raw transactions.
In the Formula field, use basic algebra referencing your line codes (e.g.,
LINE_10 - LINE_20).
Repeat this process as necessary. Then, Save & Close.
In this scenario, your company does not use tax grids. Instead, it tracks everything strictly via General Ledger accounts:
Select Prefix of Account Codes as the computation engine: Odoo uses this for lines that need to pull financial totals. Instead of looking for transaction tags, Odoo pulls live balances directly from your chart of accounts.
In the Formula field, type the starting digits of the accounts you want to track, (e.g.,
40will pull the combined total of all revenue accounts starting with400000,401000, etc.).
Repeat this process as necessary. Then, Save & Close.
Alternatively, you can:
Select Aggregate Other Formulas as the computation engine. Odoo uses this to calculate subtotals, net tax, or grand totals by adding or subtracting your other report lines.
In the Formula field, use basic algebra referencing your line codes (e.g.,
LINE_10 - LINE_20).
Repeat this process as necessary. Then, Save & Close.
In this scenario, your company requires advanced filtering, manual user overrides, or complex algorithmic logic that standard tags and account prefixes cannot handle:
Select Odoo Domain as the computation engine: Odoo uses this to bypass tax tags entirely and filter raw journal items (
account.move.line) using standard Odoo search syntax.In the Formula field, enter a valid domain starting with brackets to isolate tax-exempt transactions for specific partner categories.
Alternatively, you can:
Select External Value as the computation engine. Odoo uses this to log manual overrides or historical carryover values.
In the Formula field, type either
sum(to add all manual values together over multi-period reports) ormost_recent(to display only the latest value).In the Subformula field, type
editableto display an edit icon on the live report, allowing users to modify the value manually. Additionally, you can round numbers by typingrounding=x.
Alternatively, you can:
Select Custom Python Function as the computation engine. Odoo uses this as an execution engine to run specific calculations through backend coding when rules involve progressive brackets, loops, or multi-tier thresholds.
In the Formula field, enter the exact technical name of the Python method defined in your custom localization module.
Repeat this process as necessary. Then, Save & Close.
In the Options tab of an Expression, populate the Carry Over To field with a formula to always carry over balances or only carry them over when the amount is negative. Leave this field blank if you do not want to use this feature.
Example
if_below(EUR(0))Tax configuration¶
Next, go to and click New to create and configure new taxes for your custom tax report. Create your Sales and Purchases taxes, and populate the Tax Grids for all taxes using the matching tax grids you created earlier. Finally, make sure to specify both a tax payable and tax receivable account for each tax.
Example
Closing entry¶
To close taxes, a tax group must be specified on each tax used in your custom tax report. To do this, open the Accounting app, navigate to , open a tax that requires a tax group, click the Advanced Options tab, and select a group in the Tax Group field. Once assigned, click the (right arrow) icon and set both a Tax Payable Account and a Tax Receivable Account.
팁
When everything has been set up, make sure to test your report by creating invoices, bills, and credit notes using the taxes specific to that report. Finally, test the closing entry itself.
If you want to hide a specific account from displaying in the tax closing entry, go to , select the tax, and click the (settings adjust) icon. From there, check the Tax Closing Entry box to adjust its visibility.
더 보기: