Approval task

PropertyValueDescription
DatabaseCompanyThis table is in the company databases.
SQL nameAppTskThe table name in the database.
API identifierapprovalTaskThe API identifier used in GraphQL.
Table no.429The table number in the data model.

The following fields exist in this table:

Approval status

Status indicates the active phase of the approval flow.

More details about the status can be seen in Approval task change log table.

Workflow status in Visma.net Approval integration.

A look-up in this field gives you the following list of possible values:
1 - Sent
Request has been send to Visma.net Approval.
2 - Pending workflow
Visma.net Approval has received the request, but was not able to solve the workflow. Request needs to be handled forward in Visma.net Approval.
3 - Waiting for approval
Visma.net Approval has received the request. It is in a workflow and waiting to be approved or rejected.
4 - Approved
Request has been approved in Visma.net Approval.
5 - Rejected
Request has been rejected in Visma.net Approval.
6 - Requested cancel
User has requested cancellation of the approval request.
7 - Cancelled
Request has been cancelled. Cancellation has been confirmed by Visma.net Approval.
Note:
If the request was already approved or rejected in Visma.net Approval, only status in Business NXT is set to 7 - Cancelled. Status is not visible in Visma.net Approval.
8 - Error
There was an error in request handling. See more details in Comment field in Approval task change log table.
9 - In approval flow
10 - Automatically approved
PropertyValueDescription
Visible by defaultYesThis field is visible by default in the table display.
DomainApproval statusInteger
Write AccessNoneYou are not allowed to modify the value in this field.
SQL nameStThe database field name.
API identifierstatusThe API identifier used in GraphQL.
Number18508 

Approval Task no.

Unique number of an approval task record.

PropertyValueDescription
Visible by defaultYesThis field is visible by default in the table display.
DomainApproval Task no.Integer
Primary keyYesApproval Task no.
Write AccessNoneYou are not allowed to modify the value in this field.
SQL nameTskNoThe database field name.
API identifierapprovalTaskNoThe API identifier used in GraphQL.
Number18506 

Description

Description of the approval task.

PropertyValueDescription
Visible by defaultYesThis field is visible by default in the table display.
DomainString of length 80Text (80)
Write AccessNoneYou are not allowed to modify the value in this field.
SQL nameDescrThe database field name.
API identifierdescriptionThe API identifier used in GraphQL.
Number18507 

Order no.

Order reference.

If approval task was created from an order, link to Order no. in Order table.

Note:
If you double-click or press * in this field, you can look up a value in the related table.
PropertyValueDescription
Visible by defaultNoThis field is not visible by default in the table display.
DomainOrder no.Integer
Write AccessNoneYou are not allowed to modify the value in this field.
SQL nameOrdNoThe database field name.
API identifierorderNoThe API identifier used in GraphQL.
Number18509 
Table 1. Table relations
To tablePurposeFrom columnsTo columnsComments
OrderOrder
  • Order no.

Workflow document ID

An identifier for a document, such as an invoice or a voucher.

Workflow document ID is assigned when sending the document for approval. The identifier can be used to find the document for example in Visma.net Approval.

Note:
If you double-click or press * in this field, you can look up a value in the related table.
PropertyValueDescription
Visible by defaultNoThis field is not visible by default in the table display.
DomainWorkflow document IDInteger
Write AccessNoneYou are not allowed to modify the value in this field.
SQL nameWfDocIdThe database field name.
API identifierworkflowDocumentIdThe API identifier used in GraphQL.
Number18985 
Table 2. Table relations
To tablePurposeFrom columnsTo columnsComments
BatchBatch_WorkflowDocumentId
  • Workflow document ID
Updated batchUpdatedBatch_WorkflowDocumentId
  • Workflow document ID
General ledger transactionGeneralLedgerTransaction_WorkflowDocumentId
  • Workflow document ID
Customer transactionCustomerTransaction_WorkflowDocumentId
  • Workflow document ID
Supplier transactionSupplierTransaction_WorkflowDocumentId
  • Workflow document ID
Capital asset transactionCapitalAssetTransaction_WorkflowDocumentId
  • Workflow document ID
Open customer entryOpenCustomerEntry_WorkflowDocumentId
  • Workflow document ID
Open supplier entryOpenSupplierEntry_WorkflowDocumentId
  • Workflow document ID
Accounting transactionAccountingTransaction_WorkflowDocumentId
  • Workflow document ID

Control columns

Control columns include information about who has changed the record last and when, and which process that is currently editing the record.

Changed by provenance

The provenance for the record change.

A look-up in this field gives you the following list of possible values:

0 - None

1 - UI

10 - External API

20 - GAiA

21 - AI Connect

100 - Internal service

101 - Task automation

102 - AutoInvoice download

PropertyValueDescription
Visible by defaultNoThis field is not visible by default in the table display.
DomainProvenanceInteger
Write AccessNoneYou are not allowed to modify the value in this field.
SQL nameChPvnThe database field name.
API identifierchangedByProvenanceThe API identifier used in GraphQL.
NumberA unique column number. 

Changed by user

The name of the user that changed the record.

PropertyValueDescription
Visible by defaultNoThis field is not visible by default in the table display.
DomainUser nameText (24)
Write AccessNoneYou are not allowed to modify the value in this field.
SQL nameChUsrThe database field name.
API identifierchangedByUserThe API identifier used in GraphQL.
NumberA unique column number. 

Changed date

The date when the record was changed.

PropertyValueDescription
Visible by defaultNoThis field is not visible by default in the table display.
DomainDateInteger
Write AccessNoneYou are not allowed to modify the value in this field.
SQL nameChDtThe database field name.
API identifierchangedDateThe API identifier used in GraphQL.
NumberA unique column number. 

Changed time

The time when the record was changed.

PropertyValueDescription
Visible by defaultNoThis field is not visible by default in the table display.
DomainTimeInteger
Write AccessNoneYou are not allowed to modify the value in this field.
SQL nameChTmThe database field name.
API identifierchangedTimeThe API identifier used in GraphQL.
NumberA unique column number. 

Changed time stamp

The date and time when the record was changed.

The field is updated with the UTC time.

This value can be used by external systems to replicate changed data. The column is indexed. 

PropertyValueDescription
Visible by defaultNoThis field is not visible by default in the table display.
DomainDate/timeDateTime
Write AccessNoneYou are not allowed to modify the value in this field.
SQL nameChTsThe database field name.
API identifierchangedTimestampThe API identifier used in GraphQL.
NumberA unique column number. 

Created by provenance

The provenance for the record creation.

A look-up in this field gives you the following list of possible values:

0 - None

1 - UI

10 - External API

20 - GAiA

21 - AI Connect

100 - Internal service

101 - Task automation

102 - AutoInvoice download

PropertyValueDescription
Visible by defaultNoThis field is not visible by default in the table display.
DomainProvenanceInteger
Write AccessNoneYou are not allowed to modify the value in this field.
SQL nameCrePvnThe database field name.
API identifiercreatedByProvenanceThe API identifier used in GraphQL.
NumberA unique column number. 

Created by user

The name of the user that created the record.

PropertyValueDescription
Visible by defaultNoThis field is not visible by default in the table display.
DomainUser nameText (24)
Write AccessNoneYou are not allowed to modify the value in this field.
SQL nameCreUsrThe database field name.
API identifiercreatedByUserThe API identifier used in GraphQL.
NumberA unique column number. 

Created date

The date when the record was created.

PropertyValueDescription
Visible by defaultNoThis field is not visible by default in the table display.
DomainDateInteger
Write AccessNoneYou are not allowed to modify the value in this field.
SQL nameCreDtThe database field name.
API identifiercreatedDateThe API identifier used in GraphQL.
NumberA unique column number. 

Created time

The time when the record was created.

PropertyValueDescription
Visible by defaultNoThis field is not visible by default in the table display.
DomainTimeInteger
Write AccessNoneYou are not allowed to modify the value in this field.
SQL nameCreTmThe database field name.
API identifiercreatedTimeThe API identifier used in GraphQL.
NumberA unique column number. 

Created time stamp

The date and time when the record was created.

The field is updated with the UTC time.

PropertyValueDescription
Visible by defaultNoThis field is not visible by default in the table display.
DomainDate/timeDateTime
Write AccessNoneYou are not allowed to modify the value in this field.
SQL nameCreTsThe database field name.
API identifiercreatedTimestampThe API identifier used in GraphQL.
NumberA unique column number. 

Edit status

The current status of the record.

A look-up in this field gives you the following list of possible values:

0 - Unchanged: The record is read, but not changed.

1 - Inserted: The record is new.

2 - Changed: The record is changed.

3 - Deleted: The record is deleted.

PropertyValueDescription
Visible by defaultNoThis field is not visible by default in the table display.
DomainEdit statusInteger
Write AccessNoneYou are not allowed to modify the value in this field.
SQL nameLckStThe database field name.
API identifiereditStatusThe API identifier used in GraphQL.
NumberA unique column number. 

Process no

The Process no. from the Active company process table which is currently using or has control of this record.

Note:
If you double-click or press * in this field, you can look up a value in the related table.
PropertyValueDescription
Visible by defaultNoThis field is not visible by default in the table display.
DomainProcess no.Integer
Write AccessNoneYou are not allowed to modify the value in this field.
SQL nameChPrcThe database field name.
API identifierlockedByProcessNoThe API identifier used in GraphQL.
NumberA unique column number. 
Table 3. Table relations
To table Purpose From columns To columns Comments
Active company process CompanyProcess Process no. Process no.