Inserir lançamento de Contas a Receber
curl --request POST \
--url https://api.gestio.com.br/v2/financeiro/contasreceber \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"codigoDaFilial": 1,
"codigoDoCliente": 501,
"codigoDoItemDeLancamento": "REC-VENDA",
"historico": "Venda referente ao Pedido 4321",
"codigoDoCentroDeCusto": "COM",
"codigoDaContaCorrente": 1,
"codigoDoExercicio": 2026,
"numeroDaTransacao": 654321,
"sequenciaDaTransacao": 1,
"sequenciaDaTransacaoPai": 123,
"codigoDoTipoDeDocumento": 123,
"numeroDoDocumento": "98765",
"serieDoDocumento": "1",
"origemNotaFiscal": "<string>",
"numeroDaNFe": 123,
"dataDeEmissao": "2026-07-01T00:00:00",
"dataDeVencimento": "2026-08-05T00:00:00",
"periodoDeCompetencia": "2023-11-07T05:31:56Z",
"dataDePagamento": "2023-11-07T05:31:56Z",
"valorDoLancamento": 2500,
"codigoDaFormaDePagamento": 123,
"codigoDaCarteira": 3,
"codigoDoProjeto": 123,
"codigoDaClassificacaoAuxiliar": 123,
"observacao": "<string>",
"idWS": "<string>"
}
'import requests
url = "https://api.gestio.com.br/v2/financeiro/contasreceber"
payload = {
"codigoDaFilial": 1,
"codigoDoCliente": 501,
"codigoDoItemDeLancamento": "REC-VENDA",
"historico": "Venda referente ao Pedido 4321",
"codigoDoCentroDeCusto": "COM",
"codigoDaContaCorrente": 1,
"codigoDoExercicio": 2026,
"numeroDaTransacao": 654321,
"sequenciaDaTransacao": 1,
"sequenciaDaTransacaoPai": 123,
"codigoDoTipoDeDocumento": 123,
"numeroDoDocumento": "98765",
"serieDoDocumento": "1",
"origemNotaFiscal": "<string>",
"numeroDaNFe": 123,
"dataDeEmissao": "2026-07-01T00:00:00",
"dataDeVencimento": "2026-08-05T00:00:00",
"periodoDeCompetencia": "2023-11-07T05:31:56Z",
"dataDePagamento": "2023-11-07T05:31:56Z",
"valorDoLancamento": 2500,
"codigoDaFormaDePagamento": 123,
"codigoDaCarteira": 3,
"codigoDoProjeto": 123,
"codigoDaClassificacaoAuxiliar": 123,
"observacao": "<string>",
"idWS": "<string>"
}
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,
codigoDoCliente: 501,
codigoDoItemDeLancamento: 'REC-VENDA',
historico: 'Venda referente ao Pedido 4321',
codigoDoCentroDeCusto: 'COM',
codigoDaContaCorrente: 1,
codigoDoExercicio: 2026,
numeroDaTransacao: 654321,
sequenciaDaTransacao: 1,
sequenciaDaTransacaoPai: 123,
codigoDoTipoDeDocumento: 123,
numeroDoDocumento: '98765',
serieDoDocumento: '1',
origemNotaFiscal: '<string>',
numeroDaNFe: 123,
dataDeEmissao: '2026-07-01T00:00:00',
dataDeVencimento: '2026-08-05T00:00:00',
periodoDeCompetencia: '2023-11-07T05:31:56Z',
dataDePagamento: '2023-11-07T05:31:56Z',
valorDoLancamento: 2500,
codigoDaFormaDePagamento: 123,
codigoDaCarteira: 3,
codigoDoProjeto: 123,
codigoDaClassificacaoAuxiliar: 123,
observacao: '<string>',
idWS: '<string>'
})
};
fetch('https://api.gestio.com.br/v2/financeiro/contasreceber', 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/contasreceber",
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,
'codigoDoCliente' => 501,
'codigoDoItemDeLancamento' => 'REC-VENDA',
'historico' => 'Venda referente ao Pedido 4321',
'codigoDoCentroDeCusto' => 'COM',
'codigoDaContaCorrente' => 1,
'codigoDoExercicio' => 2026,
'numeroDaTransacao' => 654321,
'sequenciaDaTransacao' => 1,
'sequenciaDaTransacaoPai' => 123,
'codigoDoTipoDeDocumento' => 123,
'numeroDoDocumento' => '98765',
'serieDoDocumento' => '1',
'origemNotaFiscal' => '<string>',
'numeroDaNFe' => 123,
'dataDeEmissao' => '2026-07-01T00:00:00',
'dataDeVencimento' => '2026-08-05T00:00:00',
'periodoDeCompetencia' => '2023-11-07T05:31:56Z',
'dataDePagamento' => '2023-11-07T05:31:56Z',
'valorDoLancamento' => 2500,
'codigoDaFormaDePagamento' => 123,
'codigoDaCarteira' => 3,
'codigoDoProjeto' => 123,
'codigoDaClassificacaoAuxiliar' => 123,
'observacao' => '<string>',
'idWS' => '<string>'
]),
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/contasreceber"
payload := strings.NewReader("{\n \"codigoDaFilial\": 1,\n \"codigoDoCliente\": 501,\n \"codigoDoItemDeLancamento\": \"REC-VENDA\",\n \"historico\": \"Venda referente ao Pedido 4321\",\n \"codigoDoCentroDeCusto\": \"COM\",\n \"codigoDaContaCorrente\": 1,\n \"codigoDoExercicio\": 2026,\n \"numeroDaTransacao\": 654321,\n \"sequenciaDaTransacao\": 1,\n \"sequenciaDaTransacaoPai\": 123,\n \"codigoDoTipoDeDocumento\": 123,\n \"numeroDoDocumento\": \"98765\",\n \"serieDoDocumento\": \"1\",\n \"origemNotaFiscal\": \"<string>\",\n \"numeroDaNFe\": 123,\n \"dataDeEmissao\": \"2026-07-01T00:00:00\",\n \"dataDeVencimento\": \"2026-08-05T00:00:00\",\n \"periodoDeCompetencia\": \"2023-11-07T05:31:56Z\",\n \"dataDePagamento\": \"2023-11-07T05:31:56Z\",\n \"valorDoLancamento\": 2500,\n \"codigoDaFormaDePagamento\": 123,\n \"codigoDaCarteira\": 3,\n \"codigoDoProjeto\": 123,\n \"codigoDaClassificacaoAuxiliar\": 123,\n \"observacao\": \"<string>\",\n \"idWS\": \"<string>\"\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/contasreceber")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"codigoDaFilial\": 1,\n \"codigoDoCliente\": 501,\n \"codigoDoItemDeLancamento\": \"REC-VENDA\",\n \"historico\": \"Venda referente ao Pedido 4321\",\n \"codigoDoCentroDeCusto\": \"COM\",\n \"codigoDaContaCorrente\": 1,\n \"codigoDoExercicio\": 2026,\n \"numeroDaTransacao\": 654321,\n \"sequenciaDaTransacao\": 1,\n \"sequenciaDaTransacaoPai\": 123,\n \"codigoDoTipoDeDocumento\": 123,\n \"numeroDoDocumento\": \"98765\",\n \"serieDoDocumento\": \"1\",\n \"origemNotaFiscal\": \"<string>\",\n \"numeroDaNFe\": 123,\n \"dataDeEmissao\": \"2026-07-01T00:00:00\",\n \"dataDeVencimento\": \"2026-08-05T00:00:00\",\n \"periodoDeCompetencia\": \"2023-11-07T05:31:56Z\",\n \"dataDePagamento\": \"2023-11-07T05:31:56Z\",\n \"valorDoLancamento\": 2500,\n \"codigoDaFormaDePagamento\": 123,\n \"codigoDaCarteira\": 3,\n \"codigoDoProjeto\": 123,\n \"codigoDaClassificacaoAuxiliar\": 123,\n \"observacao\": \"<string>\",\n \"idWS\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gestio.com.br/v2/financeiro/contasreceber")
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 \"codigoDoCliente\": 501,\n \"codigoDoItemDeLancamento\": \"REC-VENDA\",\n \"historico\": \"Venda referente ao Pedido 4321\",\n \"codigoDoCentroDeCusto\": \"COM\",\n \"codigoDaContaCorrente\": 1,\n \"codigoDoExercicio\": 2026,\n \"numeroDaTransacao\": 654321,\n \"sequenciaDaTransacao\": 1,\n \"sequenciaDaTransacaoPai\": 123,\n \"codigoDoTipoDeDocumento\": 123,\n \"numeroDoDocumento\": \"98765\",\n \"serieDoDocumento\": \"1\",\n \"origemNotaFiscal\": \"<string>\",\n \"numeroDaNFe\": 123,\n \"dataDeEmissao\": \"2026-07-01T00:00:00\",\n \"dataDeVencimento\": \"2026-08-05T00:00:00\",\n \"periodoDeCompetencia\": \"2023-11-07T05:31:56Z\",\n \"dataDePagamento\": \"2023-11-07T05:31:56Z\",\n \"valorDoLancamento\": 2500,\n \"codigoDaFormaDePagamento\": 123,\n \"codigoDaCarteira\": 3,\n \"codigoDoProjeto\": 123,\n \"codigoDaClassificacaoAuxiliar\": 123,\n \"observacao\": \"<string>\",\n \"idWS\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"codigoDaFilial": 1,
"codigoDoCliente": 501,
"codigoDoItemDeLancamento": "REC-VENDA",
"historico": "Venda referente ao Pedido 4321",
"codigoDoCentroDeCusto": "COM",
"codigoDaContaCorrente": 1,
"codigoDoExercicio": 2026,
"descricaoDaFilial": "Matriz",
"numeroDaTransacao": 654321,
"sequenciaDaTransacao": 1,
"sequenciaDaTransacaoPai": 123,
"descricaoDoCliente": "Cliente Comércio Ltda",
"descricaoDoItemDeLancamento": "Venda de Produtos",
"codigoDoTipoDeDocumento": 123,
"descricaoDoTipoDeDocumento": "<string>",
"numeroDoDocumento": "98765",
"serieDoDocumento": "1",
"origemNotaFiscal": "<string>",
"numeroDaNFe": 123,
"dataDeEmissao": "2026-07-01T00:00:00",
"dataDeVencimento": "2026-08-05T00:00:00",
"periodoDeCompetencia": "2023-11-07T05:31:56Z",
"dataDePagamento": "2023-11-07T05:31:56Z",
"valorDoLancamento": 2500,
"descricaoDoCentroDeCusto": "Comercial",
"codigoDaFormaDePagamento": 123,
"descricaoDaContaCorrente": "Banco do Brasil - CC 12345-6",
"codigoDaCarteira": 3,
"codigoDoProjeto": 123,
"descricaoDoProjeto": "<string>",
"codigoDaClassificacaoAuxiliar": 123,
"descricaoDaClassificacaoAuxiliar": "<string>",
"observacao": "<string>",
"urlBoletoPDF": "<string>",
"baixado": true,
"responsavelBaixa": "<string>",
"ultimaAtualizacao": "<string>",
"idWS": "<string>"
}
}{
"success": false,
"errors": [
{
"key": null,
"value": "Cliente inválido, inativo ou não informado.",
"dateOccurred": "2026-07-29T14:32:10Z"
}
]
}Contas a Receber
Inserir lançamento de Contas a Receber
Inclui um novo lançamento (título) de Contas a Receber. Os campos de chave (codigoDoExercicio, numeroDaTransacao, sequenciaDaTransacao) são gerados automaticamente e ignorados quando enviados.
POST
/
v2
/
financeiro
/
contasreceber
Inserir lançamento de Contas a Receber
curl --request POST \
--url https://api.gestio.com.br/v2/financeiro/contasreceber \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"codigoDaFilial": 1,
"codigoDoCliente": 501,
"codigoDoItemDeLancamento": "REC-VENDA",
"historico": "Venda referente ao Pedido 4321",
"codigoDoCentroDeCusto": "COM",
"codigoDaContaCorrente": 1,
"codigoDoExercicio": 2026,
"numeroDaTransacao": 654321,
"sequenciaDaTransacao": 1,
"sequenciaDaTransacaoPai": 123,
"codigoDoTipoDeDocumento": 123,
"numeroDoDocumento": "98765",
"serieDoDocumento": "1",
"origemNotaFiscal": "<string>",
"numeroDaNFe": 123,
"dataDeEmissao": "2026-07-01T00:00:00",
"dataDeVencimento": "2026-08-05T00:00:00",
"periodoDeCompetencia": "2023-11-07T05:31:56Z",
"dataDePagamento": "2023-11-07T05:31:56Z",
"valorDoLancamento": 2500,
"codigoDaFormaDePagamento": 123,
"codigoDaCarteira": 3,
"codigoDoProjeto": 123,
"codigoDaClassificacaoAuxiliar": 123,
"observacao": "<string>",
"idWS": "<string>"
}
'import requests
url = "https://api.gestio.com.br/v2/financeiro/contasreceber"
payload = {
"codigoDaFilial": 1,
"codigoDoCliente": 501,
"codigoDoItemDeLancamento": "REC-VENDA",
"historico": "Venda referente ao Pedido 4321",
"codigoDoCentroDeCusto": "COM",
"codigoDaContaCorrente": 1,
"codigoDoExercicio": 2026,
"numeroDaTransacao": 654321,
"sequenciaDaTransacao": 1,
"sequenciaDaTransacaoPai": 123,
"codigoDoTipoDeDocumento": 123,
"numeroDoDocumento": "98765",
"serieDoDocumento": "1",
"origemNotaFiscal": "<string>",
"numeroDaNFe": 123,
"dataDeEmissao": "2026-07-01T00:00:00",
"dataDeVencimento": "2026-08-05T00:00:00",
"periodoDeCompetencia": "2023-11-07T05:31:56Z",
"dataDePagamento": "2023-11-07T05:31:56Z",
"valorDoLancamento": 2500,
"codigoDaFormaDePagamento": 123,
"codigoDaCarteira": 3,
"codigoDoProjeto": 123,
"codigoDaClassificacaoAuxiliar": 123,
"observacao": "<string>",
"idWS": "<string>"
}
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,
codigoDoCliente: 501,
codigoDoItemDeLancamento: 'REC-VENDA',
historico: 'Venda referente ao Pedido 4321',
codigoDoCentroDeCusto: 'COM',
codigoDaContaCorrente: 1,
codigoDoExercicio: 2026,
numeroDaTransacao: 654321,
sequenciaDaTransacao: 1,
sequenciaDaTransacaoPai: 123,
codigoDoTipoDeDocumento: 123,
numeroDoDocumento: '98765',
serieDoDocumento: '1',
origemNotaFiscal: '<string>',
numeroDaNFe: 123,
dataDeEmissao: '2026-07-01T00:00:00',
dataDeVencimento: '2026-08-05T00:00:00',
periodoDeCompetencia: '2023-11-07T05:31:56Z',
dataDePagamento: '2023-11-07T05:31:56Z',
valorDoLancamento: 2500,
codigoDaFormaDePagamento: 123,
codigoDaCarteira: 3,
codigoDoProjeto: 123,
codigoDaClassificacaoAuxiliar: 123,
observacao: '<string>',
idWS: '<string>'
})
};
fetch('https://api.gestio.com.br/v2/financeiro/contasreceber', 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/contasreceber",
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,
'codigoDoCliente' => 501,
'codigoDoItemDeLancamento' => 'REC-VENDA',
'historico' => 'Venda referente ao Pedido 4321',
'codigoDoCentroDeCusto' => 'COM',
'codigoDaContaCorrente' => 1,
'codigoDoExercicio' => 2026,
'numeroDaTransacao' => 654321,
'sequenciaDaTransacao' => 1,
'sequenciaDaTransacaoPai' => 123,
'codigoDoTipoDeDocumento' => 123,
'numeroDoDocumento' => '98765',
'serieDoDocumento' => '1',
'origemNotaFiscal' => '<string>',
'numeroDaNFe' => 123,
'dataDeEmissao' => '2026-07-01T00:00:00',
'dataDeVencimento' => '2026-08-05T00:00:00',
'periodoDeCompetencia' => '2023-11-07T05:31:56Z',
'dataDePagamento' => '2023-11-07T05:31:56Z',
'valorDoLancamento' => 2500,
'codigoDaFormaDePagamento' => 123,
'codigoDaCarteira' => 3,
'codigoDoProjeto' => 123,
'codigoDaClassificacaoAuxiliar' => 123,
'observacao' => '<string>',
'idWS' => '<string>'
]),
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/contasreceber"
payload := strings.NewReader("{\n \"codigoDaFilial\": 1,\n \"codigoDoCliente\": 501,\n \"codigoDoItemDeLancamento\": \"REC-VENDA\",\n \"historico\": \"Venda referente ao Pedido 4321\",\n \"codigoDoCentroDeCusto\": \"COM\",\n \"codigoDaContaCorrente\": 1,\n \"codigoDoExercicio\": 2026,\n \"numeroDaTransacao\": 654321,\n \"sequenciaDaTransacao\": 1,\n \"sequenciaDaTransacaoPai\": 123,\n \"codigoDoTipoDeDocumento\": 123,\n \"numeroDoDocumento\": \"98765\",\n \"serieDoDocumento\": \"1\",\n \"origemNotaFiscal\": \"<string>\",\n \"numeroDaNFe\": 123,\n \"dataDeEmissao\": \"2026-07-01T00:00:00\",\n \"dataDeVencimento\": \"2026-08-05T00:00:00\",\n \"periodoDeCompetencia\": \"2023-11-07T05:31:56Z\",\n \"dataDePagamento\": \"2023-11-07T05:31:56Z\",\n \"valorDoLancamento\": 2500,\n \"codigoDaFormaDePagamento\": 123,\n \"codigoDaCarteira\": 3,\n \"codigoDoProjeto\": 123,\n \"codigoDaClassificacaoAuxiliar\": 123,\n \"observacao\": \"<string>\",\n \"idWS\": \"<string>\"\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/contasreceber")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"codigoDaFilial\": 1,\n \"codigoDoCliente\": 501,\n \"codigoDoItemDeLancamento\": \"REC-VENDA\",\n \"historico\": \"Venda referente ao Pedido 4321\",\n \"codigoDoCentroDeCusto\": \"COM\",\n \"codigoDaContaCorrente\": 1,\n \"codigoDoExercicio\": 2026,\n \"numeroDaTransacao\": 654321,\n \"sequenciaDaTransacao\": 1,\n \"sequenciaDaTransacaoPai\": 123,\n \"codigoDoTipoDeDocumento\": 123,\n \"numeroDoDocumento\": \"98765\",\n \"serieDoDocumento\": \"1\",\n \"origemNotaFiscal\": \"<string>\",\n \"numeroDaNFe\": 123,\n \"dataDeEmissao\": \"2026-07-01T00:00:00\",\n \"dataDeVencimento\": \"2026-08-05T00:00:00\",\n \"periodoDeCompetencia\": \"2023-11-07T05:31:56Z\",\n \"dataDePagamento\": \"2023-11-07T05:31:56Z\",\n \"valorDoLancamento\": 2500,\n \"codigoDaFormaDePagamento\": 123,\n \"codigoDaCarteira\": 3,\n \"codigoDoProjeto\": 123,\n \"codigoDaClassificacaoAuxiliar\": 123,\n \"observacao\": \"<string>\",\n \"idWS\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gestio.com.br/v2/financeiro/contasreceber")
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 \"codigoDoCliente\": 501,\n \"codigoDoItemDeLancamento\": \"REC-VENDA\",\n \"historico\": \"Venda referente ao Pedido 4321\",\n \"codigoDoCentroDeCusto\": \"COM\",\n \"codigoDaContaCorrente\": 1,\n \"codigoDoExercicio\": 2026,\n \"numeroDaTransacao\": 654321,\n \"sequenciaDaTransacao\": 1,\n \"sequenciaDaTransacaoPai\": 123,\n \"codigoDoTipoDeDocumento\": 123,\n \"numeroDoDocumento\": \"98765\",\n \"serieDoDocumento\": \"1\",\n \"origemNotaFiscal\": \"<string>\",\n \"numeroDaNFe\": 123,\n \"dataDeEmissao\": \"2026-07-01T00:00:00\",\n \"dataDeVencimento\": \"2026-08-05T00:00:00\",\n \"periodoDeCompetencia\": \"2023-11-07T05:31:56Z\",\n \"dataDePagamento\": \"2023-11-07T05:31:56Z\",\n \"valorDoLancamento\": 2500,\n \"codigoDaFormaDePagamento\": 123,\n \"codigoDaCarteira\": 3,\n \"codigoDoProjeto\": 123,\n \"codigoDaClassificacaoAuxiliar\": 123,\n \"observacao\": \"<string>\",\n \"idWS\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"codigoDaFilial": 1,
"codigoDoCliente": 501,
"codigoDoItemDeLancamento": "REC-VENDA",
"historico": "Venda referente ao Pedido 4321",
"codigoDoCentroDeCusto": "COM",
"codigoDaContaCorrente": 1,
"codigoDoExercicio": 2026,
"descricaoDaFilial": "Matriz",
"numeroDaTransacao": 654321,
"sequenciaDaTransacao": 1,
"sequenciaDaTransacaoPai": 123,
"descricaoDoCliente": "Cliente Comércio Ltda",
"descricaoDoItemDeLancamento": "Venda de Produtos",
"codigoDoTipoDeDocumento": 123,
"descricaoDoTipoDeDocumento": "<string>",
"numeroDoDocumento": "98765",
"serieDoDocumento": "1",
"origemNotaFiscal": "<string>",
"numeroDaNFe": 123,
"dataDeEmissao": "2026-07-01T00:00:00",
"dataDeVencimento": "2026-08-05T00:00:00",
"periodoDeCompetencia": "2023-11-07T05:31:56Z",
"dataDePagamento": "2023-11-07T05:31:56Z",
"valorDoLancamento": 2500,
"descricaoDoCentroDeCusto": "Comercial",
"codigoDaFormaDePagamento": 123,
"descricaoDaContaCorrente": "Banco do Brasil - CC 12345-6",
"codigoDaCarteira": 3,
"codigoDoProjeto": 123,
"descricaoDoProjeto": "<string>",
"codigoDaClassificacaoAuxiliar": 123,
"descricaoDaClassificacaoAuxiliar": "<string>",
"observacao": "<string>",
"urlBoletoPDF": "<string>",
"baixado": true,
"responsavelBaixa": "<string>",
"ultimaAtualizacao": "<string>",
"idWS": "<string>"
}
}{
"success": false,
"errors": [
{
"key": null,
"value": "Cliente inválido, inativo ou não 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 Receber. 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 Cliente. Obrigatório e deve ser um Cliente ativo cadastrado na empresa.
Example:
501
Código da Categoria (Item de Lançamento) de receita. Obrigatório e deve ser uma Categoria de receita válida da Filial informada.
Example:
"REC-VENDA"
Histórico do lançamento. Obrigatório.
Example:
"Venda referente ao Pedido 4321"
Código do Centro de Custo. Obrigatório e deve ser um Centro de Custo válido da empresa.
Example:
"COM"
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:
654321
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.
Example:
"98765"
Example:
"1"
Origem da Nota Fiscal vinculada ao lançamento, quando aplicável.
Example:
"2026-07-01T00:00:00"
Example:
"2026-08-05T00:00:00"
Data de Pagamento (recebimento). Quando informada (e válida), o lançamento é baixado automaticamente na inclusão/alteração.
Valor do lançamento.
Example:
2500
Código da Carteira de cobrança, usada para emissão de boleto. Quando informada, deve ser uma Carteira válida vinculada à Conta Corrente informada.
Example:
3
Identificador externo do lançamento, usado por integrações e localizável via GET /v2/financeiro/contasreceber/localizar.
Response
Lançamento inserido com sucesso.
Example:
true
Lançamento de Contas a Receber. 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