Releases: nfe/whmcs-addon
v2.2.0
Esta versão implementa novos recursos e traz melhorias em rotinas existentes.
Novos Recursos
Validações para CPF e CNPJ
Foi incluída uma nova classe de auxílio Validations no módulo NFEioServiceInvoices. Essa classe contém métodos para validar CPFs e CNPJs com base no algoritmo de validação, conforme regras de verificação, ao invés da definição de validade de documento pelo tamanho de caracteres, garantindo a integridade dos dados tratados.
Agora quando o número de documento não for válido, seja um CPF ou CNPJ, o processo de emissão da nota será encerrado e uma mensagem com o motivo será mostrado ao usuário, além de um registro detalhado no log do módulo quando em modo depuração.
Validação e manipulação de webhook (hmac)
Foi adicionado um novo método de validação de webhook na classe de validação e uma nova manipulação de webhook no arquivo callback. Agora, é possível verificar a assinatura do webhook (HMAC) e certificar-se de que é de uma fonte confiável antes de processá-lo.
Também foi melhorado o retorno de erros e códigos de respostas para as chamadas da API ao callback, com isso é possível permitir que a API realize novas tentativas de envio em casos de impossibilidade do processamento na primeira chamada, evitando que atualizações de informações no módulo não sejam prejudicadas por qualquer impossibilidade momentânea do módulo em escutar os retornos.
Opção para atualização da nota
Foi adicionado na interface do administrador uma nova opção que permite a atualização do status da nota de forma manual. Com isso, é possível buscar as informações diretamente na API para refletir estas informações no WHMCS.
Este recurso é útil em casos onde as informações do status da nota não foram sincronizados com o módulo.
Melhorias
Tratamento de status do cancelamento da nota via API
Refatorado a manipulação do status da nota quando é realizada cancelamento para atender a estrutura atual de retorno da API de cancelamento. Antes, ao cancelar uma nota via API, o objeto de retorno possuía um atributo "message" onde o processo de atualização de notas cancelava se baseava. Agora, a API de cancelamento está retornando a nf no objeto e código de status 202. Devido a isso as notas canceladas não estavam sendo registradas adequadamente.
Melhoria no tratamento de erros e registro de status do fluxo
Foi adicionado o registro do valor de flowStatus dos retornos do webhook, garantindo que em cenários de falha ou problemas, a informação deste atributo esteja registrada corretamente para solução de problemas. Com isso será possível analisar as mensagens de retorno de forma mais eficiente e também utilizar seus valores para processamento nas rotinas de mensagens de retorno implementadas nestas atualizações.
Também foi padronizado os identificadores e adicionado novos registros de log para permitir uma melhor depuração, tanto do retorno do webhook quanto em rotinas internas do módulo.
NOTA: A mensagem ApiNoResponse é uma mensagem interna utilizada para identificar quando uma ação de cancelamento não retornou o devido status pela nota já se encontrar cancelada na API ou tiver sua emissão não concluída e o usuário tenta cancelar da mesma forma.
Modais de confirmação
Foi adicionado modais de confirmação para as ações de cancelamento e reemissão de notas fiscais.
Agora, ao realizar uma destas ações, o usuário será questionado se deseja prosseguir com a ação.
Correções
Corrigido problema no registro de timestamp das informações no banco de dados
Foi corrigido um problema na definicao do tipo de valor padrao para os campo de created_at e updated_at nas tabelas do módulo. As informações nao estavam sendo registradas devidamente por algumas definicoes manuais de data de rotinas legadas e também devido a falta de uma definicao de valores padroes para estas colunas do tipo timestamp que poderia gerar uma atribuição equivocada de valores nestes campos.
Detalhes da análise e correcao podem ser encontradas na questao 156 #156
Corrigido problema de re-emissão duplicada na fatura
Foi corrigido uma condição que poderia levar a emissão duplicada de notas quando administrador tenta gerar novas notas
a partir da visualização de uma fatura. #160
v2.1.9
v2.1.8
What's Changed
- Compatibilidade com PHP 8 e WHMCS 8.6 by @andrekutianski in #150
Full Changelog: v2.1.7...v2.1.8
Contributors
Assets 2
v2.1.7
v2.1.6
Correções
- [BUG] Nota Fiscal com status "processando" quando emissão falha #143
- Melhora a exibição das mensagens de status na interface web para os administradores.
Full Changelog: v2.1.5...v2.1.6
v2.1.5
v2.1.4
Melhoria
- Dropdown de seleção de empresas #72 by @andrekutianski in #131
Correção
- Cancela NF local quando resposta da API é nula #133 by @andrekutianski
- Corrige rotina de emissão manual quando initial_date está ausente #132 by @andrekutianski
- Aumenta quantidade máxima de caracteres para código de serviço personalizado #134 by @andrekutianski
Estilo
- Melhorado nomes e descrição de campos de configuração para refletirem nomes de campos da NFE.io by @andrekutianski
Full Changelog: v2.1.3...v2.1.4
Contributors
Assets 2
v2.1.3
A nova versão v2.1.3 do módulo de Notas Fiscais para WHMCS NFE.io já está disponível!
Nesta versão foram corrigidos os processos de cancelamento e reemissão de notas, assim como algumas melhorias na visualização das informações nas tabelas do módulo e inclusão das ações e cancelamento e reemissão de notas na visualização da fatura.
Correção
- Atualizada a lógica de reemissão das notas ficais, agora quando um administrador realizar a ação a nova nota receberá os dados mais recentes tanto da fatura quanto do cliente. Isso possibilita com que qualquer atualização nestas informações reflita na nota reemitida. (#125)
- Atualizada a lógica de cancelamento das notas ficais. Agora, caso uma fatura possua mais de uma NF, todas serão canceladas. Anteriormente o cancelamento era realizado apenas na nota específica. Com isso é possível cancelar e reemitir notas com informações recentes da fatura do cliente. (#125)
- Adicionado botões com as ações para cancelamento da nota fiscal e reemissão da série na visualizaçã/edição de uma fatura pelo administrador.
Atualização
- Atualizado pacotes e dependências do composer.
Full Changelog: v2.1.2...v2.1.3
v2.1.2
Correção
- Corrige inconsistência nos comandos de cancelamento de nota fiscal do módulo que não permitiam a alteração do status caso houvesse erro na emissão. (#125)
- Corrigido opção para possibilitar que uma nota cancelada possa ser reemitida. Este recurso emite uma nova nota com as mesmas informações da anterior (caso a fatura ou item tenha sido atualizado, essas informações NÃO refletirão na NF reemitida). (#125)
Melhoria
- Melhoria na diagramação das informações e inserção da coluna para exibição do ID da nota na NFE.io para facilitar identificação.
Full Changelog: v2.1.1...v2.1.2
v2.1.1
Correção
- fix: corrige erro de SQLSTATE by @andrekutianski in #124 #122
Full Changelog: v2.1.0...v2.1.1