Verificação de assinatura

Parâmetros de configuração

Tipo de assinatura - Pode ser ou cliente;
Permissão - Pode ser aprovador, financeiro ou backoffice.

Exemplos

Averbação do RH

Quando o passo está pendendo, um botão de “Averbar” será exibido no Porta da Empresa. Também é possível executar a assinatura por API.

Configurar averbação do RH

Pela API
Pelo Console

Para solicitar averbação do RH, configure o passo da seguinte forma:

curl --request POST \
    --url https://api.base39.io/v1/products/<id> \
    --header 'authorization: Basic <sua-api-key>' \
    --data '
    {
        "settings": {
            "steps": {
                "averbacao": {
                    "title": "Averbação"
                    "type": "signature",
                    "methodData": {
                        "type": "operator",
                        "role": "approver"
                    },
                },
                // ...
            }
        }
    }
    '

Consultar empréstimos disponíveis para averbação

Pelo Portal da Empresa
Pela API
Pelo Webhook

Uma lista de empréstimos para averbar sempre é exibida da página de empréstimos acima de todos os outros empréstimos.

Para verificar se uma proposta está disponível para ser averbada, consulte o endpoint Listar etapas do empréstimo da API de Empréstimos.

curl --request GET \
    --url 'https://api.base39.io/v1/steps?status=in_progress&type=signature'

Filtre a resposta pelo methodData.type = "operator" e methodData.role = "approver". Se houver um passo com essas características, a proposta está disponível para ser averbada.

{
    "status": "in_progress",
    "type": "signature",
    "methodData": {
        "type": "operator",
        "role": "approver"
    }
    // ...
}

Para monitorar as propostas disponíveis para averbação, assine o evento step.marked_in_progress e filtre os eventos que atendam esses parâmetros:

{
    "status": "in_progress",
    "type": "signature",
    "methodData": {
        "type": "operator",
        "role": "approver"
    }
    // ...
}

É importante monitorar outros eventos que podem impedir a averbação ou representam o resultado da averbação ou recusa:

step.marked_failed - o operador da empresa recusou a averbação;
step.marked_completed - o operador da empresa averbou o empréstimo;
loan.canceled - o empréstimo foi cancelado;
loan.expired - o empréstimo expirou;
loan.void - o empréstimo foi anulado.

Consulte todos os parâmetros do objeto Step na referência da API.

Averbar um empréstimo

Pelo Portal da Empresa
Pela API

O botão de averbar é exibido quando o passo está pendente e se o usuário logado tem a permissão configurada, nesse caso “aprovador”.

Página do Portal da Empresa que exibe o botão para averbar proposta

Para verificar se uma proposta está disponível para ser averbada, consulte o endpoint Listar etapas do empréstimo da API de Empréstimos.

curl --request GET \
    --url 'https://api.base39.io/v1/steps?status=in_progress&type=signature'

Filtre a resposta pelo methodData.type = "operator" e methodData.role = "approver". Se houver um passo com essas características, a proposta está disponível para ser averbada.

{
    "status": "in_progress",
    "type": "signature",
    "methodData": {
        "type": "operator",
        "role": "approver"
    }
    // ...
}

Para fazer a averbação, utilize o endpoint Assinar empréstimo da API de Empréstimos para averbar um empréstimo.

curl --request POST \
    --url 'https://api.base39.io/v1/loans/<id>/sign'

Quando a assinatura é feita por um operador com a permissão configurada, nesse caso approver, o passo será concluído.

Produtos

Esteira

Empréstimos

Funcionários e margens

Configuração

Verificação de assinatura

Parâmetros de configuração

Exemplos

Averbação do RH

Configurar averbação do RH

Consultar empréstimos disponíveis para averbação

Averbar um empréstimo

​Parâmetros de configuração

​Exemplos

​Averbação do RH

​Configurar averbação do RH

​Consultar empréstimos disponíveis para averbação

​Averbar um empréstimo

Parâmetros de configuração

Exemplos

Averbação do RH

Configurar averbação do RH

Consultar empréstimos disponíveis para averbação

Averbar um empréstimo