curl --request POST \
--url https://api.gestio.com.br/v2/financeiro/carteira \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"codigoDaContaCorrente": 1,
"tipoDeCobranca": "Simples",
"codigoDaCarteira": 3,
"descricaoDaCarteira": "Carteira Simples - Banco do Brasil",
"codigoCarteiraConvenio": "17",
"nossoNumero": 1,
"instrucaoCaixa": "<string>",
"percentualMulta": 2,
"percentualJuros": 1,
"percentualDesconto": 0
}
'import requests
url = "https://api.gestio.com.br/v2/financeiro/carteira"
payload = {
"codigoDaContaCorrente": 1,
"tipoDeCobranca": "Simples",
"codigoDaCarteira": 3,
"descricaoDaCarteira": "Carteira Simples - Banco do Brasil",
"codigoCarteiraConvenio": "17",
"nossoNumero": 1,
"instrucaoCaixa": "<string>",
"percentualMulta": 2,
"percentualJuros": 1,
"percentualDesconto": 0
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
codigoDaContaCorrente: 1,
tipoDeCobranca: 'Simples',
codigoDaCarteira: 3,
descricaoDaCarteira: 'Carteira Simples - Banco do Brasil',
codigoCarteiraConvenio: '17',
nossoNumero: 1,
instrucaoCaixa: '<string>',
percentualMulta: 2,
percentualJuros: 1,
percentualDesconto: 0
})
};
fetch('https://api.gestio.com.br/v2/financeiro/carteira', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.gestio.com.br/v2/financeiro/carteira",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'codigoDaContaCorrente' => 1,
'tipoDeCobranca' => 'Simples',
'codigoDaCarteira' => 3,
'descricaoDaCarteira' => 'Carteira Simples - Banco do Brasil',
'codigoCarteiraConvenio' => '17',
'nossoNumero' => 1,
'instrucaoCaixa' => '<string>',
'percentualMulta' => 2,
'percentualJuros' => 1,
'percentualDesconto' => 0
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.gestio.com.br/v2/financeiro/carteira"
payload := strings.NewReader("{\n \"codigoDaContaCorrente\": 1,\n \"tipoDeCobranca\": \"Simples\",\n \"codigoDaCarteira\": 3,\n \"descricaoDaCarteira\": \"Carteira Simples - Banco do Brasil\",\n \"codigoCarteiraConvenio\": \"17\",\n \"nossoNumero\": 1,\n \"instrucaoCaixa\": \"<string>\",\n \"percentualMulta\": 2,\n \"percentualJuros\": 1,\n \"percentualDesconto\": 0\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.gestio.com.br/v2/financeiro/carteira")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"codigoDaContaCorrente\": 1,\n \"tipoDeCobranca\": \"Simples\",\n \"codigoDaCarteira\": 3,\n \"descricaoDaCarteira\": \"Carteira Simples - Banco do Brasil\",\n \"codigoCarteiraConvenio\": \"17\",\n \"nossoNumero\": 1,\n \"instrucaoCaixa\": \"<string>\",\n \"percentualMulta\": 2,\n \"percentualJuros\": 1,\n \"percentualDesconto\": 0\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gestio.com.br/v2/financeiro/carteira")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"codigoDaContaCorrente\": 1,\n \"tipoDeCobranca\": \"Simples\",\n \"codigoDaCarteira\": 3,\n \"descricaoDaCarteira\": \"Carteira Simples - Banco do Brasil\",\n \"codigoCarteiraConvenio\": \"17\",\n \"nossoNumero\": 1,\n \"instrucaoCaixa\": \"<string>\",\n \"percentualMulta\": 2,\n \"percentualJuros\": 1,\n \"percentualDesconto\": 0\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"codigoDaContaCorrente": 1,
"tipoDeCobranca": "Simples",
"codigoDaCarteira": 3,
"descricaoDaCarteira": "Carteira Simples - Banco do Brasil",
"ativo": true,
"codigoDoBanco": 123,
"nomeDoBanco": "Banco do Brasil",
"codigoDaAgencia": 123,
"nomeDaAgencia": "<string>",
"numeroDaAgencia": "<string>",
"numeroDaContaCorrente": "<string>",
"codigoCarteiraConvenio": "17",
"nossoNumero": 1,
"instrucaoCaixa": "<string>",
"percentualMulta": 2,
"percentualJuros": 1,
"percentualDesconto": 0,
"idCarteiraWS": "<string>",
"idTecnospeedBoleto": "<string>",
"descricaoDaCarteiraFmt": "<string>",
"podeAtivar": true,
"podeDesativar": true,
"podeHabilitarIntegracaoTecnospeed": true
}
}{
"success": false,
"errors": [
{
"key": "<string>",
"value": "<string>",
"dateOccurred": "2023-11-07T05:31:56Z"
}
]
}Inserir Carteira
Inclui uma nova Carteira de cobrança bancária, vinculada a uma Conta Corrente já cadastrada. O código da Carteira (codigoDaCarteira) é gerado automaticamente.
curl --request POST \
--url https://api.gestio.com.br/v2/financeiro/carteira \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"codigoDaContaCorrente": 1,
"tipoDeCobranca": "Simples",
"codigoDaCarteira": 3,
"descricaoDaCarteira": "Carteira Simples - Banco do Brasil",
"codigoCarteiraConvenio": "17",
"nossoNumero": 1,
"instrucaoCaixa": "<string>",
"percentualMulta": 2,
"percentualJuros": 1,
"percentualDesconto": 0
}
'import requests
url = "https://api.gestio.com.br/v2/financeiro/carteira"
payload = {
"codigoDaContaCorrente": 1,
"tipoDeCobranca": "Simples",
"codigoDaCarteira": 3,
"descricaoDaCarteira": "Carteira Simples - Banco do Brasil",
"codigoCarteiraConvenio": "17",
"nossoNumero": 1,
"instrucaoCaixa": "<string>",
"percentualMulta": 2,
"percentualJuros": 1,
"percentualDesconto": 0
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
codigoDaContaCorrente: 1,
tipoDeCobranca: 'Simples',
codigoDaCarteira: 3,
descricaoDaCarteira: 'Carteira Simples - Banco do Brasil',
codigoCarteiraConvenio: '17',
nossoNumero: 1,
instrucaoCaixa: '<string>',
percentualMulta: 2,
percentualJuros: 1,
percentualDesconto: 0
})
};
fetch('https://api.gestio.com.br/v2/financeiro/carteira', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.gestio.com.br/v2/financeiro/carteira",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'codigoDaContaCorrente' => 1,
'tipoDeCobranca' => 'Simples',
'codigoDaCarteira' => 3,
'descricaoDaCarteira' => 'Carteira Simples - Banco do Brasil',
'codigoCarteiraConvenio' => '17',
'nossoNumero' => 1,
'instrucaoCaixa' => '<string>',
'percentualMulta' => 2,
'percentualJuros' => 1,
'percentualDesconto' => 0
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.gestio.com.br/v2/financeiro/carteira"
payload := strings.NewReader("{\n \"codigoDaContaCorrente\": 1,\n \"tipoDeCobranca\": \"Simples\",\n \"codigoDaCarteira\": 3,\n \"descricaoDaCarteira\": \"Carteira Simples - Banco do Brasil\",\n \"codigoCarteiraConvenio\": \"17\",\n \"nossoNumero\": 1,\n \"instrucaoCaixa\": \"<string>\",\n \"percentualMulta\": 2,\n \"percentualJuros\": 1,\n \"percentualDesconto\": 0\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.gestio.com.br/v2/financeiro/carteira")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"codigoDaContaCorrente\": 1,\n \"tipoDeCobranca\": \"Simples\",\n \"codigoDaCarteira\": 3,\n \"descricaoDaCarteira\": \"Carteira Simples - Banco do Brasil\",\n \"codigoCarteiraConvenio\": \"17\",\n \"nossoNumero\": 1,\n \"instrucaoCaixa\": \"<string>\",\n \"percentualMulta\": 2,\n \"percentualJuros\": 1,\n \"percentualDesconto\": 0\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gestio.com.br/v2/financeiro/carteira")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"codigoDaContaCorrente\": 1,\n \"tipoDeCobranca\": \"Simples\",\n \"codigoDaCarteira\": 3,\n \"descricaoDaCarteira\": \"Carteira Simples - Banco do Brasil\",\n \"codigoCarteiraConvenio\": \"17\",\n \"nossoNumero\": 1,\n \"instrucaoCaixa\": \"<string>\",\n \"percentualMulta\": 2,\n \"percentualJuros\": 1,\n \"percentualDesconto\": 0\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"codigoDaContaCorrente": 1,
"tipoDeCobranca": "Simples",
"codigoDaCarteira": 3,
"descricaoDaCarteira": "Carteira Simples - Banco do Brasil",
"ativo": true,
"codigoDoBanco": 123,
"nomeDoBanco": "Banco do Brasil",
"codigoDaAgencia": 123,
"nomeDaAgencia": "<string>",
"numeroDaAgencia": "<string>",
"numeroDaContaCorrente": "<string>",
"codigoCarteiraConvenio": "17",
"nossoNumero": 1,
"instrucaoCaixa": "<string>",
"percentualMulta": 2,
"percentualJuros": 1,
"percentualDesconto": 0,
"idCarteiraWS": "<string>",
"idTecnospeedBoleto": "<string>",
"descricaoDaCarteiraFmt": "<string>",
"podeAtivar": true,
"podeDesativar": true,
"podeHabilitarIntegracaoTecnospeed": true
}
}{
"success": false,
"errors": [
{
"key": "<string>",
"value": "<string>",
"dateOccurred": "2023-11-07T05:31:56Z"
}
]
}400 com o detalhe em notifications/errors.Authorizations
Envie o token retornado por /v2/autenticar no header Authorization, no formato Bearer {token}.
Body
Carteira de cobrança bancária, vinculada a uma Conta Corrente. Usada tanto na inclusão (POST) quanto na alteração (PUT) e nas respostas de consulta. Na alteração, codigoDaCarteira é obrigatório para identificar a Carteira.
Código da Conta Corrente vinculada à Carteira. Obrigatório e deve ser uma Conta Corrente válida.
1
Tipo de Cobrança da Carteira. Obrigatório. Valores aceitos: Simples, Descontada, Vinculada, Vendor.
Simples, Descontada, Vinculada, Vendor "Simples"
Código da Carteira. Ignorado e gerado automaticamente na inclusão; obrigatório na alteração.
3
Descrição da carteira.
"Carteira Simples - Banco do Brasil"
Código da Carteira/Convênio junto ao banco.
"17"
Próximo Nosso Número a ser usado na emissão de boletos desta Carteira.
1
Instrução de caixa impressa no boleto.
2
1
0
Response
Carteira inserida com sucesso.
