Linx Webservices Release Notes - 2.68.13-1

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.

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:

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

A correção necessita da versão 4.9.0 do Servidor de Pedidos: BIGRETAIL-35739

 BIGRETAIL-41115 [LWS] Login por "Chave de Autenticação"

• Endpoint da funcionalidade: /v2/signin/authentication_key
• Foi criada a configuração "Chaves de autenticação".
  Configuração deve estar no formato "KEY:PASSWORD:SECRET". Utilizar ";" como separador em casos de múltiplas chaves.
• KEY: Equivalente ao campo "identification" no corpo da requisição.
  PASSWORD: Equivalente ao campo "password" no corpo da requisição.
  SECRET: Deve ser utilizado por aplicações clientes para gerar a Hash, HMAC_SHA512, do campo "password".

BIGRETAIL-39845 Emissão RPS NFSe Para ativar o serviço é necessário configurar os parâmetros:

• URL base do serviço de NFSe
• URL base do serviço de token NFSe
• Client ID do serviço de token NFSe
• Client secret do serviço de token NFSe
• Escopo do serviço de token NFSe
• Timeout do serviço de NFSe (milissegundos)
• Ambiente do serviço de NFSe [HOMOLOGACAO OU PRODUCAO]
• 
  
  
  BIGRETAIL-42274 Cartão sendo solicitado duas vezes no pagamento em TEF de pedido contendo frete

• Foi criado o parâmetro para o LWS corporativo chamado: Tipos de itens não fiscais totalizados em cálculos
• Usado para definir os tipos de itens não fiscais, separados por ponto e virgula, que devem ser incluídos no calculo do total da venda. Por exemplo se desejado frete e taxa de conveniência, basta preencher FREIGHT;CONVENIENCE_FEE

HOTFIX_v2.38.1

Esta hotfix contém a implementação da NT 2020.06 que foi liberada na versão 2.46.0 do LWS. Em caso de atualização do LWS desta HFIX, se atentar em atualizar para uma versão igual ou superior à 2.46.0!

Para utilizar a api de Marketing Cloud para envio de SMS faz-se necessário configurar os seguintes parâmetros:

• URL Base da API de Mensagens Salesforce Marketing Cloud
• ID do Cliente da SalesForce Marketing Cloud
• Chave Secreta do Cliente da SalesForce Marketing Cloud
• Identificador da conta do Cliente da SalesForce Marketing Cloud
• Identificador das definições do template de mensagem da SalesForce Marketing Cloud

BIGRETAIL-44751 Ajustes no envio de SKUCupons para SEFAZ

• Novo parâmetro chamado: Quantidade de digitos do número do produto, definie o número de dígtos para o numero do produto enviado na autorização da nota. O numero é completado com zeros a esquerda para contemplar o tamanho definido.

Exemplo: numero do produto: 56867 (parametro com valor 10)

É enviado: 0000056867

BIGRETAIL-47437 Persistência da flag de venda por modelo

É necessário atualizar o banco de dados, para o Storex Cloud corporativo, com a versão "BD-STOREX-2.28.0"

• BIGRETAIL-46686 [SXC] Serviço de merge para mútiplos pedidos
  • Para habilitar a funcionalidade de mesclagem de múltiplos pedidos, faz-se necessário habilitar o parâmetro abaixo:

• • • Habilita mesclagem de múltiplos pedidos -> true

1. BIGRETAIL-53706 XML Online - LWS
   1. Novo parâmetro criado (apenas Storex Cloud Corporativo):
      "Realizar a integração dos XML das notas" Para integrar o xml das notas é necessário modificar para "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.

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.

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:

•  URL base do serviço Rest do PROMO. ex: http://meuip:8080

1. BIGRETAIL-44506 [CXR - LWS] - Melhoria na gravação das informações de pagamentos TEF no Datahub
   • Para informar o valor que será preenchido no campo Código Autorizador, utilizar o parâmetro abaixo:
     • Origem do campo Código Autorizador =Domínio: REDE ou BANDEIRA
2. BIGRETAIL-44178 [LWS] Troca Web OMS - Status para troca
   • Para adicionar novos status para troca, utilizar o parâmetro abaixo:
     • Lista de status de atendimento da Chaordic OMS (fulfillment) disponíveis para troca (Separado por ponto-vírgula)
       Exemplo: DELIVERED;PAID;FINISHED;

1. BIGRETAIL-43864 [LWS] Criar parâmetro para tempo de limpeza de transações do processador de eventos
   1. Para informar o tempo da limpeza dos eventos, utilizar o parâmetro abaixo:
      • Limite em dias dos eventos do LWS, após isso eles serão apagados
        Exemplo: 30

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.

Não Impressão de Cupom de Doação (STOREX MOBILE)
Preencher o seguinte parâmetro:

• Habilita impressão de cupom doação

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)