Assinatura do contrato
Depois de aprovado, o contrato é assinado conforme signature_method:
signature_method | O que acontece |
|---|---|
certifiqi | A QI Tech cria um lote de assinatura eletrônica na CertifiQI com os grupos de assinantes da gestora e o grupo de assinantes do fornecedor. O contrato fica em pending_signature até todos assinarem e então vira active. |
qi_sign | O mesmo fluxo de certifiqi, com o lote de assinatura no QI Sign. |
external | O documento enviado já é considerado assinado. O contrato vira active sem etapa de assinatura. |
Os assinantes assinam no produto de assinatura, fora desta API. Acompanhe o contrato pela consulta.
- Para o contrato avançar para a assinatura, a gestora precisa ter grupo de assinantes cadastrado no portal e o fornecedor, ao menos um grupo de assinantes
valid. - Se um assinante recusar ou o lote for cancelado, o contrato vira
canceled.
Para mudar signature_method:
- Antes do envio para análise, use a edição do contrato.
- Em
pending_signature, use a chamada abaixo. - Nos status entre esses dois, a forma de assinatura não pode ser alterada.
Trocar a forma de assinatura
Troca entre certifiqi e qi_sign com o contrato em pending_signature. O lote de assinatura é transferido, e o contrato continua em pending_signature.
Disponível em
| Perfil | Host | Permissão exigida |
|---|---|---|
| Gestora | manager-api | Escrita |
| Consultoria | consultant-api | Atualizar Contratos de Despesa |
URL base de cada host: Ambientes (Hosts).
ENDPOINT
/expense_contract/fund_class/{fund_class_key}/contract/{contract_key}/signature_methodMÉTODO
PUTParâmetros de caminho
| Parâmetro | Tipo | Descrição |
|---|---|---|
fund_class_key | string | Chave da classe de fundo (UUID). |
contract_key | string | Chave do contrato (UUID). |
Corpo da requisição
{
"signature_method": "qi_sign"
}
Atributos do corpo
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
signature_method | string | Sim | certifiqi ou qi_sign. external não é aceito nesta etapa. |
Resposta
STATUS
200O contrato com o novo signature_method, na estrutura descrita em atributos do contrato.
Erros
| Status | code | Quando acontece |
|---|---|---|
| 400 | QIT000001 | signature_method ausente ou diferente de certifiqi e qi_sign. |
| 404 | ECT000005 | A classe de fundo não existe ou você não tem acesso a ela. |
| 404 | ECT000009 | O contrato não existe nessa classe de fundo. |
| 409 | ECT000052 | O contrato não está em pending_signature. |
| 409 | ECT000053 | O contrato já usa essa forma de assinatura. |
Exemplo
{
"title": "Signature method not changeable",
"description": "The signature method can only be changed in pending_signature, not in_manual_analysis.",
"translation": "O metodo de assinatura so pode ser trocado em pending_signature, nao em in_manual_analysis.",
"code": "ECT000052"
}
Erros de autenticação, permissão e host: veja Erros da API.