跳到主要内容

查询签名事件

此请求返回签名事件的数据。

Request

ENDPOINT
/batch_group/batch_group_key
MÉTODO
GET

Path Params

字段描述
batch_group_key签名事件的唯一标识键。

Response Body Params

STATUS
200
Response Body
{
"batch_group_key": "c0394fb2-34f6-4d70-be70-776022fe15b8",
"name": "Teste",
"main_related_party": "ba",
"number_of_documents": 1,
"total_value": 0.0,
"all_files_url": "",
"send_to_fund_administrator": 0,
"signature_expiration_date": null,
"webhook_key": "ac73c564-989d-4c53-932b-d8f96b007585",
"client_key": "5aaf98d2-0264-48dd-8167-eab859ce5a75",
"requester_key": null,
"signature_status": "pending",
"internal_status": "pending",
"attached_document_number": "74766848000162",
"current_signature_position": "1",
"internal_webhook_key": "ac73c564-989d-4c53-932b-d8f96b007584",
"created_at": "2023-05-15 23:54:35",
"batch_group_type": "icp_signature",
"requester_identifier": null,
"send_emails": false,
"batches": [
{
"document_batch_key": "cd65292e-6748-4c1a-9520-de019f2f341b",
"name": "Termo de Endosso",
"document_type": "term_of_endorsement",
"signature_type": "cades",
"signature_status": "pending",
"created_at": "2023-05-15 23:54:35",
"related_parties": [
{
"related_party_key": "41cf4d2a-fa9a-4cd1-93a0-5a1847b14fb3",
"name": "nome da empresa ",
"role": "assignor",
"signature_status": "pending",
"signature_position": "1",
"created_at": "2023-05-15 23:54:35",
"auto_signature": 0,
"notify_to": [],
"signer_groups": [
{
"id": 38586,
"expiration": null,
"minimum_required_signers": 1,
"signable_limit": null,
"signature_status": "pending",
"created_at": "2023-05-15 23:54:35",
"signers": [
{
"id": 65062,
"signer_control_number": "1",
"signature_timestamp": null,
"signature_status": "pending",
"name": "João",
"is_group_mandatory": true,
"email": "teste@qitech.com.br",
"document_number": "85653681067",
"created_at": "2023-05-15 23:54:35"
}
]
}
]
}
],
"documents": [
{
"document_key": "19f3c0ib-3926-4274-b2ab-720014b35f53",
"control_number": "96a8cd68-76b4-4abf-8180-7d8ebe39567e",
"file_size": 1681,
"file_url": "https://storage.googleapis.com/certifier-api-storage-sandbox/093f1aef-437e-405b-9ef9-51efd73dbd57/teste_of_original.pdf",
"name": "teste_of.pdf",
"original_file_url": "https://storage.googleapis.com/certifier-api-storage-sandbox/093f1aef-437e-405b-9ef9-51efd73dbd57/teste_of_original.pdf",
"status": "pending",
"signed_file_url": null,
"created_at": "2023-05-15 23:54:35",
"signatures": []
}
]
}
],
"watcher_clients": [],
"zip_file_keys_list": [
"a1a8cd68-aab4-csbf-1180-dd8ebe395612",
"cda8cd68-7331-qebf-1280-fw8ebe395676"
]
}

字段类型描述
main_related_partystring负责签署事件的主要相关方名称
namestring事件名称。
batch_group_keystring签名事件的标识键。
signature_statusstring签名状态。
internal_statusstring事件的总体状态。
total_valuestring事件文件的总价值。
client_keystring客户的标识键。
send_emails布尔值指示是否应为此事件发送签名电子邮件。
attached_document_numberstring转让方的 CNPJ。
batches列表不同类型文件及其各自相关方的列表。
webhook_urlstringWebhook 的发送地址。
webhook_url_list列表Webhook 的发送地址列表。
zip_file_keys_list列表ZIP 文件的标识键。

Batches 对象

字段类型描述
related_parties列表参与一组文件签名的相关方列表。
documents列表文件列表。
namestringBatch 名称。
signature_typeenum签名类型。
document_typeenum文件类型。
字段类型描述
roleenum签名人所扮演的角色。
namestring相关方名称。
signature_position整数签名位置。
signer_groups列表签名人组列表。

Signer Groups 对象

字段类型描述
minimum_required_signers整数组内签名被视为完成所需的最少签名人数。
signers列表构成签名人组的签名人列表。

Signer 对象

字段类型描述
namestring签名人姓名。
document_numberstring签名人的 CPF。
emailstring签名人的电子邮件。
is_group_mandatory布尔值指示该签名人是否必须签名才能使其所属签名人组被视为完成。
signer_control_numberstring可用于控制或外部引用的自由字段。
signature_timestampdate签名日期。

Documents 对象

字段类型描述
namestring文件名称。
control_numberstring可用于控制或外部引用的自由字段。
file_sizefloat文件大小。
urlstring文件 URL。
document_keystring文件的标识键。
original_file_urlstring原始文件的 URL。
signed_file_urlstring带签名页的文件 URL。
file_urlstring签名文件的 URL。