Portal do Conhecimento MicroUniverso - Contribuições do usuário [pt-br]

O arquivo contém 1 ou mais erros no de validação de esquema '4610000 ' viola a restrição pattern de '0-9 8 '. Falha da análise do elemento ' http://www.portalfiscal.inf.br/nfe CEP' com valor '4610000

2026-10-15T18:08:34Z

Arione: O arquivo contém 1 ou mais erros no de validação de esquema '4610000 ' viola a restrição pattern de '0-9 8 '. Falha da análise do elemento ' http://www.portalfiscal.inf.br/nfe CEP' com valor '4610000

==Tutorial==
'''Durante a emissão de uma NFC-e pelo sistema MicroUniverso, pode ocorrer uma falha na validação do XML devido ao CEP informado no cadastro do cliente estar incorreto ou incompleto.'''

'''Mensagem de erro:'''

Não foi possível VALIDAR XML da NFC-e nº 094411.

O arquivo contém 1 ou mais erros no de validação de esquema '4610000_' viola a restrição pattern de '[0-9]{8}'. Falha da análise do elemento '{<nowiki>http://www.portalfiscal.inf.br/nfe}CEP'</nowiki> com valor '4610000_
[[Arquivo:Imagetry5.png|centro|525x525px]]

== Causa ==
O erro ocorre porque o CEP informado no cadastro do cliente não atende ao formato exigido para a emissão da NFC-e.

O campo CEP deve conter exatamente '''8 caracteres numéricos''', sem letras, espaços ou outros caracteres especiais.

No exemplo apresentado, o CEP <code>4610000_</code> está inválido, pois contém um caractere não numérico e possui apenas 7 dígitos numéricos.

== Solução ==
Para corrigir o problema, siga os passos abaixo:

# Acesse o cadastro do cliente no sistema MicroUniverso.
# Localize o cliente relacionado ao pedido que está sendo faturado.
# Acesse os dados do endereço do cliente.
# Localize o campo '''CEP''' e corrija a informação, preenchendo o CEP correto com os 8 dígitos numéricos.
# Salve as alterações no cadastro.
# Retorne ao pedido e realize novamente o faturamento para emitir a NFC-e.

'''Importante:''' confirme o CEP correto do cliente antes de realizar a alteração.

== Resultado esperado ==
Após corrigir o CEP no cadastro do cliente, o XML deverá ser gerado '''(faturar o mesmo pedido novamente)''' com a informação no formato esperado, permitindo a validação e a continuidade do processo de emissão da NFC-e, desde que não existam outras inconsistências.
[[Categoria:Documentos Fiscais Eletrônicos]]

O arquivo contém 1 ou mais erros no de validação de esquema '4610000 ' viola a restrição pattern de '0-9 8 '. Falha da análise do elemento ' http://www.portalfiscal.inf.br/nfe CEP' com valor '4610000

2026-10-15T18:08:10Z

==Tutorial==
'''Durante a emissão de uma NFC-e pelo sistema MicroUniverso, pode ocorrer uma falha na validação do XML devido ao CEP informado no cadastro do cliente estar incorreto ou incompleto.'''

'''Mensagem de erro:'''

Não foi possível VALIDAR XML da NFC-e nº 094411.

O arquivo contém 1 ou mais erros no de validação de esquema '4610000_' viola a restrição pattern de '[0-9]{8}'. Falha da análise do elemento '{<nowiki>http://www.portalfiscal.inf.br/nfe}CEP'</nowiki> com valor '4610000_
[[Arquivo:Imagetry5.png|centro|525x525px]]

== Causa ==
O erro ocorre porque o CEP informado no cadastro do cliente não atende ao formato exigido para a emissão da NFC-e.

O campo CEP deve conter exatamente '''8 caracteres numéricos''', sem letras, espaços ou outros caracteres especiais.

No exemplo apresentado, o CEP <code>4610000_</code> está inválido, pois contém um caractere não numérico e possui apenas 7 dígitos numéricos.

== Solução ==
Para corrigir o problema, siga os passos abaixo:

# Acesse o cadastro do cliente no sistema MicroUniverso.
# Localize o cliente relacionado ao pedido que está sendo faturado.
# Acesse os dados do endereço do cliente.
# Localize o campo '''CEP''' e corrija a informação, preenchendo o CEP correto com os 8 dígitos numéricos.
# Salve as alterações no cadastro.
# Retorne ao pedido e realize novamente o faturamento para emitir a NFC-e.

'''Importante:''' confirme o CEP correto do cliente antes de realizar a alteração.

== Resultado esperado ==
Após corrigir o CEP no cadastro do cliente, o XML deverá ser gerado '''(faturar o mesmo pedido novamente)''' com a informação no formato esperado, permitindo a validação e a continuidade do processo de emissão da NFC-e, desde que não existam outras inconsistências.

Arquivo:Imagetry5.png

2026-10-15T18:07:10Z

Arione:

Imagetry5

NF-e - Como resolver a Rejeição 1005? Operação presencial fora do estabelecimento sem informação do município do fato gerador do IBS

2026-10-14T18:11:33Z

Arione: NF-e - Como resolver a Rejeição 1005? Operação presencial fora do estabelecimento sem informação do município do fato gerador do IBS

==Tutorial==
'''Orientar sobre como identificar e corrigir a Rejeição 1005 na emissão de NFC-e, quando o município do fato gerador do IBS/CBS não é informado para uma operação presencial realizada fora do estabelecimento do emitente.'''

== Quando ocorre ==
A Rejeição 1005 ocorre quando a NFC-e é emitida com o indicador de presença igual a '''5 – Operação presencial, fora do estabelecimento''', mas o município do fato gerador do IBS/CBS não é informado no XML.

Nessa situação, a SEFAZ exige o preenchimento do campo <code>cMunFGIBS</code>, que identifica o município onde ocorreu o fato gerador do IBS e da CBS.

== Causa ==
A rejeição pode ocorrer quando:

* O indicador de presença (<code>indPres</code>) está preenchido com o código <code>5</code>.
* O campo <code>cMunFGIBS</code> não foi informado ou está vazio no XML da NFC-e.
* A configuração da operação não informa corretamente o município onde ocorreu a venda.

Conforme a regra de validação B25b-70, relacionada à Nota Técnica 2025.002, quando o indicador de presença é igual a <code>5</code>, o município do fato gerador do IBS/CBS deve ser informad

== Como resolver ==

=== 1. Verifique o indicador de presença ===
Confira o indicador de presença informado na NFC-e e confirme se corresponde à operação realizada.

* '''Código 1 – Operação presencial, no estabelecimento:''' utilizado quando a venda ocorre presencialmente no estabelecimento do emitente.
* '''Código 5 – Operação presencial, fora do estabelecimento:''' utilizado quando a venda ocorre presencialmente em local externo, como em vendas ambulantes ou feiras.

Se a operação ocorreu no estabelecimento, corrija o indicador de presença para o código correspondente. Não altere essa informação apenas para contornar a rejeição.

=== 2. Identifique o município da operação ===
Se a venda ocorreu fora do estabelecimento, identifique o município onde efetivamente ocorreu o fato gerador do IBS/CBS.

Utilize o código IBGE correspondente ao município, composto por sete dígitos.

=== 3. Confira o XML da NFC-e ===
Verifique se o campo <code>cMunFGIBS</code> está sendo gerado e preenchido corretamente no XML da nota fiscal.

Exemplo ilustrativo:

[[Arquivo:Imagetw2.png|centro|890x890px]]

'''Observação:''' o código <code>4106902</code> é utilizado apenas como exemplo e corresponde ao município de Curitiba/PR. Informe o código do município onde ocorreu efetivamente a operação.

=== 4. Ajuste a configuração e transmita novamente ===
Caso o campo não esteja sendo gerado pelo sistema, verifique a configuração da operação e os parâmetros utilizados na emissão da NFC-e.

Se necessário, solicite ao suporte técnico a análise da geração do XML para garantir que o campo <code>cMunFGIBS</code> seja preenchido corretamente.

Após realizar os ajustes, gere novamente a NFC-e e transmita-a para validação da SEFAZ.

== Observação ==
O município informado deve corresponder ao local efetivo do fato gerador, conforme as regras fiscais aplicáveis. Não utilize automaticamente o município do emitente ou do destinatário sem confirmar a regra aplicável à operação.
[[Categoria:Documentos Fiscais Eletrônicos]]

Arquivo:Imagetw2.png

2026-10-14T18:11:07Z

Arione:

Imagetw2

Arquivo:Image897u.png

2026-10-14T17:23:02Z

Arione:

Image897u

Rejeição 1164 – Não informado tipo de nota de crédito

2026-10-09T14:43:34Z

Arione: Rejeição 1164 – Não informado tipo de nota de crédito

==Tutorial==
'''Orientar sobre como identificar e corrigir a rejeição 1164, apresentada durante a transmissão de uma NF-e quando o Tipo de Nota de Crédito não foi informado.'''

== Quando ocorre ==
A rejeição '''1164 – Não informado tipo de nota de crédito''' ocorre quando a NF-e é emitida com a Finalidade de Emissão igual a '''5 – Nota de Crédito''' (<code>finNFe = 5</code>), mas o campo obrigatório '''Tipo de Nota de Crédito''' (<code>tpNFCredito</code>) não foi preenchido.

Dependendo do sistema emissor ou da validação apresentada, a mensagem pode estar associada a outros códigos de rejeição.

== Como resolver ==
'''1. Acesse a operação ou a nota fiscal'''

Tradewin | Operações | Entradas | Retorno de Mercadoria Não Entregue

'''2. Confira a finalidade de emissão'''

Verifique se a nota está configurada com a finalidade '''5 – Nota de Crédito'''.

Caso essa finalidade não corresponda à operação realizada, revise a configuração fiscal antes de prosseguir.

[[Arquivo:Image76y.png|centro|527x527px]]
'''3. Informe o Tipo de Nota de Crédito'''

Localize o campo correspondente ao '''Tipo de Nota de Crédito''' (<code>tpNFCredito</code>) no cabeçalho da nota ou nos parâmetros da operação.

Preencha o campo com a opção adequada à operação fiscal realizada, conforme as regras tributárias aplicáveis.
'''4. Confira as regras complementares'''
Antes de transmitir novamente a NF-e, verifique:

* Se o tipo de operação está configurado como entrada, quando exigido pela regra fiscal aplicável (<code>tpNF = 0</code>).
* Se os dados fiscais obrigatórios estão preenchidos corretamente.
* Se os grupos de tributação IBS/CBS, quando aplicáveis, estão de acordo com as regras vigentes.
* Se a finalidade de emissão e o tipo de nota de crédito são compatíveis com a operação realizada.

'''5. Transmita a nota novamente'''

Após realizar os ajustes, gere ou atualize o XML da NF-e e transmita a nota novamente para validação da SEFAZ.

[[Arquivo:Image644s2.png|centro|507x507px]]

== Observação ==
O Tipo de Nota de Crédito deve ser definido conforme a operação fiscal realizada. Não selecione uma opção apenas para eliminar a rejeição.

Caso o campo não esteja disponível no sistema, verifique se há necessidade de atualização da versão ou de ajuste na configuração fiscal, com o apoio do suporte responsável.

Em caso de dúvidas sobre o enquadramento tributário, consulte a contabilidade responsável pela empresa.
[[Categoria:Documentos Fiscais Eletrônicos]]

Rejeição 1164 – Não informado tipo de nota de crédito

2026-10-09T14:38:58Z

Arione: Rejeição 1164 – Não informado tipo de nota de crédito

==Tutorial==
'''Orientar sobre como identificar e corrigir a rejeição 1164, apresentada durante a transmissão de uma NF-e quando o Tipo de Nota de Crédito não foi informado.'''

== Quando ocorre ==
A rejeição '''1164 – Não informado tipo de nota de crédito''' ocorre quando a NF-e é emitida com a Finalidade de Emissão igual a '''5 – Nota de Crédito''' (<code>finNFe = 5</code>), mas o campo obrigatório '''Tipo de Nota de Crédito''' (<code>tpNFCredito</code>) não foi preenchido.

Dependendo do sistema emissor ou da validação apresentada, a mensagem pode estar associada a outros códigos de rejeição.

== Como resolver ==
'''1. Acesse a operação ou a nota fiscal'''

Tradewin | Operações | Entradas | Retorno de Mercadoria Não Entregue

'''2. Confira a finalidade de emissão'''

Verifique se a nota está configurada com a finalidade '''5 – Nota de Crédito'''.

Caso essa finalidade não corresponda à operação realizada, revise a configuração fiscal antes de prosseguir.

[[Arquivo:Image76y.png|centro|527x527px]]
'''3. Informe o Tipo de Nota de Crédito'''

Localize o campo correspondente ao '''Tipo de Nota de Crédito''' (<code>tpNFCredito</code>) no cabeçalho da nota ou nos parâmetros da operação.

Preencha o campo com a opção adequada à operação fiscal realizada, conforme as regras tributárias aplicáveis.
'''4. Confira as regras complementares'''
Antes de transmitir novamente a NF-e, verifique:

* Se o tipo de operação está configurado como entrada, quando exigido pela regra fiscal aplicável (<code>tpNF = 0</code>).
* Se os dados fiscais obrigatórios estão preenchidos corretamente.
* Se os grupos de tributação IBS/CBS, quando aplicáveis, estão de acordo com as regras vigentes.
* Se a finalidade de emissão e o tipo de nota de crédito são compatíveis com a operação realizada.

'''5. Transmita a nota novamente'''

Após realizar os ajustes, gere ou atualize o XML da NF-e e transmita a nota novamente para validação da SEFAZ.

[[Arquivo:Image644s2.png|centro|507x507px]]

== Observação ==
O Tipo de Nota de Crédito deve ser definido conforme a operação fiscal realizada. Não selecione uma opção apenas para eliminar a rejeição.

Caso o campo não esteja disponível no sistema, verifique se há necessidade de atualização da versão ou de ajuste na configuração fiscal, com o apoio do suporte responsável.

Em caso de dúvidas sobre o enquadramento tributário, consulte a contabilidade responsável pela empresa.

Arquivo:Image644s2.png

2026-10-09T14:37:37Z

Arione:

Image644s

Arquivo:Image76y.png

2026-10-09T14:32:02Z

Arione:

Image76y

Liberação para troca de endereço de entrega com diferença de frete.

2026-10-08T19:22:44Z

Arione: Liberação para troca de endereço de entrega com diferença de frete.

==Tutorial==
'''Orientar sobre a configuração da senha de liberação necessária quando a alteração do endereço de entrega de um pedido resultar em aumento do valor do frete.'''

== Configuração da senha ==
Para permitir a liberação da alteração do endereço de entrega quando houver diferença de frete, é necessário cadastrar uma senha de venda com a seguinte finalidade:

'''Libera troca de endereço de entrega com diferença no valor do frete'''

=== Caminho ===
'''Tradewin → Arquivos → Senhas de Vendas'''

A senha cadastrada será solicitada quando o novo endereço de entrega resultar em um valor de frete superior ao valor originalmente cobrado no pedido.

[[Arquivo:Image9i87.png|centro|635x635px]]

== Funcionamento ==
Ao alterar o endereço de entrega de um pedido, o sistema poderá identificar um '''novo roteiro''' para o endereço informado.

A alteração do roteiro pode resultar em uma mudança no valor do frete.

Quando o valor do frete calculado para o novo endereço for '''maior que o valor do frete originalmente cobrado no pedido''', o sistema solicitará uma senha de liberação.

Sem uma senha válida, a alteração do endereço de entrega não poderá ser concluída.

[[Arquivo:Image11w.png|centro|653x653px]]
[[Categoria:Gestão de Entregas]]

Liberação para troca de endereço de entrega com diferença de frete.

2026-10-08T19:22:25Z

Arione: Liberação para troca de endereço de entrega com diferença de frete.

==Tutorial==
'''Orientar sobre a configuração da senha de liberação necessária quando a alteração do endereço de entrega de um pedido resultar em aumento do valor do frete.'''

== Configuração da senha ==
Para permitir a liberação da alteração do endereço de entrega quando houver diferença de frete, é necessário cadastrar uma senha de venda com a seguinte finalidade:

'''Libera troca de endereço de entrega com diferença no valor do frete'''

=== Caminho ===
'''Tradewin → Arquivos → Senhas de Vendas'''

A senha cadastrada será solicitada quando o novo endereço de entrega resultar em um valor de frete superior ao valor originalmente cobrado no pedido.

[[Arquivo:Image9i87.png|centro|635x635px]]

== Funcionamento ==
Ao alterar o endereço de entrega de um pedido, o sistema poderá identificar um '''novo roteiro''' para o endereço informado.

A alteração do roteiro pode resultar em uma mudança no valor do frete.

Quando o valor do frete calculado para o novo endereço for '''maior que o valor do frete originalmente cobrado no pedido''', o sistema solicitará uma senha de liberação.

Sem uma senha válida, a alteração do endereço de entrega não poderá ser concluída.

[[Arquivo:Image11w.png|centro|653x653px]]

Arquivo:Image11w.png

2026-10-08T19:22:06Z

Arione:

Image11

Arquivo:Image9i87.png

2026-10-08T19:12:00Z

Arione:

Image9i87

Trocar endereço de entrega do pedido – Tratamento de roteiro

2026-10-08T18:47:27Z

Arione: Trocar endereço de entrega do pedido – Tratamento de roteiro

==Tutorial==
'''A rotina Trocar endereço de entrega permite alterar o endereço de entrega de um pedido já cadastrado, realizando também o tratamento do roteiro de entrega conforme as regras configuradas no orçamento.'''

'''Com o tratamento de roteiro habilitado, ao alterar o endereço de entrega o sistema poderá identificar automaticamente o novo roteiro, exigir sua definição ou permitir que o usuário o selecione, de acordo com os parâmetros configurados.'''

== Localização ==
'''Sistema de Usuários → Movimentos → Trocar endereço de entrega'''
[[Arquivo:Image7u61.png|centro]]

== Funcionamento ==
Após informar o pedido, o sistema atualiza os dados do endereço de entrega e verifica o roteiro correspondente ao novo endereço.

O campo '''Roteiro''' apresenta o roteiro relacionado ao pedido. Para pedidos que não possuem roteiro definido, o campo permanecerá em branco.

O comportamento do roteiro depende da configuração dos parâmetros utilizados no orçamento, principalmente:

* '''Roteiro obrigatório no orçamento'''
* '''Tratar roteiro automático no orçamento'''
* '''Utilizar no orçamento bairros pré-cadastrados'''
* '''Permite cadastrar bairro no orçamento'''
* '''Utiliza roteiro por faixa de CEP'''
* '''Tratamento de valor do frete por roteiro'''
* '''Utilizar tratamento de Frete/Carga no Orçamento'''

== Tratamento do bairro ==
Quando o parâmetro '''Utilizar no orçamento bairros pré-cadastrados''' estiver habilitado, o sistema poderá exigir que o bairro informado esteja previamente cadastrado como categoria.

Quando o cadastro de bairro estiver permitido, ao informar um bairro que não esteja cadastrado será apresentada a mensagem:<blockquote>'''Bairro não cadastrado. Deseja cadastrá-lo [Sim/Não]?'''</blockquote>Ao selecionar '''Sim''', o bairro será cadastrado como categoria.

Ao selecionar '''Não''', o bairro não será cadastrado e não poderá ser utilizado no endereço.

== Identificação do roteiro ==
Quando o parâmetro '''Tratar roteiro automático no orçamento''' estiver habilitado, o sistema poderá identificar automaticamente o roteiro com base na '''cidade e/ou bairro''' do endereço de entrega.

Dependendo da configuração, o roteiro poderá:

* Ser definido automaticamente pelo sistema;
* Ser obrigatório;
* Ser selecionado manualmente pelo usuário;
* Permanecer em branco quando não for obrigatório.

Quando o roteiro automático não estiver habilitado, o sistema não fará a identificação automática, podendo permitir a seleção manual do roteiro.

=== Roteiro por faixa de CEP ===
Quando os parâmetros '''Roteiro obrigatório no Orçamento''', '''Tratar roteiro automático no orçamento''' e '''Utiliza roteiro por faixa de CEP''' estiverem habilitados, o roteiro deverá ser obtido através do '''CEP do endereço de entrega'''.

== Campo Roteiro ==
O campo '''Roteiro''' será apresentado inicialmente desabilitado.

Após informar o pedido e atualizar os dados da tela, o campo poderá ser habilitado quando:

# O parâmetro '''Tratar roteiro automático no orçamento''' estiver desligado;
# O parâmetro '''Roteiro obrigatório no Orçamento''' estiver desligado;
# Os parâmetros de roteiro automático estiverem ligados, mas o sistema não localizar um roteiro para o endereço informado.

Quando habilitado, o campo apresentará os roteiros cadastrados, contendo '''Código''' e '''Descrição do roteiro'''.

== Roteiro obrigatório ==
Quando o parâmetro '''Roteiro obrigatório no Orçamento''' estiver habilitado, o sistema não permitirá concluir a alteração do endereço caso nenhum roteiro esteja definido.

Será apresentada a mensagem:<blockquote>'''Deve ser definido o roteiro para o endereço de entrega.'''</blockquote>Nesse cenário, a alteração do endereço somente poderá ser concluída após a definição de um roteiro.

== Tratamento do frete ==
Quando a alteração do endereço provocar uma mudança no roteiro, o sistema poderá recalcular o valor do frete conforme as regras configuradas.

O cálculo poderá considerar:

* Valor total do pedido;
* Itens de entrega futura;
* Itens de entrega futura por carga;
* Roteiro;
* Faixa de CEP;
* Faixa de valores da venda;
* Valor mínimo de venda;
* Valor de frete definido no cadastro do roteiro.

=== Diferença de frete ===
Caso o novo roteiro resulte em um valor de frete '''maior que o frete cobrado anteriormente no pedido''', o sistema exibirá um aviso e solicitará uma senha de liberação.

A mensagem apresentada será:<blockquote>'''ATENÇÃO!!!'''

Em função do novo endereço de entrega e por ter havido cobrança de frete na venda, foi verificado que o valor de frete do novo endereço é maior do que o valor do frete cobrado na venda com endereço anterior.</blockquote>Para prosseguir, deverá ser informada uma senha válida para:

'''Libera troca de endereço de entrega com diferença no valor do frete'''

Sem uma senha válida, o endereço de entrega não será alterado.

== Histórico da liberação ==
Quando uma senha válida for utilizada para autorizar a alteração com diferença de frete, o sistema registrará a liberação no histórico do pedido, incluindo:

* Usuário/senha responsável pela liberação;
* Roteiro anterior;
* Novo roteiro;
* Diferença de frete.

Exemplo do histórico:

'''Novo endereço de entrega com diferença de frete aprovado por [NOME]. Roteiro anterior: 999 - Novo roteiro: 999 - Diferença de frete a maior: R$ 999,99.'''

== Parâmetros envolvidos ==
{| class="wikitable"
!Parâmetro
!Abrangência
|-
|Roteiro obrigatório no orçamento
|Filial
|-
|Tratar roteiro automático no orçamento
|Empresa
|-
|Permite cadastrar bairro no orçamento
|Geral
|-
|Utilizar no orçamento bairros pré-cadastrados
|Geral
|-
|Utiliza roteiro por faixa de CEP
|Filial
|-
|Tratamento de valor do frete por roteiro
|Filial
|-
|Reduzir dados obrigatórios nos orçamentos na situação de apenas orçando
|Geral
|}

* '''Tratar roteiro automático no orçamento = S'''
* '''Utilizar no orçamento bairros pré-cadastrados = S'''
* '''Roteiro obrigatório no orçamento = S'''
[[Categoria:Gestão de Entregas]]

Trocar endereço de entrega do pedido – Tratamento de roteiro

2026-10-08T18:38:59Z

Arione: Trocar endereço de entrega do pedido – Tratamento de roteiro

==Tutorial==
'''A rotina Trocar endereço de entrega permite alterar o endereço de entrega de um pedido já cadastrado, realizando também o tratamento do roteiro de entrega conforme as regras configuradas no orçamento.'''

'''Com o tratamento de roteiro habilitado, ao alterar o endereço de entrega o sistema poderá identificar automaticamente o novo roteiro, exigir sua definição ou permitir que o usuário o selecione, de acordo com os parâmetros configurados.'''

== Localização ==
'''Sistema de Usuários → Movimentos → Trocar endereço de entrega'''
[[Arquivo:Image7u61.png|centro]]

== Funcionamento ==
Após informar o pedido, o sistema atualiza os dados do endereço de entrega e verifica o roteiro correspondente ao novo endereço.

O campo '''Roteiro''' apresenta o roteiro relacionado ao pedido. Para pedidos que não possuem roteiro definido, o campo permanecerá em branco.

O comportamento do roteiro depende da configuração dos parâmetros utilizados no orçamento, principalmente:

* '''Roteiro obrigatório no orçamento'''
* '''Tratar roteiro automático no orçamento'''
* '''Utilizar no orçamento bairros pré-cadastrados'''
* '''Permite cadastrar bairro no orçamento'''
* '''Utiliza roteiro por faixa de CEP'''
* '''Tratamento de valor do frete por roteiro'''
* '''Utilizar tratamento de Frete/Carga no Orçamento'''

== Tratamento do bairro ==
Quando o parâmetro '''Utilizar no orçamento bairros pré-cadastrados''' estiver habilitado, o sistema poderá exigir que o bairro informado esteja previamente cadastrado como categoria.

Quando o cadastro de bairro estiver permitido, ao informar um bairro que não esteja cadastrado será apresentada a mensagem:<blockquote>'''Bairro não cadastrado. Deseja cadastrá-lo [Sim/Não]?'''</blockquote>Ao selecionar '''Sim''', o bairro será cadastrado como categoria.

Ao selecionar '''Não''', o bairro não será cadastrado e não poderá ser utilizado no endereço.

== Identificação do roteiro ==
Quando o parâmetro '''Tratar roteiro automático no orçamento''' estiver habilitado, o sistema poderá identificar automaticamente o roteiro com base na '''cidade e/ou bairro''' do endereço de entrega.

Dependendo da configuração, o roteiro poderá:

* Ser definido automaticamente pelo sistema;
* Ser obrigatório;
* Ser selecionado manualmente pelo usuário;
* Permanecer em branco quando não for obrigatório.

Quando o roteiro automático não estiver habilitado, o sistema não fará a identificação automática, podendo permitir a seleção manual do roteiro.

=== Roteiro por faixa de CEP ===
Quando os parâmetros '''Roteiro obrigatório no Orçamento''', '''Tratar roteiro automático no orçamento''' e '''Utiliza roteiro por faixa de CEP''' estiverem habilitados, o roteiro deverá ser obtido através do '''CEP do endereço de entrega'''.

== Campo Roteiro ==
O campo '''Roteiro''' será apresentado inicialmente desabilitado.

Após informar o pedido e atualizar os dados da tela, o campo poderá ser habilitado quando:

# O parâmetro '''Tratar roteiro automático no orçamento''' estiver desligado;
# O parâmetro '''Roteiro obrigatório no Orçamento''' estiver desligado;
# Os parâmetros de roteiro automático estiverem ligados, mas o sistema não localizar um roteiro para o endereço informado.

Quando habilitado, o campo apresentará os roteiros cadastrados, contendo '''Código''' e '''Descrição do roteiro'''.

== Roteiro obrigatório ==
Quando o parâmetro '''Roteiro obrigatório no Orçamento''' estiver habilitado, o sistema não permitirá concluir a alteração do endereço caso nenhum roteiro esteja definido.

Será apresentada a mensagem:<blockquote>'''Deve ser definido o roteiro para o endereço de entrega.'''</blockquote>Nesse cenário, a alteração do endereço somente poderá ser concluída após a definição de um roteiro.

== Tratamento do frete ==
Quando a alteração do endereço provocar uma mudança no roteiro, o sistema poderá recalcular o valor do frete conforme as regras configuradas.

O cálculo poderá considerar:

* Valor total do pedido;
* Itens de entrega futura;
* Itens de entrega futura por carga;
* Roteiro;
* Faixa de CEP;
* Faixa de valores da venda;
* Valor mínimo de venda;
* Valor de frete definido no cadastro do roteiro.

=== Diferença de frete ===
Caso o novo roteiro resulte em um valor de frete '''maior que o frete cobrado anteriormente no pedido''', o sistema exibirá um aviso e solicitará uma senha de liberação.

A mensagem apresentada será:<blockquote>'''ATENÇÃO!!!'''

Em função do novo endereço de entrega e por ter havido cobrança de frete na venda, foi verificado que o valor de frete do novo endereço é maior do que o valor do frete cobrado na venda com endereço anterior.</blockquote>Para prosseguir, deverá ser informada uma senha válida para:

'''Libera troca de endereço de entrega com diferença no valor do frete'''

Sem uma senha válida, o endereço de entrega não será alterado.

== Histórico da liberação ==
Quando uma senha válida for utilizada para autorizar a alteração com diferença de frete, o sistema registrará a liberação no histórico do pedido, incluindo:

* Usuário/senha responsável pela liberação;
* Roteiro anterior;
* Novo roteiro;
* Diferença de frete.

Exemplo do histórico:

'''Novo endereço de entrega com diferença de frete aprovado por [NOME]. Roteiro anterior: 999 - Novo roteiro: 999 - Diferença de frete a maior: R$ 999,99.'''

== Parâmetros envolvidos ==
{| class="wikitable"
!Parâmetro
!Abrangência
|-
|Roteiro obrigatório no orçamento
|Filial
|-
|Tratar roteiro automático no orçamento
|Empresa
|-
|Permite cadastrar bairro no orçamento
|Geral
|-
|Utilizar no orçamento bairros pré-cadastrados
|Geral
|-
|Utiliza roteiro por faixa de CEP
|Filial
|-
|Tratamento de valor do frete por roteiro
|Filial
|-
|Reduzir dados obrigatórios nos orçamentos na situação de apenas orçando
|Geral
|}

* '''Tratar roteiro automático no orçamento = S'''
* '''Utilizar no orçamento bairros pré-cadastrados = S'''
* '''Roteiro obrigatório no orçamento = S'''

Arquivo:Image7u61.png

2026-10-08T18:38:13Z

Arione:

Image7u6

Mapa De Carga com Endereço de Entrega - Gráfico

2026-09-23T13:09:34Z

Arione: Mapa De Carga com Endereço de Entrega - Gráfico

==Tutorial==
'''O recurso Mapa de Carga com Endereço de Entrega permite consultar e gerar informações relacionadas às cargas, apresentando os endereços de entrega dos pedidos que compõem a carga.'''

'''Essa funcionalidade pode auxiliar na conferência e no planejamento das entregas, permitindo visualizar as informações de forma gráfica ou em texto.'''

== Caminho de acesso ==
Para acessar a funcionalidade, siga o caminho:

'''Logística → Mapa da carga → Mapa de Carga com Endereço de Entrega'''

Conforme a necessidade, estão disponíveis as opções:

* '''Mapa de carga simplificado'''
* '''Detalhado'''
** '''Gráfico'''
** '''Texto'''[[Arquivo:Image786y.png|centro|875x875px]]

== Opções disponíveis ==

=== Mapa de carga simplificado ===
Apresenta uma visão simplificada das informações relacionadas à carga e aos respectivos endereços de entrega.

=== Detalhado ===
A opção '''Detalhado''' permite selecionar a forma de apresentação das informações:

'''Gráfico:''' apresenta os dados da carga em formato gráfico, facilitando a visualização das informações de entrega.

'''Texto:''' apresenta as informações da carga em formato textual, possibilitando a consulta detalhada dos dados.

== Utilização ==
O recurso pode ser utilizado para consultar as informações dos pedidos vinculados a uma carga e seus respectivos '''endereços de entrega''', auxiliando na organização, conferência e acompanhamento das entregas.

=== Resumo do caminho ===
'''Logística → Mapa da carga → Mapa de Carga com Endereço de Entrega → Detalhado → Gráfico/Text'''o.
[[Categoria:Gestão de Entregas]]

Arquivo:Image786y.png

2026-09-23T13:08:51Z

Arione:

Image786y

Arquivo:Image7u6.png

2026-09-23T13:08:07Z

Arione:

Image7u6

Relatório de Fechamento de Caixa em Excel ou arquivo TXT

2026-09-22T16:10:55Z

Arione: Relatório de Fechamento de Caixa em Excel ou arquivo TXT

==Tutorial==
'''Orientar como realizar a impressão do Relatório de Fechamento de Caixa, permitindo selecionar o formato do arquivo para exportação em Excel ou TXT.'''

== Módulo - Fechamento de Caixa (TradFcx) ==

== Procedimento ==
Para gerar o Relatório de Fechamento de Caixa em um dos formatos disponíveis, siga os passos abaixo:

# Acesse o menu do sistema responsável pelo '''Fechamento de Caixa'''.
# Informe os filtros necessários para localizar o fechamento que deseja consultar.
# Gere o '''Relatório de Fechamento de Caixa'''.
# Na opção de impressão/exportação do relatório, selecione o formato desejado:
#* '''Excel''' – para gerar o relatório em formato de planilha;
#* '''TXT''' – para gerar o relatório em arquivo de texto.
# Confirme a geração do arquivo.
# Selecione o local onde o arquivo deverá ser salvo, quando solicitado.

== Caminho ==
'''Fechamento de Caixa - Relatórios - Fechamento de Caixa:'''

[[Arquivo:Imagerfr5.png|centro|493x493px]]
Para gerar o Relatório de Fechamento de Caixa na extensão desejada, siga os passos abaixo:

# Acesse a rotina de '''Relatório de Fechamento de Caixa'''.
# Selecione o '''Modelo''' desejado.
# Selecione o '''Detalhamento''' do relatório.
# Informe a '''Sequência'''.
# Selecione o '''Tipo de Relatório'''.
# Após preencher os parâmetros necessários, clique em '''[Imprimir]'''.
# Na sequência, clique em '''[Parâmetros]'''.
# Nos parâmetros de impressão, efetue a configuração da '''extensão do tipo de arquivo''' em que o relatório deverá ser gerado.
# Selecione a extensão desejada, como:
#* '''Excel'''
#* '''TXT'''
# Após realizar a configuração, prossiga com a geração do relatório.

== Importante ==
A definição da extensão do arquivo deve ser realizada na opção '''[Parâmetros]''', acessada após clicar em '''[Imprimir]'''.

Dessa forma, o usuário poderá escolher o formato mais adequado para utilização das informações do '''Relatório de Fechamento de Caixa'''.

[[Arquivo:Imagehy786.png|centro|725x725px]]

Marcar a opção '''Arquivo,''' no '''nome do arquivo,''' informar um nome e no final colocar '''.csv''' para que o arquivo seja no formato '''excel/csv'''

'''Exemplo:''' FechamentoDeCaixa.csv

[[Arquivo:Image87uj6.png|centro|678x678px]]
Clicar em '''Salvar''' e clicar em '''Imprimir'''
[[Arquivo:Image87uj.png|centro|625x625px]]

Ao clicar em '''Imprimir''', o sistema gera o relatório no formato '''.csv''' dentro da pasta '''Enterprise''' em: '''C:\Microuni\Enterprise'''

[[Arquivo:Imageiu87.png|centro|890x890px]]

[[Arquivo:Image8954.png|centro|678x678px]]
Para Imprimir no formato TXT

Marcar a opção '''Arquivo,''' no '''nome do arquivo,''' informar um nome e no final colocar '''.txt''' para que o arquivo seja no formato '''TXT'''

'''Exemplo:''' FechamentoDeCaixa.txt

[[Arquivo:Imageujy7.png|centro|701x701px]]

Ao clicar em '''Imprimir''', o sistema gera o relatório no formato '''.txt''' dentro da pasta '''Enterprise''' em: '''C:\Microuni\Enterprise'''

[[Arquivo:Image432.png|centro|715x715px]]

[[Arquivo:Imagehyt55.png|centro|708x708px]]

[[Categoria:Gerador de Documentos]]

Arquivo:Imagehyt55.png

2026-09-22T16:09:56Z

Arione:

Imagehyt55

Arquivo:Image432.png

2026-09-22T16:09:28Z

Arione:

Image432

Arquivo:Imageujy7.png

2026-09-22T16:08:45Z

Arione:

Imageujy7

Arquivo:Image8954.png

2026-09-22T16:07:12Z

Arione:

Image8954

Arquivo:Imageiu87.png

2026-09-22T16:06:10Z

Arione:

Imageiu87

Arquivo:Image87uj.png

2026-09-22T16:02:32Z

Arione:

Image87uj

Arquivo:Image87uj6.png

2026-09-22T15:58:59Z

Arione:

Image87uj6

Arquivo:Imagehy786.png

2026-09-22T15:56:08Z

Arione:

Imagehy786

Arquivo:Imagerfr5.png

2026-09-22T15:55:11Z

Arione:

Imagerfr5

Cancelamento de devolução de compra pelo TradWin(Livos Fiscais/Estoque Fiscal)

2026-09-22T12:42:20Z

Arione: Cancelamento de devolução de compra pelo TradWin(Livos Fiscais/Estoque Fiscal)

==Tutorial==
'''Este artigo apresenta o caminho para acessar a rotina de Devoluções de Compras no sistema MicroUniverso, facilitando a localização da funcionalidade para emissão e gerenciamento das devoluções relacionadas às entradas de mercadorias.'''

== Caminho de acesso ==
Para acessar a rotina, siga o caminho abaixo no menu principal:

Operações → Saídas → Cancelamento de NF → Devoluções Compras
[[Arquivo:Image56y7.png|centro|707x707px]]

== Passo a passo ==

# No menu principal do MicroUniverso, clique em Operações.
# Selecione a opção Saídas.
# No submenu apresentado, localize Cancelamento de NF.
# Ao abrir o próximo submenu, selecione Devoluções Compras.

O caminho pode ser visualizado na imagem abaixo:<blockquote>'''Operações → Saídas → Cancelamento de NF → Devoluções Compras'''</blockquote>

== Onde encontrar a opção ==
A opção Devoluções Compras está localizada dentro do menu Cancelamento de NF. Ao posicionar o mouse sobre essa opção, será exibido o submenu com as alternativas disponíveis, entre elas:

* Vendas
* Transferências
* Devoluções Compras
* Outras Saídas
* Complementação

Para acessar a rotina de devolução de compras, selecione Devoluções Compras, conforme destacado na imagem.

== Importante ==
Antes de realizar uma devolução, confira os dados da operação e da nota fiscal de origem para garantir que a movimentação seja registrada corretamente no sistema.

Resumo do caminho:

📌 Operações → Saídas → Cancelamento de NF → Devoluções Compras

Essa sequência permite localizar rapidamente a funcionalidade no MicroUniverso e pode ser utilizada como referência em treinamentos e consultas no Portal do Conhecimento.
[[Categoria:Documentos Fiscais Eletrônicos]]

Cancelamento de devolução de compra pelo TradWin(Livos Fiscais/Estoque Fiscal)

2026-09-22T12:41:00Z

Arione: Cancelamento de devolução de compra pelo TradWin(Livos Fiscais/Estoque Fiscal)

==Tutorial==
'''Este artigo apresenta o caminho para acessar a rotina de Devoluções de Compras no sistema MicroUniverso, facilitando a localização da funcionalidade para emissão e gerenciamento das devoluções relacionadas às entradas de mercadorias.'''

== Caminho de acesso ==
Para acessar a rotina, siga o caminho abaixo no menu principal:

Operações → Saídas → Cancelamento de NF → Devoluções Compras
[[Arquivo:Image56y7.png|centro|707x707px]]

== Passo a passo ==

# No menu principal do MicroUniverso, clique em Operações.
# Selecione a opção Saídas.
# No submenu apresentado, localize Cancelamento de NF.
# Ao abrir o próximo submenu, selecione Devoluções Compras.

O caminho pode ser visualizado na imagem abaixo:<blockquote>'''Operações → Saídas → Cancelamento de NF → Devoluções Compras'''</blockquote>

== Onde encontrar a opção ==
A opção Devoluções Compras está localizada dentro do menu Cancelamento de NF. Ao posicionar o mouse sobre essa opção, será exibido o submenu com as alternativas disponíveis, entre elas:

* Vendas
* Transferências
* Devoluções Compras
* Outras Saídas
* Complementação

Para acessar a rotina de devolução de compras, selecione Devoluções Compras, conforme destacado na imagem.

== Importante ==
Antes de realizar uma devolução, confira os dados da operação e da nota fiscal de origem para garantir que a movimentação seja registrada corretamente no sistema.

Resumo do caminho:

📌 Operações → Saídas → Cancelamento de NF → Devoluções Compras

Essa sequência permite localizar rapidamente a funcionalidade no MicroUniverso e pode ser utilizada como referência em treinamentos e consultas no Portal do Conhecimento.

Arquivo:Image56y7.png

2026-09-22T12:39:12Z

Arione:

Image56y7

Arquivo:Image567yh.png

2026-09-22T12:38:08Z

Arione:

Image567yh

Alteração no cadastro de cliente associado

2026-09-21T19:18:12Z

Arione: Alteração no cadastro de cliente associado

==Tutorial==
'''Apresentar, na consulta de clientes, informações adicionais relacionadas ao cadastro do cliente associado, incluindo a Data de Cadastro e o CPF/CNPJ do Cliente Associado, facilitando a identificação e conferência dos registros diretamente na listagem.'''

== Funcionamento ==
Quando o parâmetro '''“Mostrar Cliente Associado na lista do cadastro de clientes”''' estiver '''LIGADO''', a consulta de clientes deverá apresentar as informações relacionadas aos clientes associados.

Além da coluna atualmente disponibilizada para '''Cliente Associado''', deverá ser apresentada a coluna '''Data de Cadastro do Cliente'''.

A informação da Data de Cadastro deverá corresponder à data registrada no cadastro do cliente.

== Parâmetro ==
'''Parâmetro:''' <code>Mostrar Cliente Associado na lista do cadastro de clientes</code>

'''Opção:''' <code>LIGADO</code>

Quando o parâmetro estiver ligado, as informações adicionais deverão ser apresentadas na consulta de clientes.

== Regras de Negócio ==

=== RN001 — Exibição da Data de Cadastro ===
Atualmente, quando o parâmetro '''“Mostrar Cliente Associado na lista do cadastro de clientes”''' está '''LIGADO''', o sistema apresenta na consulta de clientes uma coluna adicional contendo a informação do '''Cliente Associado'''.

Deverá ser incluída uma nova coluna denominada '''Data de Cadastro do Cliente''', seguindo o mesmo tratamento atualmente utilizado para a coluna '''Cliente Associado'''.

A nova coluna deverá atender às seguintes regras:

* A '''Data de Cadastro''' deverá ser exibida somente quando o parâmetro '''“Mostrar Cliente Associado na lista do cadastro de clientes”''' estiver '''LIGADO''';
* A coluna deverá ser disponibilizada por padrão em todas as chamadas da tela de consulta de clientes que utilizam esse recurso;
* A informação deverá ser obtida a partir do campo de data de cadastro registrado no cadastro do cliente: <code>'''Cliente_r.CriadoEm'''</code>;
* A data apresentada deverá corresponder à data de cadastro do respectivo cliente.

=== RN002 — CPF/CNPJ do Cliente Associado ===
Na consulta de clientes, quando o recurso de exibição de clientes associados estiver habilitado, deverá ser disponibilizada també

m a informação de '''CPF/CNPJ do Cliente Associado'''.

A informação deverá corresponder ao documento cadastrado para o cliente associado apresentado na listagem.
[[Arquivo:Image2432.png|centro|1098x1098px]]
[[Arquivo:Image3e21.png|centro|691x691px]]

== Exemplo de apresentação ==
Com o parâmetro '''“Mostrar Cliente Associado na lista do cadastro de clientes”''' ligado, a consulta poderá apresentar as informações:
{| class="wikitable"
!Cliente
!Cliente Associado
!CPF/CNPJ Cliente Associado
!Data de Cadastro
|-
|Cliente principal
|Cliente associado
|CPF/CNPJ cadastrado
|Data de cadastro
|}
[[Categoria:Gerenciais]]

Arquivo:Image3e21.png

2026-09-21T19:17:02Z

Arione:

Image3e2

Arquivo:Image2432.png

2026-09-21T19:16:24Z

Arione:

Image2432

Configuração e Reimpressão do Comprovante de Entrega

2026-09-14T15:48:14Z

Arione: Configuração e Reimpressão do Comprovante de Entrega

==Tutorial==
'''Orientar sobre a configuração dos parâmetros necessários para utilização do novo modelo de comprovante de entrega para itens de Expedição e/ou Entrega Futura, bem como os procedimentos necessários para sua reimpressão.'''

== Etapas para Instalação e Configuração ==
Para utilizar o novo modelo de comprovante de entrega, é necessário realizar as seguintes configurações '''por filial''':

=== PASSO 1 ===

=== 1. Configurar o modelo do comprovante de entrega ===
Acesse os parâmetros da filial e configure:

'''Parâmetro:''' <code>Modelo de comprovante de entrega para itens de expedição e/ou futura</code>

'''Valor:''' <code>6</code>

O valor '''6''' corresponde ao '''novo modelo de comprovante de entrega'''.

=== PASSO 2 ===

=== 2. Habilitar a emissão do comprovante de entrega ===
Configure o seguinte parâmetro:

'''Parâmetro:''' <code>Emitir comprovante de entrega para itens de expedição</code>

'''Valor:''' <code>S</code>

Essa configuração habilita a emissão do comprovante de entrega para os itens destinados à expedição.

=== PASSO 3 ===

=== 3. Configurar a impressora do comprovante ===
Configure o parâmetro:

'''Parâmetro:''' <code>Impressora para comprovante de entrega para itens de Expedição e/ou Futura</code>

Informe a impressora que será utilizada para realizar a impressão do comprovante de entrega.<blockquote>'''Importante:''' A impressora deve estar corretamente configurada e disponível para a estação que realizará a emissão ou reimpressão do comprovante.[[Arquivo:Image3e4.png|centro|770x770px]]</blockquote>

== Reimpressão do Comprovante de Entrega ==
Após realizar as configurações acima, o sistema estará preparado para trabalhar com o novo modelo de comprovante.

A reimpressão deverá ser utilizada quando houver necessidade de emitir novamente um comprovante de entrega já gerado anteriormente, mantendo as informações relacionadas à entrega registrada no sistema.

Antes de realizar a reimpressão, confirme se:

* O parâmetro '''Modelo de comprovante de entrega para itens de expedição e/ou futura''' está configurado com o valor <code>6</code>;
* O parâmetro '''Emitir comprovante de entrega para itens de expedição''' está configurado como <code>S</code>;
* A '''Impressora para comprovante de entrega para itens de Expedição e/ou Futura''' está devidamente configurada;
* A impressora está disponível e funcionando corretamente na estação utilizada.

Após concluir as configurações, realize um teste de emissão e, posteriormente, de reimpressão do comprovante para validar:

# A geração correta do comprovante;
# A utilização do novo modelo;
# O direcionamento para a impressora configurada;
# A possibilidade de realizar a reimpressão quando necessário.

[[Categoria:Gestão de Entregas]]

Arquivo:Image3e4.png

2026-09-14T15:47:11Z

Arione:

Image3e4

Permitir cancelar pedido que só tenha NF Simples Faturamento

2026-08-28T17:13:22Z

Arione: http://10.10.10.173:4000/

==Tutorial==
'''Permitir o cancelamento de pedidos que possuam apenas Nota Fiscal de Simples Faturamento emitida para os itens do pedido.'''

== Cenário ==
Ao tentar cancelar um pedido, o sistema verifica se existe alguma Nota Fiscal emitida para os itens relacionados.

Quando é identificada uma NF, o cancelamento é bloqueado, mesmo que a única nota emitida seja uma '''NF de Simples Faturamento'''.

Essa validação impedia o cancelamento de pedidos em situações nas quais a Nota Fiscal emitida não deveria impedir o cancelamento.

== Solução ==
Foi alterada a rotina de '''cancelamento de pedidos''', permitindo configurar, por filial, se pedidos que possuem somente NF de Simples Faturamento poderão ser cancelados.

Para isso, foi criado o seguinte parâmetro:

'''Permitir cancelar pedido que só tenha NF Simples Faturamento.'''

=== PASSO 1 ===
O parâmetro deve ser configurado por filial:

* '''S – Sim:''' permite o cancelamento do pedido quando a única NF emitida for de Simples Faturamento.
* '''N – Não:''' mantém o comportamento padrão, impedindo o cancelamento caso exista NF emitida para o pedido.

=== Funcionamento ===
Quando o parâmetro estiver configurado como '''S''', o sistema irá desconsiderar a '''NF de Simples Faturamento''' durante a validação de existência de notas fiscais para o pedido.

Dessa forma, caso não existam outras notas fiscais que impeçam o cancelamento, o pedido poderá ser cancelado normalmente.

=== Resumo ===
{| class="wikitable"
!Configuração
!Comportamento
|-
|Parâmetro = '''S'''
|Permite cancelar pedidos que possuam somente NF de Simples Faturamento
|-
|Parâmetro = '''N'''
|Mantém a validação atual e não permite o cancelamento caso exista NF emitida
|}
'''Importante:''' a alteração não elimina a validação de notas fiscais. Ela apenas permite que a '''NF de Simples Faturamento''' seja desconsiderada nessa validação quando o parâmetro estiver habilitado.
[[Categoria:Gestão de Vendas]]

Permitir cancelar pedido que só tenha NF Simples Faturamento

2026-08-28T17:11:38Z

Arione: Permitir cancelar pedido que só tenha NF Simples Faturamento

==Tutorial==
'''Permitir o cancelamento de pedidos que possuam apenas Nota Fiscal de Simples Faturamento emitida para os itens do pedido.'''

== Cenário ==
Ao tentar cancelar um pedido, o sistema verifica se existe alguma Nota Fiscal emitida para os itens relacionados.

Quando é identificada uma NF, o cancelamento é bloqueado, mesmo que a única nota emitida seja uma '''NF de Simples Faturamento'''.

Essa validação impedia o cancelamento de pedidos em situações nas quais a Nota Fiscal emitida não deveria impedir o cancelamento.

== Solução ==
Foi alterada a rotina de '''cancelamento de pedidos''', permitindo configurar, por filial, se pedidos que possuem somente NF de Simples Faturamento poderão ser cancelados.

Para isso, foi criado o seguinte parâmetro:

'''Permitir cancelar pedido que só tenha NF Simples Faturamento.'''

=== PASSO 1 ===
O parâmetro deve ser configurado por filial:

* '''S – Sim:''' permite o cancelamento do pedido quando a única NF emitida for de Simples Faturamento.
* '''N – Não:''' mantém o comportamento padrão, impedindo o cancelamento caso exista NF emitida para o pedido.

=== Funcionamento ===
Quando o parâmetro estiver configurado como '''S''', o sistema irá desconsiderar a '''NF de Simples Faturamento''' durante a validação de existência de notas fiscais para o pedido.

Dessa forma, caso não existam outras notas fiscais que impeçam o cancelamento, o pedido poderá ser cancelado normalmente.

=== Resumo ===
{| class="wikitable"
!Configuração
!Comportamento
|-
|Parâmetro = '''S'''
|Permite cancelar pedidos que possuam somente NF de Simples Faturamento
|-
|Parâmetro = '''N'''
|Mantém a validação atual e não permite o cancelamento caso exista NF emitida
|}
'''Importante:''' a alteração não elimina a validação de notas fiscais. Ela apenas permite que a '''NF de Simples Faturamento''' seja desconsiderada nessa validação quando o parâmetro estiver habilitado.

Novo modelo de pedido de compra (modelo 10)

2026-08-05T15:23:47Z

Arione:

==Tutorial==
'''No modelo 10 de Pedido de Compra, utilizando como base o Modelo 7, incorporando as funcionalidades e estrutura já existentes.'''

'''O modelo 10 deverá foi desenvolvido a partir do Modelo 7.'''

'''Foi incluso o recurso de impressão sem valores, permitindo a emissão do pedido de compra sem exibir informações financeiras.'''

== Modelo 10 de Pedido de Compra ==

== Objetivo ==
Criar o '''Modelo 10 de Pedido de Compra''', utilizando como base o '''Modelo 7''', incorporando as funcionalidades já existentes, o recurso de impressão sem valores e as demais alterações previstas para o novo modelo.

== Funcionalidades ==

=== Alterações no Banco de Dados ===

* Inclusão das alterações necessárias na estrutura do banco de dados para suportar o Modelo 10 de Pedido de Compra.

=== Etapas para Instalação ===

* Executar os scripts de atualização do banco de dados.
* Atualizar os executáveis do sistema.
* Validar o funcionamento do novo modelo após a atualização.

=== 1. TradComp | Pedidos | Inclusão ===
Adequar a rotina de inclusão de pedidos para permitir a utilização do Modelo 10, contemplando todas as regras e recursos definidos para o novo modelo.

=== 2. TradComp | Pedidos | Alteração ===
Adequar a rotina de alteração de pedidos para manter compatibilidade com o Modelo 10, preservando o comportamento esperado durante a edição dos pedidos.

=== 3. TradComp | Pedidos | Consulta ===
Atualizar a rotina de consulta de pedidos para permitir a visualização e impressão dos pedidos utilizando o Modelo 10.

=== 4. AbswProj | Movimentos | Negociação de Compras | Negociar ===
Adequar o processo de negociação de compras para suportar o novo Modelo 10 de Pedido de Compra.

=== 5. AbswProj | Movimentos | Sugestão de Compras | Por Cálculo de Reposição ===
Atualizar a rotina de sugestão de compras para que os pedidos gerados possam utilizar o Modelo 10.

=== 6. AbswProj | Movimentos | Compras Pendentes ===
Adequar a rotina de Compras Pendentes para contemplar o tratamento do Modelo 10 de Pedido de Compra.

== Nota Técnica ==
O Modelo 10 foi desenvolvido a partir do Modelo 7, mantendo sua estrutura funcional e incorporando o recurso de '''impressão sem valores''', além das demais customizações previstas no projeto. Todas as rotinas relacionadas à geração, manutenção, consulta e utilização de pedidos de compra foram ajustadas para garantir compatibilidade com o novo modelo.

== Etapas para Instalação: ==

# Configurar o parâmetro por filial '''“Modelo de Impressão do Pedido de Compra” = 10'''
# Configurar no dado adicional da filial '''“Observação do Pedido de Compra” (rodar o script do PA 400119)'''
# '''Configurar os parâmetros por filial para o envio de e-mail:'''
# '''Envio de Email pelo TradComp, email do remetente a substituir o cadastrado na comunicação da filial (Se não for informado, será utilizado o e-mail cadastrado na forma de comunicação da filial);'''
# '''Envio de Email pelo TradComp, nome do servidor SMTP;'''
# '''Envio de Email pelo TradComp, tipo de mensagem a ser enviada;'''
# '''Envio de Email pelo TradComp, pasta onde serão gravados os arquivos gerados para envio por e-mail;'''
# '''É recomendado atualizar o BD através dos aplicativos abaixo:'''

* '''MuSincronizador'''
* '''MUAtualizaVersaoMasterEn.'''

{| class="wikitable"
|Para executar a versão web com sucesso é pré requisito que vários outros scripts que foram criados existam no BD. Por esse motivo, recomendamos a execução dos dois aplicativos citados anteriormente.

Todo script novo criado para aplicação WEB, além de existir no migration, deve também existir no MuSincronizador.
|}

=== TradComp | Pedidos | Inclusão ===

=== TradComp | Pedidos | Alteração ===

=== TradComp | Pedidos | Consulta ===

=== Objetivo ===
Criar o '''Modelo 10 de impressão de Pedidos de Compra''', utilizando como base o '''Modelo 7''', realizando as adaptações necessárias para atender aos requisitos da nova modalidade de impressão.

As alterações deverão preservar o comportamento já existente no Modelo 7, incorporando as novas funcionalidades e ajustes específicos previstos para o Modelo 10.

'''Imagem 1 – Filtro de Impressão do Modelo 10'''

O filtro de impressão deverá disponibilizar a opção de emissão utilizando o '''Modelo 10''', conforme o layout definido nos protótipos do projeto.

As funcionalidades e parâmetros disponíveis deverão seguir as regras de negócio estabelecidas para este modelo, incluindo os novos recursos e tratamentos específicos implementados para a impressão do Pedido de Compra.
[[Arquivo:ImageT.png|centro|372x372px]]
'''Imagem 2 -''' Layout de impressão para o modelo 7 com o destaque dos pontos a serem alterados para o modelo 10:
[[Arquivo:ImageT1.png|centro|638x638px]]

== Regras de Interação ==

=== RI001 – Criação do Modelo 10 ===
Deverá ser criado o '''Modelo 10 de impressão de Pedido de Compra''', utilizando como base o '''Modelo 7'''.

==== Características ====

* O Modelo 10 estará disponível apenas no formato '''gráfico'''.
* Deverão ser utilizadas as mesmas telas de filtros existentes para o Modelo 7.
* A impressão deverá permitir:
** geração do relatório em formato gráfico;
** geração do relatório gráfico para envio por e-mail.

----

=== RI002 – Impressão sem valores ===
Quando o parâmetro '''Modelo de Impressão do Pedido de Compra''' estiver configurado como '''Modelo 10''', deverá ser disponibilizado no filtro de impressão o checkbox:

'''Imprimir sem valores'''

Esse recurso permitirá gerar o Pedido de Compra sem exibir informações financeiras.
----

=== RI003 – Tratamento da impressão sem valores ===
Quando a opção '''Imprimir sem valores''' estiver marcada, o relatório deverá ocultar todas as informações relacionadas aos valores dos produtos e aos totais do pedido.

==== Itens ====
Não deverão ser impressos os seguintes campos:

* Preço Unitário;
* % Desconto;
* Valor Total;
* % IPI.

==== Cabeçalho da tabela ====
Também deverão ser ocultados os respectivos títulos das colunas para que não exista qualquer indicação de informações financeiras.

==== Totalização ====
Não deverão ser impressos os campos de totalização do Pedido de Compra.
----

=== RI004 – Impressão do preço unitário ===
Quando a impressão ocorrer com valores, a coluna '''Prç. Unit.''' deverá apresentar o preço de custo obtido na última pesquisa de preços.

Origem da informação:<blockquote>'''ItemForCad.PrecoCusto'''</blockquote>
----

=== RI005 – Observações do Pedido ===
No Modelo 10 deverá ser alterado o tratamento das observações impressas no Pedido de Compra.

==== Modelo anterior ====
No Modelo 7, além da observação do pedido, também era impresso um texto fixo contendo os endereços de entrega e faturamento da filial.

==== Modelo 10 ====
Não deverá ser impresso nenhum texto fixo.

O campo '''Observações''' deverá conter somente:

* Observações informadas no pedido:
** '''PediforCad.OBS'''
** '''PediforCad.OBS2'''
** '''PediforCad.OBS3'''
* Observação cadastrada no dado adicional da filial:
** '''Observação do Pedido de Compra'''

Caso o pedido não possua observações cadastradas, não deverão ser impressas linhas ou espaços em branco.

A impressão deverá utilizar um componente que suporte '''texto longo''', permitindo a exibição integral das informações.

==== Informação Complementar ====
Por meio do '''PA 400119''', o dado adicional '''Observação do Pedido de Compra''' passou a utilizar o tipo '''Texto Longo''', permitindo mensagens superiores a 254 caracteres.
----

= Marco de Entrega 1 =
Implementação das regras '''RI001''' a '''RI005'''.
----

= AbswProj | Movimentos | Negociação de Compras | Negociar =

== Objetivo ==
Disponibilizar a impressão do '''Modelo 10 de Pedido de Compra''' na rotina de Negociação de Compras.

=== Regras de Interação ===

==== RI006 – Impressão do Modelo 10 ====
Quando o parâmetro '''Modelo de Impressão do Pedido de Compra''' estiver configurado como '''10''', a rotina deverá utilizar o '''Modelo 10''', mantendo o mesmo comportamento da impressão realizada no módulo de Compras.
----

==== Se o parâmetro Modelo de impressão do pedido de compra estiver configurado com 10, deve ser impresso o pedido de compra modelo 10, conforme no módulo de compras. ====

== AbswProj | Movimentos | Sugestão de Compras | Por Cálculo de Reposição ==

== Objetivo ==
Disponibilizar a impressão do '''Modelo 10 de Pedido de Compra''' na rotina de Sugestão de Compras.

=== Regras de Interação ===

==== RI007 – Impressão do Modelo 10 ====
Quando o parâmetro '''Modelo de Impressão do Pedido de Compra''' estiver configurado como '''10''', a rotina deverá utilizar o '''Modelo 10''', seguindo o mesmo padrão da impressão disponível no módulo de Compras.
----

=== Marco de Entrega 3 ===
Implementação da regra '''RI007'''.
----

== AbswProj | Movimentos | Compras Pendentes ==

=== Objetivo ===
Disponibilizar a impressão do '''Modelo 10 de Pedido de Compra''' na rotina de Compras Pendentes.

=== Regras de Interação ===

==== RI008 – Impressão do Modelo 10 ====
Quando o parâmetro '''Modelo de Impressão do Pedido de Compra''' estiver configurado como '''10''', a rotina deverá utilizar o '''Modelo 10''', mantendo o mesmo comportamento adotado pelo módulo de Compras.
[[Categoria:Compras]]

Novo modelo de pedido de compra (modelo 10)

2026-08-05T15:23:19Z

Arione: Criou página com '==Tutorial== '''No modelo 10 de Pedido de Compra, utilizando como base o Modelo 7, incorporando as funcionalidades e estrutura já existentes.''' '''O modelo 10 deverá foi desenvolvido a partir do Modelo 7.'''</s...'

==Tutorial==
'''No modelo 10 de Pedido de Compra, utilizando como base o Modelo 7, incorporando as funcionalidades e estrutura já existentes.'''

'''O modelo 10 deverá foi desenvolvido a partir do Modelo 7.'''

'''Foi incluso o recurso de impressão sem valores, permitindo a emissão do pedido de compra sem exibir informações financeiras.'''

== Modelo 10 de Pedido de Compra ==

== Objetivo ==
Criar o '''Modelo 10 de Pedido de Compra''', utilizando como base o '''Modelo 7''', incorporando as funcionalidades já existentes, o recurso de impressão sem valores e as demais alterações previstas para o novo modelo.

== Funcionalidades ==

=== Alterações no Banco de Dados ===

* Inclusão das alterações necessárias na estrutura do banco de dados para suportar o Modelo 10 de Pedido de Compra.

=== Etapas para Instalação ===

* Executar os scripts de atualização do banco de dados.
* Atualizar os executáveis do sistema.
* Validar o funcionamento do novo modelo após a atualização.

=== 1. TradComp | Pedidos | Inclusão ===
Adequar a rotina de inclusão de pedidos para permitir a utilização do Modelo 10, contemplando todas as regras e recursos definidos para o novo modelo.

=== 2. TradComp | Pedidos | Alteração ===
Adequar a rotina de alteração de pedidos para manter compatibilidade com o Modelo 10, preservando o comportamento esperado durante a edição dos pedidos.

=== 3. TradComp | Pedidos | Consulta ===
Atualizar a rotina de consulta de pedidos para permitir a visualização e impressão dos pedidos utilizando o Modelo 10.

=== 4. AbswProj | Movimentos | Negociação de Compras | Negociar ===
Adequar o processo de negociação de compras para suportar o novo Modelo 10 de Pedido de Compra.

=== 5. AbswProj | Movimentos | Sugestão de Compras | Por Cálculo de Reposição ===
Atualizar a rotina de sugestão de compras para que os pedidos gerados possam utilizar o Modelo 10.

=== 6. AbswProj | Movimentos | Compras Pendentes ===
Adequar a rotina de Compras Pendentes para contemplar o tratamento do Modelo 10 de Pedido de Compra.

== Nota Técnica ==
O Modelo 10 foi desenvolvido a partir do Modelo 7, mantendo sua estrutura funcional e incorporando o recurso de '''impressão sem valores''', além das demais customizações previstas no projeto. Todas as rotinas relacionadas à geração, manutenção, consulta e utilização de pedidos de compra foram ajustadas para garantir compatibilidade com o novo modelo.

== Etapas para Instalação: ==

# Configurar o parâmetro por filial '''“Modelo de Impressão do Pedido de Compra” = 10'''
# Configurar no dado adicional da filial '''“Observação do Pedido de Compra” (rodar o script do PA 400119)'''
# '''Configurar os parâmetros por filial para o envio de e-mail:'''
# '''Envio de Email pelo TradComp, email do remetente a substituir o cadastrado na comunicação da filial (Se não for informado, será utilizado o e-mail cadastrado na forma de comunicação da filial);'''
# '''Envio de Email pelo TradComp, nome do servidor SMTP;'''
# '''Envio de Email pelo TradComp, tipo de mensagem a ser enviada;'''
# '''Envio de Email pelo TradComp, pasta onde serão gravados os arquivos gerados para envio por e-mail;'''
# '''É recomendado atualizar o BD através dos aplicativos abaixo:'''

* '''MuSincronizador'''
* '''MUAtualizaVersaoMasterEn.'''

{| class="wikitable"
|Para executar a versão web com sucesso é pré requisito que vários outros scripts que foram criados existam no BD. Por esse motivo, recomendamos a execução dos dois aplicativos citados anteriormente.

Todo script novo criado para aplicação WEB, além de existir no migration, deve também existir no MuSincronizador.
|}

=== TradComp | Pedidos | Inclusão ===

=== TradComp | Pedidos | Alteração ===

=== TradComp | Pedidos | Consulta ===

=== Objetivo ===
Criar o '''Modelo 10 de impressão de Pedidos de Compra''', utilizando como base o '''Modelo 7''', realizando as adaptações necessárias para atender aos requisitos da nova modalidade de impressão.

As alterações deverão preservar o comportamento já existente no Modelo 7, incorporando as novas funcionalidades e ajustes específicos previstos para o Modelo 10.

'''Imagem 1 – Filtro de Impressão do Modelo 10'''

O filtro de impressão deverá disponibilizar a opção de emissão utilizando o '''Modelo 10''', conforme o layout definido nos protótipos do projeto.

As funcionalidades e parâmetros disponíveis deverão seguir as regras de negócio estabelecidas para este modelo, incluindo os novos recursos e tratamentos específicos implementados para a impressão do Pedido de Compra.
[[Arquivo:ImageT.png|centro|372x372px]]
'''Imagem 2 -''' Layout de impressão para o modelo 7 com o destaque dos pontos a serem alterados para o modelo 10:
[[Arquivo:ImageT1.png|centro|638x638px]]

== Regras de Interação ==

=== RI001 – Criação do Modelo 10 ===
Deverá ser criado o '''Modelo 10 de impressão de Pedido de Compra''', utilizando como base o '''Modelo 7'''.

==== Características ====

* O Modelo 10 estará disponível apenas no formato '''gráfico'''.
* Deverão ser utilizadas as mesmas telas de filtros existentes para o Modelo 7.
* A impressão deverá permitir:
** geração do relatório em formato gráfico;
** geração do relatório gráfico para envio por e-mail.

----

=== RI002 – Impressão sem valores ===
Quando o parâmetro '''Modelo de Impressão do Pedido de Compra''' estiver configurado como '''Modelo 10''', deverá ser disponibilizado no filtro de impressão o checkbox:

'''Imprimir sem valores'''

Esse recurso permitirá gerar o Pedido de Compra sem exibir informações financeiras.
----

=== RI003 – Tratamento da impressão sem valores ===
Quando a opção '''Imprimir sem valores''' estiver marcada, o relatório deverá ocultar todas as informações relacionadas aos valores dos produtos e aos totais do pedido.

==== Itens ====
Não deverão ser impressos os seguintes campos:

* Preço Unitário;
* % Desconto;
* Valor Total;
* % IPI.

==== Cabeçalho da tabela ====
Também deverão ser ocultados os respectivos títulos das colunas para que não exista qualquer indicação de informações financeiras.

==== Totalização ====
Não deverão ser impressos os campos de totalização do Pedido de Compra.
----

=== RI004 – Impressão do preço unitário ===
Quando a impressão ocorrer com valores, a coluna '''Prç. Unit.''' deverá apresentar o preço de custo obtido na última pesquisa de preços.

Origem da informação:<blockquote>'''ItemForCad.PrecoCusto'''</blockquote>
----

=== RI005 – Observações do Pedido ===
No Modelo 10 deverá ser alterado o tratamento das observações impressas no Pedido de Compra.

==== Modelo anterior ====
No Modelo 7, além da observação do pedido, também era impresso um texto fixo contendo os endereços de entrega e faturamento da filial.

==== Modelo 10 ====
Não deverá ser impresso nenhum texto fixo.

O campo '''Observações''' deverá conter somente:

* Observações informadas no pedido:
** '''PediforCad.OBS'''
** '''PediforCad.OBS2'''
** '''PediforCad.OBS3'''
* Observação cadastrada no dado adicional da filial:
** '''Observação do Pedido de Compra'''

Caso o pedido não possua observações cadastradas, não deverão ser impressas linhas ou espaços em branco.

A impressão deverá utilizar um componente que suporte '''texto longo''', permitindo a exibição integral das informações.

==== Informação Complementar ====
Por meio do '''PA 400119''', o dado adicional '''Observação do Pedido de Compra''' passou a utilizar o tipo '''Texto Longo''', permitindo mensagens superiores a 254 caracteres.
----

= Marco de Entrega 1 =
Implementação das regras '''RI001''' a '''RI005'''.
----

= AbswProj | Movimentos | Negociação de Compras | Negociar =

== Objetivo ==
Disponibilizar a impressão do '''Modelo 10 de Pedido de Compra''' na rotina de Negociação de Compras.

=== Regras de Interação ===

==== RI006 – Impressão do Modelo 10 ====
Quando o parâmetro '''Modelo de Impressão do Pedido de Compra''' estiver configurado como '''10''', a rotina deverá utilizar o '''Modelo 10''', mantendo o mesmo comportamento da impressão realizada no módulo de Compras.
----

==== Se o parâmetro Modelo de impressão do pedido de compra estiver configurado com 10, deve ser impresso o pedido de compra modelo 10, conforme no módulo de compras. ====

== AbswProj | Movimentos | Sugestão de Compras | Por Cálculo de Reposição ==

== Objetivo ==
Disponibilizar a impressão do '''Modelo 10 de Pedido de Compra''' na rotina de Sugestão de Compras.

=== Regras de Interação ===

==== RI007 – Impressão do Modelo 10 ====
Quando o parâmetro '''Modelo de Impressão do Pedido de Compra''' estiver configurado como '''10''', a rotina deverá utilizar o '''Modelo 10''', seguindo o mesmo padrão da impressão disponível no módulo de Compras.
----

=== Marco de Entrega 3 ===
Implementação da regra '''RI007'''.
----

== AbswProj | Movimentos | Compras Pendentes ==

=== Objetivo ===
Disponibilizar a impressão do '''Modelo 10 de Pedido de Compra''' na rotina de Compras Pendentes.

=== Regras de Interação ===

==== RI008 – Impressão do Modelo 10 ====
Quando o parâmetro '''Modelo de Impressão do Pedido de Compra''' estiver configurado como '''10''', a rotina deverá utilizar o '''Modelo 10''', mantendo o mesmo comportamento adotado pelo módulo de Compras.
[[Categoria:Gestão do Estoque]]

Arquivo:ImageT1.png

2026-08-05T15:13:31Z

Arione:

ImageT1

Arquivo:ImageT.png

2026-08-05T15:10:36Z

Arione:

ImageT

Venda por Representação

2026-08-05T14:43:38Z

Arione: Venda por Representação

==Tutorial==
'''A venda por representação, a empresa trabalha com a modalidade de venda por representação e necessita que o ERP seja customizado para oferecer suporte completo a esse modelo de operação.'''

'''Nesse formato de venda, a empresa atua como intermediária entre o cliente final e o fabricante, sendo necessários ajustes específicos no sistema para garantir que os processos de gerenciamento de pedidos, controle de prazos de entrega, cálculo de comissões e tratamento financeiro estejam devidamente alinhados às necessidades operacionais dessa modalidade.'''

'''Atualmente, o ERP não possui um fluxo estruturado que atenda às particularidades da venda por representação. Embora exista um módulo de revenda, ele não apresenta aderência suficiente para esse cenário.'''

'''A customização proposta tem como objetivo suprir essas limitações, proporcionando maior automação dos processos, redução das atividades manuais e melhor controle operacional, especialmente em rotinas como a apuração de comissões e o acompanhamento das vendas realizadas por representação.'''

== Lista de funcionalidades ==
Alterações no Banco de Dados:

Etapas para Instalação:

Vendas | Vendas

Vendas | Cancelamento

Sistema de usuários | Cadastro | Produtos | Produtos

Tradewin | Arquivos | Produtos | Produtos

TradChec | Com Orçamento

MU_ECF | Vendas

Sistema de usuários | Movimentos | Gerenciador de Vendas por Representação

Sistema de usuários | Relatórios | Comissão | Por Metas de Vendas

Relatório de Vendas por Representação (não é testado pelo QA)

Nota fiscal de serviço eletrônica (NFSe)

== Etapas para Instalação: ==

# LIGAR o parâmetro '''por filial “Trabalha com venda por representação?”'''

# Configurar nos '''FORNECEDORES''' de venda por representação os '''dados adicionais:'''
## '''Fornecedor de venda por representação?'''
## '''Dia para vencimento de conta a receber de venda por representação'''
## '''Tipo de documento para conta a receber de venda por representação'''
## '''TPO para Conta a receber (dado adicional de pessoa jurídica)'''

==== Configuração para ativar o recurso de COMISSÃO POR INDICADOR (opcional): ====

# Leitura e implantação do PA 78463
## Ligar o parâmetro por empresa "'''Orçamento com tratamento de revenda"'''
## Ligar o parâmetro por empresa '''"Utiliza tratamento de comissão por indicação"'''
## Configurar o parâmetro por filial '''"TPO para comissão de Indicadores".'''
## Ligar o parâmetro por filial '''" Validar limite de crédito do cliente do orçamento nas vendas para associados".'''
## Configurar o parâmetro empresa '''"Prorrogação para pagamento de comissão da Revenda" (número de dias correspondente ao prazo para efetuar o pagamento da comissão).'''
## Cadastrar para o tipo de indicador as '''classificações''' '''do''' '''indicador''' no '''cadastro de categoria:'''

==== Exemplo: ====
'''Representante (OID = 2128)'''

'''Arquiteto (criado pelo usuário)'''

'''Decorador (criado pelo usuário)'''

'''Engenheiro (criado pelo usuário)'''

# Cadastrar uma pessoa física classificada como cliente, fornecedor,representante e utilizando umas das classificações cadastradas para o tipo de indicador.

Exemplo: Arquiteto.

# Configurar o '''dado adicional''' '''“Taxa sobre indicação de venda”''' dos indicadores já cadastrados;

# Leitura do PA 418010 - Gerar nota de crédito para comissão de indicador

== Base de Conhecimento – Venda por Representação ==

== Objetivo ==
Implementar no ERP uma nova modalidade de '''Venda por Representação''', permitindo que a empresa atue como intermediária entre o cliente final e o fabricante, sem movimentação de estoque próprio.

Todas as regras descritas neste documento devem ser aplicadas '''somente quando o parâmetro "Trabalha com venda por representação?" estiver habilitado na filial da venda.'''
----

= Vendas | Pedido de Venda =

== Objetivo ==
Adequar o processo de inclusão e alteração de pedidos para suportar a modalidade de Venda por Representação.

=== Regra Geral ===
Em um pedido de venda por representação somente poderão ser informados produtos pertencentes ao '''mesmo fornecedor'''.
----

== Regras de Negócio ==

=== RN001 – Identificação do fornecedor ===
Ao informar um produto, o sistema deve verificar se o fornecedor possui o dado adicional:<blockquote>'''Fornecedor de venda por representação = Sim'''</blockquote>
----

=== RN002 – Mesmo fornecedor no pedido ===
Caso o primeiro produto informado pertença a um fornecedor de representação, todos os demais produtos do pedido deverão pertencer ao mesmo fornecedor.

Caso seja informado um produto de fornecedor diferente, exibir a mensagem:<blockquote>'''"Pedido de venda de representação só pode conter produtos do mesmo fornecedor."'''</blockquote>A inclusão do produto deverá ser bloqueada.
----

=== RN003 – Mistura com fornecedores comuns ===
Caso o pedido já possua produtos de fornecedores comuns, não deverá ser permitida a inclusão de um produto de fornecedor de representação.

Exibir a mensagem:<blockquote>'''"Produto de fornecedor de representação não pode ser informado no mesmo pedido de outros fornecedores."'''</blockquote>
----

=== RN004 – Consulta de produtos ===
Quando o pedido for de venda por representação, a consulta de produtos deverá listar apenas produtos pertencentes ao mesmo fornecedor já informado no pedido.
----

=== RN005 – Consulta para pedidos comuns ===
Quando o pedido não for de venda por representação, a consulta de produtos não deverá exibir produtos cujo fornecedor possua:<blockquote>'''Fornecedor de venda por representação = Sim'''</blockquote>
----

=== RN006 – Tipo de entrega ===
Para produtos de fornecedores de representação:

* somente deverá ser permitido o tipo de entrega '''Futura''';
* o tipo de entrega deverá ser preenchido automaticamente;
* não deverá ser permitida alteração do tipo de entrega;
* não deverá ser permitido informar outro local de retirada;
* os campos '''Filial de Retirada''' e '''Filial de Transferência''' deverão permanecer em branco e bloqueados para edição.

----

=== RN007 – Previsão de entrega ===
A previsão de entrega deverá ser calculada automaticamente utilizando a fórmula:

'''Data da venda + Prazo Entrega Venda Representação'''

O prazo deverá ser obtido do cadastro do produto:<blockquote>'''ComplementoProduto.PrazoEntregaRepresentação'''</blockquote>O vendedor poderá alterar a previsão apenas para uma data posterior à calculada automaticamente.
----

=== RN008 – Tratamento de estoque ===
Para produtos de fornecedores de representação:

* não validar estoque;
* não reservar estoque;
* definir:
** '''Itemclicad.Reserva = N'''
** não atualizar '''Itemfilest.QtdeReserv'''
* não utilizar controle de lote;
* não utilizar controle de validade;
* não executar validações relacionadas a lote.

----

=== RN009 – Identificação do pedido ===
Ao salvar um pedido de venda por representação, atualizar:<blockquote>'''Pediclicomplemento.VendaRepresentacao = 1'''</blockquote>Esse atributo identifica o pedido como venda por representação.
----

=== RN010 – Inclusão e alteração ===
Todas as regras descritas anteriormente deverão ser aplicadas tanto na inclusão quanto na alteração do pedido.
----

== Ajustes complementares ==

=== Ficha 468236 ===
Quando o pedido for de venda por representação, não deverá ser realizada validação de crediário.
----

=== Ficha 468760 ===

==== Item 1 – Roteiro automático ====
Não exibir o alerta:<blockquote>"Não foi encontrado roteiro automático para o endereço de entrega."</blockquote>Como a entrega é realizada pelo fabricante, esse tratamento não se aplica.
----

==== Item 2 – Encomenda ====
Não permitir a utilização da opção '''Encomenda'''.

Também deverá ser desabilitado todo tratamento relacionado à reserva de estoque e lote.
----

==== Item 3 – Liberação de lote ====
Não solicitar senha para liberar a pendência:<blockquote>"Liberar pendência de venda sem reserva de lote."</blockquote>Esse tratamento não se aplica à venda por representação.
----

==== Item 4 – NFe de simples faturamento ====
Desabilitar o alerta relacionado à emissão de Nota Fiscal de Simples Faturamento para pedidos de venda por representação.
----

= Marco de Entrega 1 =
Implementação de todas as regras RN001 até RN010 e ajustes das fichas 468236 e 468760.
----

= Vendas | Cancelamento =

== Objetivo ==
Definir regras específicas para cancelamento de pedidos de venda por representação.
----

== Regras de Negócio ==

=== RN011 – Pedido faturado ===
Não permitir o cancelamento de pedidos de venda por representação já faturados.

Condição:

* '''Pediclicad.Sitven = 2'''
* '''Pediclicomplemento.VendaRepresentacao = 1'''

Exibir a mensagem:<blockquote>'''"Pedido de vendas por representação já faturado não pode ser cancelado por essa opção."'''</blockquote>O cancelamento deverá ser interrompido.
----

=== RN012 – Pedido não faturado ===
Caso o pedido ainda não esteja faturado:

'''Pediclicad.Sitven <> 2'''

o cancelamento deverá ocorrer normalmente.
----

= Marco de Entrega 2 =
Implementação das regras RN011 e RN012.
----

= Cadastro de Produtos =
'''Módulos'''

* Sistema de Usuários → Cadastro → Produtos → Produtos
* Tradewin → Arquivos → Produtos → Produtos

== Objetivo ==
Disponibilizar novos campos no cadastro de produtos para atender à modalidade de Venda por Representação.

Entre eles, o campo responsável pelo cálculo da previsão de entrega:

* '''Prazo Entrega Venda Representação''' (''ComplementoProduto.PrazoEntregaRepresentação'').

Os demais campos deverão ser definidos conforme os protótipos e requisitos funcionais do projeto.

[[Arquivo:Image4re.png|centro|607x607px]]

== Regras de Negócio ==

=== RN013 – Comissão Venda por Representação ===
Deverá ser incluído, na página '''Unidade e Preço''' do cadastro de produtos, o campo:

'''Comissão Venda por Representação'''

==== Características ====

* Campo não obrigatório;
* Utilizado para informar o percentual de comissão do produto na modalidade Venda por Representação;
* Permitir apenas valores percentuais maiores ou iguais a zero (≥ 0);
* Atualizar o campo '''ComplementoProduto.ComissaoRepresentacao'''.

----

=== RN014 – Prazo Entrega Venda por Representação ===
Deverá ser incluído, na página '''Dados Complementares''' do cadastro de produtos, o campo:

'''Prazo Entrega Venda por Representação'''

==== Características ====

* Campo não obrigatório;
* Utilizado para informar o prazo de entrega do produto para vendas por representação;
* Permitir apenas valores maiores ou iguais a zero (≥ 0);
* Atualizar o campo '''ComplementoProduto.PrazoEntregaRepresentacao'''.

----

=== RN015 – Navegação do cadastro ===
Ao navegar entre os registros do cadastro de produtos, o sistema deverá realizar corretamente a leitura, atualização e persistência dos novos campos de Venda por Representação.
----

= Marco de Entrega 3 =
Implementação das regras RN013 a RN015.
----

= TradChec | Com Orçamento =

== Objetivo ==
Adequar o processo de faturamento para pedidos de Venda por Representação.

Nesta modalidade, o cliente realiza o pagamento diretamente ao fornecedor. Portanto, o faturamento não deverá gerar os mesmos registros financeiros de uma venda convencional.

Em substituição, deverão ser gerados:

* registros da nova estrutura de Venda por Representação;
* registros de Contas a Receber referentes exclusivamente à comissão da venda por representação.

----

== Regras de Negócio ==

=== Regra Geral ===
Todas as regras descritas nesta seção deverão ser aplicadas somente quando o parâmetro '''"Trabalha com venda por representação?"''' estiver habilitado na filial padrão do usuário.
----

=== RN016 – Geração do financeiro ===
Ao faturar um pedido identificado como Venda por Representação:<blockquote>'''Pediclicomplemento.VendaRepresentacao = 1'''</blockquote>o sistema '''não deverá gerar''' os registros financeiros normalmente criados em uma venda convencional.

Essa regra existe porque o pagamento da mercadoria será realizado diretamente entre o cliente e o fornecedor, cabendo ao ERP controlar apenas as informações relacionadas à comissão da venda por representação e aos respectivos registros específicos dessa modalidade.

== Sistema de Usuários | Movimentos | Gerenciador de Vendas por Representação ==

== Objetivo ==
Criar uma nova rotina denominada '''Gerenciador de Vendas por Representação''', destinada ao gerenciamento das vendas realizadas nessa modalidade.

A rotina deverá permitir o registro dos eventos relacionados ao processo de venda por representação, bem como o acompanhamento do pedido junto ao fornecedor até a entrega da mercadoria ao cliente.
----

== Regras de Negócio ==

=== RN023 – Inclusão da rotina no menu ===
Deverá ser criada uma nova opção no menu '''Movimentos''' denominada:

'''Gerenciador de Vendas por Representação'''

==== Regras ====

* Criar o script responsável pela inclusão da opção no menu dinâmico do Sistema de Usuários;
* A opção deverá ficar disponível somente no '''menu dinâmico''';
* Apenas usuários com a devida permissão poderão visualizar e acessar a rotina.

----

=== RN024 – Interface principal ===
Ao acessar a opção '''Gerenciador de Vendas por Representação''', o sistema deverá apresentar a interface principal da rotina conforme o layout/protótipo definido para o projeto.

A tela deverá servir como ponto central para gerenciamento das vendas por representação, permitindo o acompanhamento do fluxo operacional do pedido, desde o faturamento até a entrega ao cliente, bem como o registro dos eventos relacionados ao processo.

[[Arquivo:Imagetg5.png|centro|579x579px]]

=== RN025 – Pesquisa de pedidos ===
Ao acionar o botão '''Procurar''', o sistema deverá pesquisar os pedidos de Venda por Representação considerando os filtros informados pelo usuário.

==== Validação dos filtros ====
Antes de realizar a pesquisa, deverá ser validado se pelo menos um filtro foi informado ou selecionado.

Caso nenhum filtro seja informado, exibir a mensagem:<blockquote>'''"Informe ou selecione um filtro para a pesquisa."'''</blockquote>e não executar a consulta.
----

=== Critérios da pesquisa ===
A consulta deverá retornar apenas pedidos identificados como Venda por Representação.

'''Condição obrigatória'''

* '''Pediclicomplemento.VendaRepresentacao = 1'''

Os demais filtros deverão ser aplicados somente quando informados.

==== Período ====
Filtrar pela data da venda considerando apenas a data:

* '''VendasRepresentacao.DataVenda ≥ Data Inicial'''
* '''VendasRepresentacao.DataVenda ≤ Data Final'''

----

==== Pedido ERP ====
Filtrar por:

* '''Pediclicad.Numped'''

----

==== Pedido do Fabricante ====
Filtrar por:

* '''Pediclicad.Referencia'''

----

==== Filial ====
Filtrar por:

* '''Pediclicad.Filial'''

----

==== Cliente ====
Filtrar por:

* '''Pediclicad.Codclie'''

----

==== Fornecedor ====
Relacionar:

* Itemclicad.CodPro = Produtocad.CodPro

e filtrar:

* '''Produtocad.CodFor'''

----

==== Pendência de impressão do Termo de Compra ====
Quando marcado o filtro correspondente, retornar apenas pedidos onde:

* '''VendasRepresentacao.TermoDeCompra = 0'''
* ou '''NULL'''

----

==== Entrega atrasada ====
Quando solicitado, retornar pedidos cujos itens atendam simultaneamente às condições:

* '''Itemclicad.DtPrevEnt < Data Atual'''
* '''VendasRepresentacaoItem.DataExpedicao IS NULL'''

----

==== Itens pendentes ====
Retornar pedidos que possuam quantidade pendente de entrega.

Condição:

'''Itemclicad.Quant >'''

'''(VendasRepresentacaoItem.QtdeFaturada +'''

'''VendasRepresentacaoItem.QtdeCancelada +'''

'''VendasRepresentacaoItem.QtdeDevolvida)'''
----

==== Pedidos faturados ====
Retornar apenas pedidos que possuam Nota Fiscal emitida.

Condição:

* '''VendasRepresentacaoItem.NumeroNFVenda > 0'''

----

==== Pedidos concluídos ====
Retornar pedidos cuja expedição tenha sido concluída.

Condição:

* '''VendasRepresentacao.DataExpedicao preenchida'''

----

==== Nenhum registro localizado ====
Caso nenhum pedido seja encontrado, exibir a mensagem:<blockquote>'''"Nenhum registro encontrado."'''</blockquote>
----

=== RN026 – Exibição do resultado ===
Os pedidos localizados deverão ser apresentados no GRID agrupados por pedido e ordenados inicialmente pelos seguintes campos:

# Filial;
# Data da Venda;
# Data de Previsão de Entrega;
# Pedido ERP.

Além da ordenação padrão, deverá ser disponibilizado o recurso de ordenação clicando no cabeçalho de cada coluna.
----

=== Colunas do GRID ===
{| class="wikitable"
!Coluna
!Informação apresentada
|-
|'''Filial'''
|Filial do pedido (Pediclicad.Filial).
|-
|'''Pedido ERP'''
|Número do pedido no ERP (Pediclicad.Numped).
|-
|'''Pedido Fábrica'''
|Número do pedido informado pelo fabricante (Pediclicad.Referencia).
|-
|'''TPO'''
|Código e descrição do TPO (TPO_r.Codigo - TPO_r.Nome).
|-
|'''Cliente'''
|Razão social do cliente (Pediclicad.RazaoCli).
|-
|'''Fornecedor/Fabricante'''
|Razão social do fornecedor dos produtos do pedido (Fornecedor_r.RazaoSocial).
|-
|'''Vendedor'''
|Código e nome do vendedor (Pediclicad.CodVend - VendedorCad.Nome).
|-
|'''Valor do Pedido'''
|Valor total do pedido (Pediclicad.ValPed).
|-
|'''Data da Venda'''
|Data do faturamento registrada em VendasRepresentacao.DataVenda.
|-
|'''Data da Expedição'''
|Maior data registrada em VendasRepresentacaoItem.DataExpedicao.
|-
|'''Data Prevista de Entrega'''
|Data prevista de entrega do pedido (Pediclicad.DtPrevEnt).
|-
|'''Data da Entrega'''
|Maior data registrada em VendasRepresentacaoItem.DataEntrega. ''(Ficha 470004 – 10/06/2025).''
|-
|'''Impresso Termo de Compra'''
|Indica se o Termo de Compra foi impresso (VendasRepresentacao.TermoDeCompra = 1).
|-
|'''Situação'''
|Situação atual do pedido (VendasRepresentacao.Situacao).
|}
----

=== RN027 – Impressão do Termo de Compra ===
A rotina deverá disponibilizar o botão '''Impressão Termo de Compra''', responsável pela emissão do termo referente ao pedido selecionado.

==== Validação ====
Antes da impressão, deverá ser verificado se existe um pedido selecionado no GRID.

Caso nenhum pedido esteja selecionado, exibir a mensagem:<blockquote>'''"Selecione o pedido."'''</blockquote>Caso exista um pedido selecionado, o sistema deverá gerar o Termo de Compra utilizando o layout gráfico definido para o projeto.

[[Arquivo:Image6yt5.png|centro|584x584px]]

== Cabeçalho do Termo de Compra ==
{| class="wikitable"
!Campo
!Informação
|-
|'''Página'''
|Número da página do relatório.
|-
|'''Data de Emissão'''
|Data e hora da impressão do documento.
|-
|'''Número do Pedido'''
|Número do pedido de venda (Pediclicad.Numped).
|-
|'''Data da Venda'''
|Data do faturamento registrada em VendasRepresentacao.DataVenda.
|-
|'''Filial de Venda'''
|Código e nome da filial (Pediclicad.Filial - FilialCad.Nome).
|-
|'''Vendedor'''
|Código e nome do vendedor (Pediclicad.CodVend - VendedorCad.Nome).
|-
|'''Pedido do Fabricante'''
|Número do pedido informado pelo fabricante (Pediclicad.Referencia).
|-
|'''Fornecedor/Fabricante'''
|Código e razão social do fornecedor dos produtos (Produtocad.CodFor - Fornecedor_r.RazaoSocial).
|-
|'''CNPJ'''
|CNPJ do fornecedor (Fornecedor_r.Identificador).
|-
|'''Endereço do Fornecedor'''
|Endereço comercial completo do fornecedor.
|-
|'''Cliente da Venda'''
|Nome do cliente (Pediclicad.RazaoCli).
|-
|'''CPF/CNPJ'''
|CPF ou CNPJ do cliente (Pediclicad.CgcCli).
|-
|'''Endereço do Cliente'''
|Endereço comercial completo do cliente (logradouro, bairro, cidade, estado e CEP).
|-
|'''Endereço de Entrega'''
|Endereço de entrega do pedido, obtido a partir de Pediclicad.CodEndEnt.
|-
|'''Condição de Pagamento'''
|Descrição da condição de pagamento (Pediclicad.RFormaDePagar - FormaDePagar_r.Nome).
|}
----

== Detalhamento dos Produtos ==
O relatório deverá apresentar os produtos do pedido em formato tabular contendo as seguintes informações:
{| class="wikitable"
|Campo
|Informação
|-
|'''Produto'''
|Código do produto (Itemclicad.CodPro).
|-
|'''Referência'''
|Referência do produto (Produtocad.CodInterno).
|-
|'''Descrição'''
|Descrição longa do produto (ComplementoProduto.DescricaoLonga).
|-
|'''Unidade'''
|Unidade de venda (Itemclicad.Unid).
|-
|'''Quantidade Vendida'''
|Quantidade vendida (Itemclicad.Quant).
|-
|'''Previsão de Entrega'''
|Data prevista de entrega do produto (Itemclicad.DtPrevEnt).
|-
|'''Preço Unitário'''
|Valor unitário do produto (Itemclicad.Preco).
|-
|'''Preço Total'''
|Quantidade × Preço Unitário (Itemclicad.Quant × Itemclicad.Preco).
|}
----

== Totais do Pedido ==
Ao final do relatório deverão ser apresentados os valores consolidados do pedido.
{| class="wikitable"
|Campo
|Informação
|-
|'''Total de Mercadorias'''
|Somatório do preço total dos itens do pedido.
|-
|'''Desconto'''
|Valor do desconto geral do pedido (Pediclicad.Desconto).
|-
|'''Frete'''
|Valor do frete do pedido (Pediclicad.FreteOrc).
|-
|'''Outras Despesas'''
|Demais valores que compõem o total do pedido, quando houver.
|-
|'''Total do Pedido'''
|Valor total do pedido (Pediclicad.ValPed).
|}
----O documento deverá consolidar todas essas informações em um único '''Termo de Compra''', servindo como registro formal da venda por representação e contendo os dados da negociação, das partes envolvidas, dos produtos comercializados e dos valores totais do pedido.

== Comissão do Profissional Indicador ==
O painel '''Comissão do Profissional Indicador''' deverá ser apresentado de forma condicional, conforme as configurações do sistema.
----

== Regras de Negócio ==

=== RN028 – Exibição do painel ===
O GRID '''Comissão do Profissional Indicador''' deverá ser exibido somente quando o parâmetro:<blockquote>'''"Utiliza tratamento de comissão por indicação"'''</blockquote>estiver '''habilitado'''.

Caso o parâmetro esteja desabilitado:

* o GRID não deverá ser exibido;
* o GRID de '''Comissão de Venda por Representação''' deverá ser redimensionado automaticamente para ocupar o espaço disponível na interface, evitando áreas em branco.

----

=== RN029 – Dados apresentados ===
O GRID deverá listar todos os registros financeiros relacionados à comissão por indicação vinculados ao pedido de venda.

Os registros apresentados dependerão da configuração do parâmetro:<blockquote>'''"Gerar nota de crédito para comissão de profissional indicador?"'''</blockquote>

==== Quando o parâmetro estiver habilitado ====
Exibir os registros de '''Contas a Receber (Nota de Crédito)''' gerados para o profissional indicador.

==== Quando o parâmetro estiver desabilitado ====
Exibir os registros de '''Contas a Pagar''' gerados para o profissional indicador.

Em ambos os casos, deverão ser exibidos exclusivamente os registros financeiros vinculados à comissão por indicação do pedido de venda selecionado.
[[Categoria:Gerenciais]]

Venda por Representação

2026-08-05T14:43:03Z

Arione: Venda por Representação

==Tutorial==
'''A venda por representação, a empresa trabalha com a modalidade de venda por representação e necessita que o ERP seja customizado para oferecer suporte completo a esse modelo de operação.'''

'''Nesse formato de venda, a empresa atua como intermediária entre o cliente final e o fabricante, sendo necessários ajustes específicos no sistema para garantir que os processos de gerenciamento de pedidos, controle de prazos de entrega, cálculo de comissões e tratamento financeiro estejam devidamente alinhados às necessidades operacionais dessa modalidade.'''

'''Atualmente, o ERP não possui um fluxo estruturado que atenda às particularidades da venda por representação. Embora exista um módulo de revenda, ele não apresenta aderência suficiente para esse cenário.'''

'''A customização proposta tem como objetivo suprir essas limitações, proporcionando maior automação dos processos, redução das atividades manuais e melhor controle operacional, especialmente em rotinas como a apuração de comissões e o acompanhamento das vendas realizadas por representação.'''

== Lista de funcionalidades ==
Alterações no Banco de Dados:

Etapas para Instalação:

Vendas | Vendas

Vendas | Cancelamento

Sistema de usuários | Cadastro | Produtos | Produtos

Tradewin | Arquivos | Produtos | Produtos

TradChec | Com Orçamento

MU_ECF | Vendas

Sistema de usuários | Movimentos | Gerenciador de Vendas por Representação

Sistema de usuários | Relatórios | Comissão | Por Metas de Vendas

Relatório de Vendas por Representação (não é testado pelo QA)

Nota fiscal de serviço eletrônica (NFSe)

== Etapas para Instalação: ==

# LIGAR o parâmetro '''por filial “Trabalha com venda por representação?”'''

# Configurar nos '''FORNECEDORES''' de venda por representação os '''dados adicionais:'''
## '''Fornecedor de venda por representação?'''
## '''Dia para vencimento de conta a receber de venda por representação'''
## '''Tipo de documento para conta a receber de venda por representação'''
## '''TPO para Conta a receber (dado adicional de pessoa jurídica)'''

==== Configuração para ativar o recurso de COMISSÃO POR INDICADOR (opcional): ====

# Leitura e implantação do PA 78463
## Ligar o parâmetro por empresa "'''Orçamento com tratamento de revenda"'''
## Ligar o parâmetro por empresa '''"Utiliza tratamento de comissão por indicação"'''
## Configurar o parâmetro por filial '''"TPO para comissão de Indicadores".'''
## Ligar o parâmetro por filial '''" Validar limite de crédito do cliente do orçamento nas vendas para associados".'''
## Configurar o parâmetro empresa '''"Prorrogação para pagamento de comissão da Revenda" (número de dias correspondente ao prazo para efetuar o pagamento da comissão).'''
## Cadastrar para o tipo de indicador as '''classificações''' '''do''' '''indicador''' no '''cadastro de categoria:'''

==== Exemplo: ====
'''Representante (OID = 2128)'''

'''Arquiteto (criado pelo usuário)'''

'''Decorador (criado pelo usuário)'''

'''Engenheiro (criado pelo usuário)'''

# Cadastrar uma pessoa física classificada como cliente, fornecedor,representante e utilizando umas das classificações cadastradas para o tipo de indicador.

Exemplo: Arquiteto.

# Configurar o '''dado adicional''' '''“Taxa sobre indicação de venda”''' dos indicadores já cadastrados;

# Leitura do PA 418010 - Gerar nota de crédito para comissão de indicador

== Base de Conhecimento – Venda por Representação ==

== Objetivo ==
Implementar no ERP uma nova modalidade de '''Venda por Representação''', permitindo que a empresa atue como intermediária entre o cliente final e o fabricante, sem movimentação de estoque próprio.

Todas as regras descritas neste documento devem ser aplicadas '''somente quando o parâmetro "Trabalha com venda por representação?" estiver habilitado na filial da venda.'''
----

= Vendas | Pedido de Venda =

== Objetivo ==
Adequar o processo de inclusão e alteração de pedidos para suportar a modalidade de Venda por Representação.

=== Regra Geral ===
Em um pedido de venda por representação somente poderão ser informados produtos pertencentes ao '''mesmo fornecedor'''.
----

== Regras de Negócio ==

=== RN001 – Identificação do fornecedor ===
Ao informar um produto, o sistema deve verificar se o fornecedor possui o dado adicional:<blockquote>'''Fornecedor de venda por representação = Sim'''</blockquote>
----

=== RN002 – Mesmo fornecedor no pedido ===
Caso o primeiro produto informado pertença a um fornecedor de representação, todos os demais produtos do pedido deverão pertencer ao mesmo fornecedor.

Caso seja informado um produto de fornecedor diferente, exibir a mensagem:<blockquote>'''"Pedido de venda de representação só pode conter produtos do mesmo fornecedor."'''</blockquote>A inclusão do produto deverá ser bloqueada.
----

=== RN003 – Mistura com fornecedores comuns ===
Caso o pedido já possua produtos de fornecedores comuns, não deverá ser permitida a inclusão de um produto de fornecedor de representação.

Exibir a mensagem:<blockquote>'''"Produto de fornecedor de representação não pode ser informado no mesmo pedido de outros fornecedores."'''</blockquote>
----

=== RN004 – Consulta de produtos ===
Quando o pedido for de venda por representação, a consulta de produtos deverá listar apenas produtos pertencentes ao mesmo fornecedor já informado no pedido.
----

=== RN005 – Consulta para pedidos comuns ===
Quando o pedido não for de venda por representação, a consulta de produtos não deverá exibir produtos cujo fornecedor possua:<blockquote>'''Fornecedor de venda por representação = Sim'''</blockquote>
----

=== RN006 – Tipo de entrega ===
Para produtos de fornecedores de representação:

* somente deverá ser permitido o tipo de entrega '''Futura''';
* o tipo de entrega deverá ser preenchido automaticamente;
* não deverá ser permitida alteração do tipo de entrega;
* não deverá ser permitido informar outro local de retirada;
* os campos '''Filial de Retirada''' e '''Filial de Transferência''' deverão permanecer em branco e bloqueados para edição.

----

=== RN007 – Previsão de entrega ===
A previsão de entrega deverá ser calculada automaticamente utilizando a fórmula:

'''Data da venda + Prazo Entrega Venda Representação'''

O prazo deverá ser obtido do cadastro do produto:<blockquote>'''ComplementoProduto.PrazoEntregaRepresentação'''</blockquote>O vendedor poderá alterar a previsão apenas para uma data posterior à calculada automaticamente.
----

=== RN008 – Tratamento de estoque ===
Para produtos de fornecedores de representação:

* não validar estoque;
* não reservar estoque;
* definir:
** '''Itemclicad.Reserva = N'''
** não atualizar '''Itemfilest.QtdeReserv'''
* não utilizar controle de lote;
* não utilizar controle de validade;
* não executar validações relacionadas a lote.

----

=== RN009 – Identificação do pedido ===
Ao salvar um pedido de venda por representação, atualizar:<blockquote>'''Pediclicomplemento.VendaRepresentacao = 1'''</blockquote>Esse atributo identifica o pedido como venda por representação.
----

=== RN010 – Inclusão e alteração ===
Todas as regras descritas anteriormente deverão ser aplicadas tanto na inclusão quanto na alteração do pedido.
----

== Ajustes complementares ==

=== Ficha 468236 ===
Quando o pedido for de venda por representação, não deverá ser realizada validação de crediário.
----

=== Ficha 468760 ===

==== Item 1 – Roteiro automático ====
Não exibir o alerta:<blockquote>"Não foi encontrado roteiro automático para o endereço de entrega."</blockquote>Como a entrega é realizada pelo fabricante, esse tratamento não se aplica.
----

==== Item 2 – Encomenda ====
Não permitir a utilização da opção '''Encomenda'''.

Também deverá ser desabilitado todo tratamento relacionado à reserva de estoque e lote.
----

==== Item 3 – Liberação de lote ====
Não solicitar senha para liberar a pendência:<blockquote>"Liberar pendência de venda sem reserva de lote."</blockquote>Esse tratamento não se aplica à venda por representação.
----

==== Item 4 – NFe de simples faturamento ====
Desabilitar o alerta relacionado à emissão de Nota Fiscal de Simples Faturamento para pedidos de venda por representação.
----

= Marco de Entrega 1 =
Implementação de todas as regras RN001 até RN010 e ajustes das fichas 468236 e 468760.
----

= Vendas | Cancelamento =

== Objetivo ==
Definir regras específicas para cancelamento de pedidos de venda por representação.
----

== Regras de Negócio ==

=== RN011 – Pedido faturado ===
Não permitir o cancelamento de pedidos de venda por representação já faturados.

Condição:

* '''Pediclicad.Sitven = 2'''
* '''Pediclicomplemento.VendaRepresentacao = 1'''

Exibir a mensagem:<blockquote>'''"Pedido de vendas por representação já faturado não pode ser cancelado por essa opção."'''</blockquote>O cancelamento deverá ser interrompido.
----

=== RN012 – Pedido não faturado ===
Caso o pedido ainda não esteja faturado:

'''Pediclicad.Sitven <> 2'''

o cancelamento deverá ocorrer normalmente.
----

= Marco de Entrega 2 =
Implementação das regras RN011 e RN012.
----

= Cadastro de Produtos =
'''Módulos'''

* Sistema de Usuários → Cadastro → Produtos → Produtos
* Tradewin → Arquivos → Produtos → Produtos

== Objetivo ==
Disponibilizar novos campos no cadastro de produtos para atender à modalidade de Venda por Representação.

Entre eles, o campo responsável pelo cálculo da previsão de entrega:

* '''Prazo Entrega Venda Representação''' (''ComplementoProduto.PrazoEntregaRepresentação'').

Os demais campos deverão ser definidos conforme os protótipos e requisitos funcionais do projeto.

[[Arquivo:Image4re.png|centro|607x607px]]

== Regras de Negócio ==

=== RN013 – Comissão Venda por Representação ===
Deverá ser incluído, na página '''Unidade e Preço''' do cadastro de produtos, o campo:

'''Comissão Venda por Representação'''

==== Características ====

* Campo não obrigatório;
* Utilizado para informar o percentual de comissão do produto na modalidade Venda por Representação;
* Permitir apenas valores percentuais maiores ou iguais a zero (≥ 0);
* Atualizar o campo '''ComplementoProduto.ComissaoRepresentacao'''.

----

=== RN014 – Prazo Entrega Venda por Representação ===
Deverá ser incluído, na página '''Dados Complementares''' do cadastro de produtos, o campo:

'''Prazo Entrega Venda por Representação'''

==== Características ====

* Campo não obrigatório;
* Utilizado para informar o prazo de entrega do produto para vendas por representação;
* Permitir apenas valores maiores ou iguais a zero (≥ 0);
* Atualizar o campo '''ComplementoProduto.PrazoEntregaRepresentacao'''.

----

=== RN015 – Navegação do cadastro ===
Ao navegar entre os registros do cadastro de produtos, o sistema deverá realizar corretamente a leitura, atualização e persistência dos novos campos de Venda por Representação.
----

= Marco de Entrega 3 =
Implementação das regras RN013 a RN015.
----

= TradChec | Com Orçamento =

== Objetivo ==
Adequar o processo de faturamento para pedidos de Venda por Representação.

Nesta modalidade, o cliente realiza o pagamento diretamente ao fornecedor. Portanto, o faturamento não deverá gerar os mesmos registros financeiros de uma venda convencional.

Em substituição, deverão ser gerados:

* registros da nova estrutura de Venda por Representação;
* registros de Contas a Receber referentes exclusivamente à comissão da venda por representação.

----

== Regras de Negócio ==

=== Regra Geral ===
Todas as regras descritas nesta seção deverão ser aplicadas somente quando o parâmetro '''"Trabalha com venda por representação?"''' estiver habilitado na filial padrão do usuário.
----

=== RN016 – Geração do financeiro ===
Ao faturar um pedido identificado como Venda por Representação:<blockquote>'''Pediclicomplemento.VendaRepresentacao = 1'''</blockquote>o sistema '''não deverá gerar''' os registros financeiros normalmente criados em uma venda convencional.

Essa regra existe porque o pagamento da mercadoria será realizado diretamente entre o cliente e o fornecedor, cabendo ao ERP controlar apenas as informações relacionadas à comissão da venda por representação e aos respectivos registros específicos dessa modalidade.

== Sistema de Usuários | Movimentos | Gerenciador de Vendas por Representação ==

== Objetivo ==
Criar uma nova rotina denominada '''Gerenciador de Vendas por Representação''', destinada ao gerenciamento das vendas realizadas nessa modalidade.

A rotina deverá permitir o registro dos eventos relacionados ao processo de venda por representação, bem como o acompanhamento do pedido junto ao fornecedor até a entrega da mercadoria ao cliente.
----

== Regras de Negócio ==

=== RN023 – Inclusão da rotina no menu ===
Deverá ser criada uma nova opção no menu '''Movimentos''' denominada:

'''Gerenciador de Vendas por Representação'''

==== Regras ====

* Criar o script responsável pela inclusão da opção no menu dinâmico do Sistema de Usuários;
* A opção deverá ficar disponível somente no '''menu dinâmico''';
* Apenas usuários com a devida permissão poderão visualizar e acessar a rotina.

----

=== RN024 – Interface principal ===
Ao acessar a opção '''Gerenciador de Vendas por Representação''', o sistema deverá apresentar a interface principal da rotina conforme o layout/protótipo definido para o projeto.

A tela deverá servir como ponto central para gerenciamento das vendas por representação, permitindo o acompanhamento do fluxo operacional do pedido, desde o faturamento até a entrega ao cliente, bem como o registro dos eventos relacionados ao processo.

[[Arquivo:Imagetg5.png|centro|579x579px]]

=== RN025 – Pesquisa de pedidos ===
Ao acionar o botão '''Procurar''', o sistema deverá pesquisar os pedidos de Venda por Representação considerando os filtros informados pelo usuário.

==== Validação dos filtros ====
Antes de realizar a pesquisa, deverá ser validado se pelo menos um filtro foi informado ou selecionado.

Caso nenhum filtro seja informado, exibir a mensagem:<blockquote>'''"Informe ou selecione um filtro para a pesquisa."'''</blockquote>e não executar a consulta.
----

=== Critérios da pesquisa ===
A consulta deverá retornar apenas pedidos identificados como Venda por Representação.

'''Condição obrigatória'''

* '''Pediclicomplemento.VendaRepresentacao = 1'''

Os demais filtros deverão ser aplicados somente quando informados.

==== Período ====
Filtrar pela data da venda considerando apenas a data:

* '''VendasRepresentacao.DataVenda ≥ Data Inicial'''
* '''VendasRepresentacao.DataVenda ≤ Data Final'''

----

==== Pedido ERP ====
Filtrar por:

* '''Pediclicad.Numped'''

----

==== Pedido do Fabricante ====
Filtrar por:

* '''Pediclicad.Referencia'''

----

==== Filial ====
Filtrar por:

* '''Pediclicad.Filial'''

----

==== Cliente ====
Filtrar por:

* '''Pediclicad.Codclie'''

----

==== Fornecedor ====
Relacionar:

* Itemclicad.CodPro = Produtocad.CodPro

e filtrar:

* '''Produtocad.CodFor'''

----

==== Pendência de impressão do Termo de Compra ====
Quando marcado o filtro correspondente, retornar apenas pedidos onde:

* '''VendasRepresentacao.TermoDeCompra = 0'''
* ou '''NULL'''

----

==== Entrega atrasada ====
Quando solicitado, retornar pedidos cujos itens atendam simultaneamente às condições:

* '''Itemclicad.DtPrevEnt < Data Atual'''
* '''VendasRepresentacaoItem.DataExpedicao IS NULL'''

----

==== Itens pendentes ====
Retornar pedidos que possuam quantidade pendente de entrega.

Condição:

'''Itemclicad.Quant >'''

'''(VendasRepresentacaoItem.QtdeFaturada +'''

'''VendasRepresentacaoItem.QtdeCancelada +'''

'''VendasRepresentacaoItem.QtdeDevolvida)'''
----

==== Pedidos faturados ====
Retornar apenas pedidos que possuam Nota Fiscal emitida.

Condição:

* '''VendasRepresentacaoItem.NumeroNFVenda > 0'''

----

==== Pedidos concluídos ====
Retornar pedidos cuja expedição tenha sido concluída.

Condição:

* '''VendasRepresentacao.DataExpedicao preenchida'''

----

==== Nenhum registro localizado ====
Caso nenhum pedido seja encontrado, exibir a mensagem:<blockquote>'''"Nenhum registro encontrado."'''</blockquote>
----

=== RN026 – Exibição do resultado ===
Os pedidos localizados deverão ser apresentados no GRID agrupados por pedido e ordenados inicialmente pelos seguintes campos:

# Filial;
# Data da Venda;
# Data de Previsão de Entrega;
# Pedido ERP.

Além da ordenação padrão, deverá ser disponibilizado o recurso de ordenação clicando no cabeçalho de cada coluna.
----

=== Colunas do GRID ===
{| class="wikitable"
!Coluna
!Informação apresentada
|-
|'''Filial'''
|Filial do pedido (Pediclicad.Filial).
|-
|'''Pedido ERP'''
|Número do pedido no ERP (Pediclicad.Numped).
|-
|'''Pedido Fábrica'''
|Número do pedido informado pelo fabricante (Pediclicad.Referencia).
|-
|'''TPO'''
|Código e descrição do TPO (TPO_r.Codigo - TPO_r.Nome).
|-
|'''Cliente'''
|Razão social do cliente (Pediclicad.RazaoCli).
|-
|'''Fornecedor/Fabricante'''
|Razão social do fornecedor dos produtos do pedido (Fornecedor_r.RazaoSocial).
|-
|'''Vendedor'''
|Código e nome do vendedor (Pediclicad.CodVend - VendedorCad.Nome).
|-
|'''Valor do Pedido'''
|Valor total do pedido (Pediclicad.ValPed).
|-
|'''Data da Venda'''
|Data do faturamento registrada em VendasRepresentacao.DataVenda.
|-
|'''Data da Expedição'''
|Maior data registrada em VendasRepresentacaoItem.DataExpedicao.
|-
|'''Data Prevista de Entrega'''
|Data prevista de entrega do pedido (Pediclicad.DtPrevEnt).
|-
|'''Data da Entrega'''
|Maior data registrada em VendasRepresentacaoItem.DataEntrega. ''(Ficha 470004 – 10/06/2025).''
|-
|'''Impresso Termo de Compra'''
|Indica se o Termo de Compra foi impresso (VendasRepresentacao.TermoDeCompra = 1).
|-
|'''Situação'''
|Situação atual do pedido (VendasRepresentacao.Situacao).
|}
----

=== RN027 – Impressão do Termo de Compra ===
A rotina deverá disponibilizar o botão '''Impressão Termo de Compra''', responsável pela emissão do termo referente ao pedido selecionado.

==== Validação ====
Antes da impressão, deverá ser verificado se existe um pedido selecionado no GRID.

Caso nenhum pedido esteja selecionado, exibir a mensagem:<blockquote>'''"Selecione o pedido."'''</blockquote>Caso exista um pedido selecionado, o sistema deverá gerar o Termo de Compra utilizando o layout gráfico definido para o projeto.

[[Arquivo:Image6yt5.png|centro|584x584px]]

== Cabeçalho do Termo de Compra ==
{| class="wikitable"
!Campo
!Informação
|-
|'''Página'''
|Número da página do relatório.
|-
|'''Data de Emissão'''
|Data e hora da impressão do documento.
|-
|'''Número do Pedido'''
|Número do pedido de venda (Pediclicad.Numped).
|-
|'''Data da Venda'''
|Data do faturamento registrada em VendasRepresentacao.DataVenda.
|-
|'''Filial de Venda'''
|Código e nome da filial (Pediclicad.Filial - FilialCad.Nome).
|-
|'''Vendedor'''
|Código e nome do vendedor (Pediclicad.CodVend - VendedorCad.Nome).
|-
|'''Pedido do Fabricante'''
|Número do pedido informado pelo fabricante (Pediclicad.Referencia).
|-
|'''Fornecedor/Fabricante'''
|Código e razão social do fornecedor dos produtos (Produtocad.CodFor - Fornecedor_r.RazaoSocial).
|-
|'''CNPJ'''
|CNPJ do fornecedor (Fornecedor_r.Identificador).
|-
|'''Endereço do Fornecedor'''
|Endereço comercial completo do fornecedor.
|-
|'''Cliente da Venda'''
|Nome do cliente (Pediclicad.RazaoCli).
|-
|'''CPF/CNPJ'''
|CPF ou CNPJ do cliente (Pediclicad.CgcCli).
|-
|'''Endereço do Cliente'''
|Endereço comercial completo do cliente (logradouro, bairro, cidade, estado e CEP).
|-
|'''Endereço de Entrega'''
|Endereço de entrega do pedido, obtido a partir de Pediclicad.CodEndEnt.
|-
|'''Condição de Pagamento'''
|Descrição da condição de pagamento (Pediclicad.RFormaDePagar - FormaDePagar_r.Nome).
|}
----

== Detalhamento dos Produtos ==
O relatório deverá apresentar os produtos do pedido em formato tabular contendo as seguintes informações:
{| class="wikitable"
|Campo
|Informação
|-
|'''Produto'''
|Código do produto (Itemclicad.CodPro).
|-
|'''Referência'''
|Referência do produto (Produtocad.CodInterno).
|-
|'''Descrição'''
|Descrição longa do produto (ComplementoProduto.DescricaoLonga).
|-
|'''Unidade'''
|Unidade de venda (Itemclicad.Unid).
|-
|'''Quantidade Vendida'''
|Quantidade vendida (Itemclicad.Quant).
|-
|'''Previsão de Entrega'''
|Data prevista de entrega do produto (Itemclicad.DtPrevEnt).
|-
|'''Preço Unitário'''
|Valor unitário do produto (Itemclicad.Preco).
|-
|'''Preço Total'''
|Quantidade × Preço Unitário (Itemclicad.Quant × Itemclicad.Preco).
|}
----

== Totais do Pedido ==
Ao final do relatório deverão ser apresentados os valores consolidados do pedido.
{| class="wikitable"
|Campo
|Informação
|-
|'''Total de Mercadorias'''
|Somatório do preço total dos itens do pedido.
|-
|'''Desconto'''
|Valor do desconto geral do pedido (Pediclicad.Desconto).
|-
|'''Frete'''
|Valor do frete do pedido (Pediclicad.FreteOrc).
|-
|'''Outras Despesas'''
|Demais valores que compõem o total do pedido, quando houver.
|-
|'''Total do Pedido'''
|Valor total do pedido (Pediclicad.ValPed).
|}
----O documento deverá consolidar todas essas informações em um único '''Termo de Compra''', servindo como registro formal da venda por representação e contendo os dados da negociação, das partes envolvidas, dos produtos comercializados e dos valores totais do pedido.

== Comissão do Profissional Indicador ==
O painel '''Comissão do Profissional Indicador''' deverá ser apresentado de forma condicional, conforme as configurações do sistema.
----

== Regras de Negócio ==

=== RN028 – Exibição do painel ===
O GRID '''Comissão do Profissional Indicador''' deverá ser exibido somente quando o parâmetro:<blockquote>'''"Utiliza tratamento de comissão por indicação"'''</blockquote>estiver '''habilitado'''.

Caso o parâmetro esteja desabilitado:

* o GRID não deverá ser exibido;
* o GRID de '''Comissão de Venda por Representação''' deverá ser redimensionado automaticamente para ocupar o espaço disponível na interface, evitando áreas em branco.

----

=== RN029 – Dados apresentados ===
O GRID deverá listar todos os registros financeiros relacionados à comissão por indicação vinculados ao pedido de venda.

Os registros apresentados dependerão da configuração do parâmetro:<blockquote>'''"Gerar nota de crédito para comissão de profissional indicador?"'''</blockquote>

==== Quando o parâmetro estiver habilitado ====
Exibir os registros de '''Contas a Receber (Nota de Crédito)''' gerados para o profissional indicador.

==== Quando o parâmetro estiver desabilitado ====
Exibir os registros de '''Contas a Pagar''' gerados para o profissional indicador.

Em ambos os casos, deverão ser exibidos exclusivamente os registros financeiros vinculados à comissão por indicação do pedido de venda selecionado.

Arquivo:Image6yt5.png

2026-08-05T14:39:59Z

Arione:

Image6yt5

Arquivo:Imagetg5.png

2026-08-05T14:37:44Z

Arione:

Imagetg5

Arquivo:Image4re.png

2026-08-05T14:34:20Z

Arione:

Image4re