tax_detail_rate_calculated",id:"tax_detail_rate_calculated",level:4},{value:"tax_detail_base_calculated",id:"tax_detail_base_calculated",level:4},{value:"tax_detail_tax_calculated",id:"tax_detail_tax_calculated",level:4},{value:"tax_detail_total_calculated",id:"tax_detail_total_calculated",level:4},{value:"Check existence of a field in the schema",id:"check-existence-of-a-field-in-the-schema",level:3},{value:"Remove whitespaces",id:"remove-whitespaces",level:3}];function c(e){const i={a:"a",admonition:"admonition",code:"code",em:"em",h1:"h1",h2:"h2",h3:"h3",h4:"h4",header:"header",img:"img",li:"li",p:"p",pre:"pre",strong:"strong",ul:"ul",...(0,l.R)(),...e.components};return(0,n.jsxs)(n.Fragment,{children:[(0,n.jsx)(i.header,{children:(0,n.jsx)(i.h1,{id:"formula-fields",children:"Formula fields"})}),"\n",(0,n.jsx)(i.h2,{id:"intro",children:"Intro"}),"\n",(0,n.jsx)(i.p,{children:"Formula fields in Rossum enable you to easily transform your data directly within the app. Whether you need to normalize data, perform calculations, or handle text operations, formula fields provide the flexibility to set values based on your custom logic."}),"\n",(0,n.jsx)(i.p,{children:"For most tasks, Rossum\u2019s Copilot handles everything seamlessly without needing code, and we recommend using it for the best results. However, if you want to dive deeper into custom logic, formula fields support Python-based coding with simple examples to get you started."}),"\n",(0,n.jsx)(i.admonition,{type:"info",children:(0,n.jsxs)(i.p,{children:["This powerful feature is available on the Business plan and above. Existing customers interested in using formula fields can reach out to our support team at ",(0,n.jsx)(i.a,{href:"mailto:support@rossum.ai",children:"support@rossum.ai"})," for assistance."]})}),"\n",(0,n.jsx)(i.h2,{id:"basic-information",children:"Basic information"}),"\n",(0,n.jsxs)(i.ul,{children:["\n",(0,n.jsxs)(i.li,{children:["Formula Fields can run any Python code including its ",(0,n.jsx)(i.a,{href:"https://docs.python.org/3/library/index.html",children:"Standard Library modules"}),"."]}),"\n",(0,n.jsx)(i.li,{children:"Additionally, the runtime is enriched with Rossum-specific functions and variables"}),"\n",(0,n.jsx)(i.li,{children:"They are executed in an AWS lambda"}),"\n",(0,n.jsx)(i.li,{children:"Formula Fields are automatically executed before and after each extension."}),"\n",(0,n.jsx)(i.li,{children:"Extensions cannot overwrite Formula Fields value (create a separate \u201cdata\u201d field instead)."}),"\n"]}),"\n",(0,n.jsx)(i.h2,{id:"best-practices",children:"Best practices"}),"\n",(0,n.jsx)(i.h3,{id:"field-naming-and-management",children:"Field naming and management"}),"\n",(0,n.jsxs)(i.p,{children:["When you need to create a normalized version of a field like ",(0,n.jsx)(i.code,{children:"document_id"}),", it's recommended to create a new field, such as ",(0,n.jsx)(i.code,{children:"document_id_normalized"}),". Use the formula field to apply the normalization logic. This approach allows you to preserve the original value while keeping the normalized result in a separate field, making it easier to manage both."]}),"\n",(0,n.jsx)(i.p,{children:"For better organization, it's also a good practice to group these related fields together, ensuring they are logically aligned and easy to find."}),"\n",(0,n.jsx)(i.h3,{id:"wide-variety-of-functions",children:"Wide variety of functions"}),"\n",(0,n.jsx)(i.p,{children:"As mentioned earlier, formula fields allow you to work with Python, enabling operations similar to those in serverless functions. However, formula fields are much simpler to maintain and manage, offering a streamlined approach for straightforward tasks."}),"\n",(0,n.jsx)(i.h3,{id:"access-document-object-information-in-formula-field",children:"Access document object information in formula field"}),"\n",(0,n.jsx)(i.p,{children:"Unfortunately right now there is no better way than create a simple serverless function to store desired information to custom field and continue with that one in formula field."}),"\n",(0,n.jsx)(i.h3,{id:"when-to-use-formula-fields-vs-serverless-functions",children:"When to Use Formula Fields vs. Serverless Functions"}),"\n",(0,n.jsx)(i.p,{children:"Formula fields are ideal for simple tasks such as data normalization or creating new fields based on existing ones. For more complex operations, serverless functions may be more appropriate. Situations where you should prefer serverless functions include:"}),"\n",(0,n.jsxs)(i.ul,{children:["\n",(0,n.jsxs)(i.li,{children:["There is a limit of ",(0,n.jsx)(i.strong,{children:"2000"})," characters per formula fields which declares the highest complexity of the formula fields."]}),"\n",(0,n.jsx)(i.li,{children:"You cannot access the document object from within the formula function."}),"\n",(0,n.jsx)(i.li,{children:"Formula Fields cannot and should not make HTTP requests (to Rossum API or elsewhere)."}),"\n",(0,n.jsx)(i.li,{children:"Formula Fields are executed only within the scope the specific field; for many rows (200+), the execution time may be too long."}),"\n",(0,n.jsx)(i.li,{children:"You need to set annotation status (e.g., \u201crejected\u201d, \u201cpostponed\u201d, etc.), you have to use Serverless functions."}),"\n",(0,n.jsx)(i.li,{children:"You want to edit multiple fields at the same time"}),"\n",(0,n.jsx)(i.li,{children:"Manipulate enums"}),"\n"]}),"\n",(0,n.jsx)(i.p,{children:"An additional advantage of formula fields is that they are stored at the schema level, so when you copy a queue, all associated formula fields are copied automatically. In contrast, serverless functions must be configured manually and re-linked to new queues after being copied."}),"\n",(0,n.jsx)(i.h2,{id:"examples-of-common-formula-fields",children:"Examples of common formula fields"}),"\n",(0,n.jsx)(i.h3,{id:"access-other-table-and-its-first-row-values",children:"Access other table and its first row values"}),"\n",(0,n.jsx)(i.pre,{children:(0,n.jsx)(i.code,{className:"language-py",children:"field.table_name[0].column_name\n"})}),"\n",(0,n.jsx)(i.h3,{id:"copy-fields-conditionally",children:"Copy fields conditionally"}),"\n",(0,n.jsxs)(i.p,{children:["Copy ",(0,n.jsx)(i.code,{children:"order_id"})," into another field but prioritize ",(0,n.jsx)(i.code,{children:"order_id_manual"})," datapoint if it exists:"]}),"\n",(0,n.jsxs)(i.p,{children:["New formula field ",(0,n.jsx)(i.code,{children:"order_id_normalized"}),":"]}),"\n",(0,n.jsx)(i.pre,{children:(0,n.jsx)(i.code,{className:"language-py",children:"field.order_id_manual if not is_empty(field.order_id_manual) else field.order_id\n"})}),"\n",(0,n.jsxs)(i.admonition,{type:"danger",children:[(0,n.jsxs)(i.p,{children:["Note that copying numbers like this does not copy the original format (specifically trailing zeros). So copying number ",(0,n.jsx)(i.code,{children:"123.40"})," will result in ",(0,n.jsx)(i.code,{children:"123.4"})," (notice the missing zero). In most of the cases, this is not an issue, however. To get the original format (as a string), you must use the following code:"]}),(0,n.jsx)(i.pre,{children:(0,n.jsx)(i.code,{className:"language-py",children:'field.amount.attr.value # "123.40"\n'})})]}),"\n",(0,n.jsx)(i.h3,{id:"get-all-enum-options",children:"Get all enum options"}),"\n",(0,n.jsxs)(i.p,{children:["You can access all enum options via special ",(0,n.jsx)(i.code,{children:"attr"})," attribute. The following code would return the number of enum options (regardless of what option is selected):"]}),"\n",(0,n.jsx)(i.pre,{children:(0,n.jsx)(i.code,{className:"language-py",children:"len(field.language.attr.options)\n"})}),"\n",(0,n.jsx)(i.h3,{id:"find-first-non-empty-line-item-value",children:"Find first non-empty line item value"}),"\n",(0,n.jsx)(i.pre,{children:(0,n.jsx)(i.code,{className:"language-py",children:'next((item for item in field.item_code.all_values if item), "")\n'})}),"\n",(0,n.jsx)(i.h3,{id:"generate-netsuite-external-ids",children:"Generate NetSuite external IDs"}),"\n",(0,n.jsxs)(i.p,{children:["Create external ID needed by NetSuite for ",(0,n.jsx)(i.em,{children:"VendorBill"})," and ",(0,n.jsx)(i.em,{children:"VendorCredit"})," records:"]}),"\n",(0,n.jsx)(i.pre,{children:(0,n.jsx)(i.code,{className:"language-py",children:'# Create an external ID by combining document ID and entity (vendor) match. This is to make sure\n# that different vendors with identical document numbering are not matched to the same NetSuite\n# record (same NetSuite external ID).\nexternal_id = f"{field.document_id}__{field.order_match__entity_internalId}"\n\n# Construct the final result by concatenating (and normalizing) Rossum prefix, document type, and external ID:\nsubstitute(r"[^a-zA-Z\\d\\-_]", "", f"__rossum__{field.document_type}__{external_id}".lower())\n'})}),"\n",(0,n.jsxs)(i.p,{children:["This is typically necessary when ",(0,n.jsx)(i.a,{href:"../netsuite/export-configuration#vendor-bills-invoices",children:"exporting records into NetSuite"}),"."]}),"\n",(0,n.jsx)(i.h3,{id:"get-line-item-index",children:"Get line item index"}),"\n",(0,n.jsx)(i.p,{children:"Returns line item number (indexed from 0):"}),"\n",(0,n.jsx)(i.pre,{children:(0,n.jsx)(i.code,{className:"language-py",children:"field._index\n"})}),"\n",(0,n.jsx)(i.h3,{id:"normalize-field-value",children:"Normalize field value"}),"\n",(0,n.jsx)(i.p,{children:'Remove non-alphanumeric characters (except "-" and "_"):'}),"\n",(0,n.jsx)(i.pre,{children:(0,n.jsx)(i.code,{className:"language-py",children:'substitute(r"[^a-zA-Z\\d\\-_]", "", field.order_id)\n'})}),"\n",(0,n.jsx)(i.h3,{id:"sum-line-item-values",children:"Sum line item values"}),"\n",(0,n.jsxs)(i.p,{children:["Sum the values of ",(0,n.jsx)(i.code,{children:"item_amount_total"}),". Use ",(0,n.jsx)(i.code,{children:"0"})," if the field is empty."]}),"\n",(0,n.jsx)(i.pre,{children:(0,n.jsx)(i.code,{className:"language-py",children:"sum(default_to(field.item_amount_total.all_values, 0))\n"})}),"\n",(0,n.jsx)(i.h3,{id:"validations",children:"Validations"}),"\n",(0,n.jsx)(i.admonition,{type:"warning",children:(0,n.jsxs)(i.p,{children:["Consider using a ",(0,n.jsx)(i.a,{href:"/docs/learn/rossum-formulas/serverless-functions",children:"Serverless function"})," as a better place to perform such validations. Internally, we consider this technique deprecated, albeit still valid. Formula fields should not affect behavior of other fields indirectly as it makes the overall solution less readable and predictable."]})}),"\n",(0,n.jsxs)(i.p,{children:["To validate line items, create ",(0,n.jsx)(i.code,{children:"item_validator"})," formula field with the following code:"]}),"\n",(0,n.jsx)(i.pre,{children:(0,n.jsx)(i.code,{className:"language-py",children:'import math\n\nitem_total_base_calculated = field.item_quantity * field.item_amount_base\n\nif not math.isclose(item_total_base_calculated, field.item_total_base, rel_tol=0.004):\n item_total_base_diff = abs(item_total_base_calculated - field.item_total_base)\n message = (f"The totals do not match. Expected total: {field.item_total_base}, "\n f"Calculated total: {item_total_base_calculated}, "\n f"Difference: {item_total_base_diff}")\n\n show_error(message, field.item_quantity)\n show_error(message, field.item_amount_base)\n show_error(message, field.item_total_base)\n'})}),"\n",(0,n.jsx)(i.h3,{id:"get-yearmonth-from-a-date-field",children:"Get year/month from a date field"}),"\n",(0,n.jsx)(i.p,{children:"Returns year/month integer of a date field:"}),"\n",(0,n.jsx)(i.pre,{children:(0,n.jsx)(i.code,{className:"language-py",children:"field.date_issue.year\nfield.date_issue.month\n"})}),"\n",(0,n.jsx)(i.h3,{id:"date-validation",children:"Date validation"}),"\n",(0,n.jsxs)(i.p,{children:["This function, ",(0,n.jsx)(i.code,{children:"check_invoice_date"}),", checks if the invoice date (passed as ",(0,n.jsx)(i.code,{children:"document_date"}),") is more than 90 days old compared to the current date. It calculates the difference in days between the two dates and, if the document is older than 90 days, triggers a warning message. This message notifies the user of the outdated date and blocks further automation until the issue is resolved."]}),"\n",(0,n.jsx)(i.pre,{children:(0,n.jsx)(i.code,{className:"language-py",children:'# import fo the datetime module is not necessary as it is already imported by default\nimport datetime\ndef check_invoice_date(document_date):\n # Get the current date\n current_date = datetime.datetime.now().date()\n\n # Calculate the difference in days between the current date and the document date\n days_difference = (current_date - document_date).days\n\n # Check if the document date is older than 90 days\n if days_difference > 90:\n # Raise a warning and set an automation blocker\n warning_message = f"Warning: Invoice date is older than 90 days ({days_difference} days). Please confirm the date."\n automation_blocker(warning_message, field.date_issue)\n show_warning(warning_message)\n\ncheck_invoice_date(field.date_issue)\n'})}),"\n",(0,n.jsx)(i.h3,{id:"html-formatting",children:"HTML formatting"}),"\n",(0,n.jsx)(i.p,{children:"Basic HTML formatting is available inside show_warning() and similar functions.\nYou can even paste links (e.g, to the ERP system)."}),"\n",(0,n.jsx)(i.p,{children:"Example:"}),"\n",(0,n.jsx)(i.pre,{children:(0,n.jsx)(i.code,{className:"language-python",children:'show_warning("""\ntax_detail_rate_calculated",id:"tax_detail_rate_calculated",level:4},{value:"tax_detail_base_calculated",id:"tax_detail_base_calculated",level:4},{value:"tax_detail_tax_calculated",id:"tax_detail_tax_calculated",level:4},{value:"tax_detail_total_calculated",id:"tax_detail_total_calculated",level:4},{value:"Check existence of a field in the schema",id:"check-existence-of-a-field-in-the-schema",level:3},{value:"Remove whitespaces",id:"remove-whitespaces",level:3}];function c(e){const a={a:"a",admonition:"admonition",code:"code",em:"em",h1:"h1",h2:"h2",h3:"h3",h4:"h4",header:"header",img:"img",li:"li",p:"p",pre:"pre",strong:"strong",ul:"ul",...(0,l.R)(),...e.components};return(0,n.jsxs)(n.Fragment,{children:[(0,n.jsx)(a.header,{children:(0,n.jsx)(a.h1,{id:"formula-fields",children:"Formula fields"})}),"\n",(0,n.jsx)(a.h2,{id:"intro",children:"Intro"}),"\n",(0,n.jsx)(a.p,{children:"Formula fields in Rossum enable you to easily transform your data directly within the app. Whether you need to normalize data, perform calculations, or handle text operations, formula fields provide the flexibility to set values based on your custom logic."}),"\n",(0,n.jsx)(a.p,{children:"For most tasks, Rossum\u2019s Copilot handles everything seamlessly without needing code, and we recommend using it for the best results. However, if you want to dive deeper into custom logic, formula fields support Python-based coding with simple examples to get you started."}),"\n",(0,n.jsx)(a.admonition,{type:"info",children:(0,n.jsxs)(a.p,{children:["This powerful feature is available on the Business plan and above. Existing customers interested in using formula fields can reach out to our support team at ",(0,n.jsx)(a.a,{href:"mailto:support@rossum.ai",children:"support@rossum.ai"})," for assistance."]})}),"\n",(0,n.jsx)(a.h2,{id:"basic-information",children:"Basic information"}),"\n",(0,n.jsxs)(a.ul,{children:["\n",(0,n.jsxs)(a.li,{children:["Formula Fields can run any Python code including its ",(0,n.jsx)(a.a,{href:"https://docs.python.org/3/library/index.html",children:"Standard Library modules"}),"."]}),"\n",(0,n.jsx)(a.li,{children:"Additionally, the runtime is enriched with Rossum-specific functions and variables"}),"\n",(0,n.jsx)(a.li,{children:"They are executed in an AWS lambda"}),"\n",(0,n.jsx)(a.li,{children:"Formula Fields are automatically executed before and after each extension."}),"\n",(0,n.jsx)(a.li,{children:"Extensions cannot overwrite Formula Fields value (create a separate \u201cdata\u201d field instead)."}),"\n"]}),"\n",(0,n.jsx)(a.h2,{id:"best-practices",children:"Best practices"}),"\n",(0,n.jsx)(a.h3,{id:"field-naming-and-management",children:"Field naming and management"}),"\n",(0,n.jsxs)(a.p,{children:["When you need to create a normalized version of a field like ",(0,n.jsx)(a.code,{children:"document_id"}),", it's recommended to create a new field, such as ",(0,n.jsx)(a.code,{children:"document_id_normalized"}),". Use the formula field to apply the normalization logic. This approach allows you to preserve the original value while keeping the normalized result in a separate field, making it easier to manage both."]}),"\n",(0,n.jsx)(a.p,{children:"For better organization, it's also a good practice to group these related fields together, ensuring they are logically aligned and easy to find."}),"\n",(0,n.jsx)(a.h3,{id:"wide-variety-of-functions",children:"Wide variety of functions"}),"\n",(0,n.jsx)(a.p,{children:"As mentioned earlier, formula fields allow you to work with Python, enabling operations similar to those in serverless functions. However, formula fields are much simpler to maintain and manage, offering a streamlined approach for straightforward tasks."}),"\n",(0,n.jsx)(a.h3,{id:"access-document-object-information-in-formula-field",children:"Access document object information in formula field"}),"\n",(0,n.jsx)(a.p,{children:"Unfortunately right now there is no better way than create a simple serverless function to store desired information to custom field and continue with that one in formula field."}),"\n",(0,n.jsx)(a.h3,{id:"when-to-use-formula-fields-vs-serverless-functions",children:"When to Use Formula Fields vs. Serverless Functions"}),"\n",(0,n.jsx)(a.p,{children:"Formula fields are ideal for simple tasks such as data normalization or creating new fields based on existing ones. For more complex operations, serverless functions may be more appropriate. Situations where you should prefer serverless functions include:"}),"\n",(0,n.jsxs)(a.ul,{children:["\n",(0,n.jsxs)(a.li,{children:["There is a limit of ",(0,n.jsx)(a.strong,{children:"2000"})," characters per formula fields which declares the highest complexity of the formula fields."]}),"\n",(0,n.jsx)(a.li,{children:"You cannot access the document object from within the formula function."}),"\n",(0,n.jsx)(a.li,{children:"Formula Fields cannot and should not make HTTP requests (to Rossum API or elsewhere)."}),"\n",(0,n.jsx)(a.li,{children:"Formula Fields are executed only within the scope the specific field; for many rows (200+), the execution time may be too long."}),"\n",(0,n.jsx)(a.li,{children:"You need to set annotation status (e.g., \u201crejected\u201d, \u201cpostponed\u201d, etc.), you have to use Serverless functions."}),"\n",(0,n.jsx)(a.li,{children:"You want to edit multiple fields at the same time"}),"\n",(0,n.jsx)(a.li,{children:"Manipulate enums"}),"\n"]}),"\n",(0,n.jsx)(a.p,{children:"An additional advantage of formula fields is that they are stored at the schema level, so when you copy a queue, all associated formula fields are copied automatically. In contrast, serverless functions must be configured manually and re-linked to new queues after being copied."}),"\n",(0,n.jsx)(a.h2,{id:"examples-of-common-formula-fields",children:"Examples of common formula fields"}),"\n",(0,n.jsx)(a.h3,{id:"access-other-table-and-its-first-row-values",children:"Access other table and its first row values"}),"\n",(0,n.jsx)(a.pre,{children:(0,n.jsx)(a.code,{className:"language-py",children:"field.table_name[0].column_name\n"})}),"\n",(0,n.jsx)(a.h3,{id:"copy-fields-conditionally",children:"Copy fields conditionally"}),"\n",(0,n.jsxs)(a.p,{children:["Copy ",(0,n.jsx)(a.code,{children:"order_id"})," into another field but prioritize ",(0,n.jsx)(a.code,{children:"order_id_manual"})," datapoint if it exists:"]}),"\n",(0,n.jsxs)(a.p,{children:["New formula field ",(0,n.jsx)(a.code,{children:"order_id_normalized"}),":"]}),"\n",(0,n.jsx)(a.pre,{children:(0,n.jsx)(a.code,{className:"language-py",children:"field.order_id_manual if not is_empty(field.order_id_manual) else field.order_id\n"})}),"\n",(0,n.jsx)(a.h3,{id:"get-all-enum-options",children:"Get all enum options"}),"\n",(0,n.jsxs)(a.p,{children:["You can access all enum options via special ",(0,n.jsx)(a.code,{children:"attr"})," attribute. The following code would return the number of enum options (regardless of what option is selected):"]}),"\n",(0,n.jsx)(a.pre,{children:(0,n.jsx)(a.code,{className:"language-py",children:"len(field.language.attr.options)\n"})}),"\n",(0,n.jsx)(a.h3,{id:"find-first-non-empty-line-item-value",children:"Find first non-empty line item value"}),"\n",(0,n.jsx)(a.pre,{children:(0,n.jsx)(a.code,{className:"language-py",children:'next((item for item in field.item_code.all_values if item), "")\n'})}),"\n",(0,n.jsx)(a.h3,{id:"generate-netsuite-external-ids",children:"Generate NetSuite external IDs"}),"\n",(0,n.jsxs)(a.p,{children:["Create external ID needed by NetSuite for ",(0,n.jsx)(a.em,{children:"VendorBill"})," and ",(0,n.jsx)(a.em,{children:"VendorCredit"})," records:"]}),"\n",(0,n.jsx)(a.pre,{children:(0,n.jsx)(a.code,{className:"language-py",children:'# Create an external ID by combining document ID and entity (vendor) match. This is to make sure\n# that different vendors with identical document numbering are not matched to the same NetSuite\n# record (same NetSuite external ID).\nexternal_id = f"{field.document_id}__{field.order_match__entity_internalId}"\n\n# Construct the final result by concatenating (and normalizing) Rossum prefix, document type, and external ID:\nsubstitute(r"[^a-zA-Z\\d\\-_]", "", f"__rossum__{field.document_type}__{external_id}".lower())\n'})}),"\n",(0,n.jsxs)(a.p,{children:["This is typically necessary when ",(0,n.jsx)(a.a,{href:"../netsuite/export-configuration#vendor-bills-invoices",children:"exporting records into NetSuite"}),"."]}),"\n",(0,n.jsx)(a.h3,{id:"get-line-item-index",children:"Get line item index"}),"\n",(0,n.jsx)(a.p,{children:"Returns line item number (indexed from 0):"}),"\n",(0,n.jsx)(a.pre,{children:(0,n.jsx)(a.code,{className:"language-py",children:"field._index\n"})}),"\n",(0,n.jsx)(a.h3,{id:"normalize-field-value",children:"Normalize field value"}),"\n",(0,n.jsx)(a.p,{children:'Remove non-alphanumeric characters (except "-" and "_"):'}),"\n",(0,n.jsx)(a.pre,{children:(0,n.jsx)(a.code,{className:"language-py",children:'substitute(r"[^a-zA-Z\\d\\-_]", "", field.order_id)\n'})}),"\n",(0,n.jsx)(a.h3,{id:"sum-line-item-values",children:"Sum line item values"}),"\n",(0,n.jsxs)(a.p,{children:["Sum the values of ",(0,n.jsx)(a.code,{children:"item_amount_total"}),". Use ",(0,n.jsx)(a.code,{children:"0"})," if the field is empty."]}),"\n",(0,n.jsx)(a.pre,{children:(0,n.jsx)(a.code,{className:"language-py",children:"sum(default_to(field.item_amount_total.all_values, 0))\n"})}),"\n",(0,n.jsx)(a.h3,{id:"validations",children:"Validations"}),"\n",(0,n.jsx)(a.admonition,{type:"warning",children:(0,n.jsxs)(a.p,{children:["Consider using a ",(0,n.jsx)(a.a,{href:"/docs/learn/rossum-formulas/serverless-functions",children:"Serverless function"})," as a better place to perform such validations. Internally, we consider this technique deprecated, albeit still valid. Formula fields should not affect behavior of other fields indirectly as it makes the overall solution less readable and predictable."]})}),"\n",(0,n.jsxs)(a.p,{children:["To validate line items, create ",(0,n.jsx)(a.code,{children:"item_validator"})," formula field with the following code:"]}),"\n",(0,n.jsx)(a.pre,{children:(0,n.jsx)(a.code,{className:"language-py",children:'import math\n\nitem_total_base_calculated = field.item_quantity * field.item_amount_base\n\nif not math.isclose(item_total_base_calculated, field.item_total_base, rel_tol=0.004):\n item_total_base_diff = abs(item_total_base_calculated - field.item_total_base)\n message = (f"The totals do not match. Expected total: {field.item_total_base}, "\n f"Calculated total: {item_total_base_calculated}, "\n f"Difference: {item_total_base_diff}")\n\n show_error(message, field.item_quantity)\n show_error(message, field.item_amount_base)\n show_error(message, field.item_total_base)\n'})}),"\n",(0,n.jsx)(a.h3,{id:"get-yearmonth-from-a-date-field",children:"Get year/month from a date field"}),"\n",(0,n.jsx)(a.p,{children:"Returns year/month integer of a date field:"}),"\n",(0,n.jsx)(a.pre,{children:(0,n.jsx)(a.code,{className:"language-py",children:"field.date_issue.year\nfield.date_issue.month\n"})}),"\n",(0,n.jsx)(a.h3,{id:"date-validation",children:"Date validation"}),"\n",(0,n.jsxs)(a.p,{children:["This function, ",(0,n.jsx)(a.code,{children:"check_invoice_date"}),", checks if the invoice date (passed as ",(0,n.jsx)(a.code,{children:"document_date"}),") is more than 90 days old compared to the current date. It calculates the difference in days between the two dates and, if the document is older than 90 days, triggers a warning message. This message notifies the user of the outdated date and blocks further automation until the issue is resolved."]}),"\n",(0,n.jsx)(a.pre,{children:(0,n.jsx)(a.code,{className:"language-py",children:'# import fo the datetime module is not necessary as it is already imported by default\nimport datetime\ndef check_invoice_date(document_date):\n # Get the current date\n current_date = datetime.datetime.now().date()\n\n # Calculate the difference in days between the current date and the document date\n days_difference = (current_date - document_date).days\n\n # Check if the document date is older than 90 days\n if days_difference > 90:\n # Raise a warning and set an automation blocker\n warning_message = f"Warning: Invoice date is older than 90 days ({days_difference} days). Please confirm the date."\n automation_blocker(warning_message, field.date_issue)\n show_warning(warning_message)\n\ncheck_invoice_date(field.date_issue)\n'})}),"\n",(0,n.jsx)(a.h3,{id:"html-formatting",children:"HTML formatting"}),"\n",(0,n.jsx)(a.p,{children:"Basic HTML formatting is available inside show_warning() and similar functions.\nYou can even paste links (e.g, to the ERP system)."}),"\n",(0,n.jsx)(a.p,{children:"Example:"}),"\n",(0,n.jsx)(a.pre,{children:(0,n.jsx)(a.code,{className:"language-python",children:'show_warning("""\nCopy order_id into another field but prioritize order_id_manual datapoint if it exists:
New formula field order_id_normalized:
field.order_id_manual if not is_empty(field.order_id_manual) else field.order_id
Note that copying numbers like this does not copy the original format (specifically trailing zeros). So copying number 123.40 will result in 123.4 (notice the missing zero). In most of the cases, this is not an issue, however. To get the original format (as a string), you must use the following code:
field.amount.attr.value # "123.40"
You can access all enum options via special attr attribute. The following code would return the number of enum options (regardless of what option is selected):
len(field.language.attr.options)