Manual de Integrao

TOTVS Colaborao

Manual de Integrao

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 TOTVS Colaborao

Manual de Integrao

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 TOTVS Colaborao

Manual de Integrao

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.

Nota: - Esta integrao contempla o layout 2.0 da NF-e. 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.

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

Manual de Integrao TOTVS Colaborao

Manual de Integrao

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

Manual de Integrao TOTVS Colaborao

Manual de Integrao

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.

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:

Tipo de Operao serie-docto

Descrio Srie do Documento

Manual de Integrao TOTVS Colaborao

Manual de Integrao

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

As variveis que podem ser cadastradas no Engine de Regras para utilizao nas regras so estas:

Varivel
serie-docto cod-emitente cod-observa

Descrio
Srie Documento Cdigo Emitente Cdigo Observao

Manual de Integrao TOTVS Colaborao

Manual de Integrao

cod-estabel it-codigo nat-operacao numero-ordem num-pedido parcela nr-ord-produ cod-refer cod-depos

Cdigo Estabelecimento Cdigo Item Natureza Operao Ordem Compra Pedido Compra Parcela Ordem Ordem Produo Referencia Deposito

cod-localiz

Localizao

lote dt-vali-lote cod-gr-forn ge-codigo fm-cod-com icms-cst cod-sit-trib-ipi aliq-cofins-cst cnpj-destino cnpj-saida codestabel-ori desc-item dt-emissao icms-aliq mod-frete nro-docto reduc-bc

Lote Data Validade Lote Grupo de Fornecedor Grupo de Item Famlia Comercial CST de ICMS dos Itens CST de IPI dos Itens CST de Cofins dos Itens CNPJ de Destino CNPJ de Sada Cdigo Estabelecimento de Origem Descrio do Item Data de Emisso ICMS Alquota Modalidade do Frete Numero do Documento ICMS tag <pRedBC>":

Manual de Integrao TOTVS Colaborao

Manual de Integrao

uf-end un-xml icms-csosn

Unidade de Federao do Emitente Unidade de Medida do Item 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. Recebimento iniciado pelo ERP

Manual de Integrao TOTVS Colaborao

Manual de Integrao

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 necessrio que este seja validado (para garantir a integridade do arquivo e tambm sua situao na SEFAZ), a Neogrid quem faz essa validao.

Manual de Integrao TOTVS Colaborao

10

Manual de Integrao

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 TOTVS Colaborao

11

Manual de Integrao

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 TOTVS Colaborao

12

Manual de Integrao

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 O documento que est sendo importado j est no conversor de NF-e Entrada. 1878 Documento j cadastrado! - 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 <nomearquivo.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 NFe 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 documento <chave documento> no TSS

o do

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 TOTVS Colaborao

13

Manual de Integrao

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 gerao no recebimento

para

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

2049

Natureza de operao em branco

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 desconhecido

pode

ser

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.

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 relacionamento com industrializao

possui nota de

Relacionar ao documento uma nota de industrializao atravs do boto Relaciona.

52119

Documento documento> Neogrid

<chave rejeitado

do pela

Verificar com a Neogrid o motivo da rejeio e a ao a ser tomada nesta situao.

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

Manual de Integrao TOTVS Colaborao

14