Manual de Integrao

TOTVS Colaborao

Manual de Integrao



2
Manual de Integrao
TOTVS Colaborao

Sumrio
TOTVS COLABORAO .......................................................................................................................... 3
1.1 Introduo ..................................................................................................................................... 3
1.2 Pr-Requisitos ................................................................................................................................ 3
1.3 Transao Recepo NF-e Entrada (Fornecedores) ....................................................................... 4




























Manual de Integrao



3
Manual de Integrao
TOTVS Colaborao
TOTVS COLABORAO

1.1 Introduo

Viso Geral
A oferta TOTVS Colaborao, compreende toda integrao entre os ERPs TOTVS com a soluo NeoGrid. A
responsabilidade do TSS (TOTVS Service SPED) no TOTVS Colaborao de integrar os ERPs com a NeoGrid,
provendo servios que possibilitem a comunicao e transmisso de documentos entre as partes.


1.2 Pr-Requisitos
Contratao da Oferta do TOTVS Colaborao
TSS configurado para utilizao das transaes a serem utilizadas no TOTVS Colaborao






Manual de Integrao



4
Manual de Integrao
TOTVS Colaborao

1.3 Transao Recepo NF-e Entrada (Fornecedores)


RE
Recebimento






Viso Geral
A integrao referente recepo de Notas fiscais eletrnicas (NF-e) de fornecedores abrange a utilizao dos
dados do XML da NF-e recebido dos fornecedores para gerao de informaes para automatizao do recebimento
(digitao) de notas fiscais dentro do ERP.
Entre as vantagens que esta integrao proporciona, esto:
Segurana: A nota poder ser importada no recebimento logo aps ser validada na SEFAZ o que garante a
consistncia e autenticidade das informaes;
Reduo de Custos: Reduo do volume de digitao de notas fiscais no Recebimento. Isso pode
representar reduo de custos de mo-de-obra para efetuar a digitao, bem como a reduo de possveis
erros de digitao de informaes;
Previsibilidade: Planejamento de logstica de recepo de mercadorias pelo conhecimento antecipado da
informao da NF-e, pois a previsibilidade das mercadorias a caminho permitir prvia conferncia da Nota
Fiscal com o pedido, quantidade e preo, permitindo, alm de outros benefcios, o melhor uso de docas e
reas de estacionamento para caminhes;
Reduo de Erros: Reduo de erros de escriturao devido eliminao de erros de digitao de notas
fiscais;
Reduo de Lead Time: Incentivo a B2B.
A recepo de NF-e de fornecedores, contempla a recepo, validao e traduo das informaes inerentes
ao negcio do fornecedor para informaes de negcio do cliente.

Notas:

- Esta integrao contempla o layout 2.0 da NF-e, sendo que a partir das releases definidas abaixo o sistema
possibilita tambm a entrada do layout 3.10 da NF-e:
Datasul 11 Verso 11.5.10;
EMS 2.06B Pacote 2.06.C.07.
- O sistema no contempla a entrada/recepo de NFC-e (Nota Fiscal Eletrnica de Venda ao Consumidor Final),
modelo 65;
A integrao envolve o ERP (Datasul), TSS (TOTVS Service SPED), Neogrid e SEFAZ (Secretaria da Fazenda) e
prev dois fluxos: recebimento iniciado pelo ERP e recebimento iniciado pelo Neogrid, detalhados na sequncia.







Manual de Integrao



5
Manual de Integrao
TOTVS Colaborao
Recebimento iniciado pelo ERP
1. Fornecedor envia o XML da NF-e para o cliente;
2. ERP envia o XML da NF-e para o TSS;
3. TSS envia XML da NF-e para validao;
4. Neogrid valida a mensagem;
5. Neogrid envia consulta de situao da NF-e a Secretaria da Fazenda;
6. Secretaria da Fazenda processa consulta da situao da NF-e e retorna e resultado;
7. Neogrid disponibiliza o retorno da consulta da NF-e;
8. TSS busca XML da NF-e validado na Neogrid;
9. ERP busca NF-e do TSS e efetiva no recebimento.

Recebimento iniciado pelo Neogrid
1. Fornecedor envia o XML da NF-e para o Neogrid;
2. Neogrid valida a mensagem;
3. Neogrid envia consulta de situao da NF-e a Secretaria da Fazenda;
4. Secretaria da Fazenda processa consulta da situao da NF-e e retorna e resultado;
5. Neogrid disponibiliza o retorno da consulta da NF-e;
6. TSS busca XML da NF-e validado;
7. ERP busca NF-e do TSS e efetiva no recebimento.
Manual de Integrao



6
Manual de Integrao
TOTVS Colaborao

Pr-Requisitos da Integrao dos Produtos
Contratao da oferta do TOTVS Colaborao;
TSS (TOTVS Service Sped) instalado e configurado para utilizao.

Parametrizao da Integrao no Produto, Origem
Na instalao do TSS (que deve ser a verso igual ou superior 2.07), selecionar o parmetro Recebimento
de documentos como servio a ser utilizado do TOTVS Colaborao.
Para a recepo do layout 3.10 da NF-e, dever estar instalada a verso do TSS que contempla a recepo
desta verso de Layout.

Parametrizao da Integrao no Produto, Destino
Configurao dos parmetros do conversor de NF-e entrada (RE0119);
Configurao do fornecedor, se deve ou no atualizar a NF-e automaticamente no recebimento (CD0401)
Configurao do engine de regras: O Engine de Regras possibilita configurar as condies externalizando a
regra de negcio. Utilizar os programas CD0024 para cadastro das regras, CD0025 para cadastros de tipos de
operao e CD0026 para testes.
As operaes que podem ser cadastradas no Engine para converso/sugesto de valores para entrada da nota
no recebimento so apresentadas na sequncia:



Manual de Integrao



7
Manual de Integrao
TOTVS Colaborao
Tipo de Operao Descrio
serie-docto Srie do Documento
cod-observa Cdigo Observao
it-codigo Cdigo Item
nat-operacao Natureza Operao
numero-ordem Ordem Compra
num-pedido Pedido Compra
parcela Parcela Ordem
nr-ord-produ Ordem Produo
cod-refer Referncia
cod-depos Depsito
cod-localiz Localizao
lote Lote
dt-vali-lote Data Validade Lote
un-xml Unidade de medida do Item
cod-emitente Cdigo do Emitente





Manual de Integrao



8
Manual de Integrao
TOTVS Colaborao
As variveis que podem ser cadastradas no Engine de Regras para utilizao nas regras so estas:

Varivel Descrio
serie-docto Srie Documento
cod-emitente Cdigo Emitente
cod-observa Cdigo Observao
cod-estabel Cdigo Estabelecimento
it-codigo Cdigo Item
nat-operacao Natureza Operao
numero-ordem Ordem Compra
num-pedido Pedido Compra
parcela Parcela Ordem
nr-ord-produ Ordem Produo
cod-refer Referencia
cod-depos Deposito
cod-localiz Localizao
lote Lote
dt-vali-lote Data Validade Lote
cod-gr-forn Grupo de Fornecedor
ge-codigo Grupo de Item
fm-cod-com Famlia Comercial
icms-cst CST de ICMS dos Itens
cod-sit-trib-ipi CST de IPI dos Itens
aliq-cofins-cst CST de Cofins dos Itens
cnpj-destino CNPJ de Destino
cnpj-saida CNPJ de Sada
cod-estabel-ori Cdigo Estabelecimento de Origem
desc-item Descrio do Item
Manual de Integrao



9
Manual de Integrao
TOTVS Colaborao
dt-emissao Data de Emisso
icms-aliq ICMS Alquota
mod-frete Modalidade do Frete
nro-docto Numero do Documento
reduc-bc ICMS tag <pRedBC>":
uf-end Unidade de Federao do Emitente
un-xml Unidade de Medida do Item
icms-csosn Cdigo da Situao de Operao no Simples Nacional de ICMS dos Itens

Processos de Integrao
Existem dois fluxos de integrao: o recebimento de NF-e iniciado pelo ERP e recebimento de NF-e iniciado
pelo Neogrid, os quais so descritos na sequncia. Os diagramas de fluxo de dados apresentados na sequncia
detalham como ocorre a integrao entre ERP, TSS (TOTVS Service SPED), Neogrid e Secretaria da Fazenda
(SEFAZ). O primeiro Diagrama mostra o fluxo do recebimento iniciado pelo ERP.






















Manual de Integrao



10
Manual de Integrao
TOTVS Colaborao
Recebimento iniciado pelo ERP

O processo 1 indica o incio da integrao, onde o fornecedor envia o XML da NF-e para o seu cliente, que por
sua vez, para utilizao da recepo de NF-e deve salvar esse XML em um diretrio especfico (processo 2) para
posteriormente ser enviado para validao. Quando o XML enviado diretamente do fornecedor para o cliente
Manual de Integrao



11
Manual de Integrao
TOTVS Colaborao
necessrio que este seja validado (para garantir a integridade do arquivo e tambm sua situao na SEFAZ), a
Neogrid quem faz essa validao.
Para o envio de XMLs de NF-e para que sejam validadas (processo 3), o programa a ser utilizado o RE0517
Importao de NF-e por diretrio, onde informado o diretrio da onde devem ser lidos os XMLs a serem
enviados para validao. Caso necessrio o programa pode configurado para execuo em RPW. Neste processo os
XMLs so enviados ao TSS, atravs do mtodo REMESSATOTVSCOLAB. Atravs do retorno recebido do TSS, ou
seja, se a notas foram ou no aceitas, so criadas mensagens no log: Documento pendente para gerao no
recebimento (<chave do documento>), quando a nota foi aceita ou No foi possvel criar o documento <chave do
documento> no TSS" quando no foi aceita. Os XMLs importados atravs do RE0517 aparecem no Monitor do
Conversor de NF-e (RE0708) com a situao Em validao e no podero ser atualizados para o recebimento
enquanto estiverem nesta situao. Caso alguma nota que est sendo importada possua CNPJ destino invlido
(inexistente no ERP), no sero importadas para o conversor, ou seja, no aparecero no conversor como Em
validao e nem sero enviadas Neogrid. Para este caso apresentada uma mensagem no log indicando que o
CNPJ destino inexistente e o XML movido para um subdiretrio chamado destino_inexistente. Os demais XMLs
que foram enviados para validao so movidos para um subdiretrio chamado lidos.
Aps os XMLs terem sido enviados para o TSS, os prximos passos so referentes ao envio para validao da
Neogrid (processo 4 e 5). Aps a Neogrid realizar a validao de integridade do arquivo, ela envia uma solicitao de
consulta para a SEFAZ (processo 6), que realiza a consulta (processo 7) e disponibiliza o resultado para a Negrid. A
Neogrid por sua vez, disponibiliza o XML validado para que o TSS possa busc-lo e repassar para o ERP (processo 8).
O TOTVS Service Sped busca e armazena as NF-es validadas pela Neogrid (processo 9), e para que o ERP
tenha conhecimento dessas NF-es necessrio que este fique frequentemente verificando se existem notas a serem
buscadas no TSS. Para este processo, existe o programa RE0516 Busca de NF-e do TSS que pode ser
programado para executar em RPW, para que de tempos em tempos verifique se h NF-es para serem efetivadas no
ERP. Este programa utiliza o mtodo MONITORTOTVSCOLAB para recuperar as notas do TSS. Como a busca no
TSS feita com base na entidade (Estabelecimento) o usurio deve configurar neste programa os estabelecimentos
dos quais deve-se buscar as NF-es.
Quando um documento buscado do TSS est com a situao Documento Processado seguido o seguinte
fluxo:
Caso a nota exista no Conversor com o status Em validao, ou seja, foi enviada a partir do ERP (RE0516),
ento executado o processo para enviar o documento automaticamente para o recebimento (se estiver
parametrizado para isso). atualizada a situao do documento para Erro de negcio, se no foi
processada com sucesso e Digitada Recebimento caso tenha sido processado com sucesso.
Caso a nota no exista no conversor, ou seja, veio diretamente pela Neogrid, ento executado o processo
para criar o documento no conversor e processar automaticamente para o recebimento (se estiver
parametrizado para isso). atualizada a situao do documento para Erro de negcio, se no foi
processada com sucesso e Digitada Recebimento caso tenha sido processado com sucesso.
Quando o documento buscado do TSS est com a situao Documento rejeitado ento criado um erro no
log 52119 Documento <chave do documento> rejeitado pela Neogrid, e eliminado do monitor para que no fique
poluindo a visualizao, e se preciso, para que possa ser enviado novamente para o TSS/Neogrid.
(Processo 10).
Os documentos com erro ou processados com sucesso no recebimento, podem ser consultados atravs do
RE0708 Monitor do Conversor de NF-e, neste monitor possvel consultar a situao notas, corrigir possveis
erros e reprocessar as notas caso necessrio.

Recebimento iniciado pelo Neogrid
No fluxo onde o recebimento da NF-e iniciado pelo Neogrid, praticamente igual ao primeiro, exceto pelo
fato de que a NF-e enviada diretamente para a Neogrid ao invs de para o cliente. O diagrama apresentado na
sequncia mostra esse processo.
Manual de Integrao



12
Manual de Integrao
TOTVS Colaborao

Neste cenrio, os arquivos de NF-e podero ser recebidos pela NeoGrid por integrao EDI ou Portal Web.
Integrao EDI: A soluo NeoGrid permite que o recebimento dos arquivos das NF-es seja realizado com
uma integrao EDI. A equipe NeoGrid faz o contato com cada fornecedor, executando a instalao de um
Manual de Integrao



13
Manual de Integrao
TOTVS Colaborao
client NeoGrid ou implementando uma forma de comunicao utilizando protocolos de mercado como HTTP,
FTP e WebService.
Portal Web: A soluo NeoGrid permite que o recebimento dos arquivos das NF-es seja realizado atravs
de upload pelos fornecedores. A equipe NeoGrid far o contato com cada fornecedor, executando a
configurao da integrao. O fornecedor responsvel por executar o upload manual na interface do Portal
para cada NF-e autorizada ou cancelada.
Conceitos referentes a recepo de NF-e
Entrada automtica de NF-e de fornecedores
FIFO na converso de NF-e
Natureza de operao por item
Recepo de NF-e emitida em ambiente de homologao
Tratamento de erros de integrao
Entrada automtica de NF-e: A parametrizao para entrada automtica de NF-e para o recebimento
realizada por fornecedor e ocorre da seguinte forma:
Erro Mensagem Soluo
1878 Documento j cadastrado!
O documento que est sendo importado j est no conversor de NF-e
Entrada.
- Verificar se a nota foi recebida atravs dos dois fluxos de integrao
(diretamente pela Neogrid) e est sendo importada manualmente,
neste caso no necessria a importao manual;
- Verificar se a nota j foi importada anteriormente, ela pode estar Em
Validao aguardando retorno da Neogrid.
52116
Estrutura do arquivo <nome-
arquivo.xml> no corresponde a
NF-e.
O arquivo XML que est que est sendo importado no possui o
formato correspondente a uma NF-e, verificar porque o formato est
incorreto e se o arquivo deve mesmo ser importado.
17923
No existe Estabelecimento para
CNPJ destino do documento
<chave do documento>
Verificar se a NF-e que est sendo importada possui o destino correto
(se foi direcionado para a empresa correta), pois o CNPJ destino da NF-
e no est cadastrado no ERP.
36370
<Mtodo de acesso ao TSS>
Ocorreu erro na conexo com o
WebService TSS!
Verificar se os servios do TSS esto todos ativos, se no estiverem
ativar.
30639
No foi possvel criar o
documento <chave do
documento> no TSS
Re-importar o arquivo para nova tentativa de envio ao TSS, se o erro
persistir, entrar em contato com a equipe suporte para entender o que
est ocorrendo.
52016
Funo Bloqueio de item branco
no permite gerar documento
com item branco
No foi possvel efetivar a nota no recebimento, porque o Conversor
est configurado para bloquear notas com item branco.
- Se a nota realmente deve possuir o item branco, desmarcar o
Manual de Integrao



14
Manual de Integrao
TOTVS Colaborao
parmetro, para que seja possvel reprocessar a nota e efetiv-la no
recebimento;
- Caso o item no tenha sido sugerido corretamente, verificar as
parametrizaes (Engine de Regras, Cadastro Item X Fornecedor) para
sugesto correta do item, ou efetuar a correo na tela de manuteno
de documentos do conversor.
52018
Emitente no parametrizado
para receber automaticamente o
documento
Caso deseje que o fornecedor passe a receber as NF-es
automaticamente, configurar no cadastrado de fornecedores, caso
contrrio, reprocessar a nota manualmente para o recebimento fsico
ou fiscal.
52017
Documento pendente para
gerao no recebimento
O documento est pendente de gerao no recebimento, ou seja,
aguardando a validao da NF-e pela Neogrid. Neste caso necessrio
aguardar o retorno da validao para que a nota possa ser processada
no recebimento.
2049 Natureza de operao em branco
Existe um bloqueio para entrada de documentos no fsico quando no h
natureza de operao informada, pois no h como saber que tipo de nota
est entrando e se ela pode entrar ou no pelo recebimento fsico.
Obs.: A natureza de operao, que pelo XML informada atravs da CFOP
do item pode ser configurada atravs do engine de regras ou na tela de
manuteno do item do documento no conversor.
6189
Emitente no pode ser
desconhecido
O emitente da nota pode no ter sido sugerido corretamente, verificar
as parametrizaes (Engine de Regras, cadastro de fornecedor) para
sugesto correta do emitente, ou efetuar a correo na tela de
manuteno de documentos do conversor.
2
No encontrado(a) Srie para
chave informada.
A srie da nota pode no ter sido sugerida corretamente, verificar as
parametrizaes (Engine de Regras) para sugesto correta da srie, ou
efetuar a correo na tela de manuteno de documentos do
conversor.
52015
Documento no possui
relacionamento com nota de
industrializao
Relacionar ao documento uma nota de industrializao atravs do
boto Relaciona.
52119
Documento <chave do
documento> rejeitado pela
Neogrid
Verificar com a Neogrid o motivo da rejeio e a ao a ser tomada
nesta situao.
53694
Documento <chave do
documento> no importado,
modelo igual a 65 (NFC-e).
No possvel importar documentos do tipo Nota fiscal eletrnica de
venda ao consumidor final (NFC-e). O documento com chave de acesso
<chave do documento> do tipo NFC-e (modelo do documento igual
a 65).

Manual de Integrao



15
Manual de Integrao
TOTVS Colaborao
Nota:

- Podem ocorrer outros erros de negcio, no momento da efetivao da NF-e no recebimento fsico ou fiscal, porm
a soluo a ser adotada a mesma utilizada para o recebimento no produto (sem que seja o conversor).