`UpsertCliente`altera dados

Realiza o UPSERT da tabela de clientes (INCLUSÃO/ALTERAÇÃO).

Identificação

Operação	`geral/clientes:UpsertCliente`
Serviço	ClientesCadastro
Módulo	Geral
Endpoint	`/api/v1/geral/clientes/`

Parâmetros

Campo	Tipo	Descrição
`bairro`	string	Bairro 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".
`bloqueado`	string	DEPRECATED
`bloquear_exclusao`	string	Bloqueia a exclusão do registro. (S/N)
`bloquear_faturamento`	string	Bloquear o faturamento para o cliente (S/N). Preenchimento opcional.
`caracteristicas`	lista de object	Características do cliente.
`cep`	string	CEP 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".
`cidade`	string	Có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_ibge`	string	Có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.
`cnae`	lista de string	Có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_cpf`	string	CNPJ / CPF Preenchimento Obrigatório para emissão de NF-e/NFS-e.
`codigo_cliente_integracao`	string	Código de Integração com sistemas legados.
`codigo_cliente_omie`	integer	Código de Cliente / Fornecedor
`codigo_pais`	string	Có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.
`complemento`	string	Complemento 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.
`contato`	string	Nome para contato Preenchimento Opcional. DEPRECATED para a estrutura "clientesFiltrar".
`contribuinte`	string	Indica 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.
`dadosBancarios`	object	Dados Bancários do cliente.
`documento_exterior`	string	Documento no exterior para clientes estrangeiros.
`email`	string	E-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".
`endereco`	string	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. DEPRECATED para a estrutura "clientesFiltrar".
`enderecoEntrega`	object	Dados do Endereço de Entrega.
`endereco_numero`	string	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.
`enviar_anexos`	string	Enviar 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.
`estado`	string	Sigla 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".
`exterior`	lista de string	Indica que é um tomador de serviço localizado no exterior Preenchimento automático - Não informar. Informar "S" ou "N".
`fax_ddd`	string	DDD Fax Preenchimento Opcional. Informação localizada na Aba "Telefones e E-mail" do cadastro do Cliente.
`fax_numero`	string	Fax Preenchimento Opcional. Informação localizada na Aba "Telefones e E-mail" do cadastro do Cliente.
`homepage`	string	WebSite Preenchimento Opcional. Informação localizada na Aba "Telefones e E-mail" do cadastro do Cliente. DEPRECATED para a estrutura "clientesFiltrar".
`importado_api`	string	DEPRECATED
`inativo`	string	Indica se o cliente está inativo [S/N]
`info`	lista de object	Informações sobre o cadastro do cliente.
`inscricao_estadual`	string	Inscrição Estadual Preenchimento Opcional. Informação localizada na Aba "Inscrições CNAE e Outros" do cadastro do Cliente. DEPRECATED para a estrutura "clientesFiltrar".
`inscricao_municipal`	string	Inscrição Municipal Preenchimento Opcional. Informação localizada na Aba "Inscrições CNAE e Outros" do cadastro do Cliente. DEPRECATED para a estrutura "clientesFiltrar".
`inscricao_suframa`	string	Inscrição Suframa Preenchimento Opcional. Informação localizada na Aba "Inscrições CNAE e Outros" do cadastro do Cliente. DEPRECATED para a estrutura "clientesFiltrar".
`logradouro`	string	DEPRECATED
`nif`	string	NIF - Número de Identificação Fiscal. Apenas para estrangeiros.
`nome_fantasia`	string	Nome Fantasia Preenchimento Obrigatório para emissão de NF-e/NFS-e.
`obs_detalhadas`	string	Observações Detalhadas. Preenchimento Opcional. Informação localizada na Aba "Inscrições CNAE e Outros" do cadastro do Cliente.
`observacao`	string	Observações Internas Preenchimento Opcional. Informação localizada na Aba "Inscrições CNAE e Outros" do cadastro do Cliente.
`optante_simples_nacional`	string	Indica 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_cep`	string	Pesquisar 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_fisica`	lista de string	Indica 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_rural`	lista de string	Indica 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_social`	string	Razão Social Preenchimento Obrigatório.
`recomendacao_atraso`	lista de string	Código da Instrução de Protesto Preenchimento Opcional. Informação localizada na Aba "Recomendações" do cadastro do Cliente.
`recomendacoes`	object	Recomendações do cliente.
`separar_endereco`	string	Separar 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.
`tags`	lista de object	Tags do Cliente ou Fornecedor Preenchimento Opcional.
`telefone1_ddd`	string	DDD Telefone Preenchimento Opcional.
`telefone1_numero`	string	Telefone para Contato Preenchimento Opcional.
`telefone2_ddd`	string	DDD Telefone 2 Preenchimento Opcional. Informação localizada na Aba "Telefones e E-mail" do cadastro do Cliente.
`telefone2_numero`	string	Telefone 2 Preenchimento Opcional. Informação localizada na Aba "Telefones e E-mail" do cadastro do Cliente.
`tipo_atividade`	lista de string	Tipo 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_credito`	number	Valor 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

UpsertClientealtera dados

Identificação

Parâmetros

Exemplo de chamada

`UpsertCliente`altera dados