Escopo

O objetivo desta documentação é explicar os passos fundamentais para que seja possível consumir a API.


Objetivo

O objetivo principal de uma API é permitir a troca de informações entre diferentes sistemas de forma padronizada. Essa troca de informações dá origem ao que chamamos de integração. Dessa forma, a API permite que outros sistemas sejam integrados ao MOVERE.


Para dados técnicos da integração, verificar a base de conhecimento https://meajuda.moveresoftware.com/a/solutions/articles/27000069342


Liberação de acesso

Antes de tudo, é necessário liberar os usuários de cada um daqueles que utilizarão a API. Essa liberação pode ser feita através da rotina [R697 - Liberação de Rotina por Usuário], ou [R696 - Liberação de Rotina por Grupo de Usuários]. 

Importante: Todos os usuários que utilizarão a API, precisarão ter o direito [executar].



Swagger do MOVERE API


Para utilizar o MOVERE API, acesse nossa documentação onde explica como acessar o Swagger clicando aqui.



Recursos disponíveis


Consultas de marcas e modelos de captação


Para utilizar o recurso de consulta de marcas de captação e seus modelos o usuário precisará do direito [Consultar Marcas de Captação] habilitado na [R697 - Liberação de Rotina por Usuário], ou [R696 - Liberação de Rotina por Grupo de Usuários] referente a rotina [R1000 - Central de Integração] como o exemplo abaixo:



Consulta de Clientes


Para utilizar o recurso de consulta de clientes o usuário precisará do direito [Consultar Clientes] habilitado na [R697 - Liberação de Rotina por Usuário], ou [R696 - Liberação de Rotina por Grupo de Usuários] referente a rotina [R1000 - Central de Integração] como o exemplo abaixo:


Observações: Para uma melhor eficiência da sincronização de todas as informações referente a cliente, as consultas retornadas representam apenas cadastros modificados.


Geração de orçamento (Aberto)


Para utilizar o recurso de geração de orçamento, o usuário precisará do direito [Gerar Orçamento] habilitado na [R697 - Liberação de Rotina por Usuário], ou [R696 - Liberação de Rotina por Grupo de Usuários] referente a rotina [R1000 - Central de Integração] como o exemplo abaixo:


Nota: A rotina está preparada para gerar, também, orçamentos de reforma.


Importante: Para gerar orçamento, também é necessário configurar os parâmetros:

  1. P0460 - Entrada e Saída Padrão De Venda Simplificada (Na rotina [R29 - Parâmetros por empresa]);
  2. P0051 - Série Padrão Serviço (Na rotina [R33 - Parâmetros Por Estabelecimento])
  3. P0049 - Série Padrão Mercadoria (Na rotina [R33 - Parâmetros Por Estabelecimento])
  4. P1201 - Canal de vendas padrão para o aplicativo de venda externa  (Na rotina [R33 - Parâmetros Por Estabelecimento]), se a entrada/saída obrigar informar o canal de vendas;

Importante:

  1. Todos os itens de um orçamento de reforma devem gerar ordem de produção. Essa configuração pode ser feita na [R130 - Itens]
  2. Não será possível gerar orçamento se a condição de pagamento, o portador ou o vendedor não estiverem ativos;
  3. Não será possível gerar orçamento se o portador não for válido para uma condição de pagamento;
  4. Não será possível gerar orçamento, se o tipo de preço não for informado;
  5. A partir da versão v4.529 será possível enviar, através da API, links de anexos que ficarão disponíveis no direito "Imagem" da R419.


Consulta da Estrutura de Itens


Para utilizar o recurso de consulta da estrutura de itens o usuário precisará do direito [Consultar Estruturas de Itens] habilitado na [R697 - Liberação de Rotina por Usuário], ou [R696 - Liberação de Rotina por Grupo de Usuários] referente a rotina [R1000 - Central de Integração] como o exemplo abaixo:


Importante: Essa consulta irá retornar os dados de Linhas de itens, Famílias e também grupos de itens.



Consulta de Modalidades de Cobrança


Para utilizar o recurso de consulta de modalidades de cobrança o usuário precisará do direito [Consultar Modalidades de Cobrança] habilitado na [R697 - Liberação de Rotina por Usuário], ou [R696 - Liberação de Rotina por Grupo de Usuários] referente a rotina [R1000 - Central de Integração] como o exemplo abaixo:


Consulta de Estoque de Itens por Estabelecimento


Para utilizar o recurso de consulta de estoque de itens por estabelecimento o usuário precisará do direito [Consultar Estoque de Itens por Estabelecimento] habilitado na [R697 - Liberação de Rotina por Usuário], ou [R696 - Liberação de Rotina por Grupo de Usuários] referente a rotina [R1000 - Central de Integração] como o exemplo abaixo:


Consulta de Condições de Pagamento de Venda


Para utilizar o recurso de consulta de condições de pagamento de venda o usuário precisará do direito [Consultar Condições de Pagamento de Venda] habilitado na [R697 - Liberação de Rotina por Usuário], ou [R696 - Liberação de Rotina por Grupo de Usuários] referente a rotina [R1000 - Central de Integração] como o exemplo abaixo:


Importante: Essa consulta irá retornar apenas as condições que:

  • Estiverem Ativas;
  • Forem de venda;
  • Participarem da integração com App de Venda externa.


Consulta de Vendedores

Para utilizar o recurso de consulta de vendedores o usuário precisará do direito [Consultar Vendedores] habilitado na [R697 - Liberação de Rotina por Usuário], ou [R696 - Liberação de Rotina por Grupo de Usuários] referente a rotina [R1000 - Central de Integração] como o exemplo abaixo:


Importante: Essa consulta irá retornar os vendedores que estejam na seguinte condição:

  • Participarem da integração com App de Venda externa.
  • Além dos dados básicos, o sistema retorna, também, as configurações de metas de vendedores por quantidade de itens e metas por linha de itens, desde que exista alguma meta no período vigente (Atual) para os vendedores que participam da integração com o Aplicativo de Venda Externa. Para o sistema retornar a meta, o código da mesma precisa estar no formato "AAAAMM", onde A representa os dígitos do ano e M os dígitos do mês (ex.: nov/2021 = 202111). As configurações de meta podem ser feitas na rotina R824 - Metas por Vendedores/Linhas de Itens.


Consulta de Itens


Para utilizar o recurso de consulta de itens o usuário precisará do direito [Consultar Itens] habilitado na [R697 - Liberação de Rotina por Usuário], ou [R696 - Liberação de Rotina por Grupo de Usuários] referente a rotina [R1000 - Central de Integração] como o exemplo abaixo:


Consulta de Tabelas de Preço


Para utilizar o recurso de consulta de tabelas de preço o usuário precisará do direito [Consultar Tabelas de Preço] habilitado na [R697 - Liberação de Rotina por Usuário], ou [R696 - Liberação de Rotina por Grupo de Usuários] referente a rotina [R1000 - Central de Integração] como o exemplo abaixo:


Consulta de Preços de Itens


Para utilizar o recurso de consulta de preços de itens o usuário precisará do direito [Consultar Preços de Itens por Estabelecimento] habilitado na [R697 - Liberação de Rotina por Usuário], ou [R696 - Liberação de Rotina por Grupo de Usuários] referente a rotina [R1000 - Central de Integração] como o exemplo abaixo:


Consulta de Portadores


Para utilizar o recurso de consulta de portadores o usuário precisará do direito [Consultar Portadores] habilitado na [R697 - Liberação de Rotina por Usuário], ou [R696 - Liberação de Rotina por Grupo de Usuários] referente a rotina [R1000 - Central de Integração] como o exemplo abaixo:


Importante: Para o portador ser disponibilizado nas consultas o parâmetro [Participa da integração com App de Vendas?] precisará estar ativo na [R75 - Portadores].



Consultar Tipos de Preço


Para utilizar o recurso de consultar Tipos de Preço o usuário precisará do direito [Consultar Tipos de Preço] habilitado na [R697 - Liberação de Rotina por Usuário], ou [R696 - Liberação de Rotina por Grupo de Usuários] referente a rotina [R1000 - Central de Integração] como o exemplo abaixo: 


Consultar Politicas de Descontos


Para utilizar o recurso de consultar politicas de descontos o usuário precisará do direito [Consultar Políticas de Desconto]  habilitado na [R697 - Liberação de Rotina por Usuário], ou [R696 - Liberação de Rotina por Grupo de Usuários] referente a rotina [R1000 - Central de Integração] como o exemplo abaixo: 



Consultar Estabelecimentos


Para utilizar o recurso de consultar Estabelecimentos o usuário precisará do direito [Consultar Estabelecimentos] habilitado na [R697 - Liberação de Rotina por Usuário], ou [R696 - Liberação de Rotina por Grupo de Usuários] referente a rotina [R1000 - Central de Integração] como o exemplo abaixo:


Anexo de arquivos para títulos a pagar


Para utilizar o recurso de anexos de arquivos para títulos a pagar, é necessário habilitar o direito [Anexar Arquivo de Título a Pagar] por usuário [R697 - Liberação de Rotina por Usuário] ou por grupo de usuário [R696 - Liberação de Rotina por Grupo de Usuário], como no exemplo abaixo:



Obs: Para que os arquivos sejam anexados na pasta correta, é necessário realizar a configuração do PathSistema no web.config da API. Veja que no exemplo abaixo está configurado para o ambiente de testes interno que utilizamos, que seria o current, porém, deverá ser configurado de maneira correta para cada cliente.



Exemplo de url de acesso ao sistema MOVERE:


Anexo de arquivos para nota fiscal de entrada


Para utilizar o recurso de anexos de arquivos para notas fiscais de entrada, é necessário habilitar o direito [Anexar Arquivos de Notas de Entrada] por usuário [R697 - Liberação de Rotina por Usuário] ou por grupo de usuário [R696 - Liberação de Rotina por Grupo de Usuário], como no exemplo abaixo:



Obs: Para que os arquivos sejam anexados na pasta correta, basta apenas realizar a mesma configuração do PathSistema exemplificado na documentação do Anexo de Arquivos de Títulos a Pagar, logo acima.


Consultar informações para comissionamento por faixa de margem


Para consultar as informações de comissionamento por faixa de margens, é necessário que o usuário que esteja efetuando a consulta possua o direito [Consultar Config. Comissão por Faixa de Margem]  habilitado nas rotinas [R697 - Liberação de Rotina por Usuário] ou [R696 - Liberação de Rotina por Grupo de Usuário], como no exemplo abaixo:


Consulta de Portadores por Períodos


Para consultar as informações de portadores por período, é necessário que o usuário que esteja efetuando a consulta possua o direito [Consultar Portador por Período] habilitado nas rotinas [R697 - Liberação de Rotina or Usuário] ou [R696 - Liberação de Rotina por Grupo de Usuário], como no exemplo abaixo.


Consulta de Notas Fiscais Emitidas


Para consultar as informações de notas fiscais emitidas, é necessário que o usuário que esteja efetuando a consulta possua o direito [Consultar Notas Fiscais Emitidas] habilitado nas rotinas [R697 - Liberação de Rotina or Usuário] ou [R696 - Liberação de Rotina por Grupo de Usuário], como no exemplo abaixo.


Cadastro de Leads


Para enviar Leads para o MOVERE, é necessário que o usuário que esteja efetuando o consumo da API, possua o direito [Cadastrar Novo Lead] habilitado nas rotinas [R697 - Liberação de Rotina or Usuário] ou [R696 - Liberação de Rotina por Grupo de Usuário], como no exemplo abaixo.

Para detalhes de como o Lead deve ser enviado para a API, acesse a documentação do swagger, clicando aqui.