Documentação de Release/2025/VERSÃO 5.2.10.16

Reforma Tributária - Redução e Diferimento IBS/CBS

1.1 Finalidade

Realizar a inclusão dos campos de alíquota para Diferimento do IBS-UF/CBS e Alíquota de Redução do IBS-UF/CBS no cadastro de produto.

1.2 Adição de novo campo na Tela do Cadastro de Cliente

Foi adicionado novo campo no cadastro do cliente visando contemplar as operações realizadas com entes governamentais (União, Estados, Municípios e suas autarquias/fundações). Essas operações possuem tratamento tributário diferenciado, podendo contar com “abatimentos” específicos na base de cálculo da CBS e do IBS:

No novo campo % Redutor será possível o usuário informar um valor numérico com 2 decimais, aceitando inclusive valor 0,00 ou vazio, não sendo possível o usuário digitar valores alfanuméricos.

Também foi adicionado um groupbox de nome “Compra Governamental” para agrupar as informações de órgãos públicos para melhor visualização do usuário.

1.3 Adição de novo campo na Tela do Cadastro de Produtos

Em continuidade, tornou-se necessário incluir novas opções no Cadastro de Produtos, a fim de permitir que o usuário insira as informações referentes às futuras  hipóteses  de   tributação do IBS e da CBS.

Os novos campos foram criados na aba IBS/CBS/IS, conforme demonstrado abaixo:

1.4 Adição de novo campo na Tela do Cadastro de Municípios

Em continuidade, foi necessário criar, na janela Cidades/Municípios, um novo campo destinado ao registro da Redução do IBS, conforme imagem abaixo:

2. Reforma Tributária - Configuração IBS/CBS

2.1 Finalidade

Com a implementação do cálculo do IBS/CBS no SupraMAIS, tornou-se necessário criar um mecanismo que permita o sistema identificar, de forma simples e padronizada, qual grupo de tributação deve ser gerado em cada operação.

2.2 Alteração na Tela do Cadastro do CST de IBS/CBS

Para atender à necessidade descrita acima, foram concebidos os checkboxes presentes na tela de configuração da CST IBS/CBS:

3. Expedição com Endereçamento

3.1 Finalidade

Aprimorar o módulo de controle de estoques do SupraMais permitindo que seja feito o endereçamento do estoque com o controle de localização de cada produto dentro de um ou mais armazéns.

3.2 Funcionalidades do Endereçamento na tela da Expedição

Com o aprimoramento do módulo de controle de estoque, o grid de itens a serem baixados passou por uma alteração referente ao endereçamento. Em razão disso, a coluna “Localização” foi substituída pela coluna “Endereço”. Essa alteração tem como objetivo permitir a exibição e a seleção de múltiplos endereços de separação para um mesmo item. A nova coluna apresentará comportamentos distintos, conforme a marcação do parâmetro de controle de endereços, que habilita ou desabilita suas funções avançadas, conforme descrito a seguir:

Se o parâmetro de endereçamento do estoque estiver desmarcado: o campo Localização terá o atributo “Somente Leitura”, ou seja, não será permitido selecionar endereços, além de exibir somente o endereço de picking determinado para o item.

Se o parâmetro de endereçamento do estoque estiver marcado: o funcionamento da expedição muda consideravelmente pois o sistema deixa de estar responsável apenas pela quantidade a ser baixada, mas passa a determinar também os endereços de onde cada item será retirado/colocado, a quantidade manuseada em cada endereço, os saldos e a reserva destas quantidades em seus endereços.

3.3 Funcionalidades do Endereçamento Picking no Pedido

Nos casos em que o usuário tiver permissão para editar os endereços exibidos na coluna “Localização” da tela de Expedição, será possível alterar o endereço diretamente. Ao clicar no botão existente na célula do grid (ícone com três pontinhos), o sistema exibirá uma janela para seleção de endereços.

No topo da janela estão os dados do item a ser baixado, que são o nome, a quantidade a unidade e o lote a ser movimentado. Os dados no grid obedecem aos critérios do topo da janela e contém as seguintes colunas, cada uma com suas regras:

Endereço: Permite selecionar o endereço que receberá ou cederá o item do lote especificado. Ao clicar no botão (três pontinhos) exibe a janela para seleção dos endereços. Se o pedido for de saída somente serão aceitos nesta coluna endereços que tenham quantidade do produto maior que zero. Também se o produto tiver controle de lote, somente listará endereços onde estiver presente aquele lote. O usuário deve selecionar um endereço em cada linha. Ao clicar no botão, o sistema exibirá a janela para seleção conforme ilustrada:

Quantidade: Permite informar a quantidade a ser manipulada no endereço. Se o pedido for de saída, a quantidade não pode ser maior que o valor da coluna de quantidade. A soma das linhas de quantidade deve coincidir com a quantidade a ser baixada, que aparece no topo da janela e na linha do grid de expedição.

Total: Exibe o somatório da coluna de quantidade.

Diferença: Exibe a diferença entre a quantidade a ser baixada e a soma da coluna de endereços.

Após o preenchimento correto das localizações, o usuário poderá prosseguir com a baixa do pedido, permitindo que o sistema efetue a baixa dos itens nas localizações informadas.

4. Impressão do Relatório de Separação com Controle de Endereçamento

4.1 Finalidade

A fim de orientar o separador quanto aos endereços de coleta dos itens, será necessário adaptar a impressão do relatório de separação de itens quando o parâmetro de controle de endereços estiver habilitado. Nessa condição, o sistema utilizará uma estrutura específica para a impressão, adequada à respectiva forma de visualização.

4.2 Impressão das bandas do Relatório de Separação

A disposição das bandas dos relatórios a seguir será variável de acordo com o número da página:

Um relatório de página única (com poucos itens) terá todas as bandas, fora isso a primeira página, a última página e as intermediárias terão constituição diferenciada.

Além de possuir novas regras para exibição do relatório o mesmo sofrerá alterações de layout tratadas nos tópicos a seguir.

4.3 Layout 1 - Ordenação por critérios que não sejam localização

Quando o parâmetro de controle de endereços estiver marcado, na aba Estoque a ordenação dos itens seja diferente de Localização e o pedido for de saída, o relatório de Separação será apresentado da seguinte maneira:

·       Código de barras e número do pedido: se refere ao número do Pedido.

·       S/Numero: continua sendo obtido da tela do Pedido

·       #: é uma coluna calculada na hora da impressão e serve apenas para numerar as bandas, não tem relação com o número do item no pedido, mas apenas numera a lista de separação.

·       Descrição do Produto: se refere ao nome do Produto e sempre será exibido em negrito.

·       Qtd Pend.: é a quantidade a ser separada, sempre será exibida em negrito.

·       Qtd Est.: é a quantidade física em estoque daquele produto naquele endereço.

·       Endereço: é o endereço de onde se deve retirar o item (se o pedido for de entrada é onde se deve colocar o item)

·       Descrição detalhada: quando configurado para exibir, ela mostrará a descrição detalhada do item, pode ser ocultada de acordo com parametrização.

·       Observação Expedição. Fica dentro da banda que só é exibida na última página e exibe a observação da expedição digitada na aba Observações do Pedido.

·       Produtos (Totalizador): mostra a contagem de produtos diferentes a ser separada, ou seja, é a soma agrupada por código do produto e não a contagem de itens do pedido.

·       Confirmação do pedido: data em que o pedido foi confirmado.

Para itens sem controle de lote, o sistema repetirá o item tantas vezes quantos forem os endereços a serem visitados para atender à quantidade solicitada. Observe que o agrupamento é realizado pelo código do produto, e o respectivo endereço é exibido na mesma linha do nome do item. As colunas de quantidade indicam, respectivamente, a quantidade disponível no endereço e a quantidade que deve ser retirada.

Para itens com controle de lote, a informação de endereço é apresentada apenas no detalhamento do lote, não sendo exibida na linha principal do item. Nesses casos, a quantidade pendente corresponde à soma das quantidades a serem coletadas de cada lote, enquanto a quantidade em estoque representa a soma das quantidades disponíveis nos endereços exibidos.

4.4 Layout 2 - Ordenação do Relatório pela localização

Quando a opção de ordenação do relatório for por localização, o layout será diferente a fim de favorecer o picking aplicando uma rota de separação configurada no sistema. O layout do relatório ordenado pela localização é ilustrado na imagem a seguir:

O critério de ordenação por localização não mais consistirá na ordem alfabética do endereço de estoque, mas sim na sequência de visitação definida no cadastro de endereços.

4.5 Definição de sequência para rotas de separação

A definição de sequência para rotas de separação tem por objetivo principal conceber maior precisão na elaboração do percurso de separação de pedidos ou mesmo de guarda de mercadorias quando houver impressão do relatório ordenado por localização.

Para conferir maior flexibilidade deverá ser montada pelo próprio usuário na tela de cadastro dos endereços em Tabelas > Estoque > Localização.

Para que seja corretamente alocado na rota de separação, todo endereço visitável para separação (normalmente os endereços de picking e talvez os endereços pulmão) deverá possuir informação de sequência para rota.

A seguir a ilustração da janela de cadastro de endereços contendo o grupobox de mapeamento e campo “Localizado Após” responsável por possibilitar a sequência da rota.

5. Automação de Faturamento

5.1 Finalidade

Aprimorar o módulo comercial do SupraMAIS, permitindo que o sistema realize o faturamento dos pedidos de forma autônoma, contemplando inicialmente os seguintes processos:

• Emissão de notas fiscais a partir dos pedidos;
• Transmissão das notas fiscais;
• Envio automático de e-mails com os dados das notas para o cliente e para a transportadora;
• Impressão do DANFE.

Essa reformulação tem como objetivo conferir maior agilidade e eficiência aos processos repetitivos atualmente executados manualmente.

5.2 Alteração da tela da Configuração de Parâmetros

Quando o check de habilitar rotinas de faturamento automático estiver habilitado nas Configurações de Parâmetros > Comercial, o suporte do sistema deverá ser acionado para que seja configurado o arquivo Json (Javascript Object Notation é um formato de texto leve e de fácil leitura, usado para armazenar e trocar dados estruturados entre um servidor e um aplicativo web.) conforme imagem abaixo:

5.3 Arquivo JSON

Abaixo a descrição de cada propriedade do json.

·       filtroDiasAposConfirmacaoPedido: é o filtro máximo de dias após a confirmação do pedido, pedidos que foram confirmados há mais de XX dias serão ignorados para a geração automática de notas. Este filtro tem utilidade nos casos de pedidos que são confirmados, mas ficam muito tempo aguardando baixa.

·       codigoUsuarioResponsavel: é o código do usuário que receberá alertas e notificações. Se este usuário estiver ausente (sem acessar o sistema) por um período superior a 8 dias a rotina de faturamento automática será suspensa até que um usuário assíduo seja nomeado para cuidar da rotina.

·       urlSupraMAISserver: é a url do Server a ser chamado pelo SupraWS para fazer a emissão das notas e outras rotinas.

·       gerarNFe: Quando estiver com valor “true”, o sistema irá gerar automaticamente a nota fiscal dos pedidos que estiverem disponibilizados.

·       transmitirNFe: Quando estiver com valor “true”, o sistema irá transmitir qualquer nota fiscal que se enquadre nos critérios de transmissão automática.

·       enviarEmailNotas: Quando estiver com valor “true”, o sistema irá enviar o e-mail com dados da nota conforme parametrização feita no SupraMAIS.

·       utilizarViewNotasEnviarEmail: quando estiver com valor “true” o sistema utilizará a view de consulta para obter os códigos das notas cujo e-mail deve ser enviado.

·       imprimirDanfe: Quando estiver com valor “true”, o sistema irá enviar o DANFE das notas para impressão obedecendo o modelo de DANFE configurados no SupraMAIS.

·       utilizarViewNotasImprimirDanfe: quando estiver com valor = true o sistema utilizará a view v_notas_imprimir_supra_ws para obter os códigos das notas cuja impressão deve ser realizada. A cada verificação periódica o sistema fará um select na view sem aplicar filtros adicionais.

·       codigosTiposPedidosGerarNotas: Trata-se de um array de inteiros. Quando estiver vazio [] pedidos de todos os tipos estarão aptos a emissão de notas automaticamente, porém quando possuir um ou mais códigos de tipos de pedidos separados por vírgulas [1,25,36] o sistema somente considerará pedidos desses tipos para emissão das notas.

5.4 Rotina Emissão de NFe automática

Uma vez que no JSON a propriedade "gerarNFe" = true, o sistema fará a geração de notas obtendo dados do banco de dados utilizando os seguintes filtros:

·       Pedidos confirmados;

·       Pedidos confirmados a partir da data limite configuradas pelo número de dias;

·       Pedidos com movimento de saída;

·       Pedidos totalmente baixados;

·       Pedidos cujo tipo de pedido possua informado o tipo de nota correspondente;

·       Pedidos cujo tipo de nota não movimente estoque;

·       Pedidos em cujo tipo de nota a série não seja de NFC-e;

·       Pedidos que sejam dos tipos informados na configuração caso tenham sido informados.

Somente serão feitas duas tentativas de emissão automática por pedido. A partir disso terá que ser emitida nota manualmente.

5.5 Rotina Transmissão de NFe automática

Como ocorre na Rotina de Emissão de nota, uma vez que no JSON a propriedade "transmitirNFe" = true, o sistema fará a transmissão de notas obtendo a lista de notas a transmitir do banco de dados aplicando os seguintes filtros:

·       Tanto notas emitidas manualmente quanto as automáticas são passiveis de transmissão;

·       Situação da nota = Emitida;

·       Situação da NFE = Não Processada;

·       Nota emitida a partir de zero hora (00:00) do dia anterior, ou seja, notas dos últimos dois dias;

·       Modelo de nota fiscal = 55, Nota Fiscal Eletrônica.

Nesse caso também serão feitas duas tentativas de transmissão, depois disso terá que ser tratada manualmente.

5.6 Rotina Envio de emails

Uma vez que no JSON a propriedade "enviarEmailNotas" = true, o sistema fará o envio dos dados da nota fiscal por e-mail de forma semelhante ao que se faz na emissão manual. As notas que serão enviadas obedecem aos seguintes critérios de filtragem:

·       Tanto notas emitidas manualmente quanto as automáticas são passiveis de envio de e-mail;

·       Situação da NFE = Autorizada;

·       Nota emitida a no máximo 14 dias;

·       Nota Autorizada a partir de zero hora do dia anterior, ou seja, máximo de 48 horas após transmissão;

·       Modelo de nota fiscal = 55, Nota Fiscal Eletrônica;

·       Cliente possua e-mail de faturamento nos contatos;

·       Nota cuja e-mail ainda não foi enviado;

5.7 Rotina Impressão de Danfe

Caso no JSON a propriedade "imprimirDanfe": = true,  o sistema enviará os DANFE das notas para a impressora definida no tipo de nota correspondente e no modelo especificado no tipo de nota.

Serão enviadas para impressão notas que atenderem os seguintes critérios de filtragem:

·       Tanto notas emitidas manualmente quanto as automáticas são passiveis de impressão;

·       Situação da NFE = Autorizada;

·       Nota emitida a no máximo 14 dias;

·       Nota Autorizada a partir de zero hora do dia anterior, ou seja, máximo de 48 horas após transmissão

·       Modelo de nota fiscal = 55, Nota Fiscal Eletrônica;

·       Notas cujo Danfe ainda não foi impresso.