Inserir lançamento de Contas a Pagar
curl --request POST \
--url https://api.gestio.com.br/v2/financeiro/contaspagar \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"codigoDaFilial": 1,
"codigoDoFornecedor": 501,
"codigoDoItemDeLancamento": "DESP-ALUGUEL",
"historico": "Aluguel do escritório - Julho/2026",
"codigoDoCentroDeCusto": "ADM",
"codigoDaContaCorrente": 1,
"codigoDoExercicio": 2026,
"numeroDaTransacao": 123456,
"sequenciaDaTransacao": 1,
"sequenciaDaTransacaoPai": 123,
"codigoDoCliente": 123,
"numeroDoPedidoDeCompra": 123,
"codigoDoTipoDeDocumento": 123,
"numeroDoDocumento": "12345",
"serieDoDocumento": "1",
"dataDeEmissao": "2026-07-01T00:00:00",
"dataDeVencimento": "2026-08-05T00:00:00",
"dataDePagamento": null,
"valorDoLancamento": 1500.5,
"valorBruto": 1650.5,
"valorPISRetido": 123,
"valorCOFINSRetido": 123,
"valorCSLLRetido": 123,
"valorIRRetido": 123,
"valorISSRetido": 123,
"valorINSSRetido": 123,
"codigoDaFormaDePagamento": 123,
"valorAbatimento": 123,
"tipoDeLancamento": "<string>",
"tipoChavePix": "<string>",
"chavePix": "<string>",
"codigoDoProjeto": 123,
"codigoDaClassificacaoAuxiliar": 123,
"observacao": "<string>",
"flag": "<string>",
"tags": [
"<string>"
],
"idWS": "<string>",
"numeroDaNFe": 123
}
'import requests
url = "https://api.gestio.com.br/v2/financeiro/contaspagar"
payload = {
"codigoDaFilial": 1,
"codigoDoFornecedor": 501,
"codigoDoItemDeLancamento": "DESP-ALUGUEL",
"historico": "Aluguel do escritório - Julho/2026",
"codigoDoCentroDeCusto": "ADM",
"codigoDaContaCorrente": 1,
"codigoDoExercicio": 2026,
"numeroDaTransacao": 123456,
"sequenciaDaTransacao": 1,
"sequenciaDaTransacaoPai": 123,
"codigoDoCliente": 123,
"numeroDoPedidoDeCompra": 123,
"codigoDoTipoDeDocumento": 123,
"numeroDoDocumento": "12345",
"serieDoDocumento": "1",
"dataDeEmissao": "2026-07-01T00:00:00",
"dataDeVencimento": "2026-08-05T00:00:00",
"dataDePagamento": None,
"valorDoLancamento": 1500.5,
"valorBruto": 1650.5,
"valorPISRetido": 123,
"valorCOFINSRetido": 123,
"valorCSLLRetido": 123,
"valorIRRetido": 123,
"valorISSRetido": 123,
"valorINSSRetido": 123,
"codigoDaFormaDePagamento": 123,
"valorAbatimento": 123,
"tipoDeLancamento": "<string>",
"tipoChavePix": "<string>",
"chavePix": "<string>",
"codigoDoProjeto": 123,
"codigoDaClassificacaoAuxiliar": 123,
"observacao": "<string>",
"flag": "<string>",
"tags": ["<string>"],
"idWS": "<string>",
"numeroDaNFe": 123
}
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({
codigoDaFilial: 1,
codigoDoFornecedor: 501,
codigoDoItemDeLancamento: 'DESP-ALUGUEL',
historico: 'Aluguel do escritório - Julho/2026',
codigoDoCentroDeCusto: 'ADM',
codigoDaContaCorrente: 1,
codigoDoExercicio: 2026,
numeroDaTransacao: 123456,
sequenciaDaTransacao: 1,
sequenciaDaTransacaoPai: 123,
codigoDoCliente: 123,
numeroDoPedidoDeCompra: 123,
codigoDoTipoDeDocumento: 123,
numeroDoDocumento: '12345',
serieDoDocumento: '1',
dataDeEmissao: '2026-07-01T00:00:00',
dataDeVencimento: '2026-08-05T00:00:00',
dataDePagamento: null,
valorDoLancamento: 1500.5,
valorBruto: 1650.5,
valorPISRetido: 123,
valorCOFINSRetido: 123,
valorCSLLRetido: 123,
valorIRRetido: 123,
valorISSRetido: 123,
valorINSSRetido: 123,
codigoDaFormaDePagamento: 123,
valorAbatimento: 123,
tipoDeLancamento: '<string>',
tipoChavePix: '<string>',
chavePix: '<string>',
codigoDoProjeto: 123,
codigoDaClassificacaoAuxiliar: 123,
observacao: '<string>',
flag: '<string>',
tags: ['<string>'],
idWS: '<string>',
numeroDaNFe: 123
})
};
fetch('https://api.gestio.com.br/v2/financeiro/contaspagar', 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",
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([
'codigoDaFilial' => 1,
'codigoDoFornecedor' => 501,
'codigoDoItemDeLancamento' => 'DESP-ALUGUEL',
'historico' => 'Aluguel do escritório - Julho/2026',
'codigoDoCentroDeCusto' => 'ADM',
'codigoDaContaCorrente' => 1,
'codigoDoExercicio' => 2026,
'numeroDaTransacao' => 123456,
'sequenciaDaTransacao' => 1,
'sequenciaDaTransacaoPai' => 123,
'codigoDoCliente' => 123,
'numeroDoPedidoDeCompra' => 123,
'codigoDoTipoDeDocumento' => 123,
'numeroDoDocumento' => '12345',
'serieDoDocumento' => '1',
'dataDeEmissao' => '2026-07-01T00:00:00',
'dataDeVencimento' => '2026-08-05T00:00:00',
'dataDePagamento' => null,
'valorDoLancamento' => 1500.5,
'valorBruto' => 1650.5,
'valorPISRetido' => 123,
'valorCOFINSRetido' => 123,
'valorCSLLRetido' => 123,
'valorIRRetido' => 123,
'valorISSRetido' => 123,
'valorINSSRetido' => 123,
'codigoDaFormaDePagamento' => 123,
'valorAbatimento' => 123,
'tipoDeLancamento' => '<string>',
'tipoChavePix' => '<string>',
'chavePix' => '<string>',
'codigoDoProjeto' => 123,
'codigoDaClassificacaoAuxiliar' => 123,
'observacao' => '<string>',
'flag' => '<string>',
'tags' => [
'<string>'
],
'idWS' => '<string>',
'numeroDaNFe' => 123
]),
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"
payload := strings.NewReader("{\n \"codigoDaFilial\": 1,\n \"codigoDoFornecedor\": 501,\n \"codigoDoItemDeLancamento\": \"DESP-ALUGUEL\",\n \"historico\": \"Aluguel do escritório - Julho/2026\",\n \"codigoDoCentroDeCusto\": \"ADM\",\n \"codigoDaContaCorrente\": 1,\n \"codigoDoExercicio\": 2026,\n \"numeroDaTransacao\": 123456,\n \"sequenciaDaTransacao\": 1,\n \"sequenciaDaTransacaoPai\": 123,\n \"codigoDoCliente\": 123,\n \"numeroDoPedidoDeCompra\": 123,\n \"codigoDoTipoDeDocumento\": 123,\n \"numeroDoDocumento\": \"12345\",\n \"serieDoDocumento\": \"1\",\n \"dataDeEmissao\": \"2026-07-01T00:00:00\",\n \"dataDeVencimento\": \"2026-08-05T00:00:00\",\n \"dataDePagamento\": null,\n \"valorDoLancamento\": 1500.5,\n \"valorBruto\": 1650.5,\n \"valorPISRetido\": 123,\n \"valorCOFINSRetido\": 123,\n \"valorCSLLRetido\": 123,\n \"valorIRRetido\": 123,\n \"valorISSRetido\": 123,\n \"valorINSSRetido\": 123,\n \"codigoDaFormaDePagamento\": 123,\n \"valorAbatimento\": 123,\n \"tipoDeLancamento\": \"<string>\",\n \"tipoChavePix\": \"<string>\",\n \"chavePix\": \"<string>\",\n \"codigoDoProjeto\": 123,\n \"codigoDaClassificacaoAuxiliar\": 123,\n \"observacao\": \"<string>\",\n \"flag\": \"<string>\",\n \"tags\": [\n \"<string>\"\n ],\n \"idWS\": \"<string>\",\n \"numeroDaNFe\": 123\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")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"codigoDaFilial\": 1,\n \"codigoDoFornecedor\": 501,\n \"codigoDoItemDeLancamento\": \"DESP-ALUGUEL\",\n \"historico\": \"Aluguel do escritório - Julho/2026\",\n \"codigoDoCentroDeCusto\": \"ADM\",\n \"codigoDaContaCorrente\": 1,\n \"codigoDoExercicio\": 2026,\n \"numeroDaTransacao\": 123456,\n \"sequenciaDaTransacao\": 1,\n \"sequenciaDaTransacaoPai\": 123,\n \"codigoDoCliente\": 123,\n \"numeroDoPedidoDeCompra\": 123,\n \"codigoDoTipoDeDocumento\": 123,\n \"numeroDoDocumento\": \"12345\",\n \"serieDoDocumento\": \"1\",\n \"dataDeEmissao\": \"2026-07-01T00:00:00\",\n \"dataDeVencimento\": \"2026-08-05T00:00:00\",\n \"dataDePagamento\": null,\n \"valorDoLancamento\": 1500.5,\n \"valorBruto\": 1650.5,\n \"valorPISRetido\": 123,\n \"valorCOFINSRetido\": 123,\n \"valorCSLLRetido\": 123,\n \"valorIRRetido\": 123,\n \"valorISSRetido\": 123,\n \"valorINSSRetido\": 123,\n \"codigoDaFormaDePagamento\": 123,\n \"valorAbatimento\": 123,\n \"tipoDeLancamento\": \"<string>\",\n \"tipoChavePix\": \"<string>\",\n \"chavePix\": \"<string>\",\n \"codigoDoProjeto\": 123,\n \"codigoDaClassificacaoAuxiliar\": 123,\n \"observacao\": \"<string>\",\n \"flag\": \"<string>\",\n \"tags\": [\n \"<string>\"\n ],\n \"idWS\": \"<string>\",\n \"numeroDaNFe\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gestio.com.br/v2/financeiro/contaspagar")
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 \"codigoDaFilial\": 1,\n \"codigoDoFornecedor\": 501,\n \"codigoDoItemDeLancamento\": \"DESP-ALUGUEL\",\n \"historico\": \"Aluguel do escritório - Julho/2026\",\n \"codigoDoCentroDeCusto\": \"ADM\",\n \"codigoDaContaCorrente\": 1,\n \"codigoDoExercicio\": 2026,\n \"numeroDaTransacao\": 123456,\n \"sequenciaDaTransacao\": 1,\n \"sequenciaDaTransacaoPai\": 123,\n \"codigoDoCliente\": 123,\n \"numeroDoPedidoDeCompra\": 123,\n \"codigoDoTipoDeDocumento\": 123,\n \"numeroDoDocumento\": \"12345\",\n \"serieDoDocumento\": \"1\",\n \"dataDeEmissao\": \"2026-07-01T00:00:00\",\n \"dataDeVencimento\": \"2026-08-05T00:00:00\",\n \"dataDePagamento\": null,\n \"valorDoLancamento\": 1500.5,\n \"valorBruto\": 1650.5,\n \"valorPISRetido\": 123,\n \"valorCOFINSRetido\": 123,\n \"valorCSLLRetido\": 123,\n \"valorIRRetido\": 123,\n \"valorISSRetido\": 123,\n \"valorINSSRetido\": 123,\n \"codigoDaFormaDePagamento\": 123,\n \"valorAbatimento\": 123,\n \"tipoDeLancamento\": \"<string>\",\n \"tipoChavePix\": \"<string>\",\n \"chavePix\": \"<string>\",\n \"codigoDoProjeto\": 123,\n \"codigoDaClassificacaoAuxiliar\": 123,\n \"observacao\": \"<string>\",\n \"flag\": \"<string>\",\n \"tags\": [\n \"<string>\"\n ],\n \"idWS\": \"<string>\",\n \"numeroDaNFe\": 123\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"codigoDaFilial": 1,
"codigoDoFornecedor": 501,
"codigoDoItemDeLancamento": "DESP-ALUGUEL",
"historico": "Aluguel do escritório - Julho/2026",
"codigoDoCentroDeCusto": "ADM",
"codigoDaContaCorrente": 1,
"codigoDoExercicio": 2026,
"descricaoDaFilial": "Matriz",
"numeroDaTransacao": 123456,
"sequenciaDaTransacao": 1,
"sequenciaDaTransacaoPai": 123,
"codigoDoCliente": 123,
"descricaoDoFornecedor": "Fornecedor Papelaria Ltda",
"numeroDoPedidoDeCompra": 123,
"descricaoDoItemDeLancamento": "Aluguel",
"codigoDoTipoDeDocumento": 123,
"descricaoDoTipoDeDocumento": "<string>",
"numeroDoDocumento": "12345",
"serieDoDocumento": "1",
"dataDeEmissao": "2026-07-01T00:00:00",
"dataDeVencimento": "2026-08-05T00:00:00",
"dataDePagamento": null,
"valorDoLancamento": 1500.5,
"valorBruto": 1650.5,
"valorPISRetido": 123,
"valorCOFINSRetido": 123,
"valorCSLLRetido": 123,
"valorIRRetido": 123,
"valorISSRetido": 123,
"valorINSSRetido": 123,
"descricaoDoCentroDeCusto": "Administrativo",
"codigoDaFormaDePagamento": 123,
"descricaoDaContaCorrente": "Banco do Brasil - CC 12345-6",
"valorAbatimento": 123,
"tipoDeLancamento": "<string>",
"tipoChavePix": "<string>",
"chavePix": "<string>",
"codigoDoProjeto": 123,
"descricaoDoProjeto": "<string>",
"codigoDaClassificacaoAuxiliar": 123,
"descricaoDaClassificacaoAuxiliar": "<string>",
"observacao": "<string>",
"baixado": true,
"responsavelBaixa": "<string>",
"flag": "<string>",
"tags": [
"<string>"
],
"ultimaAtualizacao": "<string>",
"idWS": "<string>",
"numeroDaNFe": 123,
"arquivos": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"nomeDoArquivo": "<string>",
"url": "<string>",
"observacao": "<string>"
}
]
}
}{
"success": false,
"errors": [
{
"key": null,
"value": "Histórico deve ser informado.",
"dateOccurred": "2026-07-29T14:32:10Z"
}
]
}Contas a Pagar
Inserir lançamento de Contas a Pagar
Inclui um novo lançamento (título) de Contas a Pagar. Os campos de chave (codigoDoExercicio, numeroDaTransacao, sequenciaDaTransacao) são gerados automaticamente e ignorados quando enviados.
POST
/
v2
/
financeiro
/
contaspagar
Inserir lançamento de Contas a Pagar
curl --request POST \
--url https://api.gestio.com.br/v2/financeiro/contaspagar \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"codigoDaFilial": 1,
"codigoDoFornecedor": 501,
"codigoDoItemDeLancamento": "DESP-ALUGUEL",
"historico": "Aluguel do escritório - Julho/2026",
"codigoDoCentroDeCusto": "ADM",
"codigoDaContaCorrente": 1,
"codigoDoExercicio": 2026,
"numeroDaTransacao": 123456,
"sequenciaDaTransacao": 1,
"sequenciaDaTransacaoPai": 123,
"codigoDoCliente": 123,
"numeroDoPedidoDeCompra": 123,
"codigoDoTipoDeDocumento": 123,
"numeroDoDocumento": "12345",
"serieDoDocumento": "1",
"dataDeEmissao": "2026-07-01T00:00:00",
"dataDeVencimento": "2026-08-05T00:00:00",
"dataDePagamento": null,
"valorDoLancamento": 1500.5,
"valorBruto": 1650.5,
"valorPISRetido": 123,
"valorCOFINSRetido": 123,
"valorCSLLRetido": 123,
"valorIRRetido": 123,
"valorISSRetido": 123,
"valorINSSRetido": 123,
"codigoDaFormaDePagamento": 123,
"valorAbatimento": 123,
"tipoDeLancamento": "<string>",
"tipoChavePix": "<string>",
"chavePix": "<string>",
"codigoDoProjeto": 123,
"codigoDaClassificacaoAuxiliar": 123,
"observacao": "<string>",
"flag": "<string>",
"tags": [
"<string>"
],
"idWS": "<string>",
"numeroDaNFe": 123
}
'import requests
url = "https://api.gestio.com.br/v2/financeiro/contaspagar"
payload = {
"codigoDaFilial": 1,
"codigoDoFornecedor": 501,
"codigoDoItemDeLancamento": "DESP-ALUGUEL",
"historico": "Aluguel do escritório - Julho/2026",
"codigoDoCentroDeCusto": "ADM",
"codigoDaContaCorrente": 1,
"codigoDoExercicio": 2026,
"numeroDaTransacao": 123456,
"sequenciaDaTransacao": 1,
"sequenciaDaTransacaoPai": 123,
"codigoDoCliente": 123,
"numeroDoPedidoDeCompra": 123,
"codigoDoTipoDeDocumento": 123,
"numeroDoDocumento": "12345",
"serieDoDocumento": "1",
"dataDeEmissao": "2026-07-01T00:00:00",
"dataDeVencimento": "2026-08-05T00:00:00",
"dataDePagamento": None,
"valorDoLancamento": 1500.5,
"valorBruto": 1650.5,
"valorPISRetido": 123,
"valorCOFINSRetido": 123,
"valorCSLLRetido": 123,
"valorIRRetido": 123,
"valorISSRetido": 123,
"valorINSSRetido": 123,
"codigoDaFormaDePagamento": 123,
"valorAbatimento": 123,
"tipoDeLancamento": "<string>",
"tipoChavePix": "<string>",
"chavePix": "<string>",
"codigoDoProjeto": 123,
"codigoDaClassificacaoAuxiliar": 123,
"observacao": "<string>",
"flag": "<string>",
"tags": ["<string>"],
"idWS": "<string>",
"numeroDaNFe": 123
}
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({
codigoDaFilial: 1,
codigoDoFornecedor: 501,
codigoDoItemDeLancamento: 'DESP-ALUGUEL',
historico: 'Aluguel do escritório - Julho/2026',
codigoDoCentroDeCusto: 'ADM',
codigoDaContaCorrente: 1,
codigoDoExercicio: 2026,
numeroDaTransacao: 123456,
sequenciaDaTransacao: 1,
sequenciaDaTransacaoPai: 123,
codigoDoCliente: 123,
numeroDoPedidoDeCompra: 123,
codigoDoTipoDeDocumento: 123,
numeroDoDocumento: '12345',
serieDoDocumento: '1',
dataDeEmissao: '2026-07-01T00:00:00',
dataDeVencimento: '2026-08-05T00:00:00',
dataDePagamento: null,
valorDoLancamento: 1500.5,
valorBruto: 1650.5,
valorPISRetido: 123,
valorCOFINSRetido: 123,
valorCSLLRetido: 123,
valorIRRetido: 123,
valorISSRetido: 123,
valorINSSRetido: 123,
codigoDaFormaDePagamento: 123,
valorAbatimento: 123,
tipoDeLancamento: '<string>',
tipoChavePix: '<string>',
chavePix: '<string>',
codigoDoProjeto: 123,
codigoDaClassificacaoAuxiliar: 123,
observacao: '<string>',
flag: '<string>',
tags: ['<string>'],
idWS: '<string>',
numeroDaNFe: 123
})
};
fetch('https://api.gestio.com.br/v2/financeiro/contaspagar', 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",
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([
'codigoDaFilial' => 1,
'codigoDoFornecedor' => 501,
'codigoDoItemDeLancamento' => 'DESP-ALUGUEL',
'historico' => 'Aluguel do escritório - Julho/2026',
'codigoDoCentroDeCusto' => 'ADM',
'codigoDaContaCorrente' => 1,
'codigoDoExercicio' => 2026,
'numeroDaTransacao' => 123456,
'sequenciaDaTransacao' => 1,
'sequenciaDaTransacaoPai' => 123,
'codigoDoCliente' => 123,
'numeroDoPedidoDeCompra' => 123,
'codigoDoTipoDeDocumento' => 123,
'numeroDoDocumento' => '12345',
'serieDoDocumento' => '1',
'dataDeEmissao' => '2026-07-01T00:00:00',
'dataDeVencimento' => '2026-08-05T00:00:00',
'dataDePagamento' => null,
'valorDoLancamento' => 1500.5,
'valorBruto' => 1650.5,
'valorPISRetido' => 123,
'valorCOFINSRetido' => 123,
'valorCSLLRetido' => 123,
'valorIRRetido' => 123,
'valorISSRetido' => 123,
'valorINSSRetido' => 123,
'codigoDaFormaDePagamento' => 123,
'valorAbatimento' => 123,
'tipoDeLancamento' => '<string>',
'tipoChavePix' => '<string>',
'chavePix' => '<string>',
'codigoDoProjeto' => 123,
'codigoDaClassificacaoAuxiliar' => 123,
'observacao' => '<string>',
'flag' => '<string>',
'tags' => [
'<string>'
],
'idWS' => '<string>',
'numeroDaNFe' => 123
]),
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"
payload := strings.NewReader("{\n \"codigoDaFilial\": 1,\n \"codigoDoFornecedor\": 501,\n \"codigoDoItemDeLancamento\": \"DESP-ALUGUEL\",\n \"historico\": \"Aluguel do escritório - Julho/2026\",\n \"codigoDoCentroDeCusto\": \"ADM\",\n \"codigoDaContaCorrente\": 1,\n \"codigoDoExercicio\": 2026,\n \"numeroDaTransacao\": 123456,\n \"sequenciaDaTransacao\": 1,\n \"sequenciaDaTransacaoPai\": 123,\n \"codigoDoCliente\": 123,\n \"numeroDoPedidoDeCompra\": 123,\n \"codigoDoTipoDeDocumento\": 123,\n \"numeroDoDocumento\": \"12345\",\n \"serieDoDocumento\": \"1\",\n \"dataDeEmissao\": \"2026-07-01T00:00:00\",\n \"dataDeVencimento\": \"2026-08-05T00:00:00\",\n \"dataDePagamento\": null,\n \"valorDoLancamento\": 1500.5,\n \"valorBruto\": 1650.5,\n \"valorPISRetido\": 123,\n \"valorCOFINSRetido\": 123,\n \"valorCSLLRetido\": 123,\n \"valorIRRetido\": 123,\n \"valorISSRetido\": 123,\n \"valorINSSRetido\": 123,\n \"codigoDaFormaDePagamento\": 123,\n \"valorAbatimento\": 123,\n \"tipoDeLancamento\": \"<string>\",\n \"tipoChavePix\": \"<string>\",\n \"chavePix\": \"<string>\",\n \"codigoDoProjeto\": 123,\n \"codigoDaClassificacaoAuxiliar\": 123,\n \"observacao\": \"<string>\",\n \"flag\": \"<string>\",\n \"tags\": [\n \"<string>\"\n ],\n \"idWS\": \"<string>\",\n \"numeroDaNFe\": 123\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")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"codigoDaFilial\": 1,\n \"codigoDoFornecedor\": 501,\n \"codigoDoItemDeLancamento\": \"DESP-ALUGUEL\",\n \"historico\": \"Aluguel do escritório - Julho/2026\",\n \"codigoDoCentroDeCusto\": \"ADM\",\n \"codigoDaContaCorrente\": 1,\n \"codigoDoExercicio\": 2026,\n \"numeroDaTransacao\": 123456,\n \"sequenciaDaTransacao\": 1,\n \"sequenciaDaTransacaoPai\": 123,\n \"codigoDoCliente\": 123,\n \"numeroDoPedidoDeCompra\": 123,\n \"codigoDoTipoDeDocumento\": 123,\n \"numeroDoDocumento\": \"12345\",\n \"serieDoDocumento\": \"1\",\n \"dataDeEmissao\": \"2026-07-01T00:00:00\",\n \"dataDeVencimento\": \"2026-08-05T00:00:00\",\n \"dataDePagamento\": null,\n \"valorDoLancamento\": 1500.5,\n \"valorBruto\": 1650.5,\n \"valorPISRetido\": 123,\n \"valorCOFINSRetido\": 123,\n \"valorCSLLRetido\": 123,\n \"valorIRRetido\": 123,\n \"valorISSRetido\": 123,\n \"valorINSSRetido\": 123,\n \"codigoDaFormaDePagamento\": 123,\n \"valorAbatimento\": 123,\n \"tipoDeLancamento\": \"<string>\",\n \"tipoChavePix\": \"<string>\",\n \"chavePix\": \"<string>\",\n \"codigoDoProjeto\": 123,\n \"codigoDaClassificacaoAuxiliar\": 123,\n \"observacao\": \"<string>\",\n \"flag\": \"<string>\",\n \"tags\": [\n \"<string>\"\n ],\n \"idWS\": \"<string>\",\n \"numeroDaNFe\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gestio.com.br/v2/financeiro/contaspagar")
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 \"codigoDaFilial\": 1,\n \"codigoDoFornecedor\": 501,\n \"codigoDoItemDeLancamento\": \"DESP-ALUGUEL\",\n \"historico\": \"Aluguel do escritório - Julho/2026\",\n \"codigoDoCentroDeCusto\": \"ADM\",\n \"codigoDaContaCorrente\": 1,\n \"codigoDoExercicio\": 2026,\n \"numeroDaTransacao\": 123456,\n \"sequenciaDaTransacao\": 1,\n \"sequenciaDaTransacaoPai\": 123,\n \"codigoDoCliente\": 123,\n \"numeroDoPedidoDeCompra\": 123,\n \"codigoDoTipoDeDocumento\": 123,\n \"numeroDoDocumento\": \"12345\",\n \"serieDoDocumento\": \"1\",\n \"dataDeEmissao\": \"2026-07-01T00:00:00\",\n \"dataDeVencimento\": \"2026-08-05T00:00:00\",\n \"dataDePagamento\": null,\n \"valorDoLancamento\": 1500.5,\n \"valorBruto\": 1650.5,\n \"valorPISRetido\": 123,\n \"valorCOFINSRetido\": 123,\n \"valorCSLLRetido\": 123,\n \"valorIRRetido\": 123,\n \"valorISSRetido\": 123,\n \"valorINSSRetido\": 123,\n \"codigoDaFormaDePagamento\": 123,\n \"valorAbatimento\": 123,\n \"tipoDeLancamento\": \"<string>\",\n \"tipoChavePix\": \"<string>\",\n \"chavePix\": \"<string>\",\n \"codigoDoProjeto\": 123,\n \"codigoDaClassificacaoAuxiliar\": 123,\n \"observacao\": \"<string>\",\n \"flag\": \"<string>\",\n \"tags\": [\n \"<string>\"\n ],\n \"idWS\": \"<string>\",\n \"numeroDaNFe\": 123\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"codigoDaFilial": 1,
"codigoDoFornecedor": 501,
"codigoDoItemDeLancamento": "DESP-ALUGUEL",
"historico": "Aluguel do escritório - Julho/2026",
"codigoDoCentroDeCusto": "ADM",
"codigoDaContaCorrente": 1,
"codigoDoExercicio": 2026,
"descricaoDaFilial": "Matriz",
"numeroDaTransacao": 123456,
"sequenciaDaTransacao": 1,
"sequenciaDaTransacaoPai": 123,
"codigoDoCliente": 123,
"descricaoDoFornecedor": "Fornecedor Papelaria Ltda",
"numeroDoPedidoDeCompra": 123,
"descricaoDoItemDeLancamento": "Aluguel",
"codigoDoTipoDeDocumento": 123,
"descricaoDoTipoDeDocumento": "<string>",
"numeroDoDocumento": "12345",
"serieDoDocumento": "1",
"dataDeEmissao": "2026-07-01T00:00:00",
"dataDeVencimento": "2026-08-05T00:00:00",
"dataDePagamento": null,
"valorDoLancamento": 1500.5,
"valorBruto": 1650.5,
"valorPISRetido": 123,
"valorCOFINSRetido": 123,
"valorCSLLRetido": 123,
"valorIRRetido": 123,
"valorISSRetido": 123,
"valorINSSRetido": 123,
"descricaoDoCentroDeCusto": "Administrativo",
"codigoDaFormaDePagamento": 123,
"descricaoDaContaCorrente": "Banco do Brasil - CC 12345-6",
"valorAbatimento": 123,
"tipoDeLancamento": "<string>",
"tipoChavePix": "<string>",
"chavePix": "<string>",
"codigoDoProjeto": 123,
"descricaoDoProjeto": "<string>",
"codigoDaClassificacaoAuxiliar": 123,
"descricaoDaClassificacaoAuxiliar": "<string>",
"observacao": "<string>",
"baixado": true,
"responsavelBaixa": "<string>",
"flag": "<string>",
"tags": [
"<string>"
],
"ultimaAtualizacao": "<string>",
"idWS": "<string>",
"numeroDaNFe": 123,
"arquivos": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"nomeDoArquivo": "<string>",
"url": "<string>",
"observacao": "<string>"
}
]
}
}{
"success": false,
"errors": [
{
"key": null,
"value": "Histórico deve ser informado.",
"dateOccurred": "2026-07-29T14:32:10Z"
}
]
}Campos obrigatórios ausentes ou inválidos retornam
400 com o detalhe em notifications/errors.Authorizations
Envie o token retornado por /v2/autenticar no header Authorization, no formato Bearer {token}.
Body
application/json
Lançamento de Contas a Pagar. Usado tanto na inclusão (POST) quanto na alteração (PUT) e nas respostas de consulta. Na inclusão, os campos de chave (codigoDoExercicio, numeroDaTransacao, sequenciaDaTransacao) são ignorados e gerados automaticamente; na alteração, eles são obrigatórios para identificar o lançamento.
Código da Filial. Deve ser uma Filial válida da empresa.
Example:
1
Código do Fornecedor. Obrigatório e deve ser um Fornecedor válido cadastrado na empresa.
Example:
501
Código da Categoria (Item de Lançamento) de despesa. Obrigatório e deve ser uma Categoria de despesa válida da Filial informada.
Example:
"DESP-ALUGUEL"
Histórico do lançamento. Obrigatório.
Example:
"Aluguel do escritório - Julho/2026"
Código do Centro de Custo. Obrigatório e deve ser um Centro de Custo válido da empresa.
Example:
"ADM"
Código da Conta Corrente. Obrigatório e deve ser uma Conta Corrente válida da Filial informada.
Example:
1
Código do Exercício. Obrigatório apenas na alteração (PUT); ignorado e gerado automaticamente na inclusão (POST).
Example:
2026
Número da Transação. Obrigatório apenas na alteração (PUT); ignorado e gerado automaticamente na inclusão (POST).
Example:
123456
Sequência da Transação. Obrigatório apenas na alteração (PUT); ignorado e gerado automaticamente na inclusão (POST).
Example:
1
Sequência da Transação pai, quando este lançamento é um desdobramento (acréscimo, desconto, juros ou multa) de outro.
Código do Cliente, usado apenas em cenários específicos de Contas a Pagar vinculadas a devoluções/estornos de Cliente.
Número do Pedido de Compra vinculado ao lançamento, quando aplicável.
Código do Tipo de Documento (ex.: Nota Fiscal, Boleto, Recibo).
Example:
"12345"
Example:
"1"
Example:
"2026-07-01T00:00:00"
Example:
"2026-08-05T00:00:00"
Data de Pagamento. Quando informada (e válida), o lançamento é baixado automaticamente na inclusão/alteração.
Example:
null
Valor líquido do lançamento — o valor efetivo do título.
Example:
1500.5
Valor bruto do lançamento, antes dos impostos retidos.
Example:
1650.5
Valor de PIS retido na nota.
Valor de COFINS retido na nota.
Valor de CSLL retido na nota.
Valor de IR retido na nota.
Valor de ISS retido na nota.
Valor de INSS retido na nota.
Valor de abatimento aplicado ao lançamento.
Tipo de lançamento interno (ex.: Normal, Acréscimo, Desconto, Juros, Multa, Estorno).
Tipo da Chave PIX usada para pagamento (ex.: CPF, CNPJ, E-mail, Telefone, Aleatória).
Código do Projeto, quando informado deve ser um Projeto válido da empresa.
Código da Classificação Auxiliar, quando informado deve ser uma Classificação Auxiliar válida do módulo Financeiro.
Flag/marcador livre do lançamento.
Identificador externo do lançamento, usado por integrações.
Número da NF-e vinculada ao lançamento, quando aplicável.
Response
Lançamento inserido com sucesso.
Example:
true
Lançamento de Contas a Pagar. Usado tanto na inclusão (POST) quanto na alteração (PUT) e nas respostas de consulta. Na inclusão, os campos de chave (codigoDoExercicio, numeroDaTransacao, sequenciaDaTransacao) são ignorados e gerados automaticamente; na alteração, eles são obrigatórios para identificar o lançamento.
Show child attributes
Show child attributes