Escolar Documentos
Profissional Documentos
Cultura Documentos
Chamado
TEZMZM
Data da publicao
13/07/12
Pas(es)
Brasil
Banco(s) de Dados
Todos
UPDCOM19,
conforme Procedimentos
Este boletim um complemento do boletim Importao NFe via Totvs Colaborao do chamado SDLCB0, para utilizao das novas
funcionalidades aqui descritas, o usurio dever realizar os procedimentos descritos no boletim referenciado.
A partir dessa funcionalidade e utilizao do servio TOTVS Colaborao, a empresa compradora de bens e/ou servios passar a receber
os arquivos eletrnicos de NF-e de diferentes tipos conforme listados abaixo. Em posse destes arquivos, ser possvel processar a
importao, permite a gerao de Documentos do tipo Pr-Nota ou Documento de Entrada (o segundo nos casos de bonificao e
complemento de preo) a partir dos dados contidos nos arquivos eletrnicos, reduzindo o trabalho de incluso e digitao de tais
documentos.
A nova verso da rotina de Importao NF-e via TOTVS Colaborao, dispe da importao de arquivos XML das seguintes espcies de
documentos:
Devoluo: A Devoluo de Vendas emitida toda vez que uma Nota Fiscal de Sada gerada e por algum motivo deve retornar
empresa. A identificao dos arquivos eletrnicos referente devoluo depende da configurao do parmetro MV_XMLCFDV
com os CFOPs de remessa (sada) aplicados ao processo de devoluo.
Complemento de preo: A nota de complemento de preo diferenciada da nota normal atravs do campo quantidade que
deve ser igual a zero. A identificao dos arquivos eletrnicos referente complemento de preo depende da configurao do
campo finNFE do arquivo xml, pois quando o contedo do campo finNFE do arquivo XML for 2-NF-e complementar, ser feito o
processamento de notas de complemento de preo.
Para que os documentos de beneficiamento e devoluo de venda sejam processados, deve-se realizar previamente o cadastro
da entidade Produtos X Clientes (SA7). Como estes documentos so remetidos por clientes, faz-se necesria a identificao do
cdigo utilizado pelo cliente para o(s) produto(s) remetidos atravs do campo Cod. Prod. Cli (A7_CODCLI). Foi disponibilizado
SIGACOM Importao NFe via Totvs Colaborao
Boletim Tcnico
tambm para esta rotina o campo UM p/ NFe (A7_UMNFE) unidade de medida para NF-e, caso a opo do campo esteja
selecionado como 2UM a rotina tomar como base o fator de converso da 1UM para 2UM conforme informado no cadastro
de produtos.
Alm da disponibilidade de importao do arquivo XML para o processamento de notas do tipo: Beneficiamento, Devoluo de Vendas e
Complemento de Preo, a rotina dispe ainda de novas funcionalidades como:
Mltipla seleo: Foi criada uma nova coluna com a opo de selecionar um ou mais documentos importados, para que
posteriormente sejam gerados os documentos de Pr-Nota ou Documento de Entrada. (O segundo nos casos de bonificao e
complemento de preo), se por acaso ocorrer algum erro no processo de gerao de documentos, a rotina ir gravar a
descrio do motivo de erro no campo Log de Ocorrncia (DS_DOCLOG) cujo os detalhes podem ser consultados durante a
visualizao do documento importado. O usurio por sua vez dever fazer a correo conforme a descrio de ocorrncia, em
seguida, dever gerar novamente o documento para que ele seja processado.
Vnculo a pedido de compra por documento.: Disponibilizada a opo de associao de pedido NFE por documento (alm da
opo por item). Caso a quantidade e ou preo unitrio do pedidio de compra sejam divergentes do item da NFe, o vinculo de
pedido de compra por documento no ocorrer;
Reprocessamento de arquivos excludos: Disponibilizada melhoria na opo de seleo dos arquivos XML para
reprocessamento, permitindo filtrar os arquivos XML a serem reprocessados por Documentos com Erros ou pela opo
Documentos Excludos;
Importao de dados complementares do documento fiscal: disponibilizada leitura e gravao dos demais dados dos
documentos importados que esto disponveis no documento XML. Abaixo segue a lista de dados importados:
o Valor da mercadoria;
o Valor do frete;
o Valor do seguro;
o Valor das despesas;
o Descontos da nota fiscal;
o Cdigo da transportadora;
o Placa do veculo;
o Peso lquido;
o Peso bruto;
o Espcie 1;
o Espcie 2;
o Espcie 3;
o Espcie 4;
o Volume 1;
o Volume 2;
o Volume 3;
o Volume 4;
o Tipo de frete;
O rateio dos valores de frete, seguro e despesas entre os itens do documento importado sero efetuados sempre pelo valor
total do item perante o valor total do documento, independentemente da configurao do parmetro MV_RATDESP. O rateio
por peso no est disponvel nesta funcionalidade pois o layout do arquivo XML no permite tal tratamento.
Boletim Tcnico
O sistema atualizado logo aps a aplicao do pacote de atualizaes (Patch) desta FNC.
Realizar o backup da base de dados do produto que ser executado o compatibilizador (diretrio
\PROTHEUS_DATA\DATA) e dos dicionrios de dados SXs (diretrio \PROTHEUS_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 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
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).
Boletim Tcnico
1.
Em Microsiga Protheus TOTVS Smart Client, digite U_UPDCOM19 no campo Programa Inicial.
Para a correta atualizao do dicionrio de dados, certifique-se que a data do compatibilizador seja igual ou superior a
29/07/11.
2.
3.
4.
5.
Clique em Sim para iniciar o processamento. O primeiro passo da execuo a preparao dos arquivos. apresentada
uma mensagem explicativa 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.
8.
ATUALIZAES DO COMPATIBILIZADOR
1. Criao no arquivo SX3 Campos:
DS_FRETE
Tipo
Tamanho
14
Decimal
Formato
@E 99,999,999,999.99
Ttulo
Vlr.Frete
Descrio
Valor do Frete
Boletim Tcnico
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Campo
DS_SEGURO
Tipo
Tamanho
14
Decimal
Formato
@E 99,999,999,999.99
Ttulo
Vlr.Seguro
Descrio
Valor do Seguro
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Campo
DS_DESPESA
Tipo
Tamanho
14
Decimal
Formato
@E 99,999,999,999.99
Ttulo
Vlr.Despesas
Descrio
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Boletim Tcnico
Campo
DS_DESCONT
Tipo
Tamanho
14
Decimal
Formato
@E 99,999,999,999.99
Ttulo
Descontos
Descrio
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Campo
DS_TRANSP
Tipo
Tamanho
Decimal
Formato
@!
Ttulo
Transp.
Descrio
Cdigo da transportadora
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Campo
DS_PLACA
Tipo
Tamanho
Decimal
Formato
@!
Ttulo
Placa
Descrio
Placa Veiculo
Boletim Tcnico
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Placa do Veculo
Campo
DS_PLIQUI
Tipo
Tamanho
11
Decimal
Formato
@E 999,999.9999
Ttulo
Peso Liquido
Descrio
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Campo
DS_PBRUTO
Tipo
Tamanho
11
Decimal
Formato
@E 999,999.9999
Ttulo
Peso Bruto
Descrio
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Campo
DS_ESPECI1
Boletim Tcnico
Tipo
Tamanho
10
Decimal
Formato
@!
Ttulo
Especie 1
Descrio
Especie 1
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Campo
DS_ESPECI2
Tipo
Tamanho
10
Decimal
Formato
@!
Ttulo
Especie 2
Descrio
Especie 2
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Campo
DS_ESPECI3
Tipo
Tamanho
10
Decimal
Formato
@!
Ttulo
Especie 3
Descrio
Especie 3
Nvel
Boletim Tcnico
Usado
Sim
Obrigatrio
No
Browse
No
Help
Campo
DS_ESPECI4
Tipo
Tamanho
10
Decimal
Formato
@!
Ttulo
Especie 4
Descrio
Especie 4
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Campo
DS_VOLUME1
Tipo
Tamanho
Decimal
Formato
@E 999999
Ttulo
Volume 1
Descrio
Volume 1
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Campo
DS_VOLUME2
Boletim Tcnico
10
Tipo
Tamanho
Decimal
Formato
@E 999999
Ttulo
Volume 2
Descrio
Volume 2
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Campo
DS_VOLUME3
Tipo
Tamanho
Decimal
Formato
@E 999999
Ttulo
Volume 3
Descrio
Volume 3
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Campo
DS_VOLUME4
Tipo
Tamanho
Decimal
Formato
@E 999999
Ttulo
Volume 4
Descrio
Volume 4
Nvel
Boletim Tcnico
Usado
Sim
Obrigatrio
No
Browse
No
Help
Campo
DS_TPFRETE
Tipo
Tamanho
Decimal
Formato
@!
Ttulo
Tipo de fret
Descrio
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Campo
DS_VALMERC
Tipo
Tamanho
14
Decimal
Formato
@E 99,999,999,999.99
Ttulo
Vlr. Mercad.
Descrio
Valor da Mercadoria
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Campo
DS_DOCLOG
11
Boletim Tcnico
12
Tipo
Tamanho
80
Decimal
Formato
@!
Ttulo
Log
Descrio
Log da Ocorrncia
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
DT_NFORI
Tipo
Tamanho
Decimal
Formato
@!
Ttulo
Docto. Orig.
Descrio
Documento Original
Nvel
Usado
Sim
Obrigatrio
No
Val. Sistema
IIf(M->DS_TIPO="D",(NaoVazio().And.A140IValNF()),.T.) .And.
MaFisRef("IT_NFORI","MT100",M->DT_NFORI)
Browse
Sim
Grp. Campos
018
Help
Campo
DT_SERIORI
Tipo
Tamanho
Decimal
Formato
@!
Boletim Tcnico
Ttulo
Serie Orig.
Descrio
Nvel
Usado
Sim
Obrigatrio
No
Val. Sistema
IIF(M>DS_TIPO=="D",A140IValNF(),.T.).And.MaFisRef("IT_SERORI","MT100",
M->DT_SERIORI)
Browse
Sim
Help
Campo
DT_ITEMORI
Tipo
Tamanho
Decimal
Formato
@!
Ttulo
It.Doc Orig.
Descrio
Nvel
Usado
Sim
Obrigatrio
No
Browse
Sim
Help
Campo
DT_VALFRE
Tipo
Tamanho
14
Decimal
Formato
@E 99,999,999,999.99
Ttulo
Vlr.Frete
Descrio
Valor do frete
Nvel
Usado
Sim
Obrigatrio
No
13
Boletim Tcnico
14
Browse
No
Help
Valor do frete.
Campo
DT_SEGURO
Tipo
Tamanho
14
Decimal
Formato
@E 99,999,999,999.99
Ttulo
Vlr.Seguro
Descrio
Vlr.Seguro
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Valor do seguro.
Campo
DT_DESPESA
Tipo
Tamanho
14
Decimal
Formato
@E 99,999,999,999.99
Ttulo
Vlr.Despesas
Descrio
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Campo
DT_VALDESC
Tipo
Tamanho
14
Boletim Tcnico
Decimal
Formato
@E 99,999,999,999.99
Ttulo
Desconto
Descrio
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
A5_TESCP
Tipo
Tamanho
Decimal
Formato
@!
Ttulo
TE p/ Compl.
Descrio
Nvel
Usado
Sim
Obrigatrio
No
Browse
Sim
Val. Sistema
MaAvalTes("E",M->A5_TESBP)
Cons. Padro
SF4
Help
A7_TESCP
Tipo
Tamanho
Decimal
Formato
@!
Ttulo
UM p/ NFe
Descrio
Nvel
1
SIGACOM Importao NFe via Totvs Colaborao
15
Boletim Tcnico
Usado
Sim
Obrigatrio
No
Browse
Sim
Val. Sistema
Pertence(12)
Prioridade
1 UM
Lista Opes
1=1 UM;2=2 UM
Help
DS_FORNEC
Ttulo
Forn/Cliente
Descrio
Cdigo do Forn/Cliente
Inic. Padro
Vazio
Cons. Padro
Vazio
DS_LOJA
Descrio
Loja do Forn/Cliente
DS_ NOMEFOR
Descrio
Nome do Fornecedor/Cliente
When
Vazio
DS_ CNPJ
Ttulo
CNPJ For/Cli
Descrio
CNPJ Fornecedor/Cliente
DS_ TIPO
Val. Sistema
Pertence(NODBC)
Lista Opes
16
N=Normal;O=Bonificao;D=Devoluo;B=Beneficiamento;
C=Compl. Preo
Boletim Tcnico
Usado
Sim
Browse
Sim
Visual
Visualizar
Contexto
Real
DT_FILIAL
Grupo de Campo
033
DT_COD
Grupo de Campo
030
DT_PRODFOR
Ttulo
Prd. For/Cli
Descrio
DT_DESCFOR
Ttulo
Desc For/Cli
Descrio
DT_CNPJ
Ttulo
CNPJ For/Cli
Descrio
CNPJ For/Cli
Chave
052
Descrio
Aviso de inconsistncias NF-e [TOTVS Colaborao]
17
Boletim Tcnico
Nome da Varivel
MV_XMLCFBN (X6_VAR)
Tipo
Caracter (X6_TIPO)
Descrio
Valor Padro
Nome da Varivel
MV_XMLCFDV (X6_VAR)
Tipo
Caracter (X6_TIPO)
Descrio
Valor Padro
2.
3.
4.
Visualizar:
1.
Vinc. Docto.:
1. Selecione o documento desejado para vincular o pedido de compra ou a nota fiscal de origem e clique em Vinc. Docto.
O Sistema apresenta a tela com cabealho e itens da NF-e importada.
2.
Para fazer o vnculo do pedido de compra, clique na opo Ped. Item no canto superior da tela, nos casos de vincular o item do
pedido de compra, caso contrrio, clique na opo Ped. Doc para fazer o vnculo do documento completo do pedido de
compra.
3.
Para fazer o vnculo da nota de origem, clique na opo N.F. Original no canto superior da tela, para vincular a nota de origem
nos casos de devoluo de vendas e complemento de preo.
4.
Escolha qual o pedido de compra ou documento de origem que deseja vincular e clique na opo Ok. Ao confirmar, o pedido ou
documento de origem estar vinculado nota selecionada anteriormente.
Gerar Pr-Nota:
18
Boletim Tcnico
1.
Para gerar a Pr-nota de entrada ou Documento de Entrada nos casos de bonificao ou complemento de preo, selecione o(s)
documento(s) desejado(s) e clique na opo Gerar Docto.
O sistema apresenta a pergunta: Confirma a gerao de Pr-Nota ou Documento de Entrada para os documentos selecionados?
2.
Para confirmar, clique em SIM e aguarde a mensagem de confirmao Pr-Nota ou Documento de Entrada gerado com
sucesso.
Legenda:
1.
Remessa:
1.
Para fazer a remessa do arquivo NF-e para o TSS, clique na opo Remessa, aps acionada a opo ser apresentada a tela para
localizar o arquivo desejado no diretrio especifico, selecione o arquivo e clique na opo Abrir.
2.
Aps acionar a opo Abrir, aguarde a mensagem de confirmao Remessa foi realizada com sucesso. Aguarde o retorno do
arquivo validado via TOTVS Colaborao.
Ao executar esta opo, verifique se a ferramenta de Schedule padro do sistema est configurado para o agendamento de
execuo da rotina MATA140I.
Excluir:
1.
2.
Esta opo executada somente para os documentos com status de Apto a gerar pr-nota ou Apto a gerar Doc. Entrada
(Bonificao ou Complemento de Preo), para os documentos que j foram gerados no ser permitida a excluso.
Reprocessar:
1.
19
Boletim Tcnico
2.
A opo Marca / Desmarca, ir reprocessar apenas os arquivos relacionados ao filtro Documentos com Erros ou
Documentos Excludos.
3.
Para reprocessar os arquivos que j foram importados, mas por algum motivo foram excludos, selecione a opo Documentos
Excludos, marque o arquivo que deseja reprocessar, caso queira marcar todos, clique na opo Marca/Desmarca.
4.
Para confirmar o reprocessamento, clique na opo OK no canto inferior do lado direito da tela.
5.
Aps confirmao, o sistema mover o(s) arquivo(s) com formato XML do diretrio Err ou do diretrio Old, caso a opo
selecionada seja Documentos Excludos para o diretrio New, e a partir deste instante os arquivos sero executado(s) de forma
automtica pela rotina MATA140I, conforme configurado no Schedule.
INFORMAES TCNICAS
SA7 - Produtos x Clientes;
SA5 - Produtos x Fornecedores;
SDS - Cabealho importao XML NF-e;
Tabelas Utilizadas
Rotinas Envolvidas
Sistemas Operacionais
20
Windows/Linux