Cada registro dessa entidade contém uma regra que define se um usuário possui ou não acesso a um cliente armazenado no Mercos. O conjunto dessas regras será utilizado para obter a carteira de clientes de cada usuário dentro do Mercos.
Por padrão os clientes cadastrados via integração estão bloqueados para todos os usuários com a opção "Limitar acesso aos clientes" selecionada, sendo necessário fazer um POST nesta entidade criando liberações destes clientes para os respectivos usuários.
Novos usuários cadastrados na interface da Mercos com a opção "Limitar acesso aos clientes" não tem liberação de acesso para nenhum cliente, sendo necessário fazer um POST nesta entidade criando liberações deste usuário para os respectivos clientes.
Caso seja feito um POST criando uma regra de liberação para um usuário com a opção "Acessar todos os Clientes" selecionada, este usuário será automaticamente alterado para a opção “Limitar acesso aos clientes” e a nova regra de liberação será cadastrada.
Por padrão clientes cadastrados pela interface do sistema Mercos estão liberados para o usuário que cadastrou estes clientes, mesmo que o usuário esteja com a opção "Limitar acesso aos clientes" selecionada. Caso seja feito um POST bloqueando um cliente para o usuário que o cadastrou, o sistema irá respeitar este bloqueio.
Não é possível fazer um bloqueio de cliente para um usuário administrador.
Ao atualizar as liberações de clientes para os usuários, não é recomendado enviar POSTs de bloqueio de todos os clientes para todos os usuários e depois enviar as novas liberações, este procedimento seria muito lento e poderia causar problemas na base do cliente e o bloqueio da integração pela Mercos. A forma correta é efetuar primeiro um GET de todos os registros desta entidade e comparar este retorno com as novas permissões definidas no ERP realizando POSTs apenas para os casos de divergência nas liberações.
Estrutura da Resposta (GET)
| Campo | Tipo | Descrição |
|---|---|---|
| cliente_id | Integer | Identificador único do Cliente da Mercos. |
| usuario_id | Integer | Identificador único do Usuário da Mercos. |
| liberado | Boolean | Representa se o Usuário tem acesso ao Cliente. |
| ultima_alteracao | DateTime | Data e hora da última modificação desta categoria no Mercos. |
Parâmetros de Envio (POST)
Importante: Para remover um usuário de um cliente é necessário enviar uma requisição com o campo "liberado": false.
| Campo | Tipo | Descrição |
|---|---|---|
| cliente_id | Integer | Identificador único do Cliente da Mercos. |
| usuario_id | Integer | Identificador único do Usuário da Mercos. |
| liberado | Boolean | Representa se o Usuário tem acesso ao Cliente. |