Fat BT Totvs Colaboracao 2.00

Boletim Tcnico
TOTVS Colaborao 2.0

Produto
Microsiga Protheus Faturamento Verso 11
Chamados
TQAWD7 - TQKNPC - TQLBR6 TQKRLW - TQLU96 - TQPOV8 TQQBID
Data da publicao
30/09/14
Pas(es)
Todos
Banco(s) de Dados
Todos
Importante
Esta melhoria depende da execuo do update de base COLABUPDATE, conforme
Procedimentos para Implementao.
Essa melhoria altera as formas de transmisso e de recebimento dos documentos via TOTVS Colaborao.
Atualmente, o TOTVS Colaborao utiliza o TSS (TOTVS Service SOA) para realizao do trfego dos documentos entre
o ERP Microsiga Protheus e a plataforma NeoGrid por meio do emprego da tecnologia Web Service. Nesta verso do TOTVS
Colaborao, denominada 2.0, foi empregado o uso do Client NeoGrid - que ser o responsvel pelo trfego dos arquivos gerados
pelo Microsiga Protheus - e dos sistemas da NeoGrid em substituio a utilizao do TSS.
A proposta do Client NeoGrid facilitar e agilizar o processo de transmisso dos documentos fiscais, pois trabalha
completamente integrado aos servios disponveis no TOTVS Colaborao no que se refere plataforma NeoGrid. Basicamente,
trata-se de um software que deve ser instalado no servidor de aplicao ERP, capaz de monitorar um diretrio de sada de
documentos alimentado pelo ERP Microsiga Protheus e de realizar a transmisso para os servios disponveis do TOTVS
Colaborao sob plataforma NeoGrid. Este software tambm tem como finalidade verificar junto a plataforma NeoGrid a existncia
de documentos pendentes de retorno, e em caso afirmativo, atualizar um diretrio de entrada para leitura do ERP Microsiga
Protheus.
2.0:
Para melhor entendimento, seguem abaixo as etapas do processo padro de envio de arquivos via TOTVS Colaborao
Envio
1. O Protheus gera o arquivo com extenso *.xml no diretrio de sada do Client NeoGrid.
2. O Client NeoGrid faz uma busca no diretrio de sada e envia o arquivo para os servios web do TOTVS
Colaborao na NeoGrid.
3. Aps concluir o envio, o arquivo do diretrio de sada movido para o diretrio de documentos enviados.
Recebimento
1. O Client NeoGrid analisa, em um determinado intervalo de tempo, a existncia de documentos disponveis para
recebimento. Em caso afirmativo, ser gravado no diretrio de entrada o arquivo .xml correspondente ao
documento de entrada.
2. Aps esta gravao, o ERP Microsiga Protheus executa, via Schedule de importao, a leitura do arquivo e a
sua importao para o sistema.
3. O ERP Microsiga Protheus executa tambm, via Schedule de importao, a movimentao do arquivo lido (que
est no diretrio de entrada) para o diretrio de arquivos lidos/processados.
SIGAFAT TOTVS Colaborao 2.0

Verso 4.0
Boletim Tcnico
Ttulo do documento
Lista de documentos
Abaixo est a lista de documentos disponveis no produto TOTVS Colaborao 2.0, referente a linha Microsiga Protheus.
Documento
NF-e
NF-e CC-e
MD-e
NFS-e
MDF-e
CT-e
EDI - Pedido
Tipo Requisio
Emisso
Emisso
Emisso
Emisso
Emisso
Emisso
Recebimento
Descrio
Emisso, Cancelamento e Inutilizao.
Envio do evento do CC-e
Envio da Manifestao do destinatrio
Emisso e Cancelamento.
Emisso, Cancelamento e Encerramento.
Emisso, Cancelamento e Inutilizao.
Recebimento de Pedido de compra, para
gerao do pedido de venda e
programao de entrega.
Procedimento para Implementao

O sistema atualizado logo aps a aplicao do pacote de atualizaes (Patch) deste chamado.
Importante
Antes de executar o compatibilizador COLABUPDATE 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*.
Ateno
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:
2
Verso 4.0
Boletim Tcnico
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 est(aro) 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 COLABUPDATE no campo Programa Inicial.

Importante
1. Para a correta atualizao do dicionrio de dados, certifique-se de que a data do compatibilizador COLUPD001 seja igual
ou superior a 27/08/2014.
2.
Clique em OK para continuar.
3.
Aps a confirmao exibida uma tela para a seleo da empresa em que o dicionrio de dados ser modificado ou
apresentada a janela para seleo do compatibilizador. Selecione o programa UPDCOL001.
4.
Ao confirmar, exibida uma mensagem de advertncia sobre o backup e a necessidade de sua execuo em modo
exclusivo.
5.
Clique em Processar 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.
Clique em Gravar para salvar o histrico (log) apresentado.
8.
Clique em OK para encerrar o processamento.

Verso 4.0
Boletim Tcnico
Ttulo do documento
Atualizaes do compatibilizador
1. Criao de tabela no arquivo SX2 Tabelas
Tabela CKP Parmetros TOTVS Colaborao
Arquivo
CKP
Nome
Parmetros TOTVS Colaborao
Mod. Ac. Filial
Exclusivo
Mod. Ac. Unidade
Exclusivo
Mod. Ac. Empresa
Exclusivo
Chave nica
CKP_FILIAL+CKP_PARAM
Tabela CKQ Monitor de documentos TOTVS Colaborao
Arquivo
CKQ
Nome
Controle de Arq. TOTVS Colab.
Mod. Ac. Filial
Exclusivo
Mod. Ac. Unidade
Exclusivo
Mod. Ac. Empresa
Exclusivo
Chave nica
CKQ_FILIAL+CKQ_MODELO+CKQ_TP_MOV+CKQ_IDERP
Tabela CKO Controle de arquivos TOTVS Colaborao
Arquivo
CKO
Nome
Arq.(X2_NOME)*
CKOCOL
Nome
Controle de Arq. TOTVS Colab.
Mod. Ac. Filial
Exclusivo
Mod. Ac. Unidade
Exclusivo
Mod. Ac. Empresa
Exclusivo
Chave nica
Importante
A tabela CKO deve ser nica para todas as empresas do sistema, desta forma o campo X2_NOME deve estar preenchido
obrigatoriamente com o contedo CKOCOL, para que a importao de arquivos funcione corretamente.

4
Verso 4.0
Boletim Tcnico
2. Criao de Campos no arquivo SX3 Campos:
Campo
CKP_FILIAL
Tipo
Tamanho
Descrio
Filial do sistema
Ttulo
Filial
Picture
@!
Contexto
Real
Propriedade
Alterar
Usado
No
Browse
No
Obrigatrio
No
Grupo de Campo
033 (Tamanho da Filial)
Help de Campo
Filial do Sistema.
Campo
CKP_PARAM
Tipo
Tamanho
10
Descrio
Parmetro do TOTVS Colab.
Ttulo
Parmetro
Picture
@!
Contexto
Real
Propriedade
Alterar
Usado
Sim
Browse
No
Obrigatrio
No
Help de Campo
Nome do parmetro utilizado para as rotinas do TOTVS

Colaborao.

Verso 4.0
Boletim Tcnico
Ttulo do documento
Campo
CKP_VALOR
Tipo
Tamanho
100
Descrio
Contedo do Parmetro
Ttulo
Contedo
Picture
@!
Contexto
Real
Propriedade
Alterar
Usado
Sim
Browse
No
Obrigatrio
No
Help de Campo
Contedo do parmetro utilizado para as rotinas do TOTVS

Colaborao.
Campo
CKP_DESCRI
Tipo
Tamanho
120
Descrio
Descrio do parmetro
Ttulo
Descrio
Picture
@!
Contexto
Real
Propriedade
Alterar
Usado
Sim
Browse
No
Obrigatrio
No
Help de Campo
Descrio do parmetro para auxlio no entendimento do

funcionamento do parmetro.
Tabela CKQ Monitor de Documentos TOTVS Colaborao
Campo
CKQ_FILIAL
Tipo
Tamanho
Descrio
Filial do sistema
6
Verso 4.0
Boletim Tcnico
Ttulo
Filial
Picture
@!
Contexto
Real
Propriedade
Alterar
Usado
No
Browse
No
Obrigatrio
No
Grupo de Campo
Help de Campo
Filial do Sistema.
Campo
CKQ_MODELO
Tipo
Tamanho
Descrio
Modelo do documento
Ttulo
Modelo
Picture
@!
Contexto
Real
Propriedade
Alterar
Usado
Sim
Browse
Sim
Obrigatrio
No
Help de Campo
Modelo do documento.
Campo
CKQ_TP_MOV
Tipo
Tamanho
Descrio
Tipo do Movimento
Ttulo
Tp. Mov
Picture
@!
Contexto
Real
Propriedade
Alterar
Usado
Sim

Verso 4.0
Boletim Tcnico
Ttulo do documento
Browse
No
Obrigatrio
No
Help de Campo
Tipo do movimento: 1 - Emisso e 2 - Recebimento.
Campo
CKQ_CODEDI
Tipo
Tamanho
Descrio
Cdigo do EDI
Ttulo
Cdigo EDI
Picture
@!
Contexto
Real
Propriedade
Alterar
Usado
Sim
Browse
No
Obrigatrio
No
Help de Campo
Cdigo do EDI, este cdigo se refere ao tipo de documento/

transao que a NeoGrid aguarda receber.
Campo
CKQ_ARQUIV
Tipo
Tamanho
30
Descrio
Nome do arquivo gerado
Ttulo
Nome Arquivo
Picture
@!
Contexto
Real
Propriedade
Alterar
Usado
Sim
Browse
Sim
Obrigatrio
No
Help de Campo
Nome do arquivo gerado no diretrio, para transmisso pelo

Integrador da NeoGrid.

8
Verso 4.0
Boletim Tcnico
Campo
CKQ_STATUS
Tipo
Tamanho
Descrio
Status do Documento
Ttulo
Status Doc.
Picture
@!
Contexto
Real
Propriedade
Alterar
Usado
Sim
Browse
No
Obrigatrio
No
Help de Campo

Campo
CKQ_DESSTA
Tipo
Tamanho
40
Descrio
Descrio do STATUS
Ttulo
Desc. STATUS
Contexto
Real
Propriedade
Alterar
Usado
Sim
Browse
Sim
Obrigatrio
No
Help de Campo
Descrio sobre o STATUS do documento.
Campo
CKQ_IDERP
Tipo
Tamanho
50
Descrio
ID gerado pelo ERP
Ttulo
ID ERP
Contexto
Real

Verso 4.0
Boletim Tcnico
Ttulo do documento
Propriedade
Alterar
Usado
Sim
Browse
No
Obrigatrio
No
Help de Campo
ID gerado pelo ERP, utilizado para manter as funcionalidades

anteriores do ERP sem o uso do novo TOTVS Colaborao.
Campo
CKQ_SERIE
Tipo
Tamanho
Descrio
Srie do documento
Ttulo
Srie
Picture
@!
Contexto
Real
Propriedade
Alterar
Usado
Sim
Browse
Sim
Obrigatrio
No
Help de Campo
Srie do documento, gerado somente para documentos que tenham

esta informao.
Campo
CKQ_NUMERO
Tipo
Tamanho
Descrio
Nmero do documento
Ttulo
Numero
Picture
@!
Contexto
Real
Propriedade
Alterar
Usado
Sim
Browse
Sim
Grupo de Campo
018 (Tamanho Documento Entrada e sada)
Obrigatrio
No
10
Verso 4.0
Boletim Tcnico
Help de Campo
Nmero do documento, gerado somente para documentos que

tenham esta informao.
Campo
CKQ_DT_GER
Tipo
Tamanho
Descrio
Data de Gerao do Arquivo
Ttulo
Data Gerao
Contexto
Real
Propriedade
Alterar
Usado
Sim
Browse
No
Obrigatrio
No
Help de Campo
Data de gerao do arquivo no diretrio para ser lido pelo integrador

NeoGrid.
Campo
CKQ_HR_GER
Tipo
Tamanho
Descrio
Hora da Gerao
Ttulo
Hora Gerao
Contexto
Real
Propriedade
Alterar
Usado
Sim
Browse
No
Obrigatrio
No
Help de Campo
Hora de gerao do arquivo no diretrio para ser lido pelo integrador

NeoGrid.
Campo
CKQ_AMBIEN
Tipo
Tamanho

Verso 4.0
11
Boletim Tcnico
Ttulo do documento
Descrio
Ambiente
Ttulo
Ambiente
Validao
Pertence(12)
Contexto
Real
Opes
1=Producao;2=Ambiente
Browse
No
Obrigatrio
No
Help de Campo
Indica ambiente em que documento foi enviado.
Tabela CKO Controle de Arquivos TOTVS Colaborao
Campo
CKO_FILIAL
Tipo
Tamanho
Descrio
Filial do sistema
Ttulo
Filial
Picture
@!
Contexto
Real
Propriedade
Alterar
Usado
No
Browse
No
Obrigatrio
No
Grupo de Campo
Help de Campo
Filial do Sistema.
Campo
CKO_ARQUIV
Tipo
Tamanho
30
Descrio
Nome do arquivo gerado
Ttulo
Nome arquivo
Picture
@!
Contexto
Real
Propriedade
Alterar
12
Verso 4.0
Boletim Tcnico
Usado
Sim
Browse
Sim
Obrigatrio
No
Help de Campo

Campo
CKO_STATUS
Tipo
Tamanho
Descrio
Status do Arquivo
Ttulo
Status Arq.
Picture
@!
Contexto
Real
Propriedade
Alterar
Usado
Sim
Browse
No
Obrigatrio
No
Help de Campo
STATUS do arquivo gerado.
Campo
CKO_DESSTA
Tipo
Tamanho
40
Descrio
Descrio do STATUS
Ttulo
Desc. STATUS
Picture
@!
Contexto
Real
Propriedade
Alterar
Usado
Sim
Browse
Sim
Obrigatrio
No
Help de Campo
Descrio sobre o STATUS do documento.

Verso 4.0
13
Boletim Tcnico
Ttulo do documento
Campo
CKO_XMLENV
Tipo
Tamanho
10
Descrio
XML de envio para NeoGrid
Ttulo
XML Envio
Contexto
Real
Propriedade
Alterar
Usado
Sim
Browse
No
Obrigatrio
No
Help de Campo
XML criado pelo ERP e gravado no diretrio OUT do integrador da

NeoGrid.
Campo
CKO_XMLRET
Tipo
Tamanho
10
Descrio
XML de retorno da NeoGrid
Ttulo
XML Retorno
Contexto
Real
Propriedade
Alterar
Usado
Sim
Browse
No
Obrigatrio
No
Help de Campo
XML importado do diretrio IN do integrador da NeoGrid, XML com a

resposta do XML gravado no campo CKO_XMLENV.
Campo
CKO_DT_GER
Tipo
Tamanho
Descrio
Data de Gerao do Arquivo
Ttulo
Data Gerao
Contexto
Real
Propriedade
Alterar
14
Verso 4.0
Boletim Tcnico
Usado
Sim
Browse
No
Obrigatrio
No
Help de Campo
Data de gerao do arquivo no diretrio para ser lido pelo integrador

NeoGrid.
Campo
CKO_HR_GER
Tipo
Tamanho
Descrio
Hora da Gerao
Ttulo
Hora Gerao
Contexto
Real
Propriedade
Alterar
Usado
Sim
Browse
No
Obrigatrio
No
Help de Campo
Hora de gerao do arquivo no diretrio para ser lido pelo integrador

NeoGrid.
Campo
CKO_DT_RET
Tipo
Tamanho
Descrio
Data de Retorno do Arquivo
Ttulo
Data Retorno
Contexto
Real
Propriedade
Alterar
Usado
Sim
Browse
No
Obrigatrio
No
Help de Campo
Data da gravao do arquivo no diretrio de arquivos de retorno pelo

integrador da NeoGrid.

Verso 4.0
15
Boletim Tcnico
Ttulo do documento
Campo
CKO_HR_RET
Tipo
Tamanho
Descrio
Hora de Retorno do Arquivo
Ttulo
Hora Retorno
Contexto
Real
Propriedade
Alterar
Usado
Sim
Browse
No
Obrigatrio
No
Help de Campo
Hora da gravao do arquivo no diretrio de arquivos de retorno pelo

integrador da NeoGrid.
Campo
CKO_IDERP
Tipo
Tamanho
50
Descrio
ID gerado pelo ERP
Ttulo
ID ERP
Picture
@!
Contexto
Real
Propriedade
Alterar
Usado
Sim
Browse
No
Obrigatrio
No
Help de Campo
ID gerado pelo ERP, utilizado para manter as funcionalidades

anteriores do ERP sem o uso do novo TOTVS Colaborao.
Campo
CKO_TP_MOV
Tipo
Tamanho
Descrio
Tipo do Movimento
Ttulo
Tp. Mov
Picture
@!
16
Verso 4.0
Boletim Tcnico
Contexto
Real
Propriedade
Alterar
Usado
Sim
Browse
No
Obrigatrio
No
Help de Campo
Tipo do movimento: 1 - Emisso e 2 - Recebimento.
Campo
CKO_FLAG
Tipo
Tamanho
Descrio
Flag de exportao
Ttulo
Flag Exp.
Picture
@!
Contexto
Real
Propriedade
Alterar
Usado
Sim
Browse
No
Obrigatrio
No
Help de Campo
Flag de exportao utilizado para os recebimentos de documentos.

Onde 1 - No Exportado e 2 - Exportado.
Campo
CKQ_CODEDI
Tipo
Tamanho
Descrio
Cdigo do EDI NeoGrid
Ttulo
Cdigo EDI
Picture
@!
Contexto
Real
Propriedade
Alterar
Usado
Sim
Browse
No
Obrigatrio
No

Verso 4.0
17
Boletim Tcnico
Ttulo do documento
Help de Campo
Cdigo do EDI, este cdigo se refere ao tipo de documento/

transao que a NeoGrid aguarda receber.
Campo
CKO_DT_IMP
Tipo
Tamanho
Descrio
Data da Importao Arquivo
Ttulo
Data Import.
Contexto
Real
Propriedade
Alterar
Usado
Sim
Browse
No
Obrigatrio
No
Help de Campo
Data de leitura do arquivo no diretrio de arquivos de retorno do

integrador da NeoGrid pelo Schedule de leitura.
Campo
CKO_HR_IMP
Tipo
Tamanho
Descrio
Hora de Importao Arq.
Ttulo
Hora Import.
Contexto
Real
Propriedade
Alterar
Usado
Sim
Browse
No
Obrigatrio
No
Help de Campo
Hora de leitura do arquivo no diretrio de arquivos de retorno do

integrador da NeoGrid pelo Schedule de leitura.

18
Verso 4.0
Boletim Tcnico
3. Criao de ndices no arquivo SIX ndices:
ndice
CKP
Ordem
Chave
CKP_FILIAL + CKP_PARAM
Descrio
Filial + Parmetro
Proprietrio
Tabela CKQ Monitor de Documentos TOTVS Colaborao
ndice
CKQ
Ordem
Chave
Descrio
Filial + Modelo + Tipo Movimento + ID do ERP
Proprietrio
ndice
CKQ
Ordem
Chave
CKQ_FILIAL+CKQ_MODELO+CKQ_TP_MOV+CKQ_SERIE+CKQ_NUMERO
Descrio
Filial + Modelo + Tipo Movimento + Srie + Numero
Proprietrio
ndice
CKQ
Ordem
Chave
CKQ_FILIAL+CKQ_MODELO+CKQ_TP_MOV+CKQ_STATUS
Descrio
Filial + Modelo + Tipo Movimento + Status
Proprietrio
ndice
CKQ
Ordem
Chave
CKQ_FILIAL+CKQ_MODELO+CKQ_TP_MOV+CKQ_STATUS
Descrio
Filial + Modelo + Tipo Movimento + Status
Proprietrio

Verso 4.0
19
Boletim Tcnico
Ttulo do documento
ndice
CKQ
Ordem
Chave
CKQ_FILIAL+CKQ_MODELO+CKQ_TP_MOV+CKQ_CODEDI
Descrio
Filial + Modelo + Tipo Movimento + Cdigo EDI
Proprietrio
ndice
CKQ
Ordem
Chave
CKQ_FILIAL+DTOS(CKQ_DT_GER)+CKQ_HR_GER
Descrio
Filial + Modelo + Data de Gerao + Hora da gerao
Proprietrio
Tabela CKO - Controle de arquivos TOTVS Colaborao
ndice
CKO
Ordem
Chave
CKO_ARQUIV
Descrio
Arquivo
Proprietrio
ndice
CKO
Ordem
Chave
CKO_ARQUIV+CKO_TP_MOV+CKO_FLAG
Descrio
Arquivo + Tipo Movimento + Flag de retorno
Proprietrio
ndice
CKO
Ordem
Chave
CKO_IDERP+DTOS(CKO_DT_GER)
Descrio
ID do ERP + Data de gerao
Proprietrio

20
Verso 4.0
Boletim Tcnico
ndice
CKO
Ordem
Chave
CKO_CODEDI+CKO_FLAG+DTOS(CKO_DT_RET)
Descrio
ID do ERP + Flag de retorno +Data de retorno
Proprietrio
Importante
O tamanho dos campos que possuem grupo pode variar conforme o ambiente em uso.
Procedimento para Configurao

CONFIGURAO DE PARMETROS
1. No Configurador (SIGACFG) acesse Ambientes/Cadastros/Parmetros (CFGX017). Configure o(s) parmetro(s) a
seguir:
Itens/Pastas
Descrio
Nome
MV_TCNEW
Tipo
Cont. Por.
Descrio
Documentos que utilizam o novo modelo TOTVS Colab. Onde:0todos,1-NFe,2-CTe,3-NFSe,4-MDe,5-MDfe,6-Recebimento.
Importante
O contedo deste parmetro deve ser informado separado pelo caractere de vrgula (,), para que seja possvel informar a
utilizao de mais de um tipo de documento. Exemplo: Ser utilizado apenas NF-e e CT-e, o contedo informado ser: 1,2.
Itens/Pastas
Descrio
Nome
MV_NGOUT
Tipo
Descrio
Indicar o caminho do diretrio dentro do ROOTPATH do Protheus

onde ser gravado os arquivos a serem enviados para NeoGrid.
Ex:'\NeoGrid\OUT'

Verso 4.0
21
Boletim Tcnico
Ttulo do documento
Itens/Pastas
Descrio
Nome
MV_NGINN
Tipo
Descrio

onde ser lido os arquivos de retorno recebidos da NeoGrid.
Ex:'\NeoGrid\IN'
Itens/Pastas
Descrio
Nome
MV_NGLIDOS
Tipo
Descrio

onde ser armazenado os arquivos aps lidos e processados.
Ex:\NeoGrid\Lidos'
Importante
de extrema importncia para o funcionamento correto da soluo que os caminhos dos diretrios sejam informados
corretamente, conforme a instalao do Client da NeoGrid. Obrigatoriamente, o Client deve ser instalado a partir do RootPath
de instalao do Microsiga Protheus, para que o Schedule de importao possa localizar os arquivos recebidos e integrar de
forma automtica para a base do Protheus.
Procedimento para Utilizao

Schedule de Importao
Aps a atualizao, ser necessrio apenas a configurao do Schedule de importao. Este Schedule ser o responsvel
pela importao dos arquivos XML que sero recebidos via Client Neogrid no diretrio IN, localizado dentro da instalao
do Client (este o diretrio que deve ser configurado no parmetro MV_NGINN). Os arquivos sero importados para a
Tabela CKO - Controle de arquivos TOTVS Colaborao. Aps a gravao do arquivo na tabela, o Schedule move o arquivo
da pasta IN para a pasta configurada no parmetro MV_NGLIDOS.
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.
22
Verso 4.0
Boletim Tcnico
8. Confira dos dados e confirme.

9. Clique em Agendamentos/Cadastro.
10. Em Detalhes clique em Incluir.
11. Informe o nome da rotina (colAutoRead).
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.
Importante
No necessria a configurao do Schedule para todas empresas e filiais cadastradas, podendo ser configurado para uma
nica empresa. Como a tabela CKO nica para todas empresas/ filiais e os arquivos que sero recebidos via Client
tambm, se o Schedule for iniciado para uma empresa/ filial, processar todas as existentes.
Caso deseje que seja apresentado no console da aplicao o procedimento que o Schedule realiza, possvel habilitar o
parmetro abaixo no arquivo appserver.ini na seo Enviroment:
COLAUTOREAD_DEBUG=1
Emisso de NF-e e CC-e TOTVS Colaborao 2.0

Importante
Para informaes sobre a utilizao da Nota Fiscal Eletrnica, fundamental a leitura do Manual para Documentos Eletrnicos,
disponvel no portal TDN pelo link: http://tdn.totvs.com, em:
Softwares de Gesto/ Linha Microsiga Protheus/ Fiscal/ Notas Fiscais Eletrnicas/ Banco de Conhecimento/
Documentos Eletrnicos.
Abaixo esto informadas as alteraes realizadas na Nota Fiscal Eletrnica e na Carta de Correo Eletrnica da NF-e,
quando configuradas para TOTVS Colaborao 2.0:
1. Foi retirado o Wizard de Configurao, que no ser necessrio pois a configurao do certificado dever ser feita na
NeoGrid. Os e-mails informativos tambm sero enviados por meio da plataforma NeoGrid.
2. Foram retirados o Status Sefaz, a Consulta Chave e a Consulta Contribuinte, visto que estes servios no esto
disponveis via TOTVS Colaborao 2.0, pois se tratam de servios Sncronos.
3. Usualmente, os processos de Transmisso, Cancelamento/ Inutilizao e Monitor continuam da mesma forma.
Internamente foram realizados tratamentos para que trabalhem corretamente via TOTVS Colaborao 2.0.
Verso 4.0
23
Boletim Tcnico
Ttulo do documento
4. Foi retirada a validao de Schema, pois esta ser realizada aps a transmisso do arquivo para a NeoGrid, que
retornar com o problema descrito de schema, caso exista.
MD-e TOTVS Colaborao 2.0

Importante
Para informaes sobre utilizao da Manifestao do Destinatrio Eletrnica, fundamental a leitura do Boletim Tcnico
COM_BT_Manifestacao do Destinatario, disponvel no portal TDN pelo link: http://tdn.totvs.com, em:
Softwares de Gesto/ Linha Microsiga Protheus /Materiais/ Compras e Suprimentos/ Boletim tcnico/ Verso 11.
Abaixo seguem as alteraes realizadas na Manifestao do Destinatrio, quando configurados para TOTVS Colaborao
2.0:
1. Foi retirado o Wizard de Configurao, que no ser necessrio pois a configurao do certificado dever ser feita na
2. Foi alterada a funcionalidade Sincronizar. Como se tratava de um servio sncrono, foi necessrio o ajuste para trabalhar
de forma assncrona. Assim, esta funcionalidade trabalhar junto com a funcionalidade Atualizar.
3. Foi inserida a funcionalidade Atualizar, que ser responsvel por atualizar a tela para que quando os documentos forem
sincronizados apaream em tela.
4. Foi retirada a funcionalidade Baixar Zip e esta foi substituda pela funcionalidade Exportar para o TOTVS Colaborao
2.0. A Alterao foi realizada para que o processo funcione de forma assncrona.
5. Inserida a opo Exportar com duas funcionalidades: Solicitar e Monitorar.
6. A funcionalidade Solicitar realiza a solicitao do download do XML para a NeoGrid.
7. A funcionalidade Monitorar abre um monitor para controle das solicitaes de downloads, no qual possvel realizar o
download por meio do boto Baixar, apenas quando estiver disponvel.
8. Usualmente os processos de Configurar, Manifestar e Monitorar continuam da mesma forma. Internamente foram
realizados tratamentos para que trabalhem corretamente via TOTVS Colaborao 2.0.
Emisso de NFS-e TOTVS Colaborao 2.0

Importante
Para informaes sobre a utilizao da Nota Fiscal Eletrnica, fundamental a leitura do Manual para Documentos Eletrnicos
disponvel no portal TDN pelo link: http://tdn.totvs.com, em:
Abaixo seguem as alteraes realizadas na Nota Fiscal de Servios Eletrnica, quando configurados para TOTVS
Colaborao 2.0:
24
Verso 4.0
Boletim Tcnico
1. Foi retirada a opo Wizard de Configurao, que no ser necessrio pois a configurao do certificado dever ser
feita na NeoGrid. Os e-mails informativos tambm sero enviados por meio da plataforma NeoGrid.
2. Foram retiradas as opes Imp.Retorno, Abrir URL e Tabela AIDF, visto que estes servios no esto disponveis via
TOTVS Colaborao 2.0, pois se tratam de servios Sncronos.
3. Usualmente os processos de Transmisso, Cancelamento e Monitor continuam da mesma forma. Internamente foram
realizados tratamentos para que trabalhem corretamente via TOTVS Colaborao 2.0.
4. Foi retirada a validao de Schema. Esta ser realizada aps a transmisso do arquivo para a NeoGrid, que retornar
com o problema descrito de Schema, caso exista.
5. A gerao do arquivo conforme layout definido pela NeoGrid ser realizada por meio da rotina customizvel
(NFSEXMLUni.prw).
MDF-e TOTVS Colaborao 2.0

Importante
Para informaes sobre a utilizao do Manifesto Eletrnico de Documentos Fiscais, fundamental a leitura do Manual para
Documentos Eletrnicos disponvel no portal TDN pelo link: http://tdn.totvs.com, em:
Abaixo seguem as alteraes realizadas na Manifestao do Destinatrio, quando configurados para TOTVS Colaborao
2.0:
1. Foi retirado o Wizard de Configurao que no ser necessrio pois a configurao do certificado dever ser feita na
2. Foi retirado o Status Sefaz, visto que este servio no est disponvel via TOTVS Colaborao 2.0, pois se trata de
servio Sncrono.
3. Usualmente os processos de Transmisso, Cancelamento, Encerramento e Monitorar continuam da mesma forma.
4. Retirada a validao de Schema, esta validao ser realizada aps a transmisso do arquivo para a NeoGrid, que
retornar com o problema descrito de schema, caso exista.
CT-e TOTVS Colaborao 2.0

Importante
Para informaes sobre a utilizao do Conhecimento de Transporte Eletrnico de Documentos Fiscais, fundamental a leitura
do Manual para Documentos Eletrnicos, disponvel no portal TDN pelo link: http://tdn.totvs.com, em:
Verso 4.0
25
Boletim Tcnico
Ttulo do documento
Abaixo seguem as alteraes realizadas no Conhecimento de Frete Eletrnico, quando configurados para TOTVS
Colaborao 2.0:
1. Foi retirada a opo Status, visto que este servio no est disponvel via TOTVS Colaborao 2.0, pois se trata de
servio Sncrono.
2. Usualmente os processos de Transmitir, Cancelamento, Inutilizao e Monitor continuam da mesma forma.
EDI-Pedido TOTVS Colaborao 2.0

Abaixo seguem as alteraes realizadas nas rotinas de Gerao de Pedido de Venda e Programao de Entrega, quando
configuradas para TOTVS Colaborao 2.0:
1. Configurar uma job que acione a funo MA411Job(), utilizando o SIGACFG, no menu Ambiente/ Schedule/ Schedule.
2. Configurar uma job que acione a funo MA412Job(), utilizando o SIGACFG, no menu Ambiente/ Schedule/ Schedule.
3. Configurar o parmetro MV_TCNEW igual a 6.
4. Configurar o parmetro MV_NGINN com o caminho da pasta para recebimento do XML da neogrid.
5. Configurar o parmetro MV_NGLIDOS com o caminho da pasta para mover os arquivos XML j processados da neogrid.
6. Usualmente os processos de Gerao do Pedido de Venda e Gerao da Programao de Entrega continuam da
mesma forma. Internamente foram realizados tratamentos para que trabalhem corretamente via TOTVS Colaborao
2.0.

26
Verso 4.0
Boletim Tcnico
Informaes Tcnicas
Tabelas Utilizadas
CKP Parmetros TOTVS Colaborao.

CKQ Monitor de Documentos TOTVS Colaborao.
CKO Controle de arquivos TOTVS Colaborao.
CC0 Manifesto Documentos Fiscais.
Rotinas Envolvidas
ColUpd001
ColabGeneric
ColabDocumentos
FISA022
SPEDNFE
SPEDCOL
DANFEII
DANFEIII
AutoNfeBusiness
AutoNfseBusiness
nfep11r1
colReadControl
colAutoRead
SPEDMDFE
DAMDFE
TMSA500
TMSA190
TMSAE70
TMSAE73
TMSAE90
TmsXFunc
CTeSefaz
MDFSefaz
Rtmsr27
Rtmsr28
MATA412
MATA411
Sistemas Operacionais
Windows/ Linux

Verso 4.0
27

Fat BT Totvs Colaboracao 2.00

Enviado por

Dados do documento

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Fat BT Totvs Colaboracao 2.00

Enviado por

Direitos autorais:

Formatos disponíveis

Boletim Tcnico

TOTVS Colaborao 2.0

Microsiga Protheus Faturamento Verso 11

TQAWD7 - TQKNPC - TQLBR6 TQKRLW - TQLU96 - TQPOV8 TQQBID

SIGAFAT TOTVS Colaborao 2.0

Procedimento para Implementao

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

i. No Configurador (SIGACFG), veja se a empresa utiliza Integridade Referencial, selecionando a opo

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

Clique em OK para continuar.

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

Clique em OK para encerrar o processamento.

SIGAFAT TOTVS Colaborao 2.0

Tabela CKP Parmetros TOTVS Colaborao

Parmetros TOTVS Colaborao

Mod. Ac. Filial

Mod. Ac. Unidade

Mod. Ac. Empresa

Tabela CKQ Monitor de documentos TOTVS Colaborao

Controle de Arq. TOTVS Colab.

Mod. Ac. Filial

Mod. Ac. Unidade

Mod. Ac. Empresa

Tabela CKO Controle de arquivos TOTVS Colaborao

Controle de Arq. TOTVS Colab.

Mod. Ac. Filial

Mod. Ac. Unidade

Mod. Ac. Empresa

SIGAFAT TOTVS Colaborao 2.0

2. Criao de Campos no arquivo SX3 Campos:

Tabela CKP Parmetros TOTVS Colaborao

033 (Tamanho da Filial)

Parmetro do TOTVS Colab.

Nome do parmetro utilizado para as rotinas do TOTVS

SIGAFAT TOTVS Colaborao 2.0

Contedo do parmetro utilizado para as rotinas do TOTVS

Descrio do parmetro para auxlio no entendimento do

Tabela CKQ Monitor de Documentos TOTVS Colaborao

033 (Tamanho da Filial)

SIGAFAT TOTVS Colaborao 2.0

Tipo do movimento: 1 - Emisso e 2 - Recebimento.

Cdigo do EDI, este cdigo se refere ao tipo de documento/

Nome do arquivo gerado

Nome do arquivo gerado no diretrio, para transmisso pelo

SIGAFAT TOTVS Colaborao 2.0

Nome do arquivo gerado no diretrio, para transmisso pelo

Descrio sobre o STATUS do documento.

ID gerado pelo ERP

SIGAFAT TOTVS Colaborao 2.0

ID gerado pelo ERP, utilizado para manter as funcionalidades

Srie do documento, gerado somente para documentos que tenham

018 (Tamanho Documento Entrada e sada)

Nmero do documento, gerado somente para documentos que

Data de Gerao do Arquivo

Data de gerao do arquivo no diretrio para ser lido pelo integrador

Hora de gerao do arquivo no diretrio para ser lido pelo integrador

SIGAFAT TOTVS Colaborao 2.0

Indica ambiente em que documento foi enviado.

Tabela CKO Controle de Arquivos TOTVS Colaborao

033 (Tamanho da Filial)

Nome do arquivo gerado

Nome do arquivo gerado no diretrio, para transmisso pelo

STATUS do arquivo gerado.