curl --request POST \
--url https://api.gestio.com.br/v2/financeiro/contaspagar/rateio \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
[
{
"idRateio": 0,
"codigoDoExercicio": 2026,
"codigoDaFilial": 1,
"numeroDaTransacao": 123456,
"sequenciaDaTransacao": 1,
"codigoDaFilialRateio": 1,
"codigoDoItemDeLancamento": "DESP-ALUGUEL",
"codigoDoCentroDeCusto": "ADM",
"codigoDoProjeto": 123,
"codigoDoCustoABC": "<string>",
"percentual": 50,
"valor": 750
}
]
'import requests
url = "https://api.gestio.com.br/v2/financeiro/contaspagar/rateio"
payload = [
{
"idRateio": 0,
"codigoDoExercicio": 2026,
"codigoDaFilial": 1,
"numeroDaTransacao": 123456,
"sequenciaDaTransacao": 1,
"codigoDaFilialRateio": 1,
"codigoDoItemDeLancamento": "DESP-ALUGUEL",
"codigoDoCentroDeCusto": "ADM",
"codigoDoProjeto": 123,
"codigoDoCustoABC": "<string>",
"percentual": 50,
"valor": 750
}
]
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([
{
idRateio: 0,
codigoDoExercicio: 2026,
codigoDaFilial: 1,
numeroDaTransacao: 123456,
sequenciaDaTransacao: 1,
codigoDaFilialRateio: 1,
codigoDoItemDeLancamento: 'DESP-ALUGUEL',
codigoDoCentroDeCusto: 'ADM',
codigoDoProjeto: 123,
codigoDoCustoABC: '<string>',
percentual: 50,
valor: 750
}
])
};
fetch('https://api.gestio.com.br/v2/financeiro/contaspagar/rateio', 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/contaspagar/rateio",
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([
[
'idRateio' => 0,
'codigoDoExercicio' => 2026,
'codigoDaFilial' => 1,
'numeroDaTransacao' => 123456,
'sequenciaDaTransacao' => 1,
'codigoDaFilialRateio' => 1,
'codigoDoItemDeLancamento' => 'DESP-ALUGUEL',
'codigoDoCentroDeCusto' => 'ADM',
'codigoDoProjeto' => 123,
'codigoDoCustoABC' => '<string>',
'percentual' => 50,
'valor' => 750
]
]),
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/contaspagar/rateio"
payload := strings.NewReader("[\n {\n \"idRateio\": 0,\n \"codigoDoExercicio\": 2026,\n \"codigoDaFilial\": 1,\n \"numeroDaTransacao\": 123456,\n \"sequenciaDaTransacao\": 1,\n \"codigoDaFilialRateio\": 1,\n \"codigoDoItemDeLancamento\": \"DESP-ALUGUEL\",\n \"codigoDoCentroDeCusto\": \"ADM\",\n \"codigoDoProjeto\": 123,\n \"codigoDoCustoABC\": \"<string>\",\n \"percentual\": 50,\n \"valor\": 750\n }\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/contaspagar/rateio")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("[\n {\n \"idRateio\": 0,\n \"codigoDoExercicio\": 2026,\n \"codigoDaFilial\": 1,\n \"numeroDaTransacao\": 123456,\n \"sequenciaDaTransacao\": 1,\n \"codigoDaFilialRateio\": 1,\n \"codigoDoItemDeLancamento\": \"DESP-ALUGUEL\",\n \"codigoDoCentroDeCusto\": \"ADM\",\n \"codigoDoProjeto\": 123,\n \"codigoDoCustoABC\": \"<string>\",\n \"percentual\": 50,\n \"valor\": 750\n }\n]")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gestio.com.br/v2/financeiro/contaspagar/rateio")
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 {\n \"idRateio\": 0,\n \"codigoDoExercicio\": 2026,\n \"codigoDaFilial\": 1,\n \"numeroDaTransacao\": 123456,\n \"sequenciaDaTransacao\": 1,\n \"codigoDaFilialRateio\": 1,\n \"codigoDoItemDeLancamento\": \"DESP-ALUGUEL\",\n \"codigoDoCentroDeCusto\": \"ADM\",\n \"codigoDoProjeto\": 123,\n \"codigoDoCustoABC\": \"<string>\",\n \"percentual\": 50,\n \"valor\": 750\n }\n]"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"payload": [
{
"idRateio": 0,
"codigoDoExercicio": 2026,
"codigoDaFilial": 1,
"numeroDaTransacao": 123456,
"sequenciaDaTransacao": 1,
"codigoDaFilialRateio": 1,
"descricaoDaFilial": "<string>",
"codigoDoItemDeLancamento": "DESP-ALUGUEL",
"descricaoDoItemDeLancamento": "<string>",
"codigoDoCentroDeCusto": "ADM",
"descricaoDoCentroDeCusto": "<string>",
"codigoDoProjeto": 123,
"descricaoDoProjeto": "<string>",
"codigoDoCustoABC": "<string>",
"descricaoDoCustoABC": "<string>",
"percentual": 50,
"valor": 750,
"ultimaAtualizacao": "<string>"
}
],
"notifications": [
"<string>"
],
"success": true
}
}{
"success": false,
"errors": [
{
"key": null,
"value": "Total do Percentual do Rateio 90% deve ser igual a 100%.",
"dateOccurred": "2026-07-29T14:32:10Z"
}
]
}Incluir rateio de um lançamento de Contas a Pagar
Substitui as linhas de rateio de um lançamento de Contas a Pagar. Todas as linhas enviadas devem pertencer ao mesmo lançamento (mesmo Exercício/Filial/Número/Sequência da Transação) e a soma dos percentuais deve totalizar 100%, com o somatório dos valores igual ao valor do lançamento.
curl --request POST \
--url https://api.gestio.com.br/v2/financeiro/contaspagar/rateio \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
[
{
"idRateio": 0,
"codigoDoExercicio": 2026,
"codigoDaFilial": 1,
"numeroDaTransacao": 123456,
"sequenciaDaTransacao": 1,
"codigoDaFilialRateio": 1,
"codigoDoItemDeLancamento": "DESP-ALUGUEL",
"codigoDoCentroDeCusto": "ADM",
"codigoDoProjeto": 123,
"codigoDoCustoABC": "<string>",
"percentual": 50,
"valor": 750
}
]
'import requests
url = "https://api.gestio.com.br/v2/financeiro/contaspagar/rateio"
payload = [
{
"idRateio": 0,
"codigoDoExercicio": 2026,
"codigoDaFilial": 1,
"numeroDaTransacao": 123456,
"sequenciaDaTransacao": 1,
"codigoDaFilialRateio": 1,
"codigoDoItemDeLancamento": "DESP-ALUGUEL",
"codigoDoCentroDeCusto": "ADM",
"codigoDoProjeto": 123,
"codigoDoCustoABC": "<string>",
"percentual": 50,
"valor": 750
}
]
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([
{
idRateio: 0,
codigoDoExercicio: 2026,
codigoDaFilial: 1,
numeroDaTransacao: 123456,
sequenciaDaTransacao: 1,
codigoDaFilialRateio: 1,
codigoDoItemDeLancamento: 'DESP-ALUGUEL',
codigoDoCentroDeCusto: 'ADM',
codigoDoProjeto: 123,
codigoDoCustoABC: '<string>',
percentual: 50,
valor: 750
}
])
};
fetch('https://api.gestio.com.br/v2/financeiro/contaspagar/rateio', 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/contaspagar/rateio",
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([
[
'idRateio' => 0,
'codigoDoExercicio' => 2026,
'codigoDaFilial' => 1,
'numeroDaTransacao' => 123456,
'sequenciaDaTransacao' => 1,
'codigoDaFilialRateio' => 1,
'codigoDoItemDeLancamento' => 'DESP-ALUGUEL',
'codigoDoCentroDeCusto' => 'ADM',
'codigoDoProjeto' => 123,
'codigoDoCustoABC' => '<string>',
'percentual' => 50,
'valor' => 750
]
]),
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/contaspagar/rateio"
payload := strings.NewReader("[\n {\n \"idRateio\": 0,\n \"codigoDoExercicio\": 2026,\n \"codigoDaFilial\": 1,\n \"numeroDaTransacao\": 123456,\n \"sequenciaDaTransacao\": 1,\n \"codigoDaFilialRateio\": 1,\n \"codigoDoItemDeLancamento\": \"DESP-ALUGUEL\",\n \"codigoDoCentroDeCusto\": \"ADM\",\n \"codigoDoProjeto\": 123,\n \"codigoDoCustoABC\": \"<string>\",\n \"percentual\": 50,\n \"valor\": 750\n }\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/contaspagar/rateio")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("[\n {\n \"idRateio\": 0,\n \"codigoDoExercicio\": 2026,\n \"codigoDaFilial\": 1,\n \"numeroDaTransacao\": 123456,\n \"sequenciaDaTransacao\": 1,\n \"codigoDaFilialRateio\": 1,\n \"codigoDoItemDeLancamento\": \"DESP-ALUGUEL\",\n \"codigoDoCentroDeCusto\": \"ADM\",\n \"codigoDoProjeto\": 123,\n \"codigoDoCustoABC\": \"<string>\",\n \"percentual\": 50,\n \"valor\": 750\n }\n]")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gestio.com.br/v2/financeiro/contaspagar/rateio")
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 {\n \"idRateio\": 0,\n \"codigoDoExercicio\": 2026,\n \"codigoDaFilial\": 1,\n \"numeroDaTransacao\": 123456,\n \"sequenciaDaTransacao\": 1,\n \"codigoDaFilialRateio\": 1,\n \"codigoDoItemDeLancamento\": \"DESP-ALUGUEL\",\n \"codigoDoCentroDeCusto\": \"ADM\",\n \"codigoDoProjeto\": 123,\n \"codigoDoCustoABC\": \"<string>\",\n \"percentual\": 50,\n \"valor\": 750\n }\n]"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"payload": [
{
"idRateio": 0,
"codigoDoExercicio": 2026,
"codigoDaFilial": 1,
"numeroDaTransacao": 123456,
"sequenciaDaTransacao": 1,
"codigoDaFilialRateio": 1,
"descricaoDaFilial": "<string>",
"codigoDoItemDeLancamento": "DESP-ALUGUEL",
"descricaoDoItemDeLancamento": "<string>",
"codigoDoCentroDeCusto": "ADM",
"descricaoDoCentroDeCusto": "<string>",
"codigoDoProjeto": 123,
"descricaoDoProjeto": "<string>",
"codigoDoCustoABC": "<string>",
"descricaoDoCustoABC": "<string>",
"percentual": 50,
"valor": 750,
"ultimaAtualizacao": "<string>"
}
],
"notifications": [
"<string>"
],
"success": true
}
}{
"success": false,
"errors": [
{
"key": null,
"value": "Total do Percentual do Rateio 90% deve ser igual a 100%.",
"dateOccurred": "2026-07-29T14:32:10Z"
}
]
}400 com o detalhe em notifications/errors.Authorizations
Envie o token retornado por /v2/autenticar no header Authorization, no formato Bearer {token}.
Body
Lista de linhas de rateio do lançamento CP. Não pode ser vazia.
Identificador da linha de rateio. Enviar 0 ao incluir uma nova linha.
0
Código do Exercício do lançamento CP ao qual esta linha de rateio pertence. Necessário para localizar o lançamento.
2026
Código da Filial do lançamento CP ao qual esta linha de rateio pertence.
1
Número da Transação do lançamento CP ao qual esta linha de rateio pertence.
123456
Sequência da Transação do lançamento CP ao qual esta linha de rateio pertence.
1
Filial de destino do rateio. Junto com codigoDoItemDeLancamento e codigoDoCentroDeCusto, ao menos um dos três deve ser informado por linha.
1
Categoria de destino do rateio.
"DESP-ALUGUEL"
Centro de Custo de destino do rateio.
"ADM"
Percentual desta linha em relação ao total do lançamento. A soma de todas as linhas do rateio deve totalizar 100.
50
Valor desta linha de rateio. A soma de todas as linhas deve ser igual ao valor do lançamento CP.
750
