- Criado por Paulo Henrique Miranda De Barros Ferreira em jul 25, 2024
Data da Versão |
| Responsável | Gerência de Configuração |
---|---|---|---|
Pacote da Versão | LINX-WEBSERVICES-3.2.4.zip | Versão Java | 01.08 |
Caminho de Liberação | ftp://10.4.229.5/Produtos/LINXWEBSERVICES/LINX-WEBSERVICES-3.2.4 |
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:
- Deve-se primeiramente carregar o xml de configuração desta versão no servidor de configuração já instalado.
- Em seguida, deve-se ajustar os novos parâmetros (alguns dados são sensíveis, deverão ser informados pelo cliente):
- Após a configuração, deve recarregar as configurações do LWS.
Versões de Compatibilidade
Cliente | Produto | Versão |
---|---|---|
Servidor de Pedidos | 4.51.0 | |
Servidor de Configuração | 4.1.0 | |
Banco de Dados | BD-Standard 7.11.1 BD-Versao14 5.8.0 BD-2961. 5.7.0 BD-STOREX. 5.12.0 BD-CSTM-STUDIOZ-1.38.0 | |
Banco de dados do MID-E-CLIENT | MID-E-CLIENT-6.15.0 | |
2961 | Storex | STOREX-RENNER-14.09.01 |
5000 | Storex | STOREX-TIM-16.00.00 |
5005 | Storex | STOREX-15.07.90 |
2961 | Storex | RENNER15.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.
Atençã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âmetro | Domínio | Descrição | Valor padrão |
---|---|---|---|
Habilitar o agente de métricas | true/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
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-42274Cartã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
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-47317 - Criado parâmetro para sobrescrever o nome exibido da forma de pagamento no Cupom fiscal.
- Nome do parâmetro: Sobrescrita dos nomes de exibição de formas de pagamento
Formato: ID_FORM_PAG=TEXTO_EXIBICAO;ID_FORM_PAG_2=TEXT_EXIBICAO_2
Exemplo de utilização: QR_LINX=QR PIX CART DIGITAL;CREDIT=CARTAO DE CREDITO
BIGRETAIL-47364 - Erro ao estornar pagamento por link de pagamento
Atualizar Client do Storex Cloud para a versão 1.34.0 ou superior e ajustar o tipo da propridade "amount"
BIGRETAIL-49062 Enviar automaticamente cupom de Vale troca para o cliente
No fluxo de venda, existe a possibilidade de enviar os cupons automaticamente para o cliente. Ativando o parâmetro de LWS: Envio de email automático ao integrar venda
Corrigido problema de serialização de classe, nas requisições de integração de venda. Para o correto funcionamento é necessário garantir que nenhuma mensagem esteja "presa" na fila antes de atualizar para essa versão. Validar se existem mensagens na seguinte pasta:
linx-wildfly\standalone\data\linx-webservices\plugins\lws_pool\sale-async
BIGRETAIL-51355 Habilitar Consulta do LinxGetCEP
- URL base para consulta de endereço da Linx = linx-get-cep.url
- Nome para autenticação na API para consulta de endereço da Linx = Storex Cloud
- Nome de usuário para autenticação na API para consulta de endereço da Linx = storex-cloud
- Email para autenticação na API para consulta de endereço da Linx = [email protected]
- Senha para autenticação na API para consulta de endereço da Linx = 2yGbR8*1@38p
obs: Necessário configurar "Nome do provedor para consulta de endereço = LINX_GET_CEP" do Storex Mobile
BIGRETAIL-52994-BR.069263.2021.022- Alteração mensagem Link de Pagamento
Para possibilitar a alteração na mensagem do Link de Pagamento, foi criado algumas propriedades dinâmicas. Internamente a aplicação faz um bind e realiza a troca das informações contidas nas propriedades mapeadas. Abaixo segue a lista de propriedades:
${LINK} -> Contém a informação do Link de Pagamento
${CUSTOMER_NAME} -> Contém a informação do nome do cliente que está realizando a compra
${CUSTOMER_ID} -> Contém a informação do identificador do cliente, se houver (O Storex não armazena esta informação, ela só existirá se a consulta for realizada externamente)
${PRODUCTS} -> Contém a lista de produtos da transação
${STORE_NUMBER} -> Contém o número da Loja em que a transação ocorreu
${STORE_NAME} -> Contém o nome da loja em que a transação ocorreu
${TOTAL_VALUE} -> Contém o valor total da transação
${ORDER_DATE} -> Contém da data da transação
Parâmetro da mensagem: Template padrão para envio de Link de Pagamento existente nos parâmetros do Storex Cloud da versão 2.74.0 ou superior.
Exemplo de uso
- Frase customizada:
- Olá, ${CUSTOMER_NAME}! Este é o link de pagamento referente à compra (${PRODUCTS}), na Loja (${STORE_NAME}), no valor de R$${TOTAL_VALUE} em (${ORDER_DATE}):\nLink: ${LINK}
- Resultado:
- Olá, Vinícios Rodrigues! Este é o link de pagamento referente à compra (Tim Chip 5G | Celular Motorola G10 Plus | FRETE), na Loja (Tim Recife), no valor de R$ 3,33 em (19/01/2022):
Link: https://checkout.pagar.me/v1/chk_x9JjNKxT4FW25neX
BIGRETAIL-54458[STOREX-CLOUD] Customização de parâmetro da API de Mensagens- O parâmetro Remetente padrão de mensagens foi atualizado para permitir mútiplos canais, sendo possível configurar o mesmo das seguintes formas:
- Forma inicial: palavra-chave (Zenvia)
- Forma nova: CANAL=palavra-chave;
- Ex: SMS=alder-danthus;WHATSAPP=pattern-claus;
- O parâmetro Remetente padrão de mensagens foi atualizado para permitir mútiplos canais, sendo possível configurar o mesmo das seguintes formas:
BIGRETAIL-54545
Funcionalidade para integração do Storex Custom com o Azure telemetria através do LWS. Como esta integração já está disponível via EP, o meio de acesso ao serviço foi parametrizado.BIGRETAIL-54426
Insere novo endpoint para consultar saldo de voucherBIGRETAIL-52014
Necessário atualizar o Storex os SP's / ProcTrans dos clientes que necessitem dessa mudança.
Configuração "Chave secreta para autenticação com a API Mundipagg" agora suporta múltiplas lojas, basta seguir o formato "STORE_NUMBER=API_KEY;STORE_NUMBER2=API_KEY2". Apenas é recomendado este formato para clientes que utilizam Storex Cloud Corporativo.
BIGRETAIL-59063
Novos parâmetros:
1. Versão do provider de link de pagamento Pagar.me. Domínio: V1,V2. V1 = pooling, V2 = webhook
2. URL base do serviço de webhook do link de pagamento Pagar.me.
3. Usuário do serviço de webhook do link de pagamento Pagar.me
4. Senha do serviço de webhook do link de pagamento Pagar.m
5. Timeout do serviço de webhook do link de pagamento Pagar.me (em segundos)
BIGRETAIL-59044
Criado a configuração "Processos Referenciados utilizados na emissão da DANFE".
Deve ser configurado no seguinte formato:
nProc=indProc,tpAto;nProc2=indProc2,tpAto2
Valores para nProc:
Deve ter no mínimo 1 caractere e no máximo 60 caracteres
Valores para indProc:
0, // SEFAZ
1, // Justiça Federal
2, // Justiça Estadual
3, // Secex/RFB
9 // Outros
Valores para tpAto: (Apenas deve ser configurado quando indProc = 0)
8, // Termo de Acordo
10, // Regime Especial
12 // Autorização Específica
BIGRETAIL-58706
Necessário Servidor de Pedidos 4.16.0
BIGRETAIL-58575
Insere novo parâmetro na transação e retorna numero da loja do pedido
> BIGRETAIL-61869
Equalização do retorno dos serviços de assinatura, consulta de produtos, campanhas e planos e eventos para os ambientes loja e corporativo.
> BIGRETAIL-59762
Foi adicionado um novo parâmetro para habilitar o tratamento de eventos de operações com giftcards. Para ocorrer o tratamento, o mesmo deverá setado como true. Seu valor default foi definido como false.
giftcard-service.enable-ctrl-events
Habilitar eventos para controle de cartão presente
o mesmo consta no xml de configuração do lws,
presente a partir da versão 2.83
-> BIGRETAIL-62884
"Template padrão para envio de Link de Pagamento": Agora pode ser configurado para múltiplos modelos de template, para isto basta informar o tipo do template, exemplo TEXT=Template em formato de Texto;EXTERNAL_TEMPLATE=ID_DO_TEMPLATE_NO_PROVEDOR
"Mapa de Protocolos do template padrão para envio de Link de Pagamento": Configurar no formato PROTOCOLO_1=MODELO_TEMPLATE;PROTOCOLO_2=MODELO_TEMPLATE_2, exemplo "SMS=TEXT;WHATSAPP=EXTERNAL_TEMPLATE
"Template para notificação de Link de Pagamento pago": Mensagem que será enviada para o cliente quando o Link é pago. Exemplo TEXT=Template em formato de Texto;EXTERNAL_TEMPLATE=ID_DO_TEMPLATE_NO_PROVEDOR
"Mapa de Protocolos do Template para notificação de Link de Pagamento pago": Configurar no formato PROTOCOLO_1=MODELO_TEMPLATE;PROTOCOLO_2=MODELO_TEMPLATE_2, exemplo SMS=TEXT;WHATSAPP=EXTERNAL_TEMPLATE
"Template para notificação de Link de Pagamento rejeitado": Quando por algum motivo o link for cancelado por rejeição esta será a mensagem enviada ao cliente. Exemplo TEXT=Template em formato de Texto;EXTERNAL_TEMPLATE=ID_DO_TEMPLATE_NO_PROVEDOR
"Mapa de Protocolos do Template para notificação de Link de Pagamento rejeitado": Configurar no formato PROTOCOLO_1=MODELO_TEMPLATE;PROTOCOLO_2=MODELO_TEMPLATE_2, exemplo SMS=TEXT;WHATSAPP=EXTERNAL_TEMPLATE
-> BIGRETAIL-62208
Equalização do retorno dos serviços de assinatura, consulta de produtos, campanhas e planos e eventos para os ambientes loja e corporativo.
Implementação do RFID, onde será necessário que a base esteja compatível com as versões:
BD-VERSAO14-3.4.0
BD-STOREX-3.13.0
BIGRETAIL-69605 Parametrizar impressão da via do estabelecimento do TEF
- Para habilitar a reimpressão da via do estabelecimento, faz-se necessário ajustar o novo parâmetro para true
- Parâmetro: Imprimir via do estabelecimento do TEF
- Para habilitar a reimpressão da via do estabelecimento, faz-se necessário ajustar o novo parâmetro para true
BIGRETAIL-69148 [CLOUD] Desativação de recálculo de itens em resgate de pedidos
- Para desabilitar o cálculo de totalização de itens no resgate de pedidos, faz-se necessário desabilitar o novo parâmetro inputando o valor para false.
- Parâmetro: Desabilita cálculos de totalizações em resgate de pedidos
- Para desabilitar o cálculo de totalização de itens no resgate de pedidos, faz-se necessário desabilitar o novo parâmetro inputando o valor para false.
BIGRETAIL-81747 Implementação de Rate Limiter no LWS
Parameters:
Habilitar Rate Limiter - Boolean
Quantidade máxima de tokens no bucket - Long
Rapidez com que os tokens podem ser recarregados em um período de tempo - Long
Tempo até o bucket ser reabastecido por completo (seg) - IntegerTipo de chave usada para bloquear requisições - Domain(JWT_TOKEN,STORE_TERMINAL,IP)
Para que a funcionalidade do Rate Limiter funcione, a aplicação deve ser inicializada com o parâmetro "Habilitar Rate Limiter" como true. Já que a classe responsável pela funcionalidade carrega de forma dinâmica em tempo de inicialização baseada no valor deste parâmetro. Para evitar carregamento desnecessário para clientes que não utilizam a funcionalidade.
BIGRETAIL-91475 [CLOUD] Contingência PROMO
- Novo parâmetro criado: URL do Servidor de Contingência PROMO
- Valor: Utilizar o endereço do PROMO Offline
BIGRETAIL-97455 [MultiTenant] Evolução arquitetural Storex Cloud
- É necessário subir o XML da versão antes de atualizar o Storex Cloud para versão 3.0.0 (ou posterior). Caso contrário, o acesso aos serviços não será possível no Storex Cloud de Loja. Se o XML de uma versão posterior já estiver sido atualizado, este passo torna-se desnecessário.
- Caso a empresa utilize o serviço de "consulta de clientes", será necessário acrescentar no parâmetro "Providers default por tipo de serviço" o provedor utilizado. Sem isso, os Storex Mobile's de versões anteriores à 3.1.0 não consultarão clientes.
- O conteúdo do parâmetro pode ser obtido no parâmetro do Storex Mobile (não é do Storex Cloud!), chamado "Provedor para consulta de Clientes". Assim, é só adicionar o texto CUSTOMER=NOME_DO_PROVEDOR ao final da lista, com o ponto-e-vírgula usado como separador e, portanto, de prefixo.
Se o provedor de consulta for VTEX, deve-se adicionar "CUSTOMER=VTEX" à lista. De: "DEVICE=STOREX;AUTHENTICATION=STOREX;IMAGE=FILESYSTEM;PRODUCT=STOREX;PAYMENT_PLAN=STOREX;
PAYMENT=STOREX;SALES_INTEGRATION=STOREX;STORE=STOREX;MIDECLIENT=STOREX" Para: "DEVICE=STOREX;AUTHENTICATION=STOREX;IMAGE=FILESYSTEM;PRODUCT=STOREX;PAYMENT_PLAN=STOREX;
PAYMENT=STOREX;SALES_INTEGRATION=STOREX;STORE=STOREX;MIDECLIENT=STOREX;CUSTOMER=VTEX"
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.
Atençã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!
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.
Atençã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!
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
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
- Para informar o valor que será preenchido no campo Código Autorizador, utilizar o parâmetro abaixo:
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;
- Lista de status de atendimento da Chaordic OMS (fulfillment) disponíveis para troca (Separado por ponto-vírgula)
- Para adicionar novos status para troca, utilizar o parâmetro abaixo:
BIGRETAIL-43864[LWS] Criar parâmetro para tempo de limpeza de transações do processador de eventos- 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
- Limite em dias dos eventos do LWS, após isso eles serão apagados
- Para informar o tempo da limpeza dos eventos, utilizar o parâmetro abaixo:
Nova configuração "Timeout em milissegundos para consulta de Planos de Pagamento na Realize"
BIGRETAIL-57622:
Para utilizar controle das autorizações de Vouchers é necessário habilitar a nova configuração "Habilita Eventos de Controle para Autorização de Voucher".
Para utilizar eventos de controle do Estoque é necessário habilitar a nova configuração "Habilita Eventos de Controle para Estoque de Produtos".
BIGRETAIL-56602:
Necessário Proctrans na versão 16.03.00
BIGRETAIL-63829
- customer-rest-api.enabled
- customer-rest-api.client-id
- customer-rest-api.client-secret
- customer-rest-api.grant-type
- customer-rest-api.username
- customer-rest-api.password
- customer-rest-api.timeout
- BIGRETAIL-64440
- Foi necessário modificar os arquivos de configuração para remover o parâmetro “Chave da API do loyalty” e adicionar o parâmetro “Credenciais do cliente do serviço do loyalty”. Com isso, após atualizar o LWS, será necessário preencher este novo parâmetro com o consumer key e consumer secret, conforme era feito anteriormente (https://share.linx.com.br/pages/viewpage.action?pageId=266437128). Para a URL de homologação da Renner (https://apihmla1.lojasrenner.com.br:443), pode-se preencher o valor “HUFlZrQRMV_aScRXqRqUEMgCsNMa:1wTh3rQtoBC2P4BfpUhVaS1TaW8a” no novo parâmetro.
- BIGRETAIL-63353
- Para o menu fiscal funcionar corretamente precisa das atualizações de DB listadas na issue https://jira.linx.com.br/browse/BIGRETAIL-51959
- BIGRETAIL-65148 e-Sitef hoje só permite channelName com valor N/I
- Channels mapeados no LWS:
CAIXA_RAPIDO_APP_NAME = "Caixa-Rapido";
SELF_CHECKOUT_APP_NAME = "Self-Checkout";
AV_APP_NAME = "AV";
PDV_APP_NAME = "PDV";
PORTAL_BIG_RETAIL_APP_NAME = "Portal-Big-Retail";
STOREX_HOME = "Storex-Home";
OMS_ORDER_PLUGIN = "Oms-Order-Plugin"; - Qualquer comportamento diferente será necessário configurar de acordo com o devido sistema de origem.
- Channels mapeados no LWS:
- BIGRETAIL-65101 Adicionar tratamento para descontos por item no pedido
- Tratamento adicionado para o tipo de desconto EXTERNAL_TOTAL_VALUE. Nesse caso, pedidos com desconto no total do item (independentemente da quantidade) devem ter o desconto total do item lançado no campo value e o tipo EXTERNAL_TOTAL_VALUE no campo source, como no exemplo abaixo:
"discounts":[ { "value":25.7, "source":"EXTERNAL_TOTAL_VALUE" } ]
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
Novas configurações:
"Quantidade de retentativas de requisição do QR Linx" - apenas ocorrerá em casos que a requisição não for enviada para PayHub, exceto se a configuração
"Força retentativas de requisição do QR Linx" for TRUE.
"Força retentativas de requisição do QR Linx" - inclusive em casos que a requisição foi enviada para PayHub
"Intervalo em MS para validação de conexões do QR Linx"
Necessário as seguintes versões:
Servidor de Pedidos: 4.14.0, 3.23.7
Storex Mobile: 1.92.0, 1.91.3
POSSUI DEPENDÊNCIA COM O STOREX-TIM-16.27.02
BIGRETAIL-68997 Não está sendo aparecendo o IMEI no cupom (TIM)
- Para imprimir o código universão dos produtos no cumpom fiscal, faz-se necessário habilitar o novo parâmetro com o valor true.
- Parâmetro: Habilita a impressão dos códigos IMEI|ICCID no rodapé do cupom
- Para imprimir o código universão dos produtos no cumpom fiscal, faz-se necessário habilitar o novo parâmetro com o valor true.
Obrigatório as seguintes versões de BD para CORP:
BD-STANDARD-6.3.0
BD-2961-3.21.0
BD-STOREX-4.3.0
BD-VERSAO14-4.3.0
https://jira.linx.com.br/browse/BIGRETAIL-75528
CLIENTE TIM DEVE HABILITAR:
Habilitar Eventos para controle de Devoluções
Habilitar Eventos de Controle de Serviços
Habilita Eventos de Controle para Autorização de Voucher
Habilita eventos de controle de doação
https://jira.linx.com.br/browse/BIGRETAIL-74828
BIGRETAIL-77759 [LWS] Acesso Caixa Rápido na versão atualizada
Foram retirados os seguintes parâmetros:
- <fqdn>version-control.minimal-mobile-version</fqdn>
- <fqdn>version-control.action-when-update-available</fqdn>
- <fqdn>version-control.update-notification-message</fqdn>
Foi criado no lugar um único parâmetro que atende mais de uma aplicação:
- <fqdn>version-control.applications-configuration</fqdn>
- Descrição: Configuração das Aplicações
- Descrição completa:
Dados devem estar no formato "NOME_APLICACAO=VERSAO_MINIMA#ACAO#MSG_NOTIFICACAO", utilizar ";" como separador em casos de multiplas chaves. Ex: LINX-CAIXA-RAPIDO=1.118.3#NOTIFY_ONLY#Por favor, atualize o Storex Mobile;
Deve possuir a seguinte formatação:
- "NOME_APLICACAO=VERSAO_MINIMA#ACAO#MSG_NOTIFICACAO"
- Possíveis valores:
- NOME_APLICACAO:
- Ex: LINX-CAIXA-RAPIDO
- VERSÃO: Deve seguir o formato: ##.###.###
- Ex: 1.118.3
- ACAO:
- IGNORE
- NOTIFY_ONLY
- NOTIFY_AND_PREVENT_LOGIN
- MSG_NOTIFICACAO: (OPCIONAL)
- Uma string contendo a mensagem a ser mostrada.
- DEFAULT: "Existe uma nova versão disponível. Favor atualizar."
- Uma string contendo a mensagem a ser mostrada.
- NOME_APLICACAO:
- Possíveis valores:
Exemplo:
- LINX-CAIXA-RAPIDO=1.118.3#NOTIFY_ONLY#Por favor, atualize o Storex Mobile;
Caso haja mais de uma aplicação elas devem ser separadas por ";".
BIGRETAIL-98366 Informação do COD_FORMA Tabela CAMPO_GENERICO não está sendo alimentado [MERGE]
- Existe uma instrução para o cliente TIM no release notes "CLIENTE TIM DEVE HABILITAR", favor acrescentar este parâmetro:
Habilitar Calcula Desconto Non Price
BIGRETAIL-60801- Crediário
- Configurar os parâmetros:
URL Base para consulta de cliente Lebes
Timeout em segundos para consulta de cliente Lebes
URL para consulta de crediario Lebes
Timeout em segundos para consulta de crediario Lebes
URL para consulta de seguros Lebes
Timeout em segundos para consulta de seguros Lebes
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.
Configurações para utilizar Termo de Consentimento
"URL base de consulta de termo de consentimento" - url do serviço responsável pela consulta se o usuário possui termo de consentimento para aprovar
"PIN para rejeição de termo de consentimento" - Numero usado para rejeitar o termo
"PIN de não recebimento de termo de consentimento" - Numero usado para pular a validação do termo. Será questionado na proxima vez.
"Mensagem de envio dos termos de consentimento" - Mensagem que será enviada no SMS. Usar na mensagem a tag <VALOR_PIN> onde deseja que o pin seja exibido.
Configurações para envio do SMS do Termo de Consentimento
"URL Base da API de Mensagens Salesforce Marketing Cloud" - url da api de envio de sms SalesForce Ex: https://mc06qt7nm8p9g453pyb9g8wz2pvy.rest.marketingcloudapis.com
"ID do Cliente da SalesForce Marketing Cloud" - ID do cliente, disponível na conta de configuração do SalesForce Ex: nqd8j33ry5lhz03jsfbtd2kq
"Chave Secreta do Cliente da SalesForce Marketing Cloud" - chave secreta da api, disponível na conta de configuração do SalesForce Ex: E1Im4YwqDXB6Gvu4ifUQqi98
"Identificador da conta do Cliente da SalesForce Marketing Cloud" - Identificador da conta, disponível na conta de configuração do SalesForce Ex: 520001508
"Identificador das definições do template de mensagem da SalesForce Marketing Cloud" - Template, disponível na conta de configuração do SalesForce Ex: SMS_API-v1
BIGRETAIL-73632 - Ajustes no Estoque para transmissão do Bloco X - Para utilização do PAF ECF, é necessário realizar as configurações abaixo:
- Realizar o preenchimento do parâmetro abaixo do LWS Corporativo, no Servidor de Configuração (GRP-LWS-CORP):
Parâmetros | Categoria | Regra de Ativação | Valor | |
Lista de números de credenciamentos estaduais | PAF | Disponível | SC=NUMERO_CREDENCIAMENTO_PAF_ECF | |
Chaves de autenticação | SIGNIN | Disponível | linx_storex:linx_storex_pass:EL%4$g=y$yHHUxF+;linx_plugin:linx_plugin_pass:8'-j.Ke`ZbCK#eZU |
Obs: NUMERO_CREDENCIAMENTO_PAF_ECF deve ser substituído pelo número de credenciamento do PAF ECF cadastrado na Sefaz SC.
- BIGRETAIL-75788
- Para utilização do Storex Cloud em âmbito de loja, faz-se, necessário a atualização do Storex para a versão da Centauro 15.25.00.
- Para utilização do Storex Cloud em âmbito corporativo, não já necessidade de atualização do Storex.
BIGRETAIL-66815 [LWS] Resgate de Pedidos Magento
- POSSUI DEPENDÊNCIA COM OS SEGUINTES ITENS:
- STOREX HC 16.14.11
- SERVIDOR DE PEDIDOS 04.25.00
BIGRETAIL-69803 Criar parâmetro para imprimir número do pedido externo ou interno no comprovante não fiscal
- Criado novo parâmetro tipo boolean no Storex Cloud:
- FQDN: coupon-builder.print-external-order-number
- Descrição: Imprimir número do pedido externo ao invés do interno no cupom não fiscal
# - Criado configurações "ID de usuário para consulta de cliente no Linx Commerce", "Senha para consulta de cliente no Linx Commerce", "Senha para consulta de cliente no Linx Commerce". Obrigatoriamente devem ser configuradas para que o serviço de consulta de clientes no Linx Commerce funcione.BIGRETAIL-40033
"Número de dígitos que identificam o código pai do produto". Esse parâmetro envia no item do Promo um atributo codeSmall, efetuando um substring até o valor informado. Valores negativos serão considerados 0."
BIGRETAIL-57398:
Criação de novo parâmetro.
Parâmetro: Código do produto usado na emissão do DANFE
Domínio: INTERNAL/EXTERNAL [código interno / código externo]
Valor padrão: INTERNAL
BIGRETAIL-70778
Implementação das novas funcionalidades do PAF-NFC-e.
- BIGRETAIL-61653 [VM] Biometria - API VALIDAÇÃO - ajuste LWS
BIGRETAIL-68348: Validação Usuario X Loja - Storex Cloud
- Criado item de configuração (signin-settings.enable-store-validation) para controlar ou não o acesso do usuário por loja.
- BIGRETAIL-76482 Novos parâmetros para restricao de acesso
- URL base servico valida status funcionario Fujioka (String)
- Token para autenticacao em api de validacao de funcionario Fujioka (String)
- Username para a conseguir o token da API de status de funcionario Fujioka (String)
- Password para a conseguir o token da API de status de funcionario Fujioka (String)
- Habilita validação status funcionario (Boolean)
- Timeout em milissegundos para API valida status funcionario Fujioka (Integer)
Lista de Issue's Liberadas nesta Versão
Issue | Resumo | Número do caso |
BIGRETAIL-109547 | Melhoria no Serviço de Envio de E-mail do StorEx Cloud |
- Sem rótulos