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

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

Tamanho

Pergunte

At a Nota Fiscal?

Nome

MV_PAR02

Grupo

MTA140I

Ordem

02

Tipo

Tamanho

Pergunte

Da Srie ?

Nome

MV_PAR03

Grupo

MTA140I

Ordem

04

Tipo

Tamanho

Pergunte

At Srie ?

Nome

MV_PAR04

Grupo

MTA140I

Ordem

04

Tipo

SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao

Boletim Tcnico

Tamanho

Pergunte

Fornecedor De ?

Nome

MV_PAR05

Grupo

MTA140I

Ordem

05

Tipo

Tamanho

Pergunte

Fornecedor At ?

Nome

MV_PAR06

Grupo

MTA140I

Ordem

06

Tipo

Tamanho

Pergunte

Dt Emisso Inicial?

Nome

MV_PAR07

Grupo

MTA140I

Ordem

07

Tipo

Tamanho

Pergunte

Dt Emisso Final?

Nome

MV_PAR08

Grupo

MTA140I

Ordem

08

Tipo

Tamanho

Pergunte

Dt Importao Inicial?

Nome

MV_PAR09

Grupo

MTA140I

Ordem

09

Tipo

5
SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao

Boletim Tcnico

2.

Pergunte

Dt Importao Final?

Nome

MV_PAR10

Grupo

MTA140I

Ordem

10

Tipo

Tamanho

Pergunte

Mostra Gerados?

Nome

MV_PAR11

Grupo

MTA140I

Ordem

11

Tipo

Tamanho

Criao de Campos no arquivo SX3 Campos:

Tamanho

Tabela SDS - Cabealho importao XML NF-e:

Campo

DS_FILIAL

Tipo

Tamanho

Decimal

Formato

@!

Ttulo

Filial

Descrio

Filial do Sistema

Nvel

Usado

No

Obrigatrio

No

Browse

No

Help

Filial do Sistema

Campo

DS_DOC

Tipo

Tamanho

Decimal

SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao

Boletim Tcnico

Formato

@!

Ttulo

Nmero

Descrio

Nmero do documento

Nvel

Usado

Sim

Obrigatrio

Sim

Browse

Sim

Help

Nmero do documento

Campo

DS_SERIE

Tipo

Tamanho

Decimal

Formato

@!

Ttulo

Srie

Descrio

Srie do documento

Nvel

Usado

Sim

Obrigatrio

No

Browse

Sim

Help

Srie do documento

Campo

DS_FORNEC

Tipo

Tamanho

Decimal

Formato

@!

Ttulo

Fornecedor

Descrio

Cdigo do fornecedor

Nvel

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

Tamanho

Decimal

Formato

@!

Ttulo

Loja

Descrio

Loja do Fornecedor

Nvel

Usado

Sim

Obrigatrio

Sim

Browse

Sim

Help

Loja do Fornecedor/Cliente.

Campo

DS_NOMEFOR

Tipo

Tamanho

40

Decimal

Formato

@!

Ttulo

Nome

Descrio

Nome do Fornecedor

Nvel

Usado

Sim

Obrigatrio

No

Browse

Sim

When

.F.

Relao

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

Help

Nome do fornecedor/cliente.

Campo

DS_CNPJ

Tipo

Tamanho

14

Decimal

Formato

@!

Formato varivel

A140IPict()

SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao

Boletim Tcnico

Ttulo

CNPJ Fornece

Descrio

CNPJ Fornecedor

Nvel

Usado

Sim

Obrigatrio

No

Browse

Sim

Help

CNPJ do Fornecedor/Cliente.

Campo

DS_TIPO

Tipo

Tamanho

Decimal

Formato

@!

Ttulo

Tipo da Nota

Descrio

Tipo da Nota

Nvel

Usado

Sim

Obrigatrio

Sim

Browse

Sim

Help

Tipo da Nota

Campo

DS_ESPECI

Tipo

Tamanho

Decimal

Formato

@!

Ttulo

Espec.Docum.

Descrio

Espcie do Documento

Nvel

Usado

No

Obrigatrio

No

Browse

No

Cons. Padro

42

Help

Espcie do Documento

9
SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao

Boletim Tcnico

10

Campo

DS_EMISSA

Tipo

Tamanho

Decimal

Ttulo

DT Emisso

Descrio

Data de Emisso da NF

Nvel

Usado

Sim

Obrigatrio

Sim

Browse

Sim

Relao

Ddatabase

Help

Data de Emisso da NF

Campo

DS_FORMUL

Tipo

Tamanho

Decimal

Formato

@!

Ttulo

Form. Prop.

Descrio

Formulrio Prprio

Nvel

Usado

No

Obrigatrio

No

Browse

No

Help

Formulrio prprio

Campo

DS_EST

Tipo

Tamanho

Decimal

Formato

@!

Ttulo

Estado

Descrio

Estado de emisso da NF

Nvel

Usado

No

SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao

Boletim Tcnico

Obrigatrio

No

Browse

No

Help

Estado de emisso da NF.

Campo

DS_STATUS

Tipo

Tamanho

Decimal

Formato

@!

Ttulo

Status

Descrio

Status do Registro

Nvel

Usado

No

Obrigatrio

No

Browse

No

Help

Status do Registro

Campo

DS_ARQUIVO

Tipo

Tamanho

80

Decimal

Formato

@!

Ttulo

Arquivo

Descrio

Nome do Arquivo XML

Nvel

Usado

No

Obrigatrio

No

Browse

No

Help

Nome do Arquivo XML

Campo

DS_USERIMP

Tipo

Tamanho

25

Decimal

Formato

@!
11
SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao

Boletim Tcnico

12

Ttulo

Usurio

Descrio

Usurio na importao

Nvel

Usado

No

Obrigatrio

No

Browse

No

Help

Usurio responsvel pela importao da Nota Fiscal Eletrnica

Campo

DS_DATAIMP

Tipo

Tamanho

Decimal

Formato

@!

Ttulo

Data Import.

Descrio

Data importao do XML

Nvel

Usado

No

Obrigatrio

No

Browse

No

Help

Data importao do XML.

Campo

DS_HORAIMP

Tipo

Tamanho

Decimal

Formato

99:99

Ttulo

Hora Import.

Descrio

Hora importao XML

Nvel

Usado

No

Obrigatrio

No

Browse

No

Help

Hora importao do XML.

Campo

DS_USERPRE

SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao

Boletim Tcnico

Tipo

Tamanho

25

Decimal

Formato

@!

Ttulo

Usurio

Descrio

Usurio res. Ger. Pre-NF

Nvel

Usado

No

Obrigatrio

No

Browse

No

Help

Usurio responsvel pela gerao da pr-nota.

Campo

DS_DATAPRE

Tipo

Tamanho

Decimal

Ttulo

Data Pr-NF

Descrio

Data de gerao de Pr-NF

Nvel

Usado

No

Obrigatrio

No

Browse

No

Help

Data de gerao da Pr-Nota de Entrada

Campo

DS_HORAPRE

Tipo

Tamanho

Decimal

Formato

99:99

Ttulo

Hora Pr NF

Descrio

Hora de gerao da Pre-NF

Nvel

Usado

No

Obrigatrio

No

Browse

No
13
SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao

Boletim Tcnico

14

Help

Hora de gerao da Pr-Nota de Entrada

Campo

DS_CHAVENF

Tipo

Tamanho

44

Decimal

Formato

@!

Ttulo

Chave Acess.

Descrio

Chave de Acesso da NF

Nvel

Usado

No

Obrigatrio

No

Browse

No

Help

Chave de acesso da Nota Fiscal Eletrnica

Campo

DS_VERSO

Tipo

Tamanho

Decimal

Formato

@!

Ttulo

Verso da Nf

Descrio

Verso Layout da NFe

Nvel

Usado

No

Obrigatrio

No

Browse

No

Help

Verso Layout da NFe

Campo

DS_CFESP

Tipo

Tamanho

Decimal

Formato

@9

Ttulo

CFOP Espec.

Descrio

CFOP Especial (s/ PC)

SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao

Boletim Tcnico

Nvel

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

Tamanho

Decimal

Formato

@!

Ttulo

Filial

Descrio

Filial do Sistema

Nvel

Usado

No

Obrigatrio

No

Browse

No

Help

Filial do Sistema

Campo

DT_ITEM

Tipo

Tamanho

Decimal

Formato

@!

Ttulo

Item NF

Descrio

Item da Nota Fiscal

Nvel

Usado

Sim

Obrigatrio

No

Browse

No

Help

Item da Nota Fiscal

15
SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao

Boletim Tcnico

16

Campo

DT_COD

Tipo

Tamanho

15

Decimal

Formato

@!

Ttulo

Produto

Descrio

Cdigo do Produto

Nvel

Usado

Sim

Obrigatrio

Sim

Browse

No

Cons. Padro

SB1

Help

Cdigo do produto

Campo

DT_DESC

Tipo

Tamanho

30

Decimal

Formato

@!

Ttulo

Desc. Prod.

Descrio

Descrio do Produto

Nvel

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

Tamanho

15

Decimal

Formato

@!

Ttulo

Prod. Fornec

SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao

Boletim Tcnico

Descrio

Cod. Prod. do Fornecedor

Nvel

Usado

Sim

Obrigatrio

No

Browse

No

Help

Cdigo do produto do fornecedor

Campo

DT_DESCFOR

Tipo

Tamanho

30

Decimal

Formato

@!

Ttulo

Desc. Fornec

Descrio

Desc. Produto Fornecedor

Nvel

Usado

Sim

Obrigatrio

No

Browse

Sim

Help

Descrio do Produto do Fornecedor

Campo

DT_FORNEC

Tipo

Tamanho

Decimal

Formato

@!

Ttulo

Forn/Cliente

Descrio

Cdigo do Forn/Cliente

Nvel

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

18

Tamanho

Decimal

Formato

@!

Ttulo

Loja

Descrio

Loja do Forn/Cliente

Nvel

Usado

No

Obrigatrio

No

Browse

No

Help

Loja do Fornecedor/Cliente.

Campo

DT_DOC

Tipo

Tamanho

Decimal

Formato

@!

Ttulo

Documento

Descrio

Nmero do Documento/Nota

Nvel

Usado

No

Obrigatrio

No

Browse

No

Help

Nmero do Documento/Nota

Campo

DT_SERIE

Tipo

Tamanho

Decimal

Formato

@!

Ttulo

Srie

Descrio

Srie da Nota Fiscal

Nvel

Usado

No

Obrigatrio

No

Browse

No

SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao

Boletim Tcnico

Help

Srie da Nota Fiscal

Campo

DT_CNPJ

Tipo

Tamanho

14

Decimal

Ttulo

CNPJ For/Cli

Descrio

CNPJ For/Cli

Nvel

Usado

No

Obrigatrio

No

Browse

No

Help

CNPJ do Fornecedor/Cliente.

Campo

DT_QUANT

Tipo

Tamanho

11

Decimal

Formato

@E 99999999.99

Ttulo

Quantidade

Descrio

Quantidade do Produto

Nvel

Usado

Sim

Obrigatrio

No

Browse

Sim

Help

Quantidade do Produto

Campo

DT_VUNIT

Tipo

Tamanho

14

Decimal

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

20

Usado

Sim

Obrigatrio

Sim

Browse

Sim

Help

Valor unitrio do Item

Campo

DT_TOTAL

Tipo

Tamanho

14

Decimal

Formato

@E 99,999,999,999.99

Ttulo

Vlr.Total

Descrio

Valor Total

Nvel

Usado

Sim

Obrigatrio

Sim

Browse

Sim

Val. Sistema

Positivo()

Help

Valor Total.

Campo

DT_PEDIDO

Tipo

Tamanho

Decimal

Formato

@!

Ttulo

Num. Pedido

Descrio

Nmero do Pedido Compra

Nvel

Usado

Sim

Obrigatrio

No

Browse

No

Help

Nmero do pedido de compra.

Campo

DT_ITEMPC

Tipo

Tamanho

SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao

Boletim Tcnico

Decimal

Formato

@!

Ttulo

Item PC

Descrio

Item Pedido de Compra

Nvel

Usado

Sim

Obrigatrio

No

Browse

No

Help

Item do pedido de compra.

Tabela SA5 Amarrao Produto x Fornecedor

Campo

A5_TESBP

Tipo

Tamanho

Decimal

Formato

@!

Ttulo

TE p/ Bonif.

Descrio

Tp.Entr. para Bonificao

Nvel

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

Tamanho

Decimal

Formato

@!

Ttulo

UM p/ NFe

Descrio

Unidade de Medida p/ NFe

Nvel

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

Help

Unidade de Medida para NFe.

O tamanho dos campos que possuem grupo podem variar conforme ambiente em uso.
3.

4.

22

Criao de tabela no arquivo SX2 Tabelas:

Chave

Nome

Modo

Cabealho
importao XML NFe

SDS

SDT

Itens importao
XML NF-e

PYME
S

Criao de ndices no arquivo SIX ndices:

ndice

SDS

Ordem

Chave

DS_FILIAL+DS_DOC+DS_SERIE+DS_FORNEC+DS_LOJA

Descrio

Nmero+Srie+Fornecedor+Loja

Proprietrio

ndice

SDS

Ordem

Chave

DS_FILIAL+DS_CHAVENF

Descrio

Chave Acess.

Proprietrio

ndice

SDT

Ordem

Chave

DT_FILIAL+DT_CNPJ+DT_FORNEC+DT_LOJA+DT_DOC+DT_SERIE

Descrio

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

Proprietrio

SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao

Boletim Tcnico

5.

ndice

SDT

Ordem

Chave

DT_FILIAL+DT_FORNEC+DT_LOJA+DT_DOC+DT_SERIE+DT_PRODFOR

Descrio

Fornecedor+Loja+Documento+Srie+Prod. Fornec

Proprietrio

ndice

SDT

Ordem

Chave

DT_FILIAL+DT_FORNEC+DT_LOJA+DT_DOC+DT_SERIE+DT_COD

Descrio

Fornecedor+Loja+Documento+Srie+Prod.

Proprietrio

ndice

SDT

Ordem

Chave

DT_FILIAL+DT_PEDIDO+DT_ITEMPC

Descrio

Nmero PC+Item

Proprietrio

Criao de Parmetros no arquivo SX6 Parmetros:

Nome da Varivel

MV_XMLCFPC

Tipo

Caracter

Descrio

Identifica os CFOPs de venda que sero tratados como bonificao na

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:

24

052 Aviso de inconsistncias NF-e [TOTVS Colaborao]

053 NF-e disponveis [TOTVS Colaborao]

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

Funes Envolvidas
Sistemas Operacionais

MATA140 Pr-Nota de Entrada

MATA140I Funes Genricas de Importao NF-e
Windows/Linux

27
SIGACOM Importao de Arquivos XML pelo TOTVS Colaborao