OmieapiDocumentaçãoOperações
← Referência das operações

AlterarClientealtera dados

Altera os dados do cliente

Identificação

Operaçãogeral/clientes:AlterarCliente
ServiçoClientesCadastro
MóduloGeral
Endpoint/api/v1/geral/clientes/

Como as pessoas pedem isso

alterar cliente

Parâmetros

CampoTipoDescrição
bairrostringBairro Preenchimento Opcional. Preenchimento Obrigatório para emissão de NF-e/NFS-e. Informação localizada na Aba "Endereço" do cadastro do Cliente. DEPRECATED para a estrutura "clientesFiltrar".
bloqueadostringDEPRECATED
bloquear_exclusaostringBloqueia a exclusão do registro. (S/N)
bloquear_faturamentostringBloquear o faturamento para o cliente (S/N). Preenchimento opcional.
caracteristicaslista de objectCaracterísticas do cliente.
cepstringCEP Preenchimento Opcional. Preenchimento Obrigatório para emissão de NF-e/NFS-e. Informação localizada na Aba "Endereço" do cadastro do Cliente. DEPRECATED para a estrutura "clientesFiltrar".
cidadestringCódigo da Cidade Recebe o código ibge ou o nome da cidade. Preenchimento Opcional caso seja enviado o codigo IBGE no campo "cidade_ibge" Informação localizada na Aba "Endereço" do cadastro do Cliente. Utilize a tag "nCodIBGE" do método "PesquisarCidades" da API /api/v1/geral/cidades/ para obter essa informação. Utilize a tag "cCod" do método "PesquisarCidades" da API /api/v1/geral/cidades/ para obter essa informação. DEPRECATED para a estrutura "clientesFiltrar".
cidade_ibgestringCódigo do IBGE para a Cidade. Preenchimento Opcional caso seja enviado o nome da cidade no campo "cidade" Utilize a tag "nCodIBGE" do método "PesquisarCidades" da API /api/v1/geral/cidades/ para obter essa informação.
cnaelista de stringCódigo do CNAE - Fiscal Preenchimento Opcional. Informação localizada na Aba "Inscrições CNAE e Outros" do cadastro do Cliente. Utilize a tag "nCodigo" do método "ListarCNAE" da API http://app.omie.com.br/api/v1/produtos/cnae/ para obter essa informação.
cnpj_cpfstringCNPJ / CPF Preenchimento Obrigatório para emissão de NF-e/NFS-e.
codigo_cliente_integracaostringCódigo de Integração com sistemas legados.
codigo_cliente_omieintegerCódigo de Cliente / Fornecedor
codigo_paisstringCódigo do País Preenchimento Opcional. Preenchimento Obrigatório para emissão de NF-e/NFS-e. Informação localizada na Aba "Endereço" do cadastro do Cliente. Utilize as tags "cCodigo","cDescricao" ou "cCodigoISO" do método "ListarPaises" da API http://app.omie.com.br/api/v1/geral/paises/ para obter essa informação.
complementostringComplemento para o Número do Endereço Preenchimento Opcional. Preenchimento Obrigatório para emissão de NF-e/NFS-e. Informação localizada na Aba "Endereço" do cadastro do Cliente.
contatostringNome para contato Preenchimento Opcional. DEPRECATED para a estrutura "clientesFiltrar".
contribuintestringIndica se o cliente é contribuinte (S/N). Preenchimento Opcional. Preenchimento Obrigatório para emissão de NF-e/NFS-e. Informar "S" ou "N". Informação localizada na Aba "Inscrições CNAE e Outros" do cadastro do Cliente.
dadosBancariosobjectDados Bancários do cliente.
documento_exteriorstringDocumento no exterior para clientes estrangeiros.
emailstringE-Mail Preenchimento Opcional. Preenchimento Obrigatório para emissão de NF-e/NFS-e. Informação localizada na Aba "Telefones e E-mail" do cadastro do Cliente. DEPRECATED para a estrutura "clientesFiltrar".
enderecostringEndereço Preenchimento Opcional. Preenchimento Obrigatório para emissão de NF-e/NFS-e. Informação localizada na Aba "Endereço" do cadastro do Cliente. DEPRECATED para a estrutura "clientesFiltrar".
enderecoEntregaobjectDados do Endereço de Entrega.
endereco_numerostringNúmero do Endereço Preenchimento Opcional. Preenchimento Obrigatório para emissão de NF-e/NFS-e. Informação localizada na Aba "Endereço" do cadastro do Cliente.
enviar_anexosstringEnviar anexos por e-mail (S/N). Valores possíveis S ou N, sendo N o padrão. Enviar anexos por e-mail além do link para o Portal Omie para o cliente cadastrado. Esta função só poderá ser utilizada se o Portal Omie estiver ativo.
estadostringSigla do Estado Preenchimento Opcional. Preenchimento Obrigatório para emissão de NF-e/NFS-e. Informação localizada na Aba "Endereço" do cadastro do Cliente. Utilize a tag "cSigla" do método "ListarEstados" da API http://app.omie.com.br/api/v1/geral/estados/ para obter essa informação. DEPRECATED para a estrutura "clientesFiltro".
exteriorlista de stringIndica que é um tomador de serviço localizado no exterior Preenchimento automático - Não informar. Informar "S" ou "N".
fax_dddstringDDD Fax Preenchimento Opcional. Informação localizada na Aba "Telefones e E-mail" do cadastro do Cliente.
fax_numerostringFax Preenchimento Opcional. Informação localizada na Aba "Telefones e E-mail" do cadastro do Cliente.
homepagestringWebSite Preenchimento Opcional. Informação localizada na Aba "Telefones e E-mail" do cadastro do Cliente. DEPRECATED para a estrutura "clientesFiltrar".
importado_apistringDEPRECATED
inativostringIndica se o cliente está inativo [S/N]
infolista de objectInformações sobre o cadastro do cliente.
inscricao_estadualstringInscrição Estadual Preenchimento Opcional. Informação localizada na Aba "Inscrições CNAE e Outros" do cadastro do Cliente. DEPRECATED para a estrutura "clientesFiltrar".
inscricao_municipalstringInscrição Municipal Preenchimento Opcional. Informação localizada na Aba "Inscrições CNAE e Outros" do cadastro do Cliente. DEPRECATED para a estrutura "clientesFiltrar".
inscricao_suframastringInscrição Suframa Preenchimento Opcional. Informação localizada na Aba "Inscrições CNAE e Outros" do cadastro do Cliente. DEPRECATED para a estrutura "clientesFiltrar".
logradourostringDEPRECATED
nifstringNIF - Número de Identificação Fiscal. Apenas para estrangeiros.
nome_fantasiastringNome Fantasia Preenchimento Obrigatório para emissão de NF-e/NFS-e.
obs_detalhadasstringObservações Detalhadas. Preenchimento Opcional. Informação localizada na Aba "Inscrições CNAE e Outros" do cadastro do Cliente.
observacaostringObservações Internas Preenchimento Opcional. Informação localizada na Aba "Inscrições CNAE e Outros" do cadastro do Cliente.
optante_simples_nacionalstringIndica se o Cliente / Fornecedor é Optante do Simples Nacional Preenchimento Opcional. Preenchimento Obrigatório para emissão de NF-e/NFS-e. Informar "S" ou "N". Informação localizada na Aba "Inscrições CNAE e Outros" do cadastro do Cliente. DEPRECATED para a estrutura "clientesFiltrar".
pesquisar_cepstringPesquisar CEP. Valores possível S ou N, sendo N o padrão. Quando igual a S o sistema irá preencher os campos do endereço que estiverem vazios (logradouro, bairro e cidade) conforme os dados do CEP
pessoa_fisicalista de stringIndica se o cadastro é Pessoa Física. Preenchimento automático - Não informar. Essa tag é funcional apenas no retorno dos métodos de consulta e listagem. DEPRECATED para a estrutura "clientesFiltro" e métodos de inclusão/alteração
produtor_rurallista de stringIndica se o Cliente / Fornecedor é um Produtor Rural Preenchimento Opcional. Informar "S" ou "N". Informação localizada na Aba "Inscrições CNAE e Outros" do cadastro do Cliente.
razao_socialstringRazão Social Preenchimento Obrigatório.
recomendacao_atrasolista de stringCódigo da Instrução de Protesto Preenchimento Opcional. Informação localizada na Aba "Recomendações" do cadastro do Cliente.
recomendacoesobjectRecomendações do cliente.
separar_enderecostringSeparar endereço. Valores possível S ou N, sendo N o padrão. Quando igual S separa do endereço o número o e complemento, caso existirem.
tagslista de objectTags do Cliente ou Fornecedor Preenchimento Opcional.
telefone1_dddstringDDD Telefone Preenchimento Opcional.
telefone1_numerostringTelefone para Contato Preenchimento Opcional.
telefone2_dddstringDDD Telefone 2 Preenchimento Opcional. Informação localizada na Aba "Telefones e E-mail" do cadastro do Cliente.
telefone2_numerostringTelefone 2 Preenchimento Opcional. Informação localizada na Aba "Telefones e E-mail" do cadastro do Cliente.
tipo_atividadelista de stringTipo da Atividade Preenchimento Opcional. Informação localizada na Aba "Inscrições CNAE e Outros" do cadastro do Cliente. Utilize a tag "cCodigo" do método "ListarTipoAtiv" da API http://app.omie.com.br/api/v1/geral/tpativ/ para obter essa informação.
valor_limite_creditonumberValor do Limite de Crédito Total. Preenchimento opcional.

Exemplo de chamada

{
  "codigo_cliente_integracao": "CodigoInterno0001",
  "email": "primeiro@ccliente.com.br",
  "razao_social": "Primeiro Cliente  Ltda Me",
  "nome_fantasia": "Primeiro Cliente"
}
Esta operação altera dados de verdade, na hora. Não existe ambiente de ensaio neste endereço.
api.omie.com.br/mcp · Documentação · Operações