tvpl.api

<back to all web services

GetSingleWorkflowStepRequest

Requires Authentication
The following routes are available for this service:
GET/WorkflowStep/{WorkflowId}/{StepId}
GetSingleWorkflowStepRequest Parameters:
NameParameterData TypeRequiredDescription
WorkflowIdpathintNo
StepIdpathintNo
GetSingleWorkflowStepResponse Parameters:
NameParameterData TypeRequiredDescription
CodeformintNo
MessageformstringYes
DataformWorkflowStepDetailNo
WorkflowStepDetail Parameters:
NameParameterData TypeRequiredDescription
DepartmentsformList<Category>No
CoDepartmentsformList<Category>No
BasisDocumentsformList<SimpleDocumentRelation>No
ReferenceDocumentsformList<SimpleDocumentRelation>No
MainAssigneesformList<WorkFlowProfile>No
SupportingAssigneesformList<WorkFlowProfile>No
StatusKeyformstringNo
StatusTextformstringNo
CanReadformbool?No
CanWriteformbool?No
CanUploadformbool?No
ReasonReturnformstringNo
ReturnDateformDateTime?No
WorkflowStep Parameters:
NameParameterData TypeRequiredDescription
IdformintNo
WorkflowIdformintNo
StepOrderformint?No
StatusIdformint?No
StepNameformstringYes
IsRequiredformboolYes
SLALegalValueformint?No
SLALegalIsByDayformbool?No
SLAInternalValueformint?No
SLAInternalIsByDayformbool?No
RequireAttachmentformboolNo
IsUsingFormformbool?No
DescriptionformstringYes
CreatedByformintNo
UpdatedAtformDateTime?No
DefaultAttachedDocumentIdformint?No
DepartmentIdsformList<int>No
MainAssigneeIdsformList<int>No
CoDepartmentIdsformList<int>No
SupportingAssigneeIdsformList<int>No
StepBasisDocumentIdsformList<int>No
AttachedDocumentsformList<StepAttached>No
AttachedFilesformList<UploadedFiles>No
StepAttached Parameters:
NameParameterData TypeRequiredDescription
IdformintNo
DocumentCodeformstringNo
TitleformstringNo
IsSequentialSigningformbool?No
PendingSignFileformUploadedFilesNo
OriginalFileformUploadedFilesNo
SignerConfigsformList<SignerConfigDetail>No
UploadedFiles Parameters:
NameParameterData TypeRequiredDescription
Idformlong?No
UploadedFileformstringYes
SubDocumentIdformint?No
StepIdformint?No
CodeformintNo
BasicUploadedFile Parameters:
NameParameterData TypeRequiredDescription
FileNameformstringYes
FilekeyformstringYes
FileUrlformstringYes
ChecksumformstringYes
ETagformstringYes
FileSizeformlongNo
SignerConfigDetail Parameters:
NameParameterData TypeRequiredDescription
ProfileformWorkFlowProfileNo
RoleformRolesNo
SignerConfig Parameters:
NameParameterData TypeRequiredDescription
IdformintNo
DocumentIdformintNo
StepIdformint?No
BasicSignerConfig Parameters:
NameParameterData TypeRequiredDescription
SubDocumentIdformint?No
DepartmentIdformint?No
SignerTypeformbyteNo
SignerRefIdformintNo
SignerRefTextformstringNo
ActionTypeformbyteNo
OrderIndexformintNo
WorkFlowProfile Parameters:
NameParameterData TypeRequiredDescription
IdformintNo
NameformstringNo
FullNameformstringNo
EmailformstringNo
DepartmentIdformint?No
AvatarformstringNo
TelephoneformstringNo
BirthdayformDateTime?No
ConfirmStatusformint?No
ConfirmStatusTextformstringNo
ConfirmAtformDateTime?No
SignAtformDateTime?No
SignedFileIdformlong?No
OriginalFileIdformint?No
SignedFileNameformstringNo
IsSignedformboolNo
SignStatusTextformstringNo
CommentformstringNo
Roles Parameters:
NameParameterData TypeRequiredDescription
IdformintNo
NameformstringYes
CreatedAtformDateTime?No
DeletedAtformDateTime?No
UpdatedAtformDateTime?No
UpdatedByformint?No
DeletedByformint?No
CreatedByformint?No
PermissionformList<string>No
Category Parameters:
NameParameterData TypeRequiredDescription
IdformintNo
LevelformintNo
KeyformstringNo
SortOrderformintNo
LastUpdateformDateTime?No
ChildrenformList<Category>Yes
CreateCategoryModel Parameters:
NameParameterData TypeRequiredDescription
NameformstringYes
LongNameformstringNo
DescriptionformstringYes
TypeformCategoryTypesNo
IsPartyformboolNo
ChildListformList<int>No
CategoryTypes Enum:
Department
PartyGroup
DocGroup
DocType
IssuingAgency
Status
Subjects
Workflow
WorkStatus
StepStatus
SignStatus
SimpleDocumentRelation Parameters:
NameParameterData TypeRequiredDescription
IdformintNo
TitleformstringYes
DocumentCodeformstringYes
PublicationDateformDateTime?No
IsSequentialSigningformbool?No
StatusTextformstringNo
StatusKeyformstringNo
DocumentTypeIdformint?No

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

GET /WorkflowStep/{WorkflowId}/{StepId} HTTP/1.1 
Host: etc-api.vsmlab.vn 
Accept: text/jsv
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	code: 0,
	message: String,
	data: 
	{
		departments: 
		[
			{
				id: 0,
				level: 0,
				key: String,
				sortOrder: 0,
				lastUpdate: "0001-01-01T00:00:00.0000000+07:06",
				children: 
				[
					{
						id: 0,
						level: 0,
						key: String,
						sortOrder: 0,
						lastUpdate: "0001-01-01T00:00:00.0000000+07:06",
						children: 
						[
							{
								id: 0,
								level: 0,
								key: String,
								sortOrder: 0,
								lastUpdate: "0001-01-01T00:00:00.0000000+07:06",
								name: String,
								longName: String,
								description: String,
								type: Department,
								isParty: False,
								childList: 
								[
									0
								]
							}
						],
						name: String,
						longName: String,
						description: String,
						type: Department,
						isParty: False,
						childList: 
						[
							0
						]
					}
				],
				name: String,
				longName: String,
				description: String,
				type: Department,
				isParty: False,
				childList: 
				[
					0
				]
			}
		],
		coDepartments: 
		[
			{
				id: 0,
				level: 0,
				key: String,
				sortOrder: 0,
				lastUpdate: "0001-01-01T00:00:00.0000000+07:06",
				children: 
				[
					{
						id: 0,
						level: 0,
						key: String,
						sortOrder: 0,
						lastUpdate: "0001-01-01T00:00:00.0000000+07:06",
						children: 
						[
							{
								id: 0,
								level: 0,
								key: String,
								sortOrder: 0,
								lastUpdate: "0001-01-01T00:00:00.0000000+07:06",
								name: String,
								longName: String,
								description: String,
								type: Department,
								isParty: False,
								childList: 
								[
									0
								]
							}
						],
						name: String,
						longName: String,
						description: String,
						type: Department,
						isParty: False,
						childList: 
						[
							0
						]
					}
				],
				name: String,
				longName: String,
				description: String,
				type: Department,
				isParty: False,
				childList: 
				[
					0
				]
			}
		],
		basisDocuments: 
		[
			{
				id: 0,
				title: String,
				documentCode: String,
				publicationDate: "0001-01-01T00:00:00.0000000+07:06",
				isSequentialSigning: False,
				statusText: String,
				statusKey: String,
				documentTypeId: 0
			}
		],
		referenceDocuments: 
		[
			{
				id: 0,
				title: String,
				documentCode: String,
				publicationDate: "0001-01-01T00:00:00.0000000+07:06",
				isSequentialSigning: False,
				statusText: String,
				statusKey: String,
				documentTypeId: 0
			}
		],
		mainAssignees: 
		[
			{
				id: 0,
				name: String,
				fullName: String,
				email: String,
				departmentId: 0,
				avatar: String,
				telephone: String,
				birthday: "0001-01-01T00:00:00.0000000+07:06",
				confirmStatus: 0,
				confirmStatusText: String,
				confirmAt: "0001-01-01T00:00:00.0000000+07:06",
				signAt: "0001-01-01T00:00:00.0000000+07:06",
				signedFileId: 0,
				originalFileId: 0,
				signedFileName: String,
				isSigned: False,
				signStatusText: String,
				comment: String
			}
		],
		supportingAssignees: 
		[
			{
				id: 0,
				name: String,
				fullName: String,
				email: String,
				departmentId: 0,
				avatar: String,
				telephone: String,
				birthday: "0001-01-01T00:00:00.0000000+07:06",
				confirmStatus: 0,
				confirmStatusText: String,
				confirmAt: "0001-01-01T00:00:00.0000000+07:06",
				signAt: "0001-01-01T00:00:00.0000000+07:06",
				signedFileId: 0,
				originalFileId: 0,
				signedFileName: String,
				isSigned: False,
				signStatusText: String,
				comment: String
			}
		],
		statusKey: String,
		statusText: String,
		canRead: False,
		canWrite: False,
		canUpload: False,
		reasonReturn: String,
		returnDate: "0001-01-01T00:00:00.0000000+07:06",
		id: 0,
		workflowId: 0,
		stepOrder: 0,
		statusId: 0,
		stepName: String,
		isRequired: False,
		slaLegalValue: 0,
		slaLegalIsByDay: False,
		slaInternalValue: 0,
		slaInternalIsByDay: False,
		requireAttachment: False,
		isUsingForm: False,
		description: String,
		createdBy: 0,
		updatedAt: "0001-01-01T00:00:00.0000000+07:06",
		defaultAttachedDocumentId: 0,
		departmentIds: 
		[
			0
		],
		mainAssigneeIds: 
		[
			0
		],
		coDepartmentIds: 
		[
			0
		],
		supportingAssigneeIds: 
		[
			0
		],
		stepBasisDocumentIds: 
		[
			0
		],
		attachedDocuments: 
		[
			{
				id: 0,
				documentCode: String,
				title: String,
				isSequentialSigning: False,
				pendingSignFile: 
				{
					id: 0,
					uploadedFile: String,
					subDocumentId: 0,
					stepId: 0,
					code: 0,
					fileName: String,
					filekey: String,
					fileUrl: String,
					checksum: String,
					eTag: String,
					fileSize: 0
				},
				originalFile: 
				{
					id: 0,
					uploadedFile: String,
					subDocumentId: 0,
					stepId: 0,
					code: 0,
					fileName: String,
					filekey: String,
					fileUrl: String,
					checksum: String,
					eTag: String,
					fileSize: 0
				},
				signerConfigs: 
				[
					{
						profile: 
						{
							id: 0,
							name: String,
							fullName: String,
							email: String,
							departmentId: 0,
							avatar: String,
							telephone: String,
							birthday: "0001-01-01T00:00:00.0000000+07:06",
							confirmStatus: 0,
							confirmStatusText: String,
							confirmAt: "0001-01-01T00:00:00.0000000+07:06",
							signAt: "0001-01-01T00:00:00.0000000+07:06",
							signedFileId: 0,
							originalFileId: 0,
							signedFileName: String,
							isSigned: False,
							signStatusText: String,
							comment: String
						},
						role: 
						{
							id: 0,
							name: String,
							createdAt: "0001-01-01T00:00:00.0000000+07:06",
							deletedAt: "0001-01-01T00:00:00.0000000+07:06",
							updatedAt: "0001-01-01T00:00:00.0000000+07:06",
							updatedBy: 0,
							deletedBy: 0,
							createdBy: 0,
							permission: 
							[
								String
							]
						},
						id: 0,
						documentId: 0,
						stepId: 0,
						subDocumentId: 0,
						departmentId: 0,
						signerType: 0,
						signerRefId: 0,
						signerRefText: String,
						actionType: 0,
						orderIndex: 0
					}
				]
			}
		],
		attachedFiles: 
		[
			{
				id: 0,
				uploadedFile: String,
				subDocumentId: 0,
				stepId: 0,
				code: 0,
				fileName: String,
				filekey: String,
				fileUrl: String,
				checksum: String,
				eTag: String,
				fileSize: 0
			}
		]
	}
}