{"id":22124,"date":"2023-03-21T10:27:14","date_gmt":"2023-03-21T09:27:14","guid":{"rendered":"https:\/\/help.openbee.com\/user-guide\/essentials\/"},"modified":"2026-05-13T09:38:49","modified_gmt":"2026-05-13T07:38:49","slug":"essentials","status":"publish","type":"page","link":"https:\/\/help.openbee.com\/en\/open-bee-notes-de-frais\/user-guide\/essentials\/","title":{"rendered":"Essentials"},"content":{"rendered":"\n<h2 class=\"wp-block-heading\">Expenditures<\/h2>\n\n<h4 class=\"wp-block-heading\">Definition of an expense<\/h4>\n\n<p>An expense represents an action of monetary expenditure carried out in a professional context. For example, it can be a meal in a restaurant, a night in a hotel, mileage travel expenses, etc.<\/p>\n\n<p>An expense (except mileage expenses) must have a proof: this is a photo\/scan of the corresponding invoice or receipt.<\/p>\n\n<p>Finally, an expense can be associated with an expense report at any stage of its lifecycle.<\/p>\n\n<h4 class=\"wp-block-heading\">Fields of an expense<\/h4>\n\n<p>An expense is composed of a set of fields representing its data:<\/p>\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th class=\"has-text-align-center\" data-align=\"center\">Field Name<\/th><th class=\"has-text-align-center\" data-align=\"center\">Editable field<\/th><th class=\"has-text-align-center\" data-align=\"center\">Required field<\/th><th class=\"has-text-align-center\" data-align=\"center\">Description<\/th><\/tr><\/thead><tbody><tr><td class=\"has-text-align-center\" data-align=\"center\">Title<\/td><td class=\"has-text-align-center\" data-align=\"center\">Yes<\/td><td class=\"has-text-align-center\" data-align=\"center\">Yes<\/td><td class=\"has-text-align-center\" data-align=\"center\">Title of expenditure. Defaults to the file name of the associated credential.<\/td><\/tr><tr><td class=\"has-text-align-center\" data-align=\"center\">Category<\/td><td class=\"has-text-align-center\" data-align=\"center\">Yes<\/td><td class=\"has-text-align-center\" data-align=\"center\">Yes<\/td><td class=\"has-text-align-center\" data-align=\"center\">Category of expenditure. A ceiling may be applied to the amount to be reimbursed depending on the category chosen.<\/td><\/tr><tr><td class=\"has-text-align-center\" data-align=\"center\">Date<\/td><td class=\"has-text-align-center\" data-align=\"center\">Yes<\/td><td class=\"has-text-align-center\" data-align=\"center\">Yes<\/td><td class=\"has-text-align-center\" data-align=\"center\">Date of expenditure.<\/td><\/tr><tr><td class=\"has-text-align-center\" data-align=\"center\">Country<\/td><td class=\"has-text-align-center\" data-align=\"center\">Yes<\/td><td class=\"has-text-align-center\" data-align=\"center\">No<\/td><td class=\"has-text-align-center\" data-align=\"center\">Country where the expenditure was made.<\/td><\/tr><tr><td class=\"has-text-align-center\" data-align=\"center\">TTC<\/td><td class=\"has-text-align-center\" data-align=\"center\">Yes<\/td><td class=\"has-text-align-center\" data-align=\"center\">Yes<\/td><td class=\"has-text-align-center\" data-align=\"center\">The amount of the expense, including VAT, <strong>in the currency of the expense<\/strong>.<\/td><\/tr><tr><td class=\"has-text-align-center\" data-align=\"center\">Motto<\/td><td class=\"has-text-align-center\" data-align=\"center\">Yes<\/td><td class=\"has-text-align-center\" data-align=\"center\">Yes<\/td><td class=\"has-text-align-center\" data-align=\"center\">Currency of expenditure.<\/td><\/tr><tr><td class=\"has-text-align-center\" data-align=\"center\">Converted VAT<\/td><td class=\"has-text-align-center\" data-align=\"center\">No<\/td><td class=\"has-text-align-center\" data-align=\"center\">\/<\/td><td class=\"has-text-align-center\" data-align=\"center\">Amount including VAT converted <strong>to your company currency<\/strong>. Hidden field if the currency of the expense is the same as your company&#8217;s currency.<\/td><\/tr><tr><td class=\"has-text-align-center\" data-align=\"center\">Exchange rates<\/td><td class=\"has-text-align-center\" data-align=\"center\">No<\/td><td class=\"has-text-align-center\" data-align=\"center\">\/<\/td><td class=\"has-text-align-center\" data-align=\"center\">Exchange rate to convert the amount including VAT into your company&#8217;s currency. Rate retrieved automatically.  <br\/><strong>This is the exchange rate at the time of the expense<\/strong>.<br\/><br\/>Hidden field if the currency of the expense is the same as your company&#8217;s currency.<\/td><\/tr><tr><td class=\"has-text-align-center\" data-align=\"center\">Amount to be repaid<\/td><td class=\"has-text-align-center\" data-align=\"center\">No<\/td><td class=\"has-text-align-center\" data-align=\"center\">\/<\/td><td class=\"has-text-align-center\" data-align=\"center\">The amount to be reimbursed for the expense. The amount displayed in your company currency.<br\/><br\/>If a spending limit is set for the chosen category, the amount to be reimbursed is capped by default.<\/td><\/tr><tr><td class=\"has-text-align-center\" data-align=\"center\">VAT amount<\/td><td class=\"has-text-align-center\" data-align=\"center\">Yes<\/td><td class=\"has-text-align-center\" data-align=\"center\">No<\/td><td class=\"has-text-align-center\" data-align=\"center\">The amount of VAT on the expense, in the currency of your business.<\/td><\/tr><tr><td class=\"has-text-align-center\" data-align=\"center\">VAT rate<\/td><td class=\"has-text-align-center\" data-align=\"center\">Yes<\/td><td class=\"has-text-align-center\" data-align=\"center\">No<\/td><td class=\"has-text-align-center\" data-align=\"center\">Rate of VAT on expenditure.<\/td><\/tr><tr><td class=\"has-text-align-center\" data-align=\"center\">Comment<\/td><td class=\"has-text-align-center\" data-align=\"center\">Yes<\/td><td class=\"has-text-align-center\" data-align=\"center\">No<\/td><td class=\"has-text-align-center\" data-align=\"center\">Comment associated with the expense<\/td><\/tr><\/tbody><\/table><\/figure>\n\n<p>VAT can be multiple. Each VAT corresponds to the combination of an amount and a VAT rate.<\/p>\n\n<p>The <strong>Comment<\/strong> field is not required by default. It becomes mandatory if the amount to be reimbursed exceeds the ceiling set for the chosen category.<\/p>\n\n<h4 class=\"wp-block-heading\">Expense lifecycle<\/h4>\n\n<p>Each expense has its own life cycle. Each stage of the cycle corresponds to its own specificities and status:<\/p>\n\n<ol class=\"wp-block-list\">\n<li><strong>Reviewing<\/strong> : The expense has been created and is being automatically recognized by the server. The expense information is editable.<\/li>\n\n\n\n<li><strong>To check<\/strong> : The expense has been analyzed by the server. The user must verify and validate the values of the fields. The expense information is editable.\n<ul class=\"wp-block-list\">\n<li>To move to Verified status, a receipt must be associated with the expense (except mileage expenses).<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Verified <\/strong>: The values of the expense fields have been verified. The expense is ready to be sent for validation. The expense information is editable.<\/li>\n\n\n\n<li><strong>Submitted <\/strong>: The expense report associated with the expense has been sent for posting. The expense information is no longer editable.<\/li>\n\n\n\n<li><strong>Approved <\/strong>: The expense report associated with the expense has been approved. The expense information is no longer editable.<\/li>\n\n\n\n<li><strong>Rejected <\/strong>: The expense report associated with the expense has been rejected. The expense information is editable.<\/li>\n<\/ol>\n\n<h2 class=\"wp-block-heading\">Expense reports<\/h2>\n\n<h4 class=\"wp-block-heading\">Definition of an expense report<\/h4>\n\n<p>  An expense report represents a set of expenses made by the user:  <\/p>\n\n<ul class=\"wp-block-list\">\n<li>Over a period of time (e.g. a specific month)<\/li>\n\n\n\n<li>On a specific event (trip, seminar etc.)<\/li>\n\n\n\n<li>etc.<\/li>\n<\/ul>\n\n<p>An expense report can contain multiple expenses, but an expense can only belong to one expense report.<a href=\"#champs-m%C3%A9tadonn%C3%A9es-de-la-note-de-frais\"><\/a><\/p>\n\n<h4 class=\"wp-block-heading\">Fields of an expense report<\/h4>\n\n<p>An expense report is composed of two fields:<\/p>\n\n<ul class=\"wp-block-list\">\n<li><strong>Title <\/strong>: The title of the expense report. Required field.<\/li>\n\n\n\n<li><strong>Description <\/strong>: Optional description of the expense report.<\/li>\n<\/ul>\n\n<h4 class=\"wp-block-heading\">Expense report lifecycle<\/h4>\n\n<p>Each expense report has its own life cycle. Each stage of the cycle corresponds to its own specificities and status:<\/p>\n\n<ol class=\"wp-block-list\">\n<li><strong>Draft<\/strong> : The expense report is being created. Expenses may or may not be associated with it. Its information is editable.\n<ul class=\"wp-block-list\">\n<li>The expense report in <strong>the Draft<\/strong> status can only be submitted for validation if all its associated expenses have been verified.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Sending<\/strong> : The expense report is being sent to the validation circuit. Its information is no longer editable.<\/li>\n\n\n\n<li><strong>Submitted <\/strong>: The expense report has been sent for validation, the validators have been notified. Its information is no longer editable.<\/li>\n\n\n\n<li><strong>Validated <\/strong>: The expense report has been approved by the validators. Its information is no longer editable.\n<ul class=\"wp-block-list\">\n<li>The expense report can now be archived.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Declined <\/strong>: The expense report was rejected by the validators. its information is editable again.<\/li>\n\n\n\n<li><strong>Archived <\/strong>: The expense report has been archived. This allows the user to sort and hide old expense reports in the expense report list.<\/li>\n<\/ol>\n\n<p><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Expenditures Definition of an expense An expense represents an action of monetary expenditure carried out in a professional context. For example, it can be a meal in a restaurant, a night in a hotel, mileage travel expenses, etc. An expense (except mileage expenses) must have a proof: this is a photo\/scan of the corresponding invoice [&hellip;]<\/p>\n","protected":false},"author":93,"featured_media":0,"parent":22059,"menu_order":1,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-22124","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/help.openbee.com\/en\/wp-json\/wp\/v2\/pages\/22124","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help.openbee.com\/en\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/help.openbee.com\/en\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/help.openbee.com\/en\/wp-json\/wp\/v2\/users\/93"}],"replies":[{"embeddable":true,"href":"https:\/\/help.openbee.com\/en\/wp-json\/wp\/v2\/comments?post=22124"}],"version-history":[{"count":1,"href":"https:\/\/help.openbee.com\/en\/wp-json\/wp\/v2\/pages\/22124\/revisions"}],"predecessor-version":[{"id":22127,"href":"https:\/\/help.openbee.com\/en\/wp-json\/wp\/v2\/pages\/22124\/revisions\/22127"}],"up":[{"embeddable":true,"href":"https:\/\/help.openbee.com\/en\/wp-json\/wp\/v2\/pages\/22059"}],"wp:attachment":[{"href":"https:\/\/help.openbee.com\/en\/wp-json\/wp\/v2\/media?parent=22124"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}