Inserir Cliente
curl --request POST \
--url https://api.gestio.com.br/v2/cliente \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"nomeComercial": "Comercial Alfa",
"razaoSocial": "Comercial Alfa Distribuidora Ltda",
"natureza": "J",
"seuCodigo": "<string>",
"cnpj": "12345678000199",
"cpf": "12345678909",
"inscricaoEstadual": "<string>",
"inscricaoMunicipal": "<string>",
"indicadorContribuinte": "<string>",
"codigoDoTipoDeCliente": 123,
"codigoDoGrupoDeCliente": 123,
"codigoDaClassificacaoAuxiliar": 123,
"codigoDoSegmento": "<string>",
"idRamoDeAtividade": 123,
"codigoDoVendedor": 123,
"codigoDaCategoria": 123,
"codigoDaSituacaoFinanceira": 123,
"endereco": {
"cep": "01311000",
"logradouro": "Av. Paulista",
"numero": "1578",
"complemento": "Conjunto 41",
"bairro": "Bela Vista",
"cidade": "São Paulo",
"uf": "SP",
"codigoDoMunicipio": "3550308"
},
"telefone": "(11) 4002-8922",
"site": "https://www.suaempresa.com.br",
"email": "[email protected]",
"receberEmailBoleto": true,
"paisExterior": true,
"codigoDoPais": 123,
"idExterior": "<string>",
"observacao": "<string>",
"observacaoFinanceiro": "<string>",
"textoLivre": "<string>",
"codigoDoRegimeTributario": 123,
"contatoFinanceiro": "<string>",
"emailContatoFinanceiro": "<string>",
"telefoneFinanceiro": "<string>",
"emailsFinanceiro": [
"<string>"
],
"contatoFaturamento": "<string>",
"emailContatoFaturamento": "<string>",
"telefoneFaturamento": "<string>",
"aliquotaISSRetidoFaturamento": 123,
"idClienteWS": "<string>"
}
'import requests
url = "https://api.gestio.com.br/v2/cliente"
payload = {
"nomeComercial": "Comercial Alfa",
"razaoSocial": "Comercial Alfa Distribuidora Ltda",
"natureza": "J",
"seuCodigo": "<string>",
"cnpj": "12345678000199",
"cpf": "12345678909",
"inscricaoEstadual": "<string>",
"inscricaoMunicipal": "<string>",
"indicadorContribuinte": "<string>",
"codigoDoTipoDeCliente": 123,
"codigoDoGrupoDeCliente": 123,
"codigoDaClassificacaoAuxiliar": 123,
"codigoDoSegmento": "<string>",
"idRamoDeAtividade": 123,
"codigoDoVendedor": 123,
"codigoDaCategoria": 123,
"codigoDaSituacaoFinanceira": 123,
"endereco": {
"cep": "01311000",
"logradouro": "Av. Paulista",
"numero": "1578",
"complemento": "Conjunto 41",
"bairro": "Bela Vista",
"cidade": "São Paulo",
"uf": "SP",
"codigoDoMunicipio": "3550308"
},
"telefone": "(11) 4002-8922",
"site": "https://www.suaempresa.com.br",
"email": "[email protected]",
"receberEmailBoleto": True,
"paisExterior": True,
"codigoDoPais": 123,
"idExterior": "<string>",
"observacao": "<string>",
"observacaoFinanceiro": "<string>",
"textoLivre": "<string>",
"codigoDoRegimeTributario": 123,
"contatoFinanceiro": "<string>",
"emailContatoFinanceiro": "<string>",
"telefoneFinanceiro": "<string>",
"emailsFinanceiro": ["<string>"],
"contatoFaturamento": "<string>",
"emailContatoFaturamento": "<string>",
"telefoneFaturamento": "<string>",
"aliquotaISSRetidoFaturamento": 123,
"idClienteWS": "<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({
nomeComercial: 'Comercial Alfa',
razaoSocial: 'Comercial Alfa Distribuidora Ltda',
natureza: 'J',
seuCodigo: '<string>',
cnpj: '12345678000199',
cpf: '12345678909',
inscricaoEstadual: '<string>',
inscricaoMunicipal: '<string>',
indicadorContribuinte: '<string>',
codigoDoTipoDeCliente: 123,
codigoDoGrupoDeCliente: 123,
codigoDaClassificacaoAuxiliar: 123,
codigoDoSegmento: '<string>',
idRamoDeAtividade: 123,
codigoDoVendedor: 123,
codigoDaCategoria: 123,
codigoDaSituacaoFinanceira: 123,
endereco: {
cep: '01311000',
logradouro: 'Av. Paulista',
numero: '1578',
complemento: 'Conjunto 41',
bairro: 'Bela Vista',
cidade: 'São Paulo',
uf: 'SP',
codigoDoMunicipio: '3550308'
},
telefone: '(11) 4002-8922',
site: 'https://www.suaempresa.com.br',
email: '[email protected]',
receberEmailBoleto: true,
paisExterior: true,
codigoDoPais: 123,
idExterior: '<string>',
observacao: '<string>',
observacaoFinanceiro: '<string>',
textoLivre: '<string>',
codigoDoRegimeTributario: 123,
contatoFinanceiro: '<string>',
emailContatoFinanceiro: '<string>',
telefoneFinanceiro: '<string>',
emailsFinanceiro: ['<string>'],
contatoFaturamento: '<string>',
emailContatoFaturamento: '<string>',
telefoneFaturamento: '<string>',
aliquotaISSRetidoFaturamento: 123,
idClienteWS: '<string>'
})
};
fetch('https://api.gestio.com.br/v2/cliente', 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/cliente",
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([
'nomeComercial' => 'Comercial Alfa',
'razaoSocial' => 'Comercial Alfa Distribuidora Ltda',
'natureza' => 'J',
'seuCodigo' => '<string>',
'cnpj' => '12345678000199',
'cpf' => '12345678909',
'inscricaoEstadual' => '<string>',
'inscricaoMunicipal' => '<string>',
'indicadorContribuinte' => '<string>',
'codigoDoTipoDeCliente' => 123,
'codigoDoGrupoDeCliente' => 123,
'codigoDaClassificacaoAuxiliar' => 123,
'codigoDoSegmento' => '<string>',
'idRamoDeAtividade' => 123,
'codigoDoVendedor' => 123,
'codigoDaCategoria' => 123,
'codigoDaSituacaoFinanceira' => 123,
'endereco' => [
'cep' => '01311000',
'logradouro' => 'Av. Paulista',
'numero' => '1578',
'complemento' => 'Conjunto 41',
'bairro' => 'Bela Vista',
'cidade' => 'São Paulo',
'uf' => 'SP',
'codigoDoMunicipio' => '3550308'
],
'telefone' => '(11) 4002-8922',
'site' => 'https://www.suaempresa.com.br',
'email' => '[email protected]',
'receberEmailBoleto' => true,
'paisExterior' => true,
'codigoDoPais' => 123,
'idExterior' => '<string>',
'observacao' => '<string>',
'observacaoFinanceiro' => '<string>',
'textoLivre' => '<string>',
'codigoDoRegimeTributario' => 123,
'contatoFinanceiro' => '<string>',
'emailContatoFinanceiro' => '<string>',
'telefoneFinanceiro' => '<string>',
'emailsFinanceiro' => [
'<string>'
],
'contatoFaturamento' => '<string>',
'emailContatoFaturamento' => '<string>',
'telefoneFaturamento' => '<string>',
'aliquotaISSRetidoFaturamento' => 123,
'idClienteWS' => '<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/cliente"
payload := strings.NewReader("{\n \"nomeComercial\": \"Comercial Alfa\",\n \"razaoSocial\": \"Comercial Alfa Distribuidora Ltda\",\n \"natureza\": \"J\",\n \"seuCodigo\": \"<string>\",\n \"cnpj\": \"12345678000199\",\n \"cpf\": \"12345678909\",\n \"inscricaoEstadual\": \"<string>\",\n \"inscricaoMunicipal\": \"<string>\",\n \"indicadorContribuinte\": \"<string>\",\n \"codigoDoTipoDeCliente\": 123,\n \"codigoDoGrupoDeCliente\": 123,\n \"codigoDaClassificacaoAuxiliar\": 123,\n \"codigoDoSegmento\": \"<string>\",\n \"idRamoDeAtividade\": 123,\n \"codigoDoVendedor\": 123,\n \"codigoDaCategoria\": 123,\n \"codigoDaSituacaoFinanceira\": 123,\n \"endereco\": {\n \"cep\": \"01311000\",\n \"logradouro\": \"Av. Paulista\",\n \"numero\": \"1578\",\n \"complemento\": \"Conjunto 41\",\n \"bairro\": \"Bela Vista\",\n \"cidade\": \"São Paulo\",\n \"uf\": \"SP\",\n \"codigoDoMunicipio\": \"3550308\"\n },\n \"telefone\": \"(11) 4002-8922\",\n \"site\": \"https://www.suaempresa.com.br\",\n \"email\": \"[email protected]\",\n \"receberEmailBoleto\": true,\n \"paisExterior\": true,\n \"codigoDoPais\": 123,\n \"idExterior\": \"<string>\",\n \"observacao\": \"<string>\",\n \"observacaoFinanceiro\": \"<string>\",\n \"textoLivre\": \"<string>\",\n \"codigoDoRegimeTributario\": 123,\n \"contatoFinanceiro\": \"<string>\",\n \"emailContatoFinanceiro\": \"<string>\",\n \"telefoneFinanceiro\": \"<string>\",\n \"emailsFinanceiro\": [\n \"<string>\"\n ],\n \"contatoFaturamento\": \"<string>\",\n \"emailContatoFaturamento\": \"<string>\",\n \"telefoneFaturamento\": \"<string>\",\n \"aliquotaISSRetidoFaturamento\": 123,\n \"idClienteWS\": \"<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/cliente")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"nomeComercial\": \"Comercial Alfa\",\n \"razaoSocial\": \"Comercial Alfa Distribuidora Ltda\",\n \"natureza\": \"J\",\n \"seuCodigo\": \"<string>\",\n \"cnpj\": \"12345678000199\",\n \"cpf\": \"12345678909\",\n \"inscricaoEstadual\": \"<string>\",\n \"inscricaoMunicipal\": \"<string>\",\n \"indicadorContribuinte\": \"<string>\",\n \"codigoDoTipoDeCliente\": 123,\n \"codigoDoGrupoDeCliente\": 123,\n \"codigoDaClassificacaoAuxiliar\": 123,\n \"codigoDoSegmento\": \"<string>\",\n \"idRamoDeAtividade\": 123,\n \"codigoDoVendedor\": 123,\n \"codigoDaCategoria\": 123,\n \"codigoDaSituacaoFinanceira\": 123,\n \"endereco\": {\n \"cep\": \"01311000\",\n \"logradouro\": \"Av. Paulista\",\n \"numero\": \"1578\",\n \"complemento\": \"Conjunto 41\",\n \"bairro\": \"Bela Vista\",\n \"cidade\": \"São Paulo\",\n \"uf\": \"SP\",\n \"codigoDoMunicipio\": \"3550308\"\n },\n \"telefone\": \"(11) 4002-8922\",\n \"site\": \"https://www.suaempresa.com.br\",\n \"email\": \"[email protected]\",\n \"receberEmailBoleto\": true,\n \"paisExterior\": true,\n \"codigoDoPais\": 123,\n \"idExterior\": \"<string>\",\n \"observacao\": \"<string>\",\n \"observacaoFinanceiro\": \"<string>\",\n \"textoLivre\": \"<string>\",\n \"codigoDoRegimeTributario\": 123,\n \"contatoFinanceiro\": \"<string>\",\n \"emailContatoFinanceiro\": \"<string>\",\n \"telefoneFinanceiro\": \"<string>\",\n \"emailsFinanceiro\": [\n \"<string>\"\n ],\n \"contatoFaturamento\": \"<string>\",\n \"emailContatoFaturamento\": \"<string>\",\n \"telefoneFaturamento\": \"<string>\",\n \"aliquotaISSRetidoFaturamento\": 123,\n \"idClienteWS\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gestio.com.br/v2/cliente")
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 \"nomeComercial\": \"Comercial Alfa\",\n \"razaoSocial\": \"Comercial Alfa Distribuidora Ltda\",\n \"natureza\": \"J\",\n \"seuCodigo\": \"<string>\",\n \"cnpj\": \"12345678000199\",\n \"cpf\": \"12345678909\",\n \"inscricaoEstadual\": \"<string>\",\n \"inscricaoMunicipal\": \"<string>\",\n \"indicadorContribuinte\": \"<string>\",\n \"codigoDoTipoDeCliente\": 123,\n \"codigoDoGrupoDeCliente\": 123,\n \"codigoDaClassificacaoAuxiliar\": 123,\n \"codigoDoSegmento\": \"<string>\",\n \"idRamoDeAtividade\": 123,\n \"codigoDoVendedor\": 123,\n \"codigoDaCategoria\": 123,\n \"codigoDaSituacaoFinanceira\": 123,\n \"endereco\": {\n \"cep\": \"01311000\",\n \"logradouro\": \"Av. Paulista\",\n \"numero\": \"1578\",\n \"complemento\": \"Conjunto 41\",\n \"bairro\": \"Bela Vista\",\n \"cidade\": \"São Paulo\",\n \"uf\": \"SP\",\n \"codigoDoMunicipio\": \"3550308\"\n },\n \"telefone\": \"(11) 4002-8922\",\n \"site\": \"https://www.suaempresa.com.br\",\n \"email\": \"[email protected]\",\n \"receberEmailBoleto\": true,\n \"paisExterior\": true,\n \"codigoDoPais\": 123,\n \"idExterior\": \"<string>\",\n \"observacao\": \"<string>\",\n \"observacaoFinanceiro\": \"<string>\",\n \"textoLivre\": \"<string>\",\n \"codigoDoRegimeTributario\": 123,\n \"contatoFinanceiro\": \"<string>\",\n \"emailContatoFinanceiro\": \"<string>\",\n \"telefoneFinanceiro\": \"<string>\",\n \"emailsFinanceiro\": [\n \"<string>\"\n ],\n \"contatoFaturamento\": \"<string>\",\n \"emailContatoFaturamento\": \"<string>\",\n \"telefoneFaturamento\": \"<string>\",\n \"aliquotaISSRetidoFaturamento\": 123,\n \"idClienteWS\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"nomeComercial": "Comercial Alfa",
"codigoDoCliente": 1023,
"razaoSocial": "Comercial Alfa Distribuidora Ltda",
"natureza": "J",
"seuCodigo": "<string>",
"cnpjcpf": "<string>",
"cnpj": "12345678000199",
"cpf": "12345678909",
"inscricaoEstadual": "<string>",
"inscricaoMunicipal": "<string>",
"indicadorContribuinte": "<string>",
"codigoDoTipoDeCliente": 123,
"descricaoDoTipoDeCliente": "<string>",
"codigoDoGrupoDeCliente": 123,
"codigoDaClassificacaoAuxiliar": 123,
"descricaoDoGrupoDeCliente": "<string>",
"codigoDoSegmento": "<string>",
"idRamoDeAtividade": 123,
"descricaoDoSegmento": "<string>",
"codigoDoVendedor": 123,
"descricaoDoVendedor": "<string>",
"codigoDaCategoria": 123,
"codigoDaSituacaoFinanceira": 123,
"descricaoDaCategoria": "<string>",
"descricaoDaSituacaoFinanceira": "<string>",
"endereco": {
"cep": "01311000",
"logradouro": "Av. Paulista",
"numero": "1578",
"complemento": "Conjunto 41",
"bairro": "Bela Vista",
"cidade": "São Paulo",
"uf": "SP",
"codigoDoMunicipio": "3550308"
},
"telefone": "(11) 4002-8922",
"site": "https://www.suaempresa.com.br",
"email": "[email protected]",
"receberEmailBoleto": true,
"paisExterior": true,
"codigoDoPais": 123,
"idExterior": "<string>",
"observacao": "<string>",
"observacaoFinanceiro": "<string>",
"textoLivre": "<string>",
"codigoDoRegimeTributario": 123,
"descricaoDoRegimeTributario": "<string>",
"contatoFinanceiro": "<string>",
"emailContatoFinanceiro": "<string>",
"telefoneFinanceiro": "<string>",
"emailsFinanceiro": [
"<string>"
],
"contatoFaturamento": "<string>",
"emailContatoFaturamento": "<string>",
"telefoneFaturamento": "<string>",
"aliquotaISSRetidoFaturamento": 123,
"dataDeCadastro": "2023-11-07T05:31:56Z",
"ativo": true,
"podeAtivar": true,
"podeDesativar": true,
"idClienteWS": "<string>",
"ultimaAtualizacao": "<string>",
"contatos": [
{
"codigoDoCliente": 1023,
"seqContato": 1,
"nomeDoContato": "Ana Beatriz Ferreira",
"nomeAbreviado": "Ana Ferreira",
"departamento": "Financeiro",
"telefone": "(11) 4002-8922",
"celular": "(11) 98877-6655",
"email": "[email protected]",
"observacao": "<string>",
"ativo": true
}
],
"podeEditar": true,
"nomeComercialFmt": "<string>"
}
}{
"success": false,
"errors": [
{
"key": "<string>",
"value": "<string>",
"dateOccurred": "2023-11-07T05:31:56Z"
}
]
}Cliente
Inserir Cliente
Cria um novo Cliente. Campo nomeComercial é obrigatório; natureza define se o cliente é Pessoa Jurídica (J, padrão) ou Física (F) e, quando informado, cnpj/cpf são validados quanto ao formato (não são obrigatórios).
POST
/
v2
/
cliente
Inserir Cliente
curl --request POST \
--url https://api.gestio.com.br/v2/cliente \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"nomeComercial": "Comercial Alfa",
"razaoSocial": "Comercial Alfa Distribuidora Ltda",
"natureza": "J",
"seuCodigo": "<string>",
"cnpj": "12345678000199",
"cpf": "12345678909",
"inscricaoEstadual": "<string>",
"inscricaoMunicipal": "<string>",
"indicadorContribuinte": "<string>",
"codigoDoTipoDeCliente": 123,
"codigoDoGrupoDeCliente": 123,
"codigoDaClassificacaoAuxiliar": 123,
"codigoDoSegmento": "<string>",
"idRamoDeAtividade": 123,
"codigoDoVendedor": 123,
"codigoDaCategoria": 123,
"codigoDaSituacaoFinanceira": 123,
"endereco": {
"cep": "01311000",
"logradouro": "Av. Paulista",
"numero": "1578",
"complemento": "Conjunto 41",
"bairro": "Bela Vista",
"cidade": "São Paulo",
"uf": "SP",
"codigoDoMunicipio": "3550308"
},
"telefone": "(11) 4002-8922",
"site": "https://www.suaempresa.com.br",
"email": "[email protected]",
"receberEmailBoleto": true,
"paisExterior": true,
"codigoDoPais": 123,
"idExterior": "<string>",
"observacao": "<string>",
"observacaoFinanceiro": "<string>",
"textoLivre": "<string>",
"codigoDoRegimeTributario": 123,
"contatoFinanceiro": "<string>",
"emailContatoFinanceiro": "<string>",
"telefoneFinanceiro": "<string>",
"emailsFinanceiro": [
"<string>"
],
"contatoFaturamento": "<string>",
"emailContatoFaturamento": "<string>",
"telefoneFaturamento": "<string>",
"aliquotaISSRetidoFaturamento": 123,
"idClienteWS": "<string>"
}
'import requests
url = "https://api.gestio.com.br/v2/cliente"
payload = {
"nomeComercial": "Comercial Alfa",
"razaoSocial": "Comercial Alfa Distribuidora Ltda",
"natureza": "J",
"seuCodigo": "<string>",
"cnpj": "12345678000199",
"cpf": "12345678909",
"inscricaoEstadual": "<string>",
"inscricaoMunicipal": "<string>",
"indicadorContribuinte": "<string>",
"codigoDoTipoDeCliente": 123,
"codigoDoGrupoDeCliente": 123,
"codigoDaClassificacaoAuxiliar": 123,
"codigoDoSegmento": "<string>",
"idRamoDeAtividade": 123,
"codigoDoVendedor": 123,
"codigoDaCategoria": 123,
"codigoDaSituacaoFinanceira": 123,
"endereco": {
"cep": "01311000",
"logradouro": "Av. Paulista",
"numero": "1578",
"complemento": "Conjunto 41",
"bairro": "Bela Vista",
"cidade": "São Paulo",
"uf": "SP",
"codigoDoMunicipio": "3550308"
},
"telefone": "(11) 4002-8922",
"site": "https://www.suaempresa.com.br",
"email": "[email protected]",
"receberEmailBoleto": True,
"paisExterior": True,
"codigoDoPais": 123,
"idExterior": "<string>",
"observacao": "<string>",
"observacaoFinanceiro": "<string>",
"textoLivre": "<string>",
"codigoDoRegimeTributario": 123,
"contatoFinanceiro": "<string>",
"emailContatoFinanceiro": "<string>",
"telefoneFinanceiro": "<string>",
"emailsFinanceiro": ["<string>"],
"contatoFaturamento": "<string>",
"emailContatoFaturamento": "<string>",
"telefoneFaturamento": "<string>",
"aliquotaISSRetidoFaturamento": 123,
"idClienteWS": "<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({
nomeComercial: 'Comercial Alfa',
razaoSocial: 'Comercial Alfa Distribuidora Ltda',
natureza: 'J',
seuCodigo: '<string>',
cnpj: '12345678000199',
cpf: '12345678909',
inscricaoEstadual: '<string>',
inscricaoMunicipal: '<string>',
indicadorContribuinte: '<string>',
codigoDoTipoDeCliente: 123,
codigoDoGrupoDeCliente: 123,
codigoDaClassificacaoAuxiliar: 123,
codigoDoSegmento: '<string>',
idRamoDeAtividade: 123,
codigoDoVendedor: 123,
codigoDaCategoria: 123,
codigoDaSituacaoFinanceira: 123,
endereco: {
cep: '01311000',
logradouro: 'Av. Paulista',
numero: '1578',
complemento: 'Conjunto 41',
bairro: 'Bela Vista',
cidade: 'São Paulo',
uf: 'SP',
codigoDoMunicipio: '3550308'
},
telefone: '(11) 4002-8922',
site: 'https://www.suaempresa.com.br',
email: '[email protected]',
receberEmailBoleto: true,
paisExterior: true,
codigoDoPais: 123,
idExterior: '<string>',
observacao: '<string>',
observacaoFinanceiro: '<string>',
textoLivre: '<string>',
codigoDoRegimeTributario: 123,
contatoFinanceiro: '<string>',
emailContatoFinanceiro: '<string>',
telefoneFinanceiro: '<string>',
emailsFinanceiro: ['<string>'],
contatoFaturamento: '<string>',
emailContatoFaturamento: '<string>',
telefoneFaturamento: '<string>',
aliquotaISSRetidoFaturamento: 123,
idClienteWS: '<string>'
})
};
fetch('https://api.gestio.com.br/v2/cliente', 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/cliente",
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([
'nomeComercial' => 'Comercial Alfa',
'razaoSocial' => 'Comercial Alfa Distribuidora Ltda',
'natureza' => 'J',
'seuCodigo' => '<string>',
'cnpj' => '12345678000199',
'cpf' => '12345678909',
'inscricaoEstadual' => '<string>',
'inscricaoMunicipal' => '<string>',
'indicadorContribuinte' => '<string>',
'codigoDoTipoDeCliente' => 123,
'codigoDoGrupoDeCliente' => 123,
'codigoDaClassificacaoAuxiliar' => 123,
'codigoDoSegmento' => '<string>',
'idRamoDeAtividade' => 123,
'codigoDoVendedor' => 123,
'codigoDaCategoria' => 123,
'codigoDaSituacaoFinanceira' => 123,
'endereco' => [
'cep' => '01311000',
'logradouro' => 'Av. Paulista',
'numero' => '1578',
'complemento' => 'Conjunto 41',
'bairro' => 'Bela Vista',
'cidade' => 'São Paulo',
'uf' => 'SP',
'codigoDoMunicipio' => '3550308'
],
'telefone' => '(11) 4002-8922',
'site' => 'https://www.suaempresa.com.br',
'email' => '[email protected]',
'receberEmailBoleto' => true,
'paisExterior' => true,
'codigoDoPais' => 123,
'idExterior' => '<string>',
'observacao' => '<string>',
'observacaoFinanceiro' => '<string>',
'textoLivre' => '<string>',
'codigoDoRegimeTributario' => 123,
'contatoFinanceiro' => '<string>',
'emailContatoFinanceiro' => '<string>',
'telefoneFinanceiro' => '<string>',
'emailsFinanceiro' => [
'<string>'
],
'contatoFaturamento' => '<string>',
'emailContatoFaturamento' => '<string>',
'telefoneFaturamento' => '<string>',
'aliquotaISSRetidoFaturamento' => 123,
'idClienteWS' => '<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/cliente"
payload := strings.NewReader("{\n \"nomeComercial\": \"Comercial Alfa\",\n \"razaoSocial\": \"Comercial Alfa Distribuidora Ltda\",\n \"natureza\": \"J\",\n \"seuCodigo\": \"<string>\",\n \"cnpj\": \"12345678000199\",\n \"cpf\": \"12345678909\",\n \"inscricaoEstadual\": \"<string>\",\n \"inscricaoMunicipal\": \"<string>\",\n \"indicadorContribuinte\": \"<string>\",\n \"codigoDoTipoDeCliente\": 123,\n \"codigoDoGrupoDeCliente\": 123,\n \"codigoDaClassificacaoAuxiliar\": 123,\n \"codigoDoSegmento\": \"<string>\",\n \"idRamoDeAtividade\": 123,\n \"codigoDoVendedor\": 123,\n \"codigoDaCategoria\": 123,\n \"codigoDaSituacaoFinanceira\": 123,\n \"endereco\": {\n \"cep\": \"01311000\",\n \"logradouro\": \"Av. Paulista\",\n \"numero\": \"1578\",\n \"complemento\": \"Conjunto 41\",\n \"bairro\": \"Bela Vista\",\n \"cidade\": \"São Paulo\",\n \"uf\": \"SP\",\n \"codigoDoMunicipio\": \"3550308\"\n },\n \"telefone\": \"(11) 4002-8922\",\n \"site\": \"https://www.suaempresa.com.br\",\n \"email\": \"[email protected]\",\n \"receberEmailBoleto\": true,\n \"paisExterior\": true,\n \"codigoDoPais\": 123,\n \"idExterior\": \"<string>\",\n \"observacao\": \"<string>\",\n \"observacaoFinanceiro\": \"<string>\",\n \"textoLivre\": \"<string>\",\n \"codigoDoRegimeTributario\": 123,\n \"contatoFinanceiro\": \"<string>\",\n \"emailContatoFinanceiro\": \"<string>\",\n \"telefoneFinanceiro\": \"<string>\",\n \"emailsFinanceiro\": [\n \"<string>\"\n ],\n \"contatoFaturamento\": \"<string>\",\n \"emailContatoFaturamento\": \"<string>\",\n \"telefoneFaturamento\": \"<string>\",\n \"aliquotaISSRetidoFaturamento\": 123,\n \"idClienteWS\": \"<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/cliente")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"nomeComercial\": \"Comercial Alfa\",\n \"razaoSocial\": \"Comercial Alfa Distribuidora Ltda\",\n \"natureza\": \"J\",\n \"seuCodigo\": \"<string>\",\n \"cnpj\": \"12345678000199\",\n \"cpf\": \"12345678909\",\n \"inscricaoEstadual\": \"<string>\",\n \"inscricaoMunicipal\": \"<string>\",\n \"indicadorContribuinte\": \"<string>\",\n \"codigoDoTipoDeCliente\": 123,\n \"codigoDoGrupoDeCliente\": 123,\n \"codigoDaClassificacaoAuxiliar\": 123,\n \"codigoDoSegmento\": \"<string>\",\n \"idRamoDeAtividade\": 123,\n \"codigoDoVendedor\": 123,\n \"codigoDaCategoria\": 123,\n \"codigoDaSituacaoFinanceira\": 123,\n \"endereco\": {\n \"cep\": \"01311000\",\n \"logradouro\": \"Av. Paulista\",\n \"numero\": \"1578\",\n \"complemento\": \"Conjunto 41\",\n \"bairro\": \"Bela Vista\",\n \"cidade\": \"São Paulo\",\n \"uf\": \"SP\",\n \"codigoDoMunicipio\": \"3550308\"\n },\n \"telefone\": \"(11) 4002-8922\",\n \"site\": \"https://www.suaempresa.com.br\",\n \"email\": \"[email protected]\",\n \"receberEmailBoleto\": true,\n \"paisExterior\": true,\n \"codigoDoPais\": 123,\n \"idExterior\": \"<string>\",\n \"observacao\": \"<string>\",\n \"observacaoFinanceiro\": \"<string>\",\n \"textoLivre\": \"<string>\",\n \"codigoDoRegimeTributario\": 123,\n \"contatoFinanceiro\": \"<string>\",\n \"emailContatoFinanceiro\": \"<string>\",\n \"telefoneFinanceiro\": \"<string>\",\n \"emailsFinanceiro\": [\n \"<string>\"\n ],\n \"contatoFaturamento\": \"<string>\",\n \"emailContatoFaturamento\": \"<string>\",\n \"telefoneFaturamento\": \"<string>\",\n \"aliquotaISSRetidoFaturamento\": 123,\n \"idClienteWS\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gestio.com.br/v2/cliente")
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 \"nomeComercial\": \"Comercial Alfa\",\n \"razaoSocial\": \"Comercial Alfa Distribuidora Ltda\",\n \"natureza\": \"J\",\n \"seuCodigo\": \"<string>\",\n \"cnpj\": \"12345678000199\",\n \"cpf\": \"12345678909\",\n \"inscricaoEstadual\": \"<string>\",\n \"inscricaoMunicipal\": \"<string>\",\n \"indicadorContribuinte\": \"<string>\",\n \"codigoDoTipoDeCliente\": 123,\n \"codigoDoGrupoDeCliente\": 123,\n \"codigoDaClassificacaoAuxiliar\": 123,\n \"codigoDoSegmento\": \"<string>\",\n \"idRamoDeAtividade\": 123,\n \"codigoDoVendedor\": 123,\n \"codigoDaCategoria\": 123,\n \"codigoDaSituacaoFinanceira\": 123,\n \"endereco\": {\n \"cep\": \"01311000\",\n \"logradouro\": \"Av. Paulista\",\n \"numero\": \"1578\",\n \"complemento\": \"Conjunto 41\",\n \"bairro\": \"Bela Vista\",\n \"cidade\": \"São Paulo\",\n \"uf\": \"SP\",\n \"codigoDoMunicipio\": \"3550308\"\n },\n \"telefone\": \"(11) 4002-8922\",\n \"site\": \"https://www.suaempresa.com.br\",\n \"email\": \"[email protected]\",\n \"receberEmailBoleto\": true,\n \"paisExterior\": true,\n \"codigoDoPais\": 123,\n \"idExterior\": \"<string>\",\n \"observacao\": \"<string>\",\n \"observacaoFinanceiro\": \"<string>\",\n \"textoLivre\": \"<string>\",\n \"codigoDoRegimeTributario\": 123,\n \"contatoFinanceiro\": \"<string>\",\n \"emailContatoFinanceiro\": \"<string>\",\n \"telefoneFinanceiro\": \"<string>\",\n \"emailsFinanceiro\": [\n \"<string>\"\n ],\n \"contatoFaturamento\": \"<string>\",\n \"emailContatoFaturamento\": \"<string>\",\n \"telefoneFaturamento\": \"<string>\",\n \"aliquotaISSRetidoFaturamento\": 123,\n \"idClienteWS\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"nomeComercial": "Comercial Alfa",
"codigoDoCliente": 1023,
"razaoSocial": "Comercial Alfa Distribuidora Ltda",
"natureza": "J",
"seuCodigo": "<string>",
"cnpjcpf": "<string>",
"cnpj": "12345678000199",
"cpf": "12345678909",
"inscricaoEstadual": "<string>",
"inscricaoMunicipal": "<string>",
"indicadorContribuinte": "<string>",
"codigoDoTipoDeCliente": 123,
"descricaoDoTipoDeCliente": "<string>",
"codigoDoGrupoDeCliente": 123,
"codigoDaClassificacaoAuxiliar": 123,
"descricaoDoGrupoDeCliente": "<string>",
"codigoDoSegmento": "<string>",
"idRamoDeAtividade": 123,
"descricaoDoSegmento": "<string>",
"codigoDoVendedor": 123,
"descricaoDoVendedor": "<string>",
"codigoDaCategoria": 123,
"codigoDaSituacaoFinanceira": 123,
"descricaoDaCategoria": "<string>",
"descricaoDaSituacaoFinanceira": "<string>",
"endereco": {
"cep": "01311000",
"logradouro": "Av. Paulista",
"numero": "1578",
"complemento": "Conjunto 41",
"bairro": "Bela Vista",
"cidade": "São Paulo",
"uf": "SP",
"codigoDoMunicipio": "3550308"
},
"telefone": "(11) 4002-8922",
"site": "https://www.suaempresa.com.br",
"email": "[email protected]",
"receberEmailBoleto": true,
"paisExterior": true,
"codigoDoPais": 123,
"idExterior": "<string>",
"observacao": "<string>",
"observacaoFinanceiro": "<string>",
"textoLivre": "<string>",
"codigoDoRegimeTributario": 123,
"descricaoDoRegimeTributario": "<string>",
"contatoFinanceiro": "<string>",
"emailContatoFinanceiro": "<string>",
"telefoneFinanceiro": "<string>",
"emailsFinanceiro": [
"<string>"
],
"contatoFaturamento": "<string>",
"emailContatoFaturamento": "<string>",
"telefoneFaturamento": "<string>",
"aliquotaISSRetidoFaturamento": 123,
"dataDeCadastro": "2023-11-07T05:31:56Z",
"ativo": true,
"podeAtivar": true,
"podeDesativar": true,
"idClienteWS": "<string>",
"ultimaAtualizacao": "<string>",
"contatos": [
{
"codigoDoCliente": 1023,
"seqContato": 1,
"nomeDoContato": "Ana Beatriz Ferreira",
"nomeAbreviado": "Ana Ferreira",
"departamento": "Financeiro",
"telefone": "(11) 4002-8922",
"celular": "(11) 98877-6655",
"email": "[email protected]",
"observacao": "<string>",
"ativo": true
}
],
"podeEditar": true,
"nomeComercialFmt": "<string>"
}
}{
"success": false,
"errors": [
{
"key": "<string>",
"value": "<string>",
"dateOccurred": "2023-11-07T05:31:56Z"
}
]
}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
Cliente. Utilizado tanto como body de inclusão/alteração quanto como retorno das rotas de consulta.
Nome/razão social de exibição do cliente. Obrigatório.
Example:
"Comercial Alfa"
Example:
"Comercial Alfa Distribuidora Ltda"
Natureza jurídica: J (Pessoa Jurídica) ou F (Pessoa Física). Padrão: J.
Available options:
J, F Código auxiliar/externo do cliente no sistema de origem.
Obrigatório informar cnpj quando natureza = J e se desejar CNPJ/CPF preenchido; formato validado quando informado.
Example:
"12345678000199"
Formato validado quando informado (natureza F).
Example:
"12345678909"
Endereço utilizado pelos cadastros de Cliente e Filial.
Show child attributes
Show child attributes
Example:
"(11) 4002-8922"
Example:
"https://www.suaempresa.com.br"
Formato validado quando informado.
Example:
Indica se o cliente está localizado no exterior.
Formato validado quando informado.
Formato validado quando informado.
Identificador externo do cliente, usado para integração.