Boletim Tcnico

Importao de Arquivos XML pelo Totvs Colaborao

Produto : Microsiga Protheus Compras verso 11

Chamado : TFUAJL Data da publicao : 15/10/12

Pas(es) : Brasil Banco(s) de Dados : Todos

Esta melhoria depende de execuo do update de base UPDCOM19, conforme Procedimentos

para Implementao.
(Este boletim substitui o boletim anterior referente ao chamado TEQYOH).

Com o objetivo de tornar mais simples e gil a incluso dos documentos fiscais de entrada, implementou-se na rotina
Pr-nota Entrada (MATA140) a funcionalidade que permite importar os arquivos de nota fiscal eletrnica (formato XML), por
meio da utilizao da soluo TOTVS Colaborao. Aps atualizao do Sistema e contratao do servio TOTVS Colaborao, a
rotina de importao disponibilizada na rotina Pr-nota Entrada (MATA140) atravs da opo Entrada NF-e.
A partir desta funcionalidade e utilizao do servio TOTVS Colaborao, a empresa passa a receber os arquivos
eletrnicos de NF-e referentes s compras de produtos (notas fiscais normais) e bonificaes realizadas com seus fornecedores
(para notas fiscais de Beneficiamento, Devoluo e Complemento de Preo, consultar o boletim complementar disponvel em
http://tdn.totvs.com/pages/viewpage.action?pageId=29426751). De posse destes arquivos, ser possvel processar a
importao, permitindo assim a gerao de documentos, Pr-nota ou Documento de Entrada (o segundo nos casos de
bonificao) a partir dos dados contidos nos arquivos eletrnicos, reduzindo o trabalho de incluso e digitao de tais
documentos. Os documentos importados e disponveis para gerao de Pr-nota ou Documento de entrada ficam dispostos em
rotina especfica, identificada pela opo Entrada NF-e, em que, aps configurao de filtro, sero listados os documentos
correspondentes para que sejam analisados/processados por uma das seguintes aes:

Visualizar: Exibe os detalhes do arquivo eletrnico.

Vinc. Docto: Exibe tela para realizao de vnculo entre os itens do documento eletrnico e os itens de pedido pendentes.

Gerar Docto: Gera o documento (Pr-Nota ou Documento de Entrada nos casos de bonificao) correspondente ao arquivo
eletrnico.

Legenda: Visualiza as legendas da rotina.

Filtrar: Filtra os registros exibidos em tela.

Remessa: Opo utilizada para enviar um arquivo XML via TSS para validao pela NeoGrid, para que o mesmo faa parte
do processo TOTVS Colaborao.

Excluir: Exclui um documento previamente importado, desde que ainda no tenha sido gerada pr-nota ou documento de
entrada para o mesmo.

Reprocessar: Disponibiliza o arquivo XML novamente para importao no diretrio XMLNFE/NEW.

Sair: Abandona a rotina.

1
SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao
 Boletim Tcnico

A identificao dos arquivos eletrnicos referentes bonificao, depende da configurao do parmetro MV_XMLCFPC com os
CFOPs de venda usados no processo de bonificao. A gerao do documento de entrada dos arquivos identificados como
bonificao, depende da configurao do campo TE p/ Bonif (A5_TESBP), com uma TES adequada ao processo.
A automatizao do processo de importao dos arquivos deve ser configurada por meio da ferramenta de Schedule padro do
Sistema pelo agendamento de execuo da rotina Funes Genricas de Importao NF-e (MATA140I) (ver procedimentos para
utilizao).
Antes da utilizao da funcionalidade implementada nesta FNC, necessrio revisar o cadastro de Produtos X Fornecedores,
pois a identificao dos produtos contidos no arquivo eletrnico realizada por meio do cdigo do fornecedor, identificado no
campo Cod. Prod. For (A5_CODPRF).

Aps aplicar o patch referente a este chamado, recomendvel entrar em contato com seu executivo de contas para que
seja apresentado o projeto TOTVS Colaborao.

Para que os arquivos XML estejam aptos para importao, necessrio possuir a licena junto a TOTVS X Neogrid, bem
como a instalao/configurao do TSS (TOTVS Service Sped) com o Certificado Digital vlido.

Em conjunto com o compatibilizador contido neste chamado, necessrio tambm aplicar o compatibilizador NFEP11R1,
em especfico os Ids. NFE11R102 e NFE11R105, que implementam os parmetros necessrios ao funcionamento do TOTVS
Colaborao.

Para mais informaes sobre os parmetros criados por este compatibilizador, consulte o boletim tcnico TOTVS
Colaborao - Envio de NF-e e NFS-e, disponvel no TDN: http://tdn.totvs.com/pages/viewpage.action?pageId=4810783.

O parmetro MV_SPEDURL deve ser configurado com o servidor TSS utilizado.

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*.

2 SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao

 Boletim Tcnico

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).
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 compatibilizador seja igual ou
superior a 28/04/11.
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.

3
SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao
 Boletim Tcnico

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.

ATUAILZAES DO COMPATIBILIZADOR

1. Criao de Perguntas no arquivo SX1 Cadastro de Perguntes:

Pergunte Da Nota Fiscal ?

Nome MV_PAR01

Grupo MTA140I

Ordem 01

Tipo C

Tamanho 9

Pergunte At a Nota Fiscal?

Nome MV_PAR02

Grupo MTA140I

Ordem 02

Tipo C

Tamanho 9

Pergunte Da Srie ?

Nome MV_PAR03

Grupo MTA140I

Ordem 04

Tipo C

Tamanho 3

Pergunte At Srie ?

Nome MV_PAR04

Grupo MTA140I

Ordem 04

Tipo C

4 SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao

 Boletim Tcnico

Tamanho 3

Pergunte Fornecedor De ?

Nome MV_PAR05

Grupo MTA140I

Ordem 05

Tipo C

Tamanho 6

Pergunte Fornecedor At ?

Nome MV_PAR06

Grupo MTA140I

Ordem 06

Tipo C

Tamanho 6

Pergunte Dt Emisso Inicial?

Nome MV_PAR07

Grupo MTA140I

Ordem 07

Tipo D

Tamanho 8

Pergunte Dt Emisso Final?

Nome MV_PAR08

Grupo MTA140I

Ordem 08

Tipo D

Tamanho 8

Pergunte Dt Importao Inicial?

Nome MV_PAR09

Grupo MTA140I

Ordem 09

Tipo D

5
SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao
 Boletim Tcnico

Tamanho 8

Pergunte Dt Importao Final?

Nome MV_PAR10

Grupo MTA140I

Ordem 10

Tipo D

Tamanho 8

Pergunte Mostra Gerados?

Nome MV_PAR11

Grupo MTA140I

Ordem 11

Tipo N

Tamanho 1

2. Criao de Campos no arquivo SX3 Campos:

Tabela SDS - Cabealho importao XML NF-e:

Campo DS_FILIAL

Tipo C

Tamanho 2

Decimal 0

Formato @!

Ttulo Filial

Descrio Filial do Sistema

Nvel 1

Usado No

Obrigatrio No

Browse No

Help Filial do Sistema

Campo DS_DOC

Tipo C

Tamanho 9

Decimal 0

6 SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao

 Boletim Tcnico

Formato @!

Ttulo Nmero

Descrio Nmero do documento

Nvel 1

Usado Sim

Obrigatrio Sim

Browse Sim

Help Nmero do documento

Campo DS_SERIE

Tipo C

Tamanho 3

Decimal 0

Formato @!

Ttulo Srie

Descrio Srie do documento

Nvel 1

Usado Sim

Obrigatrio No

Browse Sim

Help Srie do documento

Campo DS_FORNEC

Tipo C

Tamanho 6

Decimal 0

Formato @!

Ttulo Fornecedor

Descrio Cdigo do fornecedor

Nvel 1

Usado Sim

Obrigatrio Sim

Browse Sim

Help Cdigo identificador do fornecedor ou cliente.

7
SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao
 Boletim Tcnico

Campo DS_LOJA

Tipo C

Tamanho 2

Decimal 0

Formato @!

Ttulo Loja

Descrio Loja do Fornecedor

Nvel 1

Usado Sim

Obrigatrio Sim

Browse Sim

Help Loja do Fornecedor/Cliente.

Campo DS_NOMEFOR

Tipo C

Tamanho 40

Decimal 0

Formato @!

Ttulo Nome

Descrio Nome do Fornecedor

Nvel 1

Usado Sim

Obrigatrio No

Browse Sim

When .F.

IF(FINDFUNCTION("NOMEFORINI"),NOMEFORINI(),A140IBUSFC(SDS-
Relao
>DS_TIPO))

Help Nome do fornecedor/cliente.

Campo DS_CNPJ

Tipo C

Tamanho 14

Decimal 0

Formato @!

Formato varivel A140IPict()

8 SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao

 Boletim Tcnico

Ttulo CNPJ Fornece

Descrio CNPJ Fornecedor

Nvel 1

Usado Sim

Obrigatrio No

Browse Sim

Help CNPJ do Fornecedor/Cliente.

Campo DS_TIPO

Tipo C

Tamanho 1

Decimal 0

Formato @!

Ttulo Tipo da Nota

Descrio Tipo da Nota

Nvel 1

Usado Sim

Obrigatrio Sim

Browse Sim

Help Tipo da Nota

Campo DS_ESPECI

Tipo C

Tamanho 5

Decimal 0

Formato @!

Ttulo Espec.Docum.

Descrio Espcie do Documento

Nvel 1

Usado No

Obrigatrio No

Browse No

Cons. Padro 42

Help Espcie do Documento

9
SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao
 Boletim Tcnico

Campo DS_EMISSA

Tipo D

Tamanho 8

Decimal 0

Ttulo DT Emisso

Descrio Data de Emisso da NF

Nvel 1

Usado Sim

Obrigatrio Sim

Browse Sim

Relao Ddatabase

Help Data de Emisso da NF

Campo DS_FORMUL

Tipo C

Tamanho 1

Decimal 0

Formato @!

Ttulo Form. Prop.

Descrio Formulrio Prprio

Nvel 1

Usado No

Obrigatrio No

Browse No

Help Formulrio prprio

Campo DS_EST

Tipo C

Tamanho 2

Decimal 0

Formato @!

Ttulo Estado

Descrio Estado de emisso da NF

Nvel 1

Usado No

10 SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao

 Boletim Tcnico

Obrigatrio No

Browse No

Help Estado de emisso da NF.

Campo DS_STATUS

Tipo C

Tamanho 1

Decimal 0

Formato @!

Ttulo Status

Descrio Status do Registro

Nvel 1

Usado No

Obrigatrio No

Browse No

Help Status do Registro

Campo DS_ARQUIVO

Tipo C

Tamanho 80

Decimal 0

Formato @!

Ttulo Arquivo

Descrio Nome do Arquivo XML

Nvel 1

Usado No

Obrigatrio No

Browse No

Help Nome do Arquivo XML

Campo DS_USERIMP

Tipo C

Tamanho 25

Decimal 0

Formato @!

11
SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao
 Boletim Tcnico

Ttulo Usurio

Descrio Usurio na importao

Nvel 1

Usado No

Obrigatrio No

Browse No

Help Usurio responsvel pela importao da Nota Fiscal Eletrnica

Campo DS_DATAIMP

Tipo D

Tamanho 8

Decimal 0

Formato @!

Ttulo Data Import.

Descrio Data importao do XML

Nvel 1

Usado No

Obrigatrio No

Browse No

Help Data importao do XML.

Campo DS_HORAIMP

Tipo C

Tamanho 5

Decimal 0

Formato 99:99

Ttulo Hora Import.

Descrio Hora importao XML

Nvel 1

Usado No

Obrigatrio No

Browse No

Help Hora importao do XML.

Campo DS_USERPRE

12 SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao

 Boletim Tcnico

Tipo C

Tamanho 25

Decimal 0

Formato @!

Ttulo Usurio

Descrio Usurio res. Ger. Pre-NF

Nvel 1

Usado No

Obrigatrio No

Browse No

Help Usurio responsvel pela gerao da pr-nota.

Campo DS_DATAPRE

Tipo D

Tamanho 8

Decimal 0

Ttulo Data Pr-NF

Descrio Data de gerao de Pr-NF

Nvel 1

Usado No

Obrigatrio No

Browse No

Help Data de gerao da Pr-Nota de Entrada

Campo DS_HORAPRE

Tipo C

Tamanho 5

Decimal 0

Formato 99:99

Ttulo Hora Pr NF

Descrio Hora de gerao da Pre-NF

Nvel 1

Usado No

Obrigatrio No

Browse No

13
SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao
 Boletim Tcnico

Help Hora de gerao da Pr-Nota de Entrada

Campo DS_CHAVENF

Tipo C

Tamanho 44

Decimal 0

Formato @!

Ttulo Chave Acess.

Descrio Chave de Acesso da NF

Nvel 1

Usado No

Obrigatrio No

Browse No

Help Chave de acesso da Nota Fiscal Eletrnica

Campo DS_VERSO

Tipo C

Tamanho 5

Decimal 0

Formato @!

Ttulo Verso da Nf

Descrio Verso Layout da NFe

Nvel 1

Usado No

Obrigatrio No

Browse No

Help Verso Layout da NFe

Campo DS_CFESP

Tipo N

Tamanho 1

Decimal 0

Formato @9

Ttulo CFOP Espec.

Descrio CFOP Especial (s/ PC)

14 SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao

 Boletim Tcnico

Nvel 1

Usado No

Obrigatrio No

Browse No

Opes 1=Sim;2=Nao

Help Documento com CFOP especial sem vinculo ao PC

Tabela SDT Itens Importao Xml Nf-e:

Campo DT_FILIAL

Tipo C

Tamanho 2

Decimal 0

Formato @!

Ttulo Filial

Descrio Filial do Sistema

Nvel 1

Usado No

Obrigatrio No

Browse No

Help Filial do Sistema

Campo DT_ITEM

Tipo C

Tamanho 4

Decimal 0

Formato @!

Ttulo Item NF

Descrio Item da Nota Fiscal

Nvel 1

Usado Sim

Obrigatrio No

Browse No

Help Item da Nota Fiscal

15
SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao
 Boletim Tcnico

Campo DT_COD

Tipo C

Tamanho 15

Decimal 0

Formato @!

Ttulo Produto

Descrio Cdigo do Produto

Nvel 1

Usado Sim

Obrigatrio Sim

Browse No

Cons. Padro SB1

Help Cdigo do produto

Campo DT_DESC

Tipo C

Tamanho 30

Decimal 0

Formato @!

Ttulo Desc. Prod.

Descrio Descrio do Produto

Nvel 0

Usado Sim

Obrigatrio No

Browse No

When .F.

Relao POSICIONE("SB1",1,(XFILIAL("SDT")+SDT->DT_COD),"B1_DESC")

Help Descrio do Produto

Campo DT_PRODFOR

Tipo C

Tamanho 15

Decimal 0

Formato @!

Ttulo Prod. Fornec

16 SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao

 Boletim Tcnico

Descrio Cod. Prod. do Fornecedor

Nvel 0

Usado Sim

Obrigatrio No

Browse No

Help Cdigo do produto do fornecedor

Campo DT_DESCFOR

Tipo C

Tamanho 30

Decimal 0

Formato @!

Ttulo Desc. Fornec

Descrio Desc. Produto Fornecedor

Nvel 0

Usado Sim

Obrigatrio No

Browse Sim

Help Descrio do Produto do Fornecedor

Campo DT_FORNEC

Tipo C

Tamanho 6

Decimal 0

Formato @!

Ttulo Forn/Cliente

Descrio Cdigo do Forn/Cliente

Nvel 0

Usado No

Obrigatrio No

Browse No

Help Cdigo do Fornecedor/Cliente

Campo DT_LOJA

Tipo C

17
SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao
 Boletim Tcnico

Tamanho 2

Decimal 0

Formato @!

Ttulo Loja

Descrio Loja do Forn/Cliente

Nvel 1

Usado No

Obrigatrio No

Browse No

Help Loja do Fornecedor/Cliente.

Campo DT_DOC

Tipo C

Tamanho 9

Decimal 0

Formato @!

Ttulo Documento

Descrio Nmero do Documento/Nota

Nvel 1

Usado No

Obrigatrio No

Browse No

Help Nmero do Documento/Nota

Campo DT_SERIE

Tipo C

Tamanho 3

Decimal 0

Formato @!

Ttulo Srie

Descrio Srie da Nota Fiscal

Nvel 1

Usado No

Obrigatrio No

Browse No

18 SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao

 Boletim Tcnico

Help Srie da Nota Fiscal

Campo DT_CNPJ

Tipo C

Tamanho 14

Decimal 0

Ttulo CNPJ For/Cli

Descrio CNPJ For/Cli

Nvel 0

Usado No

Obrigatrio No

Browse No

Help CNPJ do Fornecedor/Cliente.

Campo DT_QUANT

Tipo N

Tamanho 11

Decimal 2

Formato @E 99999999.99

Ttulo Quantidade

Descrio Quantidade do Produto

Nvel 1

Usado Sim

Obrigatrio No

Browse Sim

Help Quantidade do Produto

Campo DT_VUNIT

Tipo N

Tamanho 14

Decimal 2

Formato @E 99,999,999,999.99

Ttulo Vlr.Unitrio

Descrio Valor Unitrio

Nvel 1

19
SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao
 Boletim Tcnico

Usado Sim

Obrigatrio Sim

Browse Sim

Help Valor unitrio do Item

Campo DT_TOTAL

Tipo N

Tamanho 14

Decimal 2

Formato @E 99,999,999,999.99

Ttulo Vlr.Total

Descrio Valor Total

Nvel 1

Usado Sim

Obrigatrio Sim

Browse Sim

Val. Sistema Positivo()

Help Valor Total.

Campo DT_PEDIDO

Tipo C

Tamanho 6

Decimal 0

Formato @!

Ttulo Num. Pedido

Descrio Nmero do Pedido Compra

Nvel 1

Usado Sim

Obrigatrio No

Browse No

Help Nmero do pedido de compra.

Campo DT_ITEMPC

Tipo C

Tamanho 4

20 SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao

 Boletim Tcnico

Decimal 0

Formato @!

Ttulo Item PC

Descrio Item Pedido de Compra

Nvel 1

Usado Sim

Obrigatrio No

Browse No

Help Item do pedido de compra.

Tabela SA5 Amarrao Produto x Fornecedor

Campo A5_TESBP

Tipo C

Tamanho 3

Decimal 0

Formato @!

Ttulo TE p/ Bonif.

Descrio Tp.Entr. para Bonificao

Nvel 1

Usado Sim

Obrigatrio No

Browse Sim

Cons. Padro SF4

Val. Sistema MaAvalTes("E",M->A5_TESBP) .And. MT060VlNFe()

Help Tp.Entr. para Bonificao.

Campo A5_UMNFE

Tipo C

Tamanho 1

Decimal 0

Formato @!

Ttulo UM p/ NFe

Descrio Unidade de Medida p/ NFe

Nvel 1

Usado Sim

21
SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao
 Boletim Tcnico

Obrigatrio No

Browse Sim

Opes 1=1 UM;2=2 UM

Val. Sistema Pertence("12")

Relao 1

Help Unidade de Medida para NFe.

O tamanho dos campos que possuem grupo podem variar conforme ambiente em uso.
3. Criao de tabela no arquivo SX2 Tabelas:

Chave Nome Modo PYME

Cabealho E
SDS importao XML NF- S
e

Itens importao E
SDT S
XML NF-e

4. Criao de ndices no arquivo SIX ndices:

ndice SDS

Ordem 1

Chave DS_FILIAL+DS_DOC+DS_SERIE+DS_FORNEC+DS_LOJA

Descrio Nmero+Srie+Fornecedor+Loja

Proprietrio S

ndice SDS

Ordem 2

Chave DS_FILIAL+DS_CHAVENF

Descrio Chave Acess.

Proprietrio S

ndice SDT

Ordem 1

Chave DT_FILIAL+DT_CNPJ+DT_FORNEC+DT_LOJA+DT_DOC+DT_SERIE

Descrio CNPJ Fornece+Forn/Cliente+Loja+Documento+Serie

Proprietrio S

22 SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao

 Boletim Tcnico

ndice SDT

Ordem 2

Chave DT_FILIAL+DT_FORNEC+DT_LOJA+DT_DOC+DT_SERIE+DT_PRODFOR

Descrio Fornecedor+Loja+Documento+Srie+Prod. Fornec

Proprietrio S

ndice SDT

Ordem 3

Chave DT_FILIAL+DT_FORNEC+DT_LOJA+DT_DOC+DT_SERIE+DT_COD

Descrio Fornecedor+Loja+Documento+Srie+Prod.

Proprietrio S

ndice SDT

Ordem 4

Chave DT_FILIAL+DT_PEDIDO+DT_ITEMPC

Descrio Nmero PC+Item

Proprietrio S

5. Criao de Parmetros no arquivo SX6 Parmetros:

Nome da Varivel MV_XMLCFPC

Tipo Caracter

Identifica os CFOPs de venda que sero tratados como bonificao na

Descrio
importao dos XML de NFe.

Valor Padro EX: 6102*6103*5102*2910

PROCEDIMENTOS PARA UTILIZAO

Automatizao do processo de importao dos arquivos atravs de configurao do Schedule:

Para que a importao das NF-e (XML) ocorra de forma automtica pelo TOTVS Colaborao necessrio configurar o Schedule para
a rotina MATA140I.
Segue abaixo sugesto para configurao do Schedule:

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

2. Clique em Agent/Cadastro.

3. Em Detalhes clique em Incluir.

4. Informe um nome para o agente.

23
SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao
 Boletim Tcnico

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 4.

8. Confira dos dados e confirme.

9. Clique em Agendamentos/Cadastro.

10. Em Detalhes clique em Incluir.

11. Informe o nome da rotina (MATA140I()).

12. Selecione a empresa(s)/filial(ais) desejada(s) e o mdulo correspondente.

13. Clique na opo Recorrncia.

Selecione o padro de recorrncia Dirio a cada 1 dia.
No intervalo de recorrncia selecione 96 execues por dia com intervalo de 15 minutos sem data de trmino e confirme.

14. Clique em Confirmar para gravar o agendamento.

15. Clique em Agent e clique em Iniciar Todos os Servios.

16. Reinicie o Server.

Criao dos diretrios no Rootpath do Protheus:

XMLNFE\NEW\ -> Caminho onde sero localizados os arquivos para serem importados.

XMLNFE\OLD\ -> Caminho para onde sero enviados os XMLs Lidos pela rotina.

XMLNFE\ERR\ -> Caminho para onde sero enviados os XMLs com no conformidades encontradas pela rotina.

Caso a rotina no encontre os diretrios no momento da importao, eles sero criados automaticamente.

Configurao dos eventos do M-Messenger:

Disponibilizados dois novos eventos para recebimento de mensagens sobre o resultado da importao dos arquivos XML:
Estes eventos devem ser configurados atravs do M-Messenger:
052 Aviso de inconsistncias NF-e [TOTVS Colaborao]

053 NF-e disponveis [TOTVS Colaborao]

24 SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao

 Boletim Tcnico

Utilizao dos arquivos importados com o TOTVS Colaborao:

1. Em Compras (SIGACOM) acesse Atualizaes/Movimentos/Pr-nota de entrada (MATA140).

O Sistema apresenta a janela de Pr-Notas de Entrada cadastradas.

2. Clique em Aes Relacionadas/Entrada NF-e.

3. Informe os parmetros para filtro das Notas j importadas.

O Sistema apresenta a tela com os XML carregados contendo as seguintes opes:

1 Visualizar

2 Vinc. Docto

3 Gerar Docto

4 Legenda

5 Filtrar

6 Remessa

7 Excluir

8 Reprocessar

9 Sair

Visualizar Nota:
1. Selecione no grid a nota desejada e clique em Visualizar.

O Sistema apresenta os dados do cabealho da Nota, Itens da Nota e Rodap com informaes da Nota Fiscal Eletrnica.

Vincular Pedido de Compra:

1. Selecione a nota fiscal e clique em Vinc. Docto.

O Sistema apresenta a tela com os itens da nota.

2. Escolha o item que deseja selecionar o(s) pedido(s) e clique em Aes Relacionadas/Pedidos.

O Sistema pesquisa os pedidos de compra que se identifiquem com o item da nota fiscal. Caso no identifique nenhum
pedido de compra correspondente, o Sistema exibe um aviso informando que no foi identificado nenhum pedido de
compra para o item da nota fiscal.

3. Caso encontre um ou mais pedidos, exibida a tela para seleo de itens por pedido de compra.

4. D um duplo clique para selecionar o item do pedido.

Nesta tela possvel visualizar o pedido de compra.

5. Selecione o pedido desejado e clique em Visualizar Pedido.

25
SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao
 Boletim Tcnico

exibida a visualizao padro de pedido de compra.

6. Para finalizar a seleo do item do pedido de compra, marque o item do pedido e clique em OK.

O parmetro MV_PCNFE define se obrigatria a amarrao de pedidos de compra Nota fiscal. Caso seja configurado com SIM, na
gerao da pr-nota verificado se existe algum item sem pedido de compra.

Gerar Pr-Nota:
1. Selecione o registro e clique em Gerar Docto.

O Sistema apresenta itens e informaes da nota.

2. Aguarde o trmino do processo da criao de pr-nota de entrada.

Observe que s sero permitidas as opes Vinc. Docto e Gerar Docto para os registros que tenham o status Apto. a gerar Pr-
Nota. Caso contrrio, as opes desta rotina esto bloqueadas.

Legenda:
Exibe tela de legenda com a correspondncia das cores dos faris:
Verde: Corresponde a documento liberado para pr-nota.
Azul: Correspondem a documentos de bonificao liberado para gerao do documento de entrada.
Vermelho: Corresponde a Nota fiscal processada, j gerou pr-nota ou documento de bonificao.

Importao de XML NF-e de forma manual:

1. Clique na opo Remessa.

2. Informe o caminho para leitura do arquivo XML e confirme

efetuada a comunicao com o TSS e, em seguida, com a NeoGrid para validao da Nota Fiscal eletrnica. Aps a
validao, a nota importada para a tela do XML.

Este procedimento pode apresentar um delay dependendo da comunicao do TSS com a NeoGrid (entre 5 e 10 minutos).

Excluir:
1. Selecione no grid a nota desejada e clique em Excluir.

O sistema efetuar a excluso do documento previamente importado pelo TOTVS Colaborao, desde que o status do
mesmo seja Apto. a gerar Pr-Nota.

Reprocessar:
1. Clique na opo Reprocessar.

O Sistema apresenta a tela para selecionar documentos com erro ou documentos excludos.

2. Aps escolher o tipo de documento desejado, selecione os arquivos que deseja reprocessar e confirme.

O Sistema movimentar os arquivos selecionados para a pasta XMLNFE\NEW\ para que sejam importados novamente para
as tabelas SDS/SDT. A importao ocorrer de forma automtica.

26 SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao

 Boletim Tcnico

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

MATA140 Pr-Nota de Entrada

Funes Envolvidas
MATA140I Funes Genricas de Importao NF-e

Sistemas Operacionais Windows/Linux

27
SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao