Exibir código-fonte para Importação e Exportação de Pedidos de Beneficiamento

== '''Objetivo''' ==



Tornar possível a exportação e importação de pedidos automaticamente por meio de arquivos XML, para que os pedidos e notas fiscais de beneficiamento sejam feitos de forma rápida e o mais simples possível entre dois bancos de dados.

== '''Fluxo Operacional''' ==



[[Arquivo:FluxoOperacional.png|center]]



== '''Descrição do Recurso''' ==



Os pedidos serão captados normalmente pelo banco de dados da empresa Revenda, quando um determinado acompanhamento for vinculado ao pedido, o sistema irá gerar automaticamente através de um gatilho(trigger) um registro na '''tabela de exportação*''' para que o aplicativo de exportação crie o arquivo xml referente ao pedido.

Esse aplicativo faz a leitura da tabela de exportação a cada 1 minuto procurando registros a serem exportados, ao encontrar um registro o aplicativo gera um arquivo xml referente ao pedido e grava a '''data de exportação**''' confirmando que o pedido será exportado.

Após a geração do xml o aplicativo de importação realiza a cada 1 minuto a leitura na pasta de exportação procurando arquivos xml a serem importados, se encontrar importará o pedido no banco de dados da empresa Laboratório. Após o pedido ser importado, o sistema irá gerar um roteiro de beneficiamento (parâmetros por empresa -> estoque -> roteiro) no momento de sua impressão. Foi implementado um novo roteiro porque o pedido que entra na empresa com o objetivo de beneficiamento não deverá passar pela célula de estoque, já que o produto foi enviado para beneficiamento, não necessitando fazer separação de estoque. O sistema somente irá gerar o roteiro de beneficiamento quando houver no pedido um cfop de beneficiamento. O fluxo operacional do pedido na empresa Laboratório é o mesmo de outros pedidos, passando normalmente pelo SGCEL, expedição e faturamento.

Existem travas tanto no banco de exportação como no banco de importação que impedem a alteração, cancelamento e exclusão do pedido após sua exportação ou importação, portanto caso seja necessário alguma alteração no pedido, o mesmo deverá ser cancelado no Laboratório para que seja cancelado na Revenda e novamente digitado na Revenda para ser reexportado. O fluxo fiscal completo de beneficiamento deve ser obedecido: 



*Nota Fiscal de Saída na Revenda : Remessa para industrialização por encomenda
*Nota Fiscal de Entrada no Laboratório : Entrada para industrialização por encomenda
*Nota Fiscal de Saída no Laboratório : Retorno de mercadoria utilizada na industrialização por encomenda
*Nota Fiscal de Entrada na Revenda : Retorno de mercadoria remetida para industrialização por encomenda



 '''Notas Técnicas'''
 Tabela de Exportação : Tabela : PDEXPIMP
 Data de Exportação : Campo : PDEXPIMP.PEIDTREMESSA


Enquanto a nota de "Remessa para industrialização por encomenda" não tiver sido enviada, importada e faturada no Laboratório, o pedido que foi importado não poderá ser faturado no Laboratório. Todas as travas e restrições serão explicadas detalhadamente em seguida.



== '''Aplicativo de Exportação (Exporta.exe) e Importação (Importa.exe)''' ==


O aplicativo usado para gerar os arquivos xml de exportação e importação é usado tanto para exportar como importar, ficando no '''Arquivo de Configurações*''' do executável a configuração se o mesmo irá importar ou exportar pedidos.
O projeto se encontra no '''repositório**''' do grupo acert  e se chama ExportaImporta.dpr. Para que não haja risco do aplicativo ficar aberto em duas máquinas, deve ser gerado um atalho do aplicativo com o parâmetro “-bot” ficando parecido com o exemplo a seguir: 


D:\Execs\SGO\Exporta.exe –bot

D:\Execs\SGO\Importa.exe –bot


Mais a frente será explicado o funcionamento do aplicativo sem o parâmetro “-bot”.
O seu funcionamento é parecido com o do AtualNfe, fica na barra de tarefas do Windows e suas configurações podem ser acessadas clicando com o botão direito do mouse no ícone do aplicativo que fica fica na barra de tarefas do windows:

 '''Notas Técnicas'''
 Arquivo de Configurações : Arquivo : Exporta.ini ou Importa.ini
 Repositório : Subversion : [pasta do subversion] \Sisger\SGO\ExportaPedidXML\Exporta 2.0


Aplicativo para Exportação:


[[Arquivo:Figura4.png|center|Figura 4]]

Clicando com o botão direito do mouse no aplicativo de Exportação:


[[Arquivo:Figura5.png|center|Figura 5]]


Aplicativo para Importação:


[[Arquivo:Figura22.png|center|Figura 22]]

Clicando com o botão direito do mouse no aplicativo de Importação:


[[Arquivo:Figura23.png|center|Figura 23]]


Primeiro vamos configurar as pastas de exportação para que os arquivos xml sejam gerados nos diretórios corretos, para isso clique na opção “Configurações”.


==='''Configurações > Geral'''===


[[Arquivo:Figura6.png|center|Figura 6]]


*Finalidade = Configurar se o aplicativo irá exportar ou importar pedidos;
*Tempo = Intervalo que o aplicativo irá startar a exportação\importação de pedidos;
*Cliente = Código do cliente dos parâmetros por empresa configurada no banco de dados do Revenda que será colocado no arquivo xml do pedido exportado;
*Pasta onde serão gerenciados os arquivos para exportação = Diretório onde serão gerados os arquivos xml,  a pasta OK é criada automaticamente pelo aplicativo para guardar os arquivos que são importados com sucesso. A pasta ERRO é criada automaticamente para guardar os arquivos xml que tiveram erro na importação.
*Pasta onde serão gerenciados os arquivos para importação = Diretório onde serão gerados os arquivos xml que foram importados com sucesso, acompanhamento dos pedidos importados, cancelamento dos pedidos importados e erros ocorridos na importação de pedidos.



==='''Configurações > Exportação'''===


[[Arquivo:Figura7.png|center|Figura 7]]


*Ordem de compra = Quando o pedido for exportado, o campo ordem de compra no Laboratório será o código do pedido ou ID do pedido;



==='''Configurações > Importação'''===


Esses parâmetros somente deverão ser configurados se o aplicativo estiver configurado para Importar.



[[Arquivo:Figura8.png|center|Figura 8]]



==='''Configurações > Importação > Benef. Produtos (Saída)'''===


*CFOP dentro do estado = Deverá ser informado o cfop que deverá ficar no pedido que será importado no Laboratório. Deve sempre ser REB(Retorna entrada de beneficiamento) para saída e não lançar estoque.
*CFOP fora do estado = Deverá ser informado o cfop que deverá ficar no pedido que será importado no Laboratório. Deve sempre ser EB(Entrada de beneficiamento) para entrada e não lançar estoque.
*Importar pedidos de fornecedores = Se essa opção for marcada, os pedidos de clientes exportados para dar entrada no Laboratório como entrada para beneficiamento serão importados automaticamente, se não estiver marcado, a importação será manual.


==='''Configurações > Importação > Benef. Serviços (Saída)'''===
*CFOP dentro do estado = Deverá ser informado o cfop dos serviços que deverá ficar no pedido que será importado no Laboratório. 
*CFOP fora do estado = Deverá ser informado o cfop dos serviços que deverá ficar no pedido que será importado no Laboratório. 


==='''Configurações > Importação > Benef. Produtos (Entrada)'''===
*CFOP dentro do estado = Deverá ser informado o cfop dos serviços que deverá ficar no pedido que será importado no Laboratório. Deve sempre ser EB(Entrada de beneficiamento) para entrada e não lançar estoque.
*CFOP fora do estado = Deverá ser informado o cfop dos serviços que deverá ficar no pedido que será importado no Laboratório. Deve sempre ser EB(Entrada de beneficiamento) para entrada e não lançar estoque.



== '''Aplicativo SGO (Banco de Dados da Revenda)''' ==

Existem laboratórios que utilizam os serviços (tratamentos, montagem, etc..) cadastrados como produtos e será necessário configurar no Banco da Revenda, o código do produto e fornecedor referente ao serviço no banco do Laboratório, como podemos observar abaixo:


[[Arquivo:Figura1.png|center|Figura 1]]


Os códigos da Revenda e Laboratório são os mesmos, porém um cadastrado como serviço e o outro cadastrado como produto.

No cadastro de produtos existe uma configuração para selecionar o produto para exportação ou não. Caso o produto esteja marcado, o mesmo será exportado no pedido, se não estiver, o produto não será exportado.


[[Arquivo:Figura9.png|center|Figura 9]]



Após esse passo deverá ser configurado nos "parâmetros por empresa -> outros" o laboratório de exportação e também que os serviços serão importados no Laboratório como produtos, como demonstrados abaixo:


[[Arquivo:Figura2.png|center|Figura 2]]


O campo “Transporta serviços como produto do tipo Serviço” deverá estar marcado para que o sistema busque no '''Cadastro de Fornecedor/Cliente do Serviço*''' o código referente do serviço no Laboratório e exporte o '''pedido com produto**''' quando o serviço estiver no pedido da Revenda. 
O campo “laboratório de exportação” deverá ser preenchido com o código do fornecedor referente ao Laboratório para que o sistema encontre as configurações necessárias no '''Cadastro de Fornecedor/Cliente do Serviço*'''.


 '''Notas Técnicas'''
 Tarefa Cadastro de Fornecedor/Cliente do Serviço : Tabelas : SRFOR e SRFUN
 Tabela Pedido com Produto : Tabela : PDPRD


No cadastro de localização do pedido foi criado um campo para configurar o acompanhamento que irá disparar a exportação do pedido.


[[Arquivo:Figura3.png|center|Figura 3]]



Na tabela de '''Acompanhamento de Pedidos*''' foi criado um '''gatilho**''' após a inserção que irá inserir na '''Tabela de Exportação***''' o pedido que ganhar o acompanhamento que estiver marcado para exportar para beneficiamento. Esse acompanhamento poderá ser referente ao início de uma célula ou simplesmente uma localização normal. O correto do fluxo de beneficiamento é ter uma célula que controle o envio e recebimento do pedido para beneficiamento (parecido com a célula de tratamento), mas ficará a cargo do cliente decidir sobre o caso. Provisoriamente no '''gatilho**''' tem a execução de um '''procedimento****''' que apaga do roteiro do pedido inserido na '''Tabela de Exportação***''' as células que são diferentes de estoque e expedição. Isso foi feito para que o cliente possa testar o recurso sem ter problemas de roteiro nos pedidos que forem enviados para o Laboratório, mas isso é provisório até o mesmo tomar a decisão de colocar o recurso em produção e refazer o roteiro dos produtos e serviços.



 '''Notas Técnicas'''
 Acompanhamento de Pedidos : ACOPED : Tabela
 Gatilho : Trigger : TAI_ACOPED_EXPORTA
 Tabela de Exportação : Tabela : PDEXPIMP
 Procedimento : Procedure : ROTEIRO_REFACTORY



=== '''Exportando um Pedido de Beneficiamento''' ===



Ao clicar duas vezes no aplicativo de exportação, o mesmo ficará na barra de tarefas do Windows, para iniciar a exportação dos pedidos é necessário clicar com o botão direito do mouse no ícone do aplicativo localizado na barra de tarefas e selecionar a opção “iniciar”


[[Arquivo:Figura13.png|center|Figura 13]]



O pedido é digitado normalmente no banco de dados da revenda. Após o usuário ligar ao pedido o acompanhamento que o libera para exportação, o mesmo é exportado. O jitbox também é exportado com o pedido. Caso o mesmo não exista ou esteja ligado a outro pedido no banco de dados do Laboratório, o sistema irá gravar no log que o jitbox não foi ligado ao pedido importado porque o mesmo não estava disponível no momento da importação.



[[Arquivo:Figura11.png|center|Figura 11]]


[[Arquivo:Figura10.png|center|Figura 10]]



Após o pedido ser inserido na '''tabela de exportação*''', o sistema não permitirá a sua alteração.


[[Arquivo:Figura12.png|center|Figura 12]]


O aplicativo então iniciará o monitoramento da '''tabela de exportação*''' para gerar os arquivos XML no diretório configurado para exportação. Ao encontrar registros na tabela de exportação, o aplicativo irá gerar o arquivo XML no diretório de exportação, como pode ser visualizado na imagem abaixo:


[[Arquivo:Figura14.png|center|Figura 14]]



O arquivo mostrado acima será movido para o diretório “Ok” somente após a importação com sucesso do pedido no banco de dados do Laboratório. Caso ocorra algum erro como produto não cadastrado no laboratório ou serviço não cadastrado no laboratório o arquivo será movido para o diretório “Erro” e será gerado um arquivo TXT com o mesmo nome do arquivo XML com a mensagem de erro ocorrida na importação, como pode ser visualizado na imagem abaixo:



[[Arquivo:Figura15.png|center|Figura 15]]



 '''Notas Técnicas'''
 Tabela de Exportação : Tabela : PDEXPIMP



== '''Aplicativo SGO (Banco de Dados do Laboratório)''' ==

=== '''Importando um Pedido de Beneficiamento (Entrada)''' ===

=== '''Importando um Pedido de Beneficiamento''' ===

=== '''Faturando um Pedido de Beneficiamento''' ===

==== ''' Descrição do Recurso ''' ====

Ao realizar o faturamento de algum pedido que seja de beneficiamento, o sistema irá lançar automaticamente na Nota Fiscal, os insumos de acordo com os percentuais configurados.
Para que essa Nota Fiscal seja lançada com sucesso, é necessário que algumas configurações sejam feitas, conforme descrito nos tópicos abaixo.

==== ''' Configurando ''' ====

===== ''' Parâmetros por Empresa > CFOPs (2) ''' =====


[[Arquivo:Figura17.png|center|Figura 17]]


Aqui é necessário informar a Natureza de Insumos. Essa CFOP será utilizada no lançamento dos Insumos que são adicionados na Nota Fiscal de Saída.
Essa CFOP não pode lançar Estoque e é recomendável que esteja com a Finalidade “Outras Saídas”. Essa CFOP geralmente tributa ICMS e alguns outros impostos (Verifique com o contador responsável o que deve ser tributado ou não).

 '''Notas Técnicas'''
 Nome dos campos da CFOP de Insumo: Dentro do Estado: FISCODIGOINSUMO1 e Fora do Estado: FISCODIGOINSUMO2

===== ''' Estoque > Produtos > Cadastro de Produtos > Preços/Estoques ''' =====

[[Arquivo:Figura18.png|center|Figura 18]]

Informe no campo “Percentual Insumo” qual o percentual do valor desse produto que deverá ser tributado. Deve ser informado um valor maior do que zero para que funcione corretamente.
O exemplo acima indica que 33% do valor de venda do produto será tributado e os outros 67% não.

 '''Nota técnica:'''
 Nome do campo do Percentual de Insumo: PREPCINSUMO

===== ''' Cadastros > Serviços > Serviços por Empresa ''' =====

[[Arquivo:Figura19.png|center|Figura 19]]

Caso seja necessário lançar insumos de um serviço, o usuário deverá configurar o “Percentual de Insumo” nessa tela.

 '''Nota técnica: '''
 Nome do campo do Percentual de Insumo: SERPCINSUMO

==== ''' Lançamento dos Insumos ''' ====

No momento que a Nota Fiscal estiver sendo gerada, será validado se algum de seus pedidos possui um produto ou serviço com uma CFOP cuja finalidade seja “Retorna Entrada Beneficiamento”. Caso exista, será lançado o Insumo seguindo o seguinte processo:
*Serão percorridos todos os itens já inclusos na Nota Fiscal e calculados os novos valores de venda de acordo com o percentual configurado em cada item.
*Para cada item encontrado com percentual configurado, um novo produto será lançado na Nota Fiscal com o mesmo código e quantidade, mas com a descrição seguida de “Insumos X%” e o valor proporcional calculado na etapa anterior.
*Esse novo item utilizará a CFOP configurada nos parâmetros por empresa (conforme tópico acima)

Veja abaixo um exemplo:


[[Arquivo:Figura21.png|center|Figura 21]]


O pedido de clientes foi importado com valor de venda de R$ 44,00 em cada serviço.
Ao gerar a Nota de Saída, o serviço que veio do pedido foi copiado para a Nota, porém com valor de R$ 29,48 (valor de venda no pedido – 33%) e o texto "M. Obra X%" em sua descrição. Os 33% configurados no serviço (=R$ 14,52) foram colocados em um novo serviço com mesmo código, mas com o texto “Insumos X%” em sua descrição. Veja que esse novo serviço está com a CFOP configurada nos parâmetros por Empresa.



[[Arquivo:Figura16.png|center|Figura 16]]


Vale lembrar que só serão faturados os pedidos que não estão aguardando a Nota Fiscal de Entrada. Essa restrição se aplica atualmente apenas aos clientes que utilizam os aplicativos Importa 2.0 e/ou Exporta 2.0.

==== ''' Referência às Notas Fiscais de Entrada na observação da Nota Fiscal de Saída ''' ====


Na observação da Nota de Saída, serão apresentados os números das Notas Fiscais de Entrada, Valor e Data de Emissão. Essa referência só é feita com sucesso quando:
*Foi digitado/importado um Pedido de Fornecedor e esse Pedido foi vinculado a um Pedido de Clientes (atualmente apenas o aplicativo Importa 2.0 faz esse vínculo quando é realizada a importação dos Pedidos de Fornecedores de Beneficiamento);
*O Pedido de Fornecedor deve estar Faturado;

[[Arquivo:Figura20.png|center|Figura 20]]


Se existir mais de uma Nota de Entrada para os pedidos, elas serão apresentadas também.

 '''Notas Técnicas'''
 Como são buscadas as Notas de Entrada: É buscado o ID do Pedido na tabela PEDPFO. Dessa maneira é localizado o Pedido de Fornecedor. 
 A partir daí é verificado o PFNFE e então a Nota de Entrada é encontrada.