Data da Versão

 

Responsável

Gerência de Configuração

Pacote da Versão

LINX-WEBSERVICES-2.42.0-3.zip

Versão Java

01.08

Caminho de Liberação

ftp://ftprec.linx.com.br/Produtos/Linx Webservices/LINX-WEBSERVICES-2.42.0-3


Caso não possua esta versão, entre em contato com o suporte da Linx para fazer a atualização não se esquecendo de executar todas as informações adicionais da nota de liberação da versão mínima requerida


Os xmls de configuração encontram-se disponíveis dentro do pacote da versão.


Passos para atualizar novos parâmetros:

  1. Deve-se primeiramente carregar o xml de configuração desta versão no servidor de configuração já instalado.
  2. Em seguida, deve-se ajustar os novos parâmetros (alguns dados são sensíveis, deverão ser informados pelo cliente):
  3. Após a configuração, deve recarregar as configurações do LWS.








Versões de Compatibilidade



Cliente

Produto

Versão


Servidor de Pedidos

02.07.00


Banco de Dados

BD-2961-1.11.0

BD-STANDARD-3.19.0

2961Storex

STOREX-RENNER-14.09.01

5000Storex

STOREX-TIM-16.00.00

5005 StorexSTOREX-15.07.90
2961STOREXRENNER15.03.00








Instruções Adicionais da Versão


Habilitação do LWS para trabalhar com MFE + Mid-e client Agent

 

Para habilitar a operação do lws e do cxr com o MFE através do agent, você deve primeiramente carregar os xmls de configuração desta versão no servidor de configuração já instalado. Em seguida, instale o agent, para que seja possível configurar o ip e a porta do mesmo no servidor de configuração.

 Em seguida, você deve fazer as seguintes configurações:

  • Para o grupo do LWS:
    • tipo autorizador: selecionar opção "sat_integradorfiscal".
    • uso do mid-e client agent: true
    • tipo do mid-e client agent: mfe
    • endereco ip do mid-e client agent: <ip onde o agent foi instalado>
    • porta do mid-e client agent: <porta onde o agent foi instalado>
    • fabricante do aparelho sat: <fabricante desejado>

    • código de ativação do fabricante sat: <código de ativação do fabricante desejado>

    • Intervalo leitura output Integrador Fiscal: 10000 (milissegundos)

    • Diretório output MFE: <diretório onde o Integrador Fiscal gravará os retornos dos arquivos de solicitação fiscal>

    • Diretório input MFE: <diretório de onde o Integrador Fiscal fará a leitura dos arquivos de solicitação fiscal>

  • para o Caixa Rápido:
    • tipo autorizador: selecionar a opção "integrador fiscal".


Após a configuração, você deve enviar a mesma para o linx webservice correspondente. Em seguida, deve reiniciar o Mid-e client agent para que ele receba as configurações carregadas pelo LWS. Sem isso, ele não vai funcionar.


Atenção: Quando usar um MFE Elgin, deve ser colocado no bin do wildfly o arquivo mide-client-mfe-elgin-homologacao.properties para o ambiente de homologação.



para esta funcionalidade operar corretamente com o Caixa rápido, não se esqueça de realizar as configurações informadas no release notes do CXR!



Alteração Legal (RJ): Inclusão do PROCON e CODECON no Documento Fiscal

Esta versão contempla uma alteração legal para o Rio de Janeiro, que é a exibição dos endereços do PROCON e CODECON nos documentos fiscais.

Para habilitar esta alteração legal, você deve primeiramente carregar os xmls de configuração desta versão no servidor de configuração já instalado.

Foram criados 2 parâmetros, que indicam a lista dos endereços destes departamentos no formato <UF>=<Endereço>, separadas por ;. Desta forma, quando for necessário incluir um endereço de PROCON ou CODECON para uma nova UF, basta alterar os parâmetros, acrescentando um novo elemento <UF>=<Endereço>

Sendo assim, você deve fazer as seguintes configurações para o grupo do LWS:

  • Lista de endereços dos Procons estaduais: UF=Endereço ; UF=Endereço
  • Lista de endereços dos Codecons estaduais: UF=Endereço ; UF=Endereço

Para a UF do RJ, seguem os endereços que devem ser informados:

PROCON: tel. 151, end. Av. Rio Branco, 25 - 5o andar, Centro/RJ.
CODECON: tel. 0800 282 7060, end. R. da Alfandega, 8 – Centro/RJ.

Exemplo do preenchimento para o RJ:

  • Lista de endereços dos Procons estaduais: RJ=tel. 151, end. Av. Rio Branco, 25 - 5o andar, Centro/RJ
  • Lista de endereços dos Codecons estaduais: RJ=tel. 0800 282 7060, end. R. da Alfandega, 8 – Centro/RJ


Após a configuração, você deve enviar a mesma para todos os LWS, visto que os novos parâmetros são globais.



Habilitar da funcionalidade: Múltiplos Agent's com MFE

Para habilitar a funcionalidade, deve-se primeiramente carregar o xml de configuração desta versão no servidor de configuração já instalado.

Em seguida, você deve fazer as seguintes configurações (alguns dados são sensíveis, deverão ser informados pelo cliente):

  • Endereço IP e Porta do MID-e Client Agent: informar os IPs e Portas dos Agentes no seguinte formato: IP:PORTA;IP:PORTA;

Após a configuração, deve recarregar as configurações do LWS.

 

Habilitar QR Linx

Deve-se primeiramente carregar o xml de configuração desta versão no servidor de configuração já instalado.

Em seguida, você deve fazer as seguintes configurações (alguns dados são sensíveis, deverão ser informados pelo cliente): 

Os valores dos parâmetros abaixo são específicos por cliente.

Target da API do QR Linx
Canal do cliente da API do QR Linx
Chave de assinatura da API do QR Linx
Após a configuração, você deve recarregar as configurações pro LWS.


Alterar o Tempo de armazenamento da MFD

 Deve-se primeiramente carregar o xml de configuração desta versão no servidor de configuração já instalado.
Em seguida, você deve fazer as seguintes configurações (alguns dados são sensíveis, deverão ser informados pelo cliente):

  • Tempo de armazenamento da MFD (em dias): 60

Após a configuração, você deve recarregar as configurações do Caixa Rápido.


Envio de e-mail automático ao integrar venda

Deve-se primeiramente carregar o xml de configuração desta versão no servidor de configuração já instalado.
Em seguida, deve-se fazer as seguintes configurações (alguns dados são sensíveis, deverão ser informados pelo cliente):

  • Envio de email automático ao integrar venda: true

Após a configuração, você deve recarregar as configurações do Caixa Rápido.


Parametrizar novos adquirente de aprovação do pagamento do cartão

Deve-se primeiramente carregar o xml de configuração desta versão no servidor de configuração já instalado.

Em seguida, você deve fazer as seguintes configurações (alguns dados são sensíveis, deverão ser informados pelo cliente): 

  • Mapeamento das autorizadoras do CTF= authorizerCode=description#brandType#cnpj ; authorizerCode=description#brandType#cnpj;

ex: NL=CLESSELODEBITO#99#01027058000191 ; BL=CLESSELODEBITO#99#01027058000191

Após a configuração, você deve recarregar as configurações pro LWS.



BIGRETAIL-15453 [LWS] Criar integração do LWS com o Link de Pagamento

Para utilizar o link de pagamento da Linx Pay Hub, deve-se seguir os passos seguintes:
1 - Carregar o XML de configuração desta versão no servidor de configuração.
2 - Após a importação, seguir para a tela de configurações dos parâmetros.
3 - Informar os parâmetros do link de pagamento, são eles:

  • API Key do Link de pagamento.
  • URL da API de Link de pagamento.
  • Timeout de requisições à API de Link de pagamento.
  • Usuário da API de Link de pagamento.
  • Senha da API de Link de pagamento.

Após a configuração, deve-se carregar as configurações no LWS.


Recarregar Configurações Automaticamente no Caixa Rápido

Parâmetro:

  • TTL de cache dos parâmetros de configuração: <valor>
    Onde: O LWS só retornará dados quando o valor for maior ou igual a ZERO. Com zero indicando que uma consulta sempre será feita ao Serv. de Config. e com valores maiores que uma consulta só será feita após o valor em minutos definido no parâmetro.


Liberar o arquivo em anexo (serv-config-webservice.xml) no FTP junto com as versões.

  • Clientes: TODOS
  • Projeto: Parametrização chave de criptografia no LWS
  • Chave Crypto-Triple (chave-crypto-triple-des)


[LWS] Integração Zenvia API 2.0

**Para habilitar a funcionalidade de envio de SMS e Whatsapp da Zenvia 2.0, informe o parâmetro abaixo:
 - Token da API de mensagens da Zenvia
OBS: O Token é fornecido pela Zenvia.


Parametrização do Agente de Métricas:


ParâmetroDomínioDescriçãoValor padrão
Habilitar o agente de métricastrue/false'true' habilita o envio, 'false' desabilita.false
Intervalo de envio das métricas (em segundos)(segundos)Intervalo de consulta das métricas a serem enviadas. Mínimo: 30. 60
 Serviço de métricas AzureApplicationInsights/LinxMetricsService AzureApplicationInsights ->Envia para o Azure Application Insights diretamente.
LinxMetricsService -> Envia para o serviço de métricas Linx (que hoje repassa, como um proxy, pro Azure Application Insights)
 
Chave do serviço de métricas Chave do provider. No caso do Azure Application Insights, é o Instrumentation Key.  
URL base do serviço de métricas Linx URL base do serviço de métricas da Linx 
Timeout do serviço de métricas Linx (em segundos) (segundos) Timeout do serviço de métricas Linx (em segundos) 60


Habilitação Geração de Vale Troca - Nota Fiscal Web

Fazer as seguintes configurações no servidor de configuração para o LWS:

  • URL para consulta de transações LOGIC= <URL>


Habilitar Voucher de Vale Troca do Promo:
Identificador único do tipo de Voucher -> É o código do tipo do voucher criado no Promo
Número prefixo de Voucher -> Se houver um prefixo, deve-se informar aqui
Url do PROMO -> URL base do PROMO para as requisições
CompanyId do PROMO -> É o identificador da empresa no PROMO


Habilitar Regras de desconto do Promo:

Tipo do Motor de Promoções = PROMO
Parâmetro que guarda a url do servidor do PROMO = (Url do PROMO)
Identificador da empresa no serviço do Promo = ( ID cadastrado no Promo)


Habilitar consulta de Pedidos no OMS para anulação/devolução/troca:

URL base do serviço Chaordic OMS =
ID do cliente do Chaordic OMS =
Usuário do serviço do Chaordic OMS =
Senha do serviço do Chaordic OMS =
Timeout padrão dos serviços da Chaordic OMS (milissegundos) =


Habilitar consultas de Pedidos WEB no OMS
URL base do serviço Chaordic OMS =
ID do cliente do Chaordic OMS =
Usuário do serviço do Chaordic OMS =
Senha do serviço do Chaordic OMS =
Timeout padrão dos serviços da Chaordic OMS (milissegundos) =
 
 
Habilitar geração de Vale Troca no Promo
 Identificador único do tipo de Voucher -> É o código do tipo do voucher criado no Promo
Número prefixo de Voucher -> Se houver um prefixo, deve-se informar aqui
Url do PROMO -> URL base do PROMO para as requisições
CompanyId do PROMO -> É o identificador da empresa no PROMO


  • A funcionalidade "Forma de recebimento Link Pgto SE via CXR" necessita:
  • SELINK-CALLBACK-SERVICE-1.0.0 esteja configurado e pronto (BIGRETAIL-24608)
  • SERVIDOR_PEDIDOS-4.4.0 esteja configrado e pront (BIGRETAIL-24091)
  • Parâmetros dessa funcionalidade:
  • Período de verificação de pagamento para Pedidos: Tempo em Segundos
  • Tipos de verificação de pagamento para Pedidos: Para Renner informar "SE" (Sem aspas)
  • URL da API de Link de pagamento - SiTef: Informar O Host do SELink Callback Service
  • Timeout de requisições à API de Link de pagamento - SiTef: Padrão se não informado é 15000 (15s)

Habilitar Desoneração base de PIS e COFINS

Configurar o parâmetro:

Habilita calculo desonerado= true


Habilitação da funcionalidade de Geração de vale-troca

Para habilitar a funcionalidade de Geração de vale-troca, você deve primeiramente carregar os xmls de configuração desta versão no servidor de configuração já instalado.

 Em seguida, você deve fazer as seguintes configurações para o grupo do LWS:

  • Tipo da operaçao de retorno de itens: TIPO_2

Após a configuração, você deve enviar a mesma para o linx webservices correspondente.

para esta funcionalidade operar corretamente com o Caixa rápido, não se esqueça de realizar as configurações informadas no release notes do CXR!


Habilitação da funcionalidade de Atualização dos dados do cliente

Para habilitar a funcionalidade de Atualização dos dados do cliente, você deve primeiramente carregar os xmls de configuração desta versão no servidor de configuração já instalado.

 Em seguida, você deve fazer as seguintes configurações para o grupo do LWS (alguns dados são sensíveis, deverão ser informados pelo cliente):

  • Habilita o uso de API externa de clientes: true
  • URL base da API externa de Clientes
  • Id do cliente consumidor da API (client_id)
  • Chave do cliente consumidor da API (client_secret)
  • Tipo de concessão da autenticação (grant_type oAuth): client_credentials
  • Nome de usuário da API externa (username)
  • Senha do usuário da API externa (password)
  • Tempo (segundos) limite de espera por requisição à API: 15

Após a configuração, você deve enviar a mesma para o linx webservices correspondente.

para esta funcionalidade operar corretamente com o Caixa rápido, não se esqueça de realizar as configurações informadas no release notes do CXR!


Habilitação da funcionalidade de Impressão de Cupom de Troca Genérico

Para habilitar a funcionalidade de Impressão de Cupom de Troca, você deve primeiramente carregar os xmls de configuração desta versão no servidor de configuração já instalado.

 Em seguida, você deve fazer as seguintes configurações para o grupo do LWS (alguns dados são sensíveis, deverão ser informados pelo cliente):

  • Imprimir Cupom de Troca: true

Após a configuração, você deve enviar a mesma para o linx webservices correspondente.


Para integrar o LWS com a API de Cashback da Realize, faz-se necessário seguir os seguintes passos:

Deve-se primeiramente carregar o xml de configuração desta versão no servidor de configuração já instalado.

Em seguida, você deve fazer as seguintes configurações (alguns dados são sensíveis, deverão ser informados pelo cliente): 

  • Parâmetro: URL base da API externa de cashback
    -ex: https://api
  • Parâmetro: Nome de usuário da API externa (username)
    -ex: usuario
  • Parâmetro: Senha do usuário da API externa (password)
    -ex: senha
  • Parâmetro: Tempo (segundos) limite de espera por requisição à API
    -ex: 15

Após a configuração, você deve recarregar as configurações pro LWS.

 
[BR.002961.2020.047] LWS - Desconto de colaborador pelo CPF
Para habilitar, configurar o parâmetro "URL para descontos pelo cadastro do cliente"


[BR.002961.2020.042] Permitir o pagamento de carnês, faturas e acordos no VM (BIGRETAIL-24321)

Um datasource deve ser mapeado no Wildfly para o JNDI: "java:jboss/datasources/DeferredProcessDS"
Parâmetros da funcionalidade:
 - URL para consulta de cobranças
 - URL para confirmação de pagamento de cobranças


Um novo parâmetro para definição de timeout no serviço de consulta de transações Web LOGIC foi adicionado à versão:

Nome: Tempo de expiração da requisição (Timeout) LOGIC em segundos.
fqdn: transaction-search.logic.timeout
Valor padrão: 25
Observações: O valor do tempo deve ser informado em segundos.


Integração Linx-commerce - consulta imagem de produto:

Preencher os seguintes parâmetros:

  • URL base de consulta de produtos via Linx-Commerce
  • Chave de autorização da consulta de produtos via Linx-Commerce
  • clientId da consulta de produtos via Linx-Commerce
  • channelid da consulta de produtos via Linx-Commerce

Integração Linx-Promo - atualização de senha de cartões usando API REST (Catálogos):

Preencher os seguintes parâmetros:


BIGRETAIL-13527 LWS - Super Gêmeos

Deve-se primeiramente carregar o xml de configuração desta versão no servidor de configuração já instalado.

Em seguida, você deve fazer as seguintes configurações (alguns dados são sensíveis, deverão ser informados pelo cliente): 

  • Mercadológicos sem valor fiscal em BUNDLE=ZV.A12020001,ZV.A12020002 ( No P2K, esse é o valor do parâmetro "PRODUTO_KIT_MERCADOLOGICO")
  • Filtro de Consulta de Produtos=BUNLDE_NO_ORPHANS

Após a configuração, você deve recarregar as configurações pro LWS.

 


CR 126681: [LINX MESSAGES] Adicionar tratamento de cliente estrangeiro

 

Adicionar o caminho abaixo como uma linha no arquivo host do windows:

10.56.96.116 hospoq00ler.lmbr.int.adeo.com

 

<system-properties>

    <property name="javax.net.ssl.trustStore" value="D:/Packages/wildfly-10.1.0.Final/standalone/configuration/clientkeystore.jks"/>

</system-properties>

 

Adicionar isso no standalone.xml do wildfly

 

Arquivo: clientkeystore.jks

 

jogar essa chave na pasta standalone\configuration do wildfly (Ou jogar em qualquer lugar e editar o path ali em cima no system-properties)



Habilitação da funcionalidade: Inclusão de campos de marketing

Necessário Storex-EP atualizado com a versão STOREX 15.07.68 e CAIXA-RAPIDO-1.22.6.





Lista de CR’s Liberadas nesta Versão



DemandaCategoriaResumoID Problema
BIGRETAIL-35753História[LWS] Atualizar GIVEX-CLIENT
BIGRETAIL-35351Bug[LWS} "Erro ao processar autorização de venda! Mensagem: 'null'." para as lojas de SP.PRB0046251