Manual de Integração: MK Solutions e ZapISP
A integração liga o ERP MK Solutions à plataforma ZapISP em três etapas: criar um usuário administrador no MK, liberar um perfil de Web Service para esse usuário e cadastrar as credenciais no ZapISP. Tenha em mãos acesso de administrador ao MK Solutions e à plataforma ZapISP.
1. Criação do usuário administrador no MK Solutions
Crie no MK Solutions um usuário com perfil de administrador, dedicado só à integração.
-
Clique no ícone de engrenagem (Configurações), no canto superior direito.
-
Vá em Usuários.
-
Clique em Cadastrar.

1.1. Dados obrigatórios
| Campo | Valor a preencher |
|---|---|
| Login | zapisp |
| Nome do usuário | ZapISP |
| Senha | Definida pelo provedor |
| Definido pelo provedor |
1.2. Permissões
| Permissão | Seleção |
|---|---|
| Administrador Geral | Sim |
| Administrador SAC | Não |
| Setor principal | Administrativo |
Na parte inferior da tela, na linha do sistema MK Solutions, marque as três opções:
-
Acessar
-
Administrador
-
Acesso Externo

1.3. Grupo de administrador e token
-
Clique no ícone de Salvar.
-
Na mesma janela, clique em Grupos aos quais pertence.

-
Clique no botão + e selecione o grupo de administrador.
-
Clique em Salvar novamente.

Importante: ao salvar, o MK gera automaticamente o Token de Acesso do usuário, exibido no campo de mesmo nome. Copie e guarde esse token, ele será usado no passo 3.
2. Configuração do perfil de Web Service
O perfil de Web Service libera o acesso via API para o usuário criado no passo 1.
-
No menu superior, clique em Integradores.
-
No menu lateral, selecione Gerenciador de Webservices.

- Clique no botão + (Adicionar), no canto inferior direito. Abre o formulário Definição de perfil de webservices.

2.1. Dados do perfil e contra-senha
| Campo | Preenchimento |
|---|---|
| Descrição identificativa do perfil | Zapisp |
| Contra-senha | Anote a senha gerada automaticamente ou defina uma nova |
Atenção: anote a contra-senha. Sem ela não é possível concluir a conexão entre o MK Solutions e o ZapISP.
2.2. Permissões do operador
-
Clique em Avançar (ícone de seta).
-
Na tela Definição de perfil, encontre o operador zapisp na lista Operadores disponíveis e mova para Operadores selecionados.
-
Atribua todas as permissões ao operador zapisp.
-
Clique em Salvar.

3. Conexão na plataforma ZapISP
Com o token e a contra-senha em mãos, cadastre as credenciais no ZapISP para ativar a integração.
-
No ZapISP, abra a integração Mksolutions e vá na aba Configurações.
-
Preencha os campos conforme a tabela.
| Campo no ZapISP | O que inserir |
|---|---|
| Host | URL do seu MK Solutions, sem o /MK/ do final |
| Token | Token de Acesso do usuário zapisp (passo 1.3) |
| Senha do Token | Contra-senha do perfil de Web Service (passo 2.1) |
| Login | O mesmo login criado no MK (zapisp) |
Campo Empresa: preencha com o nome da empresa somente se o provedor tiver mais de uma filial cadastrada no MK Solutions. Caso contrário, deixe em branco.

- Clique em Ativar para concluir a integração.
Checklist final
Confira cada item antes de dar a integração como concluída.
-
☐ Usuário zapisp criado com os dados e permissões de administrador
-
☐ Usuário incluído no grupo de administrador
-
☐ Token de Acesso copiado e guardado
-
☐ Perfil de Web Service criado com a descrição Zapisp
-
☐ Contra-senha do Web Service anotada
-
☐ Todas as permissões do Web Service concedidas ao operador zapisp
-
☐ Host cadastrado no ZapISP sem o /MK/ do final
-
☐ Token, Senha do Token e Login preenchidos no ZapISP e integração ativada