Integração Backoffice Datasul x Trade Easy

Contexto de negócio (Introdução)

O Siscoserv é um sistema informatizado desenvolvido pelo Governo Federal, em plataforma web, em operação deste 2012, que obriga o registro de todas as operações de aquisição e prestação de serviços no mercado internacional.

No geral, as empresas costumam registrar em seus sistemas de gestão as informações de alguns serviços somente no momento do pagamento ou recebimento para controle interno, porém neste caso existe a possibilidade do prazo deste registro já ter expirado de acordo com o cronograma, pois a partir do dia que o serviço foi iniciado a empresa tem até o último dia útil do 6º mês subsequente para registrá-lo no SISCOSERV.

Isso reforça a importância de que as empresas se atentem a esta nova obrigação, especialmente para não correrem o risco de serem multadas por perda de prazos.

Foi neste contexto que surgiu a necessidade de integrar o ERP Datasul ao Trade Easy Siscoserv com intuito de oferecer uma ferramenta que possa ajudar a empresa suprir algumas dificuldades no momento de adaptar suas estruturas de operações e sistematizar processos e controles que viabilizem o registro destas informações de forma precisa.

Sistemas Envolvidos

• Datasul
  Módulo de Compras: responsável por controlar as demandas de compra de serviço recebidas pelas demais áreas da empresa e gerenciar todo o processo de compras, englobando as negociações com fornecedores até o fechamento do pedido de compra.
  Módulo de Recebimento: é o canal de entrada das notas fiscais envolvidas no dia-a-dia da empresa.
  Módulo de Importação: responsável pelo controle das informações dos processos de importação, permite o acompanhamento dos eventos dos processos (itinerários), emissão dos relatórios e documentos de importação em diversos idiomas, contabilização das movimentações e realização do cálculo do custo da importação, incluindo os impostos e as despesas.
  Módulo de Pedido: visa o controle operacional e gerencial da carteira de pedidos de venda, fornecendo informações detalhadas e sumariadas sobre as vendas efetuadas em termos de cliente, representante, região, itens, canal de venda e estabelecimento.
  Módulo de Faturamento: responsável por gerenciar o atendimento dos pedidos de venda por intermédio dos valores faturados, desde a emissão da nota fiscal até a geração das estatísticas de venda.
  Módulo de Exportação: controla as informações dos processos de exportação, permite realizar o acompanhamento dos eventos dos processos (itinerários), emite os relatórios e documentos de exportação em diversos idiomas e auxilia os controles dos módulos de Pedidos de Venda e Faturamento.

• Trade Easy
  A TRADE-EASY desenvolve soluções em software específicas para a realidade brasileira no comércio exterior, gerenciando e otimizando as operações de importação, exportação, cambio e drawback. As soluções Easy são WEB, multiplataforma de fácil integração com os principais ERPs do mercado.
  Módulo de Siscoserv: responsável por controlar e simplificar o registro das Aquisições ou Vendas de serviços no exterior junto ao Siscoserv, além de auxiliar na gestão dos prazos envolvidos, evitando multas e outras penalidades previstas na legislação.

Integração

O objetivo desta integração será permitir [KLM1] [ARV2] às empresas registrarem as aquisições e vendas de serviços no exterior, e através do módulo de Easy Siscoserv fazer a gestão completa das informações necessárias, auxiliando no processo de obtenção dos dados e controle de prazos, evitando multas e outras penalidades previstas na legislação.[KLM3] [ARV4] 

Benefícios para as empresas:

• Informação centralizada dos serviços;
• Gerenciamento e controle destas operações;
• Identificação da data de início e término do serviço;
• Definição de valores proporcionais dos serviços iniciados antes do prazo inicial do SISCOSERV e que terminarão depois;
• Controle de operações de frete e seguro internacional;
• Classificação NBS (Nomenclatura Brasileira de Serviços) das operações de serviço;

Arquitetura

A integração com o Trade Easy Siscoserv será em arquivo texto com codificação ANSI separado por “;” com extensão “.csv”.[KLM7] [ARV8] 

Foram criadas 9 tabelas de extensão:

Venda:

• item do pedido de venda (ped-item-siscoserv),
• registro de exportação (reg-export-siscoserv),
• item da nota fiscal de saída (nota-export-siscoserv),

Aquisição:

• ordem de compra (ord-compra-siscoserv);
• despesas de importação (despes-import-siscoserv)
• despesas de exportação (despes-export-siscoserv)
• declaração de importação (decla-import-siscoserv)
• item da nota de entrada  (nota-import-siscoserv)
• títulos a pagar (parc-cambiais-siscoserv)

Essas tabelas serão criadas e atualizadas sempre que um desses processos forem movimentados dentro do ERP.

Também foram criados programas para Carga Inicial (cd0045/cd0055) com o objetivo de gerar essas extensões para os registros que já estão na base no momento da implantação.

Os programas de envio (vendas e aquisição) farão a geração dos arquivos “.csv”. Após essa geração, o usuário terá que acessar o sistema Trade Easy e importar as informações do arquivo para o módulo de Siscoserv. Esse processo será todo manual.

Escopo

A gravação dos dados deve ser realizada em todos os pontos em que o ERP atualiza informações de serviços internacionais:

• implantação/atualização do pedido de venda;
• registro de exportação;
• cálculo das notas fiscais/cancelamento;
• pedido de compra
• despesas de importação/despesas de exportação;
• declaração de importação;
• recebimento de documento de entrada/desatualização;
• geração de títulos no contas a pagar

Foram criadas tabelas de extensões para realizar o controle das pendencias de envios para o Siscoserv Trade Easy. Por intermédio dessas tabelas serão filtrados os registros que estiverem pendentes de envio para o módulo de Siscoserv. 

Fluxo de Vendas de Serviços:

Pré-requisitos instalação/implantação/utilização

• Utilizar o ERP Datasul versão 12.1.3 ou superior;
• Acesso ao Trade Easy, módulo Siscoserv.

Instalação/Atualização

Ativação/Desativação da integração

Por padrão a integração vem desativada. Essa ativação/desativação da integração deve ser feita nos programas Manutenção Parâmetros Materiais (CD1001) e Manutenção Parâmetros Distribuição (CD2000), através do campo “Siscoserv Aquisição e “Siscoserv Vendas””, respectivamente.

Controle de Versão

O grupo TOTVS representado por suas marcas irá administrar as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.

Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância das marcas e alinhamento com as diretivas definidas pelo Comitê de Integração TOTVS.

Suporte

O suporte a essa integração é de responsabilidade compartilhada entre TOTVS e Trade Easy. Como no ERP fica somente com a extração dos dados de serviço, sendo no Trade Easy a importação das informações, gestão desses dados disponibilizadas em interfaces do Trade Easy e a integração com o Siscoserv, caso o cliente identifique necessidade de acionar o suporte, essa situação deverá ser realizada para o suporte Trade Easy, que fará o encaminhamento à equipe da TOTVS quando necessário.

Transações/Entidades/Mensagens únicas

Serão enviados para Trade Easy arquivos contendo os layouts:

PROCESSO_VENDA_SERVICO

PROCESSO_VENDA_RES

INVOICE_VENDA_SERVICO

Fluxo das Informações

Para cada fluxo de informação descreva, se necessário, alterações de comportamento que o respectivo produto irá sofrer. Por exemplo: quando o Logix recebe o PEDIDO de OUTRO ERP, este pedido não poderá ser alterado no Logix.

Liste quais as entidades integradas e como é o mapeamento entre as diferentes estruturas. Por exemplo: Classe no sistema A vira categoria no sistema B, o campo X é refletido no campo Y etc.

Liste quais transações/operações a integração fará com as entidades relacionadas. Exemplo: Insert de PEDIDO, Insert, update de ITEM, buscar saldo em estoque do ITEM no dia X ou buscar dados do FUNCIONÁRIO.

Cadastros

Descreva características gerais do fluxo de informações e que serão comuns para este tipo de entidade. Características particulares para cada entidade deverão ser citadas em tópicos específicos de cada entidade.

Sempre que existir (a sugestão é sempre criar) e for agregador ao documento acrescentar aqui os diagramas/imagens ou até mesmo colocar tais diagramas diretamente na especificação dos processos

Em seguida faça uma descrição para cada um dos fluxos para cada entidade

<Transação/Entidade>

Identificador da Mensagem: <mensagem>

Versão: <versão>

Módulo <marca 1>: <BackOffice – Gestão xxxxxxx>

Módulo <marca 2>: <SIGAXXX>

Tipo de Envio: <Assíncrona/Síncrona>

Notas:

Observações sobre comportamento desta mensagem ou dos processos envolvidos nela/para ela

A seguir descrever as variações, particularidades da mensagem e processos (integração) de acordo com cada marca

Limitações/Restrições

Descreva limitações e restrições para a integração que está sendo descrita.

Processos

Descreva características gerais do fluxo de informações e que serão comuns para este tipo de entidade. Características particulares para cada entidade deverão ser citadas em tópicos específicos de cada entidade.

Sempre que existir (a sugestão é sempre criar) e for agregador ao documento acrescentar aqui os diagramas/imagens ou até mesmo colocar tais diagramas diretamente na especificação dos processos

Em seguida faça uma descrição para cada um dos fluxos para cada entidade

<Transação/Processo>

Tipo de Fluxo: Protheus -> RM

Mensagem: Request_1_000

Versão: 1.000

Descrição de todo o comportamento e funcionamento do processo. Breve contexto, origem, regras, integração (geração da mensagem, envio, recebimento no destino), o quê supostamente irá ocorrer no destino, retorno, impacto, consequências, o que foi afetado, como conferir, validar, etc o retorno.

Acrescentar um diagrama do processo.

A seguir descrever as variações, particularidades da mensagem e processos (desta integração) de acordo com cada marca

Notas:

Observações sobre comportamento desta mensagem ou dos processos envolvidos nela/para ela

Limitações/Restrições

Descreva limitações e restrições para a integração que está sendo descrita. 

Limitações / Restrições Gerais

Descreva limitações e restrições para cada fluxo descrito no tópico anterior. Exemplo:

• ERP1 envia ITEM cadastrado para o ERP2

ERP1 somente enviará o ITEM se este estiver em uma das famílias cadastradas no parâmetro FAMILIA_INTEGRACAO.

Se o tipo de valorização do estoque for FIFO.

• ERP2 envia PEDIDO cadastrado para o ERP1

O pedido recebido no ERP1 vindo do ERP2 estará bloqueado para alteração.

Como fazer (opcional)

Descreva os passos que viabilizem a integração.

Exemplo:

Os passos para viabilizar a integração são:

• No Logix ou no Protheus efetue o cadastro das seguintes informações: Clientes, fornecedores, transportadores, cidades, cotação de moeda e unidades de medida.
• No Logix cadastrar um novo depositante e efetuar toda a parametrização necessária para a operação de WMS.
• No Logix cadastrar um novo produto que seja controlado pelo WMS, para o depositante cadastrado anteriormente.
• No Logix efetuar um processo de recebimento para o produto cadastrado anteriormente, utilizando uma nota fiscal provisória (tipo “A”).
• No Protheus consultar a nota fiscal de recebimento que foi registrada no Logix, validando as informações recebidas.
• No Logix efetuar um processamento de regularização fiscal, efetuando a cobertura dos produtos recebidos anteriormente.
• No Protheus verificar se foi efetuado corretamente o relacionamento entre os dois documentos.
• No Logix efetuar um processo de expedição para o novo produto cadastrado, até o momento do envio da mensagem de integração de pedido de venda.
• No Protheus efetuar o faturamento do pedido de venda recebido.
• No Protheus verificar se a nota fiscal gerada contém todas as informações necessárias para o segmento de operador logístico (armazém geral).
• No Protheus efetuar a escrituração fiscal das notas fiscais, verificando se as regras da legislação deste segmento foram respeitadas.
• No Logix é possível consultar o número do pedido de venda gerado para as notas fiscais de retorno simbólico e conta/ordem no programa WMS6333 (Consulta de Documentos). Para os processos de faturamento de serviço o número do pedido está disponível no programa WMS6411 (Movimentos a Faturar).

Situações comuns (opcional)

Descreva situações problemáticas comuns que podem ocorrer durante o funcionamento da integração e como solucioná-los. Neste ponto também é importante dar instruções de como reconhecer e investigar problemas que podem vir a ocorrer durante a integração. Se houver, apresente tabelas de códigos e descrições de erros que a integração poderá apresentar.

Este tópico possivelmente será alimentado com as experiências durante o desenvolvimento da integração e poderá ser realimentado durante o uso da integração no cliente.

Exemplo 1:

Tratamento de erros de integração (Produto A)

Tratamento de erros de integração (Produto B)

Exemplo 2:

Quando uma mensagem é enviada do Logix para o Protheus, podem ocorrer situações em que o WebService não estará totalmente funcional. Nestes casos uma mensagem de erro genérica irá aparecer na tela:

Exemplo:

Erro ao enviar a mensagem de Cidade via Integração

Se o arquivo de log for analisado, poderemos ver a falha na comunicação com o sistema destino:

-------------------------------------------------------------------------------

WSCERR044 / Não foi possível POST : URL http://172.16.31.57:8011/ws/FWWSEAI.apw

ADVPL WSDL Client 1.080707 / tst on 20120315 08:49:51

-------------------------------------------------------------------------------

Para resolver este problema, verifique as configurações do sistema de destino, analisando o funcionamento do servidor utilizado para esta comunicação e a habilitação do endereço do WebService. 

Checklist de suporte da aplicação

Crie um check-list de verificação de alguns pontos importantes para o funcionamento e atendimento da integração.

Instalação/Configuração

Relacione itens de verificação para garantir que a integração está corretamente instalada e configurada. Isto não pode ser uma cópia do procedimento de instalação/configuração, mas verificações pontuais que podem remeter aos itens da instalação.

Checklist de Verificações:

Relacione itens de verificações para que o atendente possa:

• Identificar o funcionamento da integração;
• Identificar a ocorrências de problemas;
• Coletar evidências do mau funcionamento relatado pelo cliente;
• Realizar possíveis ajustes na integração quanto à configuração ou negócio.

PROCESSO_AQUISICAO_SERVICO

PROCESSO_AQUISICAO_SERVICO

PROCESSO_AQUISIÇÃO_SERVICO

PROCESSO_AQUISICAO_DIS

Por item de serviço:

Por despesa de importação:

INVOICE_AQUISICAO_SERVICO

Quando o registro for um item de serviço (cdn-identif = 1) o layout deve ser criado conforme informações abaixo:

Quando o registro for de uma despesa de importação (cdn-identif = 2), o layout deve ser criado conforme informações abaixo:

Quando o registro for de uma despesa de exportação (cdn-identif = 3), o layout deve ser criado conforme informações abaixo:

Fluxo das Informações

Esta integração agrega novas funcionalidades para as áreas de negócios internacionais da empresa (aquisição e venda de serviços).

• Datasul gera o arquivo PROCESSO_VENDA_SERVICO com extensão “csv” através do programa CD0040.
  O programa irá ler a tabela de extensão gerada para o item de serviço. Somente irá gerar o arquivo de layout para o item de serviço que estiver dentro da faixa de seleção e que o pedido não estiver cancelado ou suspenso. No Módulo Easy Siscoserv, será acessada a opção Miscelânea\ Integração\ Arquivo CSV, indicado o caminho e o arquivo com extensão .CSV. O Easy Siscoserv processará a integração.

• Datasul gera o arquivo PROCESSO_VENDA_RES com extensão “csv” através do programa CD0040.
  O programa irá ler a tabela de extensão gerada para o RE. Somente irá gerar o arquivo de layout para os RE´s vinculados a itens de serviço. No Módulo Easy Siscoserv, será acessada a opção Miscelânea\ Integração\ Arquivo CSV, indicado o caminho e o arquivo com extensão .CSV. O Easy Siscoserv processará a integração. 

• Datasul gera o arquivo INVOICE_VENDA_SERVICO com extensão “csv” através do programa CD0040.
  O programa irá ler a tabela de extensão gerada para a nota fiscal. Somente irá gerar o arquivo de layout para as notas que tenham itens de serviço vinculados. No Módulo Easy Siscoserv, será acessada a opção Miscelânea\ Integração\ Arquivo CSV, indicado o caminho e o arquivo com extensão .CSV. O Easy Siscoserv processará a integração. 

• Datasul gera o arquivo PROCESSO_AQUISIÇÃO_SERVICO com extensão “csv” através do programa CD0050.
  O programa irá ler a tabela de extensão gerada para os itens de serviço e as despesas contratadas durante o processo de importação ou exportação. Somente irá gerar o arquivo de layout para os itens cujo pedido de compra está impresso e sem pendencia de aprovação. No Módulo Easy Siscoserv, será acessada a opção Miscelânea\ Integração\ Arquivo CSV, indicado o caminho e o arquivo com extensão .CSV. O Easy Siscoserv processará a integração. 

• Datasul gera o arquivo PROCESSO_AQUISIÇÃO_DIS com extensão “csv” através do programa CD0050.
  O programa irá ler a tabela de extensão gerada para as DI´s vinculadas aos itens de serviço e as despesas internacionais. No Módulo Easy Siscoserv, será acessada a opção Miscelânea\ Integração\ Arquivo CSV, indicado o caminho e o arquivo com extensão .CSV. O Easy Siscoserv processará a integração. 

• Datasul gera o arquivo INVOICE_AQUISIÇÃO_SERVICO com extensão “csv” através do programa CD0050.
  O programa irá ler a tabela de extensão gerada para a nota fiscal. Somente irá gerar o arquivo de layout para as notas que tenham itens de serviço vinculados. No Módulo Easy Siscoserv, será acessada a opção Miscelânea\ Integração\ Arquivo CSV, indicado o caminho e o arquivo com extensão .CSV. O Easy Siscoserv processará a integração. 

• Datasul gera o arquivo CAMBIO_AQUISIÇÃO_SERVIÇO com extensão “csv” através do programa CD0050.
  O programa irá ler a tabela de extensão gerada para os títulos a pagar dos itens de serviços e despesas. Somente irá gerar o arquivo de layout para os títulos gerados pela nota fiscal ou pelas despesas. No Módulo Easy Siscoserv, será acessada a opção Miscelânea\ Integração\ Arquivo CSV, indicado o caminho e o arquivo com extensão .CSV. O Easy Siscoserv processará a integração

Cadastros

Não existe uma integração de cadastro que necessite ser realizada para o funcionamento da integração.

Processos

O SISCOSERV é dividido em dois módulos: Venda e Aquisição. No módulo de Venda existem dois registros principais: RVS (Registro de Venda de Serviços) e RF (Registro de Faturamento). No módulo de Aquisição existem dois registros principais: RAS (Registro de Aquisição de Serviços) e RP (Registro de Pagamento).

O Registro de Venda de Serviço (RVS) consiste no layout onde serão exportados os itens do pedido de venda identificados pela natureza de operação como serviço.

O Registro de Exportação consiste no layout onde serão enviados os RE´s associados a serviços enviados no registro de venda. Pode existir mais de um Registro de Exportação para cada item, nesse caso, deverão ser enviados todos os RE´s relacionados. Essa informação não é obrigatória para o Siscoserv.

O Registro das Invoices da Venda (RF) referem-se a comprovação do pagamento através das notas fiscais da venda do serviço internacional. Para este layout deverão ser consideradas as notas fiscais que pertencem ao item de serviço do pedido de venda.

O Registro de Aquisição de Serviço (RAS) consiste no envio das ordens de serviços vinculadas ao pedido de compra e as despesas de  Importação/Exportação contratadas de fornecedores estrangeiros.

O Registro das Declarações de Importação  consiste no layout onde serão enviadas as DI´s associadas aos serviços e despesas de importação enviados no registro de aquisição. Essa informação não é obrigatória para o Siscoserv.

O Registro das Invoices de Aquisição faz parte do Registro de Pagamento (RP) e referem-se a comprovação do recebimento do serviço através das notas fiscais da compra ou títulos do serviço internacional. Para este layout deverão ser consideradas as notas fiscais que pertencem ao item de serviço do pedido de compra e as despesas que fazem parte da nota.

As despesas que são pagas diretamente por títulos implantados no Contas a Pagar deverão ser registradas manualmente no módulo de Siscoserv do Trade Easy.

O Registro de Parcelas Cambiais devem enviar os pagamentos realizados associado ao Registro das Invoices de Aquisição.

Como fazer

No Datasul acessar o programa de Parâmetros de Materiais e marcar o campo Siscoserv Aquisição. Utilizar normalmente a rotina de compra de serviços, e periodicamente executar o programa de Envio de Aquisições Siscoserv para geração de dados para o módulo Easy Siscoserv. Da mesma forma, acessar o programa de Parâmetros de Distribuição e marcar o campo Siscoserv Vendas. Utilizar normalmente a rotina de vendas de serviços, e periodicamente executar o programa de Envio de Vendas Siscoserv para geração de dados para o módulo Easy Siscoserv.

Situações comuns

A seguir são apresentados algumas situações que podem ser apresentadas no sistema devido a integração com o Trade Easy, com sua respectiva solução:

A extração de informações do ERP para as tabelas temporárias será realizada durante o processo de inclusão, alteração ou exclusão de um serviço internacional. Não haverá nenhum tipo de validação, pois as API´s de vendas e aquisição irão verificar se aquele determinado registro já existe, se existir atualiza, se não existir cria.

O programa que irá exportar as informações para  os arquivos de layout também não irão apresentar mensagens de erro, pois conforme seleção irão fazer a leitura das tabelas de extensão e criar os arquivos.

Somente no momento da importação dessas informações para o sistema da Trade Easy é que pode acontecer de existir algum tipo de rejeição. Nesse caso, é que deve ser analisado qual campo que apresentou problema para que possa ser corrigido. Para regerar o arquivo deve ser seguido os seguintes passos:

• eliminar o registro de extensão no ERP : executar o programa cd0046/cd0056 informando a chave que deve ser excluída.
• executar o programa de carga inicial cd0045/cd0055 para criar novamente o registro. Este programa vai criar um registro novo apenas para serviços que ainda não possuem as tabelas de extensão siscoserv.

Checklist de suporte de aplicação

Para facilitar o suporte a situações da integração, realizar as seguintes verificações: 

• Conferir se a situação reportada pelo cliente está relacionada a alguma parametrização (campos Siscoserv Aquisição ou Siscoserv Vendas marcados);
• Coletar evidências do erro reportado pelo cliente (processo executado, relatório de vendas/aquisições);
• Orientar o cliente do caso de problemas de parametrização. Se necessário encaminhar a situação para ajuste.