Árvore de páginas

01. DADOS GERAIS:

Linha do ProdutoLinha RMS
SegmentoVarejo Supermercado
MóduloCadastro

02. PRÉ-REQUISITOS:

RMSV12R27 ou superior
.Net Framework4.7.1 ou superior
.Net Core3.1 ou superior
Windows + IIS

Windows 2008 ou superior

SimplusSer assinante do serviço Simplus
Download APIsPacotes de APIs TOTVS Supermercados - Linha RMS na Release R27

03. Objetivo         

         Integrar dados da base Simplus ao cadastro de produto (VABUITEM).

04. Instalação

  • Etapa 1 - Copiar o conteúdo da pasta SimplusApi para [Unidade de disco]:\inetpub\wwwroot\RMS\Aplicacoes\Simplus\API.
  • Etapa 2 - No gerenciador do IIS e converter para aplicativo a API.


  • Etapa 3 - Configurar dados do banco de dados no arquivo web.config da SimplusApi.

  • Etapa 4 - Ainda no arquivo Web.config configurar os dados de acesso recebidos pela Simplus.
  • Obs. 1: O valor (campo value) da key Database:schemaName, deve corresponder ao esquema do banco de dados.
  • Obs. 2: A versão antiga da API possui a tag <appSettings> como na imagem a seguir. Dessa forma o valor (TOKEN------) da key Simplus:token deve corresponder ao token fixo fornecido pela Simplus. Neste caso a Obs 3 deve ser ignorada.

  • Obs. 3: A versão nova da API possui a tag <appSettings> como na imagem a seguir. Dessa forma os valores (SIMPLUS-USERNAME) da key SubscriptionCenter:password e (SIMPLUS-USERNAME) da key SIMPLUS-PASSWORD devem corresponder ao usuário e senha respectivamenet fornecidos pela Simplus. Neste caso a Obs 2 deve ser ignorada.


  • Etapa 5 - Copiar pasta SimplusService para diretório de sua preferência. Ex[Unidade de disco]:\SimplusService.
  • Etapa 6 - Configurar novamente dados do banco de dados appsettings.json do SimplusService.

  • Etapa 7 - Executar o InstalarService.bat como administrador, ele irá criar o serviço SimplusService' e iniciar.
  • Etapa 8 - Criar a pasta Logs dentro da pasta Content em[Unidade de disco]:\inetpub\wwwrootRMS\Aplicacoes\Simplus\API. 
  • Etapa 9 - Permitir que o usuário do IIS possa escrever na pasta Logs criada na etapa anterior. 

05. Exemplo de Utilização

  • Utilizar a função Incluir do VABUTITEM;
  • Utilizar a função Obter Simplus, preencher um GTIN e clicar em Confirmar.

  • Se o produto for cadastrado na Simplus, os campos a seguir serão preenchidos:
  1. Fornecedor;
  2. Descrição Reduzida;
  3. Qtde./Base;
  4. Qtde./Altura;
  5. Empilhamento Máximo;
  6. Normatização;
  7. Grade de Dimensões;
  8. Tipo Etiqueta;
  9. EAN;
  10. Descrição do Produto;
  11. Descrição Comercial Reduzida;
  12. Descrição Comercial;
  13. Tipo Produto;
  14. Class. Fiscal.
  15. Procedência
  16. Referencia (Código interno do produto no fornecedor)
  17. Descrição Marketing (Se houver)
  18. Descrição Ecommerce (Se houver)
  19. Validade do produto (Em dias, se houver)

06. Logs Adicionais

  • Log de banco de dados:

Adicionar o trecho de código a seguir ao web.config da API entre as tags </defaultConnectionFactory> e <providers>:

<interceptors>
  <interceptor type="System.Data.Entity.Infrastructure.Interception.DatabaseLogger, EntityFramework">
    <parameters>
      <parameter value="C:\SimplusLogBd.txt" />
     <parameter value="false" type="System.Boolean"/>
   </parameters>
  </interceptor>
</interceptors>

Ex.:

  • Log do SimplusService: