Integrações e Marketplace¶
Tela destinada a criar as integrações externas e com marketplace para permitir enviar e receber dados à entidades externas.
Marketplace¶
Integração com marketplace, plataformas de vendas e outras.
Mercado Livre¶
Para integração com Mercado Livre, é necessário cadastrar o aplicativo Modus na conta do vendedor e obter o ID do Aplicativo e a Secret Key. Com estas informações em mãos, cadastre os campos conforme abaixo:
| Campo | Conteúdo |
| Tipo Integração | 01-Mercado Livre |
| Descrição | Identificação, que será exibida na tela de integração |
| Endereço Base | Deixar com o endereço padrão sugerido |
| Identif App | ID Aplicativo, obtido no cadastro do Mercado Livre (ver abaixo) |
| Senha App | Secret Key, obtido no cadastro do Mercado Livre (ver abaixo) |
| Identif Usuário | Código interno do usuário no Mercado Livre |
| Pedido Filial/Tipo | Informe a Filial e o Tipo de Pedido que serão gerados no Modus quando receber um pedido de venda |
| % Faturam | Percentual adicional que deve ser descontado a título de taxas de faturamento (impostos). Este percentual será aplicado após descontar as taxas padrões do Mercado Livre |
| Situação | A-Ativo |
Cadastrando/vinculando o Modus no Mercado Livre
- Acesse: http://applications.mercadolibre.com/
- Na tela inicial, selecione o país: Brazil
- Na tela seguinte, informe o login da conta que deseja. Clique em Continuar
- Se você já estiver logado ao Mercado Livre com um perfil diferente do desejado, clique no seu perfil no canto superior direito, e selecione a opção Sair, e então reinicie o processo
- Informe a senha. Clique em Entrar
- Caso seja solicitado um código de validação, aguarde um e-mail e informe o código
- Na página seguinte, localize e clique no botão "Criar nova aplicação". Informe os dados conforme abaixo:
- Nome: Modus COM - <Nome Empresa>. Exemplo: Modus COM - Venda do Jose
- Nome Curto: moduscom-<empresa>. Exemplo: moduscom-vendajose
- Descrição: Modus COM - Via Regra Sistemas de Gestão
- Clique em Continuar
- Na próxima página, deverão ser realizadas as liberações para a aplicação Modus COM. Selecione os dados conforme a tela abaixo:
- Após configurar as permissões, marque "Li e aceito Termos e Condições"
- Clique em Criar
Abaixo do nome do aplicativo, estará disponível os campos ID e Secret Key necessários ao Modus. Copie e cole no sistema conforme indicado abaixo:
| Mercado Livre | Modus |
| ID | Identif App |
| Secret Key | Senha App |
Exemplo de imagem: Homologação
SkyHub¶
Tray e-commerce¶
Para integração com Tray e-commerce, é necessário efetuar a instalação do aplicativo dentro do painel administrativo da loja, através do seguinte caminho:- Meus Aplicativos > Instalar novos aplicativos
- Procure por Modus e clique em Filtrar
- Ao localizar, instale o aplicativo, concedendo as permissões solicitadas.
- Após instalado, ao clicar em "Acessar" , você deverá capturar as informações do api_address e do code.
Veja o passo a passo ilustrado das opções acima:
Tray - Passo a Passo
Com estas informações em mãos, cadastre os campos conforme abaixo:
| Campo | Conteúdo |
| Tipo Integração | 03-Tray e-commerce |
| Descrição | Identificação, que será exibida na tela de integração |
| Endereço Base | api_address (informe o endereço acima) |
| Identif App | Consumer Key (obter com a Via Regra) |
| Senha App | Consumer Secret (obter com a Via Regra) |
| Identif Usuário | store_id (não preencher, gerado pela integração) |
| Senha Usuário | code (informe o código obtido acima) |
| Pedido Filial/Tipo | Informe a Filial e o Tipo de Pedido que serão gerados no Modus quando receber um pedido de venda |
| % Faturam | |
| Situação | A-Ativo |
iFood¶
Para integração com iFood, é necessário efetuar a instalação do aplicativo dentro do painel administrativo da loja. Esta instalação deve ser solicitada pela Via Regra, e autorizada pelo cliente na própria loja, através do seguinte caminho:- Acessar o portal do parceiro iFood: https://portal.ifood.com.br
- No painel a esquerda, selecionar: Aplicativos
- No painel à direita será exibido no topo Meus Aplicativos, o aplicativo ModusDelivery.
- Clique no menu do aplicativo (três pontos), e selecione a opção "Permitir".
- Confirme as permissões. Feito isso, será liberado o acesso à loja para o aplicativo.
- No painel à esquerda, selecione Minha loja > Loja. Copie o campo ID da Loja e envie para a Via Regra.
Com estas informações em mãos, cadastre os campos conforme abaixo:
| Campo | Conteúdo |
| Tipo Integração | 40-iFood |
| Descrição | Identificação, que será exibida na tela de integração |
| Endereço Base | https://merchant-api.ifood.com.br |
| Identif App | client ID (obter com a Via Regra) |
| Senha App | client Secret (obter com a Via Regra) |
| Identif Usuário | ID da Loja (obtido no passo anterior, último item) |
| Pedido Filial/Tipo | Informe a Filial e o Tipo de Pedido que serão gerados no Modus quando receber um pedido de venda |
| Situação | A-Ativo |
Observações: Outras configurações são necessárias. Obter diretamente com o suporte da Via Regra.
ByFood¶
O ByFood fornece uma URL base personalizada para o cliente, bastando portanto ajustar somente o endereço fornecido pela plataforma e informar o token de acesso:
| Campo | Conteúdo | Observação |
| Tipo Integração | 41-ByFood | |
| Descrição | Identificação da integração | |
| Endereço Base | https://<<cliente>>.byfood.com.br/api/pedidos | Substituir <<cliente>> pelo ID fornecido pela plataforma |
| Token App | Token da plataforma | |
| Pedido Filial/Tipo | Informe a Filial e o Tipo de Pedido que serão gerados no Modus quando receber um pedido de venda | |
| Situação | A-Ativo |
Outros¶
A integração Outros está liberada temporariamente para integração do Modus com outros sistemas. Os campos atualmente disponíveis são:
| Campo | Conteúdo | Observação |
| Tipo Integração | 99-Outros | |
| Módulo Integração | 1-Marketplace | |
| Descrição | Identificação da integração | |
| Endereço Base | https://<<endereco_base:porta>>/api/PedidoCompra | Endereço fornecido pela plataforma |
| Identif App | 03xxx | ID (CNPJ) do fornecedor. Informar somente dígitos numéricos |
| Identificação Usuário | 29xxx | ID (CNPJ) do cliente. Informar somente dígitos numéricos |
| Pedido Filial/Tipo | Informe a Filial e o Tipo de Pedido que serão gerados no Modus quando receber um pedido de venda | |
| Situação | A-Ativo |
Serviços Postais¶
Correios¶
| Campo | Conteúdo |
| Tipo Integração | 81-Correios |
| Descrição | Identificação da integração |
| Endereço Base | homologação: Deixar em branco Produção: https://apps.correios.com.br/SigepMasterJPA/AtendeClienteService/AtendeCliente |
| Identif App/Adm | 17000190 |
| Senha App/Contrato | 9992157880 |
| Identif Usuário | sigep |
| Senha Usuário | n5f9t8 |
| Token App/Cartão | 0067599079 |
| Situação | A-Ativo |
Meios de Pagamentos¶
Multiplus Card¶
| Campo | Conteúdo |
| Tipo Integração | 60-Multiplus Card |
| Módulo Integr | 5-Conciliaçãp de Cartões |
| Descrição | Identificação da integração |
| Endereço Base | https://webapi.relatoriotef.com.br |
| Identif App/Adm | ==AQQFOA4DMQIICTAxCAs=== (Identificador interno) |
| Senha App/Contrato | ==fURdTFATZ1hZFAQBCDg=== (Senha interna) |
| Identif Usuário | CNPJ do Cliente - Somente numeros |
| Situação | A-Ativo |
