Boletim Tcnico

TOTVS Colaborao: gerao automtica dos documentos

Produto

Microsiga Protheus Compras Verso 11

Chamado

TFWKC6

Data da publicao

15/03/13

Pas(es)

Brasil

Banco(s) de Dados

Todos

Esta melhoria depende de execuo do update de base

para Implementao.

UPDCOM19, conforme Procedimentos

Com o objetivo de tornar mais simples e gil a gerao dos Documentos Fiscais de Entrada, implementou-se na rotina
do TOTVS Colaborao (COMXCOL) a funcionalidade que permite gerar automaticamente estes Documentos, Pr-Nota de
Entrada (MATA140) ou Documento de Entrada (MATA103).
O processo para gerao automtica dos Documentos de Entrada ser feito pela configurao do parmetro
MV_COMCOL1, que admite as seguintes opes:
0 - No Gera: O processo permanece inalterado, ou seja, os documentos eletrnicos recebidos via TOTVS
Colaborao ficam disponveis no Monitor TOTVS Colaborao aguardando a gerao do respectivo
documento pelo usurio;
1 - A Classificar: Os Documentos Eletrnicos recebidos via TOTVS Colaborao sero automaticamente
processados para gerao de pr-nota (Exceto: Documentos de bonificao, Complemento de preo e
Conhecimento de transporte, que sempre geram Documento de Entrada);
2 - Classificado: Todos os Documentos Eletrnicos recebidos via TOTVS Colaborao so automaticamente
processados para gerao de Documento de Entrada (pr-nota classificada);

Quando o parmetro MV_COMCOL1 estiver com o contedo igual a 2 - Classificado, o Tipo de Entrada que ser utilizado
para classificao dos itens do documento de entrada ser o Tipo de Entrada Padro informado no Cadastro do Produto
processado (Campo TE Padro [B1_TE]). Caso queira implementar tratamento especfico para identificao do Tipo de
Entrada a ser utilizado na classificao dos documentos, utilize o ponto de entrada COMCOLF4.

Quando o parmetro MV_COMCOL1 estiver com o contedo igual a 2 - Classificado, aps identificao dos Tipos de
Entrada aplicados aos itens dos documentos, ser analisado se algum dos Tipos de Entrada est configurado para gerao
de duplicata. Em caso positivo, a identificao da Condio de Pagamento a ser aplicada no Documento de Entrada ser
feita pelo Cadastro de Fornecedores/Clientes. Caso queira implementar tratamento especfico para identificao da
condio de pagamento a ser utilizada na classificao dos documentos, utilize o ponto de entrada A140ICOND.

Quando o parmetro MV_COMCOL1 estiver com o contedo igual a 2- Classificado, pode-se parametrizar para quais
Tipos de Documentos ser processada a gerao automtica. Para isto o parmetro MV_COMCOL2 dever ser configurado

SIGACOM TOTVS Colaborao: gerao automtica dos documentos

Boletim Tcnico

identificando quais Tipos de Documentos sero gerados automaticamente. O parmetro MV_COMCOL2 admite os seguintes
valores:
N Notas de compra;
D Notas de devoluo de venda;
C Notas de complemento de preo;
O Notas de bonificao;
T Notas de conhecimento de transporte (CT-e);
B Notas de entrada para beneficiamento;

A gerao automtica dos documentos de entrada no ser processada caso alguma das validaes da gerao do documento de
entrada no seja atendida, como por exemplo, quando no existe TE padro para os produtos ou condio de pagamento para o
documento. Neste caso o documento eletrnico importado via TOTVS Colaborao permanecer no Monitor TOTVS Colaborao
para gerao manual do documento. Como indicativo do no processamento, a legenda do documento no Monitor TOTVS
Colaborao estar como Documento c/ Ocorrncia e a ocorrncia poder ser visualizada no documento.

PROCEDIMENTOS PARA IMPLEMENTAO

Para viabilizar essa melhoria, necessrio aplicar o pacote de atualizaes (Patch) deste chamado.

Antes de executar o compatibilizador U_UPDCOM19 imprescindvel:

a)

Realizar o backup da base de dados do produto que ser executado o compatibilizador (diretrio PROTHEUS11_DATA\
DATA) e dos dicionrios de dados SXs (diretrio PROTHEUS11_DATA_SYSTEM).

b)

Os diretrios acima mencionados correspondem instalao padro do Protheus, portanto, devem ser alterados conforme
o produto instalado na empresa.

c)

Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usurio deve estar utilizando o sistema.

d)

Se os dicionrios de dados possurem ndices personalizados (criados pelo usurio), antes de executar o compatibilizador,
certifique-se de que esto identificados pelo nickname. Caso o compatibilizador necessite criar ndices, ir adicion-los a
partir da ordem original instalada pelo Protheus, o que poder sobrescrever ndices personalizados, caso no estejam
identificados pelo nickname.

e)

O compatibilizador deve ser executado com a Integridade Referencial desativada*.

O procedimento a seguir deve ser realizado por um profissional qualificado como Administrador de Banco de
Dados (DBA) ou equivalente!
A ativao indevida da Integridade Referencial pode alterar drasticamente o relacionamento entre tabelas no
banco de dados. Portanto, antes de utiliz-la, observe atentamente os procedimentos a seguir:
i. No Configurador (SIGACFG), veja se a empresa utiliza Integridade Referencial, selecionando a opo

SIGACOM TOTVS Colaborao: gerao automtica dos documentos

Boletim Tcnico

Integridade/Verificao (APCFG60A).
ii. Se no h Integridade Referencial ativa, so relacionadas em uma nova janela todas as empresas e filiais
cadastradas para o sistema e nenhuma delas estar selecionada. Neste caso, E SOMENTE NESTE, no
necessrio qualquer outro procedimento de ativao ou desativao de integridade, basta finalizar a
verificao e aplicar normalmente o compatibilizador, conforme instrues.
iii. Se h Integridade Referencial ativa em todas as empresas e filiais, exibida uma mensagem na janela
Verificao de relacionamento entre tabelas. Confirme a mensagem para que a verificao seja concluda,
ou;
iv. Se h Integridade Referencial ativa em uma ou mais empresas, que no na sua totalidade, so relacionadas
em uma nova janela todas as empresas e filiais cadastradas para o sistema e, somente, a(s) que possui(em)
integridade estar(ro) selecionada(s). Anote qual(is) empresa(s) e/ou filial(is) possui(em) a integridade
ativada e reserve esta anotao para posterior consulta na reativao (ou ainda, contate nosso Help Desk
Framework para informaes quanto a um arquivo que contm essa informao).
v. Nestes casos descritos nos itens iii ou iv, E SOMENTE NESTES CASOS, necessrio desativar tal integridade,
selecionando a opo Integridade/Desativar (APCFG60D).
vi. Quando desativada a Integridade Referencial, execute o compatibilizador, conforme instrues.
vii. Aplicado o compatibilizador, a Integridade Referencial deve ser reativada, SE E SOMENTE SE tiver sido
desativada, atravs da opo Integridade/Ativar (APCFG60). Para isso, tenha em mos as informaes da(s)
empresa(s) e/ou filial(is) que possua(m) ativao da integridade, selecione-a(s) novamente e confirme a
ativao.

Contate o Help Desk Framework EM CASO DE DVIDAS!

1.

Em Microsiga Protheus Smart Client, digite U_UPDCOM19 no campo Programa Inicial.

Para a correta atualizao do dicionrio de dados, certifique-se que a data do fonte compatibilizador
(UPDCOM19.prw) seja igual ou superior a 14/03/13.
2.

Clique em Ok para continuar.

3.

Ao confirmar exibida uma mensagem de advertncia sobre o backup e a necessidade de sua execuo em modo
exclusivo.

4.

Aps a confirmao exibida uma tela para a seleo da empresa em que o dicionrio de dados ser modificado.
Selecione a empresa desejada e confirme.

5.

apresentada a pergunta para confirmar a atualizao dos dicionrios. Clique em Sim para iniciar o processamento. O
primeiro passo da execuo a preparao dos arquivos, conforme mensagem explicativa apresentada na tela.

6.

Em seguida, exibida a janela Atualizao concluda com o histrico (log) de todas as atualizaes processadas. Nesse
log de atualizao so apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos
que ainda no existem no dicionrio de dados.

7.

Clique em Gravar para salvar o histrico (log) apresentado.

8.

Clique em Ok para encerrar o processamento.

SIGACOM TOTVS Colaborao: gerao automtica dos documentos

Boletim Tcnico

ATUAILZAES DO COMPATIBILIZADOR
1.

Criao de Parmetros no arquivo SX6 Parmetros:

Nome da Varivel

MV_COMCOL1

Tipo

Numrico

Descrio

Indica como ser processada a gerao automtica de documentos do

TOTVS Colaborao (0=No Gera; 1=A Classificar; 2=Classificado).

Valor Padro

Nome da Varivel

MV_COMCOL2

Tipo

Caractere

Descrio

Indica para quais documentos TOTVS Colab. ser processada a gerao

automtica (N=Compra; D=Devol.; C=Complemento; O=Bonificao;
T=CTe; B=Beneficia.).

Valor Padro

NDCOTB

PROCEDIMENTOS PARA UTILIZAO

Automatizao do processo de importao dos arquivos atravs da configurao do Schedule.
1.

No Configurador (SIGACFG) acesse Ambiente/Schedule/Schedule.

2.

Clique em Agent/Cadastro.

3.

Em Detalhes clique em Incluir.

4.

Informe um nome para o agente.

5.

No campo IP e Porta informe os mesmos dados do Microsiga Protheus.

O ambiente preenchido automaticamente.

6.

Informe o grupo de empresas.

7.

No campo Nmero de Threads, informe a opo 4.

8.

Confira dos dados e confirme.

9.

Clique em Agendamentos/Cadastro.

10. Em Detalhes clique em Incluir.

11. Informe o nome da rotina (SCHEDCOMCOL).

SIGACOM TOTVS Colaborao: gerao automtica dos documentos

Boletim Tcnico

12. Selecione a empresa/filial desejada e o mdulo correspondente.

13. Clique na opo Recorrncia e marque Sempre Ativo.
14. Clique em Confirmar para o agendamento.
15. Clique em Agent e clique em Iniciar Todos os Servios.
recomendvel reiniciar o Server.
Utilizao dos arquivos importados com o TOTVS Colaborao:
1.

Em Compras (SIGACOM) acesse Atualizaes/Miscelnea/TOTVS Colaborao (COMXCOL).

O Sistema apresenta a janela de parmetros.

2.

Informe os parmetros do filtro para visualizao das Notas j importadas.

3.

O Sistema apresenta a tela os documentos eletrnicos importados e gerados automaticamente pelo sistema.

INFORMAES TCNICAS
SA5 Produtos X Fornecedores
SDS - Cabealho importao XML NF-e
Tabelas Utilizadas

SDT - Itens importao XML NF-e

SF1 Cabealho das NF de entrada
SD1 - Itens das NF de entrada
SB1 Cadastro de Produtos
MATA140 Pr-Nota de Entrada

Funes Envolvidas

MATA103 Documento de Entrada

MATA140I Funes Genricas de Importao NF-e
COMXCOL Monitor do TOTVS Colaborao

Sistemas Operacionais

Windows/Linux

SIGACOM TOTVS Colaborao: gerao automtica dos documentos