# **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.

1. Clique no ícone de engrenagem (Configurações), no canto superior direito.

2. Vá em **Usuários**.

3. Clique em **Cadastrar**.

![](https://chat.zapisp.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNndrQVE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--3776fadfaf4825dabe0ebca7bfba5d321f4cf0d9/mk%201.png)

### **1.1. Dados obrigatórios**

| Campo           | Valor a preencher      |
| --------------- | ---------------------- |
| Login           | zapisp                 |
| Nome do usuário | ZapISP                 |
| Senha           | Definida pelo provedor |
| E-mail          | 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

![](https://chat.zapisp.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBN0FrQVE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--88662439168bd8bdac56a35e043ac973295028e7/image.png)

### **1.3. Grupo de administrador e token**

1. Clique no ícone de **Salvar**.

2. Na mesma janela, clique em **Grupos aos quais pertence**.

![](https://chat.zapisp.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBN0lrQVE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--c76d3ff6c754dcffec94ec7e4dc5cf3cb57208a4/image.png)

1. Clique no botão **+** e selecione o **grupo de administrador**.

2. Clique em **Salvar** novamente.

![](https://chat.zapisp.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBN1VrQVE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--3dea9f4828497d9213cf8ad41b3e573327e9009c/image.png)

\
**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.

1. No menu superior, clique em **Integradores**.

2. No menu lateral, selecione **Gerenciador de Webservices**.

![](https://chat.zapisp.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBN1lrQVE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--9b706c56d4ba26d4ff64965247ad9e1955f32217/image.png)

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

![](https://chat.zapisp.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBN2NrQVE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--37bd1ce5c0a90eb4931376faf3c2a3cd467df903/image.png)

### **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**

1. Clique em **Avançar** (ícone de seta).

2. Na tela Definição de perfil, encontre o operador **zapisp** na lista Operadores disponíveis e mova para Operadores selecionados.

3. Atribua **todas as permissões** ao operador zapisp.

4. Clique em **Salvar**.

![](https://chat.zapisp.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBN2drQVE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--9ec4c009f8ba159ae5dab040faaf89d46d6d93d9/image.png)

## **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.

1. No ZapISP, abra a integração **Mksolutions** e vá na aba **Configurações**.

2. 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.

![](https://chat.zapisp.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBN29rQVE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--b0898f56262ee9374fcaa775ccd7a9c0e87933c3/image.png)

1. 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


