API - Clientes - ENTRADA

Entrada de clientes

Entrada de clientes para o isoCRM.

Com o token de sessão obtido na autenticação, poderá fazer a seguinte chamada ao webservice REST para o envio das informações do cadastro de clientes para o isoCRM.

Tabelas importação via Excel


Campos obrigatórios

Importação de pessoa

Entrada-Clientes-Pessoa.xlsx

Importação de organização

Entrada-Clientes-Organizacao.xlsx

Regras para o envio de cadastro de cliente

Poderá ser enviado mais de um cliente para ser processado na integração. Quado houver alguma inconsistência nas informações será retornado um conjunto de mensagens de crítica.

Para a identificação do cliente os campos de CPF ou CNPJ, código externo do cliente, origem da informação, identificação se o cliente é estrangeiro e o tipo do cliente são obrigatórios. Caso uma dessas informações não estejam preenchidas esse cadastro não é integrado. 

São informações básicas referente ao cadastro do tipo "Pessoa".  Quando CPF estiver preenchido.

São informações básicas referente ao cadastro do tipo "Organização" .  Quando o CNPJ estiver preenchido.

São informações gerais do cadastro referente ao cliente.

Informações do cadastro CNAE para os clientes do tipo "Organização".

Relação de endereços do cliente. 

Caso encontre alguma diferença nas informações (CEP e nº) do cadastro a ser integrado com o cadastro do isoCRM, esse registro de entrada será inserido como um novo endereço. Esse procedimento é feito para manter a integridade das informações já existentes no cadastro do cliente.

Relação de telefones do cliente. 

Caso encontre alguma diferença nas informações (ddd, telefone e ramal) do cadastro a ser integrado com o do cadastro do isoCRM, esse registro de entrada será inserido como um novo telefone. Esse procedimento é feito para manter a integridade das informações já existentes no cadastro do cliente.

Relação de contatos eletrônicos do cliente. 

Caso encontre alguma diferença do econtact a ser integrado com algum já cadastrado no isoCRM, esse registro de entrada será inserido como um novo econtact. Esse procedimento é feito para manter a integridade das informações já existentes no cadastro do cliente.

São informações complementares para o cadastro do cliente.

Relação de responsáveis do cliente. Caso o registro não exista, será inserido um novo registro de responsável e será vinculado ao cliente.

Informação referente a categoria fiscal do cliente.  Sempre irá inserir um novo registro e o existe será inativado.

Caso não exista o código da categoria fiscal cadastrada no isoCRM, será inserido um novo código no cadastro básico referente a essa categoria fiscal. (Ver integração de dados fiscais).

Informação referente ao cadastro da tabela de venda do cliente vinculado a um local de faturamento e armazém. A chave da tabela de venda é a mesma do cadastro de tabela de venda lista do produto. Ver integração de entrada de produtos.

No parâmetro de mensagens serão retornar as críticas, caso ocorra erro no cadastro das informações, com as inconsistências de cada item.

Controle de acesso ao web service. Irá retornar "True" caso tenha autoridade para acessar esse web service, senão irá retornar "False". 

Requisição

Request URL: https://[servidor]/[aplicacao_isoCRM]/rest/WSISOInt_EntradaCliente

Request Method: POST

Campos de entrada

A entrada deverá ser enviado no formato REST - JSON. 

Especificação dos campos de entrada

Mensagens de retorno