Criar contato

Cria um contato no ERP Bling através da API V3.

Parâmetros

Campo	Tipo	Descrição
Descrição	Campo de texto	Descrição visual do conector no editor de fluxo.
Conta de serviço	Seletor	Permite selecionar a conta de serviço para conexão com ERP Bling. A conta de serviço deverá ser do tipo de autenticação OAuth2 e tipo de serviço Bling.
ID da conta de serviço	Campo de texto	Configuração disponível quando selecionada a opção de conta de serviço personalizada. Permite inserir o identificador da conta de serviço Bling. Pode ser usado para aplicar valores dinâmicos utilizando a notação Mustache {{msg}}.
Nome	Campo de texto	Nome do contato a ser cadastrado no ERP.
Código	Campo de texto	Código do contato a ser cadastrado no ERP.
Situação do contato	Campo de texto	Situação do contato: A - Ativo E - Excluído I - Inativo S - Sem movimentação
Número do documento	Campo de texto	Número de CPF ou CNPJ do contato.
Telefone	Campo de texto	Telefone do contato.
Celular	Campo de texto	Celular do contato.
Nome fantasia	Campo de texto	Nome fantasia do contato.
Tipo de pessoa	Campo de texto	Tipo de pessoa do contato: F - Física J - Jurídica E - Estrangeiro
Indicador de inscrição estadual	Campo de texto	Número de indicações de inscrição estadual: 1 - Contribuinte ICMS 2 - Contribuinte isento de inscrição 9 - Não contribuinte
Inscrição estadual	Campo de texto	Inscrição estadual do contato.
RG	Campo de texto	RG do contato, caso seja do tipo Pessoa Física.
Órgão emissor do RG	Campo de texto	Órgão emissor do RG do contato, caso seja do tipo Pessoa Física.
E-mail	Campo de texto	E-mail do contato.
Rua do endereço geral	Campo de texto	Nome da rua do contato para cadastro do endereço geral.
CEP do endereço geral	Campo de texto	CEP do contato para cadastro do endereço geral.
Bairro do endereço geral	Campo de texto	Bairro do contato para cadastro do endereço geral.
Município do endereço geral	Campo de texto	Município do contato para cadastro do endereço geral.
UF do endereço geral	Campo de texto	UF do contato para cadastro do endereço geral.
Número do endereço geral	Campo de texto	Número do endereço do contato para cadastro do endereço geral.
Complemento do endereço geral	Campo de texto	Complemento do endereço do contato para cadastro do endereço geral.
Rua do endereço de cobrança	Campo de texto	Rua do contato para cadastro do endereço de cobrança.
CEP do endereço de cobrança	Campo de texto	CEP do contato para cadastro do endereço de cobrança.
Bairro do endereço de cobrança	Campo de texto	Bairro do contato para cadastro do endereço de cobrança.
Município do endereço de cobrança	Campo de texto	Município do contato para cadastro do endereço de cobrança.
UF do endereço de cobrança	Campo de texto	UF do contato para cadastro do endereço de cobrança.
Número do endereço de cobrança	Campo de texto	Número do endereço do contato para cadastro do endereço de cobrança.
Complemento do endereço de cobrança	Campo de texto	Complemento do endereço do contato para cadastro do endereço de cobrança.
ID do vendedor	Campo de texto	Identificador do vendedor cadastrado no ERP Bling.
Data de nascimento	Campo de texto	Data de nascimento do contato. Utilizar o formato YYYY- MM-DD. exemplo: 2021-12-31
Sexo	Campo de texto	Sexo do contao: M - Masculino F - Feminino
Naturalidade	Campo de texto	Naturalidade do contato. Exemplo: Brasileira.
Limite de crédito do cliente	Campo de texto	Limite de crédito do contato.
Condição de pagamento	Campo de texto	Condição de pagamento do contato. Em número de parcelas ou prazos.
Categoria financeira do cliente	Campo de texto	Identificador da categoria financeira. O identificador pode ser obtido no ERP Bling.
País	Campo de texto	País do contato. Exemplo: Brasil.
Array com tipos de contato	Campo de texto	Caminho do array, dentro do objeto message, que contém os tipos de contato.
ID do tipo de contato	Campo de texto	Identificador do tipo de contato. O identificador pode ser obtido no ERP Bling
Descrição do tipo de contato	Campo de texto	Descrição do tipo de contato.
Array com pessoas de contato	Campo de texto	Caminho do array, dentro do objeto message, que contém os tipos de contato.
ID da pessoa de contato	Campo de texto	Identificador da pessoa de contato. O identificador pode ser obtido no ERP Bling
Descrição da pessoa de contato	Campo de texto	Descrição da pessoa de contato.
Output Path	Campo de texto	Refere-se ao caminho do resultado da execução na saída do conector no contexto de execução do fluxo

Payload

Sucesso

A requisição deste conector é feita para a API V3 na rota POST /contatos permitindo a criação de um contato no ERP Bling. A documentação oficial pode ser acessada em Bling Developer.

Quando a execução ocorre com sucesso, o identificador do contato criado no ERP será retornado na carga de dados do conector. Além disso, a resposta incluirá informações adicionais da requisição nos objetos request e response.

Sucesso na criação de contato no ERP.

Erro

Em cenários de erro será retornado os dados da requisição, a response e a mensagem de erro mapeada na API. Segue exemplo de erro de quando contato não é cadastrado corretamente.

Erro na criação

Configuração de array

Nos campos de configuração de Array deve-se informar o caminho da lista de dados, no exemplo é msg.contacts. Nos campos seguintes os dados de cada produto dentro da lista podem ser informado utilizando a notação {{$.chaveObjeto}}. No exemplo, a notação {{$.id}} acessa o valor de id dentro de cada contato da lista, ou seja, acessa msg.contacts[i].i onde [i] serão as iterações de acordo com o tamanho da lista. O mesmo se aplica para {{$.description}}. Desta forma é possível informar de forma dinâmica os dados que serão cadastrados no contato.

Configuração de array