2tech API

Esta documentação visa detalhar os métodos disponíveis na API da 2tech e os parâmetros necessários para integração.

Geração de token de acesso

Para gerar o token de acesso, siga as instruções abaixo:

Acesse o endpoint: https://app1.gerencialcredito.com.br/apiexterna/api/token
Defina os seguintes parâmetros: username:
password:
grant_type: password

Você deve solicitar esses parâmetros através de ticket para a equipe de Suporte da 2tech.

Exemplo de consumo:

var client = new RestClient("https://app1.gerencialcredito.com.br/apiexterna/api/token");
var request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "application/x-www-form-urlencoded");
request.AddParameter("application/x-www-form-urlencoded", "username=SEU_USERNAME&password=SUA_SENHA&grant_type=password", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

{
    "access_token": "oDg2iVNtls6NYXGq4ctvMBcDGq5nihUeT6g5yQiktWJI3oFaEtBTz1tKWAaYC43bJFLKX1usmP6Hnd4eQgQAYxJ30xTTROW65t2HRPK5EeLULTeRw2_n_6oQlKajysVYdTTPPYw2pHBgbCwLSaPOBrlzX60MEjdrSDXa6Lu3Ph0i5ZYw2pJsZC5SQKlbxs",
    "token_type": "bearer",
    "expires_in": 299
}

Consulta de contratos por período

Após gerar o token é possível acessar o endpoint de Consulta de Contratos por Período. Para ter acesso aos dados, siga as instruções abaixo:

Acesse o endpoint: https://app1.gerencialcredito.com.br/apiexterna/api/contratos/periodo
Defina os seguintes cabeçalhos: Authorization: Bearer {access_token} apikey: {apiKey}

Exemplos de consumo

contratos/periodo

var client = new RestClient("https://app1.gerencialcredito.com.br/apiexterna/api/contratos/periodo?dataInicio=2024-01-01&dataFim=2024-01-31&tipoData=1");
var request = new RestRequest(Method.GET);
request.AddHeader("Content-Type", "application/json");
request.AddHeader("Authorization", "Bearer TOKEN");
request.AddHeader("apikey", "SUA_API_KEY");
IRestResponse response = client.Execute(request);

[
    {
        "contratoId": 1111111,
        "numeroProposta": "1111111111",
        "numeroContrato": "",
        "dataDigitacao": "2024-01-14T00:00:00",
        "valorBruto": 2857.14,
        "valorLiquido": 2857.14,
        "prazo": "84",
        "valorParcela": 100.00,
        "statusProposta": "PAGO",
        "dataStatusProposta": "2024-01-22T00:00:00",
        "banco": "ITAÚ",
        "convenio": "INSS",
        "tabela": "Tabela Normal",
        "codigoVendedor": "1111",
        "vendedor": "AAA21",
        "cpfCnpjVendedor": "11111111111",
        "cpfCliente": "11111111111",
        "nomeCliente": "NOME DO CLIENTE",
        "matriculaCliente": "111111111"
        "tipoContrato": "Contrato Novo"
    }
]

No parâmetro tipoData da requisição utilize uma das opções:

Usar 1 para "Data de Digitação no banco"

Usar 2 para "Data de Pagamento ao cliente (data de liberação do crédito)"

Usar 3 para "Data de Pagamento da Comissão do Vendedor"

Usar 4 para "Data de Última Alteração de Status"

contratos/periodo/mes-atual

var client = new RestClient("https://app1.gerencialcredito.com.br/apiexterna/api/contratos/periodo/mes-atual?tipoData=1");
var request = new RestRequest(Method.GET);
request.AddHeader("Content-Type", "application/json");
request.AddHeader("Authorization", "Bearer TOKEN");
request.AddHeader("apikey", "SUA_API_KEY");
IRestResponse response = client.Execute(request);

[
    {
        "contratoId": 1111111,
        "numeroProposta": "1111111111",
        "numeroContrato": "",
        "dataDigitacao": "2024-01-14T00:00:00",
        "valorBruto": 2857.14,
        "valorLiquido": 2857.14,
        "prazo": "84",
        "valorParcela": 100.00,
        "statusProposta": "PAGO",
        "dataStatusProposta": "2024-01-22T00:00:00",
        "banco": "ITAÚ",
        "convenio": "INSS",
        "tabela": "Tabela Normal",
        "codigoVendedor": "1111",
        "vendedor": "AAA21",
        "cpfCnpjVendedor": "11111111111",
        "cpfCliente": "11111111111",
        "nomeCliente": "NOME DO CLIENTE",
        "matriculaCliente": "111111111"
    }
]

contratos/periodo/quinzenal

var client = new RestClient("https://app1.gerencialcredito.com.br/apiexterna/api/contratos/periodo/quinzenal?tipoData=1");
var request = new RestRequest(Method.GET);
request.AddHeader("Content-Type", "application/json");
request.AddHeader("Authorization", "Bearer TOKEN");
request.AddHeader("apikey", "SUA_API_KEY");
IRestResponse response = client.Execute(request);

[
    {
        "contratoId": 1111111,
        "numeroProposta": "1111111111",
        "numeroContrato": "",
        "dataDigitacao": "2024-01-14T00:00:00",
        "valorBruto": 2857.14,
        "valorLiquido": 2857.14,
        "prazo": "84",
        "valorParcela": 100.00,
        "statusProposta": "PAGO",
        "dataStatusProposta": "2024-01-22T00:00:00",
        "banco": "ITAÚ",
        "convenio": "INSS",
        "tabela": "Tabela Normal",
        "codigoVendedor": "1111",
        "vendedor": "AAA21",
        "cpfCnpjVendedor": "11111111111",
        "cpfCliente": "11111111111",
        "nomeCliente": "NOME DO CLIENTE",
        "matriculaCliente": "111111111"
        "tipoContrato": "Contrato Novo"
    }
]

contratos/periodo/semanal

var client = new RestClient("https://app1.gerencialcredito.com.br/apiexterna/api/contratos/periodo/semanal?tipoData=1");
var request = new RestRequest(Method.GET);
request.AddHeader("Content-Type", "application/json");
request.AddHeader("Authorization", "Bearer TOKEN");
request.AddHeader("apikey", "SUA_API_KEY");
IRestResponse response = client.Execute(request);

[
    {
        "contratoId": 1111111,
        "numeroProposta": "1111111111",
        "numeroContrato": "",
        "dataDigitacao": "2024-01-14T00:00:00",
        "valorBruto": 2857.14,
        "valorLiquido": 2857.14,
        "prazo": "84",
        "valorParcela": 100.00,
        "statusProposta": "PAGO",
        "dataStatusProposta": "2024-01-22T00:00:00",
        "banco": "ITAÚ",
        "convenio": "INSS",
        "tabela": "Tabela Normal",
        "codigoVendedor": "1111",
        "vendedor": "AAA21",
        "cpfCnpjVendedor": "11111111111",
        "cpfCliente": "11111111111",
        "nomeCliente": "NOME DO CLIENTE",
        "matriculaCliente": "111111111"
        "tipoContrato": "Contrato Novo"
    }
]

NextAcesso a Dados para BI

Last updated 4 months ago

Was this helpful?