INTEGRAÇÃO IMPORTAÇÃO (DATASUL) X DESPACHANTE
O Despachante Aduaneiro é um profissional responsável pelos procedimentos legais e administrativos, visando a entrada (importação) e a saída (exportação) de mercadorias no Brasil.
Este profissional representa os importadores e exportadores perante aos diversos órgãos governamentais e demais intervenientes do comércio exterior, tais como: Receita Federal, empresas de logística, bancos e portos.
As operações aduaneiras no Brasil são complexas e regidas por diversas normas e em muitas delas, um simples descuido leva ao interessado uma sanção pecuniária. É neste contexto, de evitar o erro e fazer cumprir a norma aduaneira, que está inserido o despachante aduaneiro.
A integração entre o ERP Datasul e o sistema do despachante tem como objetivo facilitar o fluxo das informações, com intuito de agilizar o processo e reduzir erros de digitação.
Existem clientes da linha Datasul que utilizam os serviços de despachante aduaneiro e não conseguem enviar as informações envolvidas na importação em um único arquivo. São enviados vários documentos ao despachante, que precisa fazer a entrada dessas informações no seu sistema de forma manual. Acontece a mesma coisa no retorno das informações do despachante para o importador.
Por meio dessa integração será possível realizar a geração e envio dessas informações de importação em um único arquivo TXT, assim como o posterior recebimento das informações do despachante.
Possibilitar a integração entre despachante e importador, para envio e recebimento das informações envolvidas no processo de cadastramento de uma DI (Declaração de Importação) no SISCOMEX.
O processo consiste em: o IMPORTADOR gera o arquivo TXT com a DI EMS e seus embarques vinculados e envia para o despachante. O DESPACHANTE utiliza a opção de seu sistema para importar essas informações. Após finalizar o desembaraço da mercadoria, o despachante envia informações da Declaração de Importação elaborada no Siscomex para o importador em arquivo TXT. O IMPORTADOR atualiza as informações da DI no ERP e gera a nota fiscal.
1. Envio de informações para cadastro da DI
2. Recebimento de despesas (antecipações)
3. Recebimento da DI (com despesas efetivas)
4. Recebimento de valores da DI
Configurações Iniciais
1. Executar o programa de Carga e Conferencia de Dados (CD0323), opção Integração DI com Despachante, onde será disponibilizada as seguintes opções:
2. Executar o programa de Parâmetros de Importação (IM0000), pasta Siscomex, marcar parâmetro Integração com Despachante.
Executar a rotina DE-PARA com as informações dos intervenientes de importação e das despesas e impostos geradas pelo ERP Datasul.
Evoluções dos layouts demandam desenvolvimento por parte da equipe de produto TOTVS, que precisa adequar o produto à alterações ou novas informações.
O suporte a esta integração é de responsabilidade da equipe TOTVS (módulo de Importação).
Atualmente a integração conta com a troca de arquivos TXT entre o ERP e o sistema do despachante.
Os arquivos seguem o layout disponibilizado em XXXXX.
A DI deve ser cadastrada no ERP (através da rotina Declaração de Importação - IM0400);
Assim que estiver concluída, deve ser realizada a exportação das informações da DI, que poderá ser para uma faixa de DI´s, para envio para o despachante. O layout do arquivo gerado para envio será em formato TXT (rotina de Envio DI Despachante - IM0470). O envio será realizado por e-mail a partir do próprio programa IM0470 ou posteriormente de forma manual.
O despachante fará o processamento do arquivo para o seu sistema e enviará para o importador uma solicitação de adiantamento com as despesas a serem antecipadas. Este arquivo vem também em formato TXT.
Enquanto o módulo de Importação não trata antecipações, o programa fará a geração de um relatório com as despesas a serem lançadas manualmente no Contas a Pagar, permitindo que o envio de e-mail notificando um determinado usuário sobre essa pendencia.
O despachante envia ao importador os dados da DI registrada no SISCOMEX e também as informações das despesas efetivas. Esse documento também é recebido em formato TXT e por e-mail.
O sistema valida as informações vindas no arquivo e importa para o ERP caso esteja consistente
Enquanto não houver nota gerada no recebimento para a DI, as despesas serão gravadas no ponto de controle “Nacionalização” do programa de Manutenção da Declaração de Importação (IM0400), pasta Despesas.
Quando executada novamente a importação do arquivo, for identificado que a DI já está “Registrada” e a Nota Fiscal já existir no recebimento, estas despesas serão gravadas no ponto de controle “Complementar” do programa de Manutenção da Declaração de Importação (IM0400), pasta Despesas.
O despachante gera a simulação da nota fiscal com base no que foi registrado na DI do Siscomex e envia ao importador;
Esse documento também é recebido em formato TXT por e-mail.
No processamento desse arquivo, o sistema valida as informações vindas no arquivo e importa para o ERP caso esteja consistente;
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>
Mensagem Padrão | PROTHEUS | RM | ||
Tabela | Campo | Tabela | Campo | |
Code | CTO990 | CTO_SIMB | GMOEDA | SIMBOLO * |
Description | CTO990 | CTO_DESC | GMOEDA | DESCRICAO |
Symbol | CTO990 | CTO_SIMB | GMOEDA | SIMBOLO |
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.
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.
Descreva limitações e restrições para cada fluxo descrito no tópico anterior. Exemplo:
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.
O pedido recebido no ERP1 vindo do ERP2 estará bloqueado para alteração.
Descreva os passos que viabilizem a integração.
Exemplo:
Os passos para viabilizar a integração são:
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)
Erro | Mensagem | Solução |
Código do erro | Mensagem exibida | Ação a ser tomada para resolução do erro. |
Tratamento de erros de integração (Produto B)
Erro | Mensagem | Solução |
Código do erro | Mensagem exibida | Ação a ser tomada para resolução do erro. |
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.
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: