Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tesouro.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

On this page, you will discover how to tailor your approval processes to your specific needs by looking into the practical side of customizing your approval policies. Customization allows you to adapt the rules to fit your unique requirements, making your application’s decision-making more efficient.
Approval policies are designed using the TesouroScript. The conditions mentioned on this page must be inserted into the script field.

​
Conditional invoice approval

The approval policy below states that the approval of either one user OR two roles is required for an invoice to be approved: 
"script": [
  {
    "if": {
      "any": [
       {
         "call": "ApprovalRequests.request_approval_by_users",
         "params": {
           "user_ids": [user_uuid_list],
           "required_approval_count": 1
         }
       },
       {
         "call": "ApprovalRequests.request_approval_by_roles",
         "params": {
           "role_ids": [role_uuid_list],
           "required_approval_count": 2
         }
       }
      ]
    },
    "then": ["{Payables.approve(invoice.id)}"],
    "else": ["{Payables.reject(invoice.id)}"]
  }
]

​
Mark invoice as paid

The approval policy below states that once the invoice is approved by two users AND two roles, it is marked as paid with the comment Marked from approval.: 
"script": [
  {
    "if": {
      "all": [
        {
          "call": "ApprovalRequests.request_approval_by_users",
          "params": {
            "user_ids": [user_uuid_list],
            "required_approval_count": 2
          }
        },
        {
          "call": "ApprovalRequests.request_approval_by_roles",
          "params": {
            "role_ids": [role_uuid_list],
            "required_approval_count": 2
          }
        }
      ]
    },
    "then": ["{Payables.mark_as_paid(invoice.id, 'Marked from approval.')}"],
    "else": ["{Payables.reject(invoice.id)}"]
  }
]

​
Approval chains

The approval policy below is a structured sequence of approvals that occur in a particular order and depend on the previous condition: 
"script": [
  {
    "if": {
      "call": "ApprovalRequests.request_approval_by_users",
      "params": {
        "user_ids": [
          "ac717ee4-bd7d-4564-9319-3c8546e40c36"
        ],
        "required_approval_count": 1
      }
    },
    "then": [
      {
        "if": {
          "call": "ApprovalRequests.request_approval_by_roles",
          "params": {
            "role_ids": [
              "2b89fb81-2e51-412f-9164-34607bd842a1"
            ],
            "required_approval_count": 1
          }
        },
        "then": [
          "{Payables.approve(invoice.id)}"
        ],
        "else": [
          "{Payables.reject(invoice.id)}"
        ]
      }
    ],
    "else": [
      "{Payables.reject(invoice.id)}"
    ]
  }
]