Manipulação de contrato

---

Dependendo do fluxo, pode ser necessário realizar algumas chamadas para concluir o fluxo de um contrato.

---

Aprovação do Gestor

---

Caso o contrato seja proposto por uma consultoria, após a geração dos documentos, será necessária a aprovação do gestor, antes que o mesmo sja enviado para assinatura.

Request

ENDPOINT

/assignment_contract/assignment_contract/ASSIGNMENT_CONTRACT_KEY

MÉTODO

PUT

Request Body

{
    "status": "denied",
    "denial_reason": "Documentação do cedente insuficiente",
}

Body Params

Campo	Tipo	Descrição	Caracteres
status *	string	Decisão do Gestor. denied ou approved	--
denial_reason	string	Descritivo com o motivo da recusa.	1 a 500

*Campos obrigatórios

Response

STATUS

202

Erros Tratáveis

Código	HTTP	Causa	Como resolver
ACT000023	404	Contrato de cessão não encontrado para o assignment_contract_key informado.	Verificar se o assignment_contract_key está correto.
ACT000025	400	Apenas gestores podem realizar a aprovação ou recusa.	A aprovação/recusa deve ser feita por um agente com AGENT-TYPE=manager.
ACT000077	400	Status atual do contrato não permite aprovação ou recusa.	Para approved: o contrato deve estar em pending_manager_approval. Para denied: o contrato deve estar em pending_manager_approval ou pending_document.

---

Envio para Assinatura Manual

---

Caso o template configure envio manual para assinatura, é possível agrupar vários contratos, desde que os mesmos tenham o mesmo gestor, cedente e avalistas, para um mesmo lote de assinaturas.

Request

ENDPOINT

/assignment_contract/signature_batch

MÉTODO

POST

Request Body

{
    "assignment_contract_keys": ["assignment_contract_key", "assignment_contract_key"],
}

Body Params

Campo	Tipo	Descrição	Caracteres
assignment_contract_keys *	array	Lista de contratos para serem enviados no mesmo lote	--

*Campos obrigatórios

Response

STATUS

202

Erros Tratáveis

Código	HTTP	Causa	Como resolver
ACT000023	404	Contrato de cessão não encontrado para uma das chaves informadas.	Verificar todos os assignment_contract_keys enviados no array.
ACT000088	400	Status de um contrato não é válido para envio manual.	Todos os contratos do lote devem estar com status=pending_signature_submission.
ACT000089	404	Contratos do lote possuem partes relacionadas (gestor, cedente, avalistas) diferentes.	Apenas contratos com as mesmas partes relacionadas podem ser agrupados em um mesmo lote de assinaturas.

---

Cancelamento de Contrato

---

Em qualquer etapa, menos no caso de um contrato já assinado, é possível cancelar o mesmo. Caso esteja em assinatura, o evento de assinaturas também é cancelado

Request

ENDPOINT

/assignment_contract/assignment_contract/ASSIGNMENT_CONTRACT_KEY

MÉTODO

PUT

Request Body

{
    "status": "canceled"
}

Body Params

Campo	Tipo	Descrição	Caracteres
status *	string	canceled	--

*Campos obrigatórios

Response

STATUS

202

Erros Tratáveis

Código	HTTP	Causa	Como resolver
ACT000023	404	Contrato de cessão não encontrado para o assignment_contract_key informado.	Verificar se o assignment_contract_key está correto.
ACT000077	400	Status atual do contrato não permite cancelamento.	Contratos com status signed ou denied não podem ser cancelados.