Pular para o conteúdo principal

Criar Evento de Assinatura

Este endpoint deve ser utilizado para o envio do evento de assinatura, que inclui os documentos e os respectivos assinantes, agrupados em um objeto denominado batch_group.

Definições

Request

ENDPOINT
/batch_group
MÉTODO
POST
Request Body
{
"main_related_party": "ba",
"webhook_url": "google.com.br",
"send_to_fund_administrator": false,
"is_asynchronous": false,
"name": "Teste",
"total_value": 0,
"webhook_url_list": [
"https://google.com",
"https://google2.com"
],
"attached_document_number": "74766848000162",
"send_emails": false,
"batches": [{
"signature_type": "cades",
"document_type": "term_of_endorsement",
"name": "Termo de Endosso",
"related_parties":[
{
"name": "nome da empresa ",
"role": "assignor",
"signature_position":1,
"signer_groups": [
{
"minimum_required_signers": 1,
"signers":[
{
"name": "João",
"document_number": "85653681067",
"email": "teste@qitech.com.br",
"is_group_mandatory": true,
"signer_control_number": "1"
}
]
}
]
}
],
"documents": [{
"name": "teste_of.pdf",
"control_number": null,
"url": "https://storage.googleapis.com/certifier-api-storage-sandbox/093f1aef-437e-405b-9ef9-51efd73dbd57/teste_of_original.pdf",
"document_key": "19f3c0ib-3926-4274-b2ab-720014b35f53",
"file_size": 1681
}]
}]
}

STATUS
200
Response Body

```json
{
"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",
"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,
"is_asynchronous": 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": []
}

Request Body Params

CampoTipoDescriçãoObrigatório
main_related_partystringNome da parte principal responsável por assinar o evento.SIM
namestringNome do evento de assinatura.SIM
total_valuestringValor total dos documentos do evento.SIM
send_emailsbooleanoIndica se os e-mails de assinatura devem ser enviados para este evento. Caso o valor seja FALSE, nenhum e-mail será enviado em nenhuma etapa do processo.SIM
attached_document_numberstringCNPJ do cedente, utilizado quando o documento estiver relacionado a um cedente específico.NÃO
batcheslistaLista dos diferentes tipos de documentos e suas respectivas partes relacionadas.SIM
webhook_urlstringURL para a qual o webhook de notificação será enviado.NÃO
webhook_url_listlistaLista de URLs para as quais os webhooks de notificação serão enviados.NÃO
is_asynchronousbooleanoO evento inclui um documento gerado de forma assíncrona.NÃO
send_to_fund_administradorbooleanoApós a assinatura, o evento deve notificar via SOAP uma administradora que utiliza o software Fromtis.NÃO
info
  • Os campos webhook_url ou webhook_url_list devem ser enviados somente se houver interesse no recebimento de webhooks. Além disso, apenas uma dessas opções deve ser informada por requisição.
  • O campo is_asynchronous deve ser informado como True quando o evento contiver um documento criado de forma assíncrona.

Objeto Batches

CampoTipoDescriçãoObrigatório
related_partieslistaLista das partes relacionadas envolvidas na assinatura de uma lista de documentos.SIM
documentslistalista de documentos.SIM
namestringNome do batch.SIM
signature_typeenumTipo de assinatura.SIM
document_typeenumTipo de documento.SIM
Enumeradores para os tipos de assinatura (signature_type)

cades: Cades
pades: Pades

Enumeradores para os tipos de documentos (document_type)

endorsement: Endosso
other: Outros
contract: Contrato
term_of_assignment: Termo de cessão
term_of_endorsement: Termo de Endosso
promissory_note: Nota promissória
rural_term_of_assignment: Termo de cessão
term_of_fomentation: Termo de Fomento
cpr: CPR
cprf: CPRF
trade_bill: Duplicata
subscription_note: Boletim de Subscrição
adhesion_term: Termo de Adesão
limited_liability_term: Termo de responsabilidade limitada
account_request_document: Contrato de abertura de conta
ccb_post_sac_cdi: CCB Pós-SAC CDI
ccb_post_sac_ipca: CCB Pós-SAC IPCA
ccb_post_sac_igpm: CCB Pós-SAC IGPM
ccb_post_price_cdi: CCB Pós-Price CDI
ccb_post_price_ipca: CCB Pós-Price IPCA
ccb_post_price_igpm: CCB Pós-Price IGPM
ccb_post_price_days_cdi: CCB Pós-Price Days CDI
ccb_post_price_days_ipca: CCB Pós-Price Days IPCA
ccb_post_price__days_igpm: CCB Pós-Price Days IGPM
ncom_pre_sac: Nota Comercial Pré-Sac
ncom_pre_price: Nota Comercial Pré Price
ncom_pre_sac_days: Nota Comercial Pré-Price Days
ncom_post_sac_cdi: Nota Comercial Pós-SAC CDI
ncom_post_sac_ipca: Nota Comercial Pós-SAC IPCA
ncom_post_sac_igpm: Nota Comercial Pós-SAC IGPM
ncom_post_price_cdi: Nota Comercial Pós-Price CDI
ncom_post_price_ipca: Nota Comercial Pós-Price IPCA
ncom_post_price_igpm: Nota Comercial Pós-Price IGPM
ncom_post_price_days_cdi: Nota Comercial Pós-Price Days CDI
ncom_post_price_days_ipca: Nota Comercial Pós-Price Days IPCA
ncom_post_price__days_igpm: Nota Comercial Pós-Price Days IGPM
ccb_cdi_perc: CCB CDI Perc
ccb_cdi_plus: CCB CDI+
ccb_pre_price: CCB Pré-Price
ccb_pre_sac: CCB (pre-sac)
cce_cdi_perc: CCE CDI Perc
cce_cdi_plus: CCE CDI+
cce_pre_price: CCE Pré-Price
cce_pre_sac: CCE Pré-Sac
cce_post_sac_cdi: CCE Pós-SAC CDI
cce_post_sac_ipca: CCE Pós-SAC IPCA
cce_post_sac_igpm: CCE Pós-SAC IGPM
cce_post_price_cdi: CCE Pós-Price CDI
cce_post_price_ipca: CCE Pós-Price IPCA
cce_post_price_igpm: CCE Pós-Price IGPM
cce_post_price_days_cdi: CCE Pós-Price Days CDI
cce_post_price_days_ipca: CCE Pós-Price Days IPCA
cce_post_price_daysigpm: CCE Pós-Price Days IGPM
cci_cdi_perc: CCI CDI Perc
cci_cdi_plus: CCI CDI+
cci_pre_price: CCI Pré-Price
cci_pre_sac: CCI Pré-Sac
cci_post_sac_cdi: CCI Pós-SAC CDI
cci_post_sac_ipca: CCI Pós-SAC IPCA
cci_post_sac_igpm: CCI Pós-SAC IGPM
cci_post_price_cdi: CCI Pós-Price CDI
cci_post_price_ipca: CCI Pós-Price IPCA
cci_post_price_igpm: CCI Pós-Price IGPM
cci_post_price_days_cdi: CCI Pós-Price Days CDI
cci_post_price_days_ipca: CCI Pós-Price Days IPCA
cci_post_price_days_igpm: CCI Pós-Price Days IGPM
nce_cdi_perc: NCE CDI Perc
nce_cdi_plus: NCE CDI+
nce_pre_price: NCE Pré-Price
nce_pre_sac: NCE Pré-Sac
nce_post_sac: NCE Pós-SAC
nce_post_price: NCE Pós-Price
nce_post_price_days: NCE Pós-Price Days

CampoTipoDescriçãoObrigatório
roleenumPapel desempenhado pelos assinantes.SIM
namestringNome da parte relacionada.SIM
signature_positioninteiroPosição da assinatura, deve ser informada quando houver ordem de assinatura entre as partes relacionadas. A ordem segue uma sequência crescente.NÃO
signer_groupslistaLista dos grupos de assinantes.SIM
Enumeradores que representam os papéis das partes relacionadas (role)

assignor: Cedente
manager: Gestor
underwriter: Subscritor
issuer: Emissor
intervening_discharger: Interveniente Quitante
investor: Cotista
debtor: Devedor
secretary: Secretário
intervening_consentor: Interveniente Anuente
guarantor: Fiador
fund_representative: Representante do Fundo
company_representative: Representante da Empresa
solidary_debtor: Devedor Solidário
attestant: Testemunha
bestowal: Outorga Uxória
owner: Titular
attorney: Procurador
associate: Sócio
co_issuer: Co-emissor
fiduciary_agent: Agente Fiduciário
guest: Convidado
spouse: Cônjuge
intervening_guarantor: Interveniente Fiador
fiduciary_debtor: Devedor Fiduciário
bonafide_depositary: Fiel Depositário
faithful_depositary: Fiel Depositário
president: Presidente
endorser: Endossante
fund_administrator: Administrador do Fundo
cosigner: Avalista
consulting: Consultor
fund_manager: Gestor do Fundo
director: Diretor

Objeto Signer Groups

CampoTipoDescriçãoObrigatório
minimum_required_signersinteiroNúmero mínimo de assinantes que devem ter assinado para que as assinaturas do grupo sejam consideradas concluídas.SIM
signerslistaLista dos assinantes que compõem o grupo de assinantes.SIM

Objeto Signer

CampoTipoDescriçãoObrigatório
namestringNome do assinante.SIM
document_numberstringCPF do assinante.SIM
emailstringEmail do assinante.SIM
is_group_mandatorybooleanoInforme TRUE para indicar que o assinante é obrigatório assinar para que o grupo de assinantes ao qual pertence seja considerado concluído.SIM
signer_control_numberstringCampo livre que pode ser utilizado para fins de controle ou referência externa.SIM

Objeto Documents

Importante

O campo documents deve ser populado com a resposta da requisição /document.

CampoTipoDescriçãoObrigatório
namestringNome do documento.SIM
control_numberstringCampo livre que pode ser utilizado para fins de controle ou referência externa. Na integração com o Fromtis envolvendo duplicatas, o valor deste campo deve ser mantido igual ao recebido no endpoint de geração de documentos de forma assíncrona.SIM
file_sizefloatTamanho do documento.SIM
urlstringURL do documento.SIM
document_keystringChave de identificação do documento.SIM

Response Body Params

CampoTipoDescrição
batch_group_keystringChave de identificação do evento de assinatura.
signature_statusstringStatus da assinatura.
internal_statusstringStatus geral do evento.
original_file_urlstringURL do documento original.
signed_file_urlstringURL do documento com página de assinatura.
file_urlstringURL do arquivo de assinatura.
signature_timestampdateData da assinatura.
webhook_keystringChave de identificação do webhook.