Páginas filhas
  • Integração Declaração Única de Exportação (Datasul)

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

INTEGRAÇÃO EXPORTAÇÃO (DATASUL) X DECLARAÇÃO ÚNICA DE EXPORTAÇÃO (SISCOMEX)

Contexto de negócio (Introdução)

No novo processo de exportação, a operação tem por base a DU-E (Declaração Única de Exportação), que substituirá os atuais: Registro de Exportação (RE), Declaração de Exportação (DE)  e Declaração Simplificada de Exportação (DSE).

A DU-E é o documento eletrônico que compreende informações de natureza comercial, administrativa, aduaneira, fiscal e logística que caracterizam a operação de exportação das mercadorias nela contidas.

A emissão da Nota Fiscal Eletrônica (NF-e) correspondente à exportação será pré-requisito para a elaboração da respectiva DU-E (ressalvadas algumas exceções). De posse da chave de acesso de cada uma das notas fiscais, o exportador ou responsável pela declaração, já habilitado no cadastro de intervenientes do Siscomex, elaborará a DU-E.

A integração do módulo de Exportação do produto Datasul com o Siscomex tem como objetivo automatizar a geração e integração da DU-E com o sistema do Portal Único Siscomex.


Sistemas Envolvidos

  • Módulo de Exportação do produto Datasul: Será o responsável pela criação da DU-E, consistência de alguns dados e integração da mesma com o Portal Único do Siscomex;
  • Portal Único do Siscomex: Responsável pelo recebimento, validação e registro da DU-E. 

Integração

Conforme portaria instituída em conjunto entre a Receita Federal do Brasil (RFB) e a Secretaria de Comércio Exterior (SECEX), a  DUE substituirá o Registro de Exportação (RE), sistema atualmente utilizado para a realização de exportações. 

A partir de julho de 2018, exportações deverão ser realizadas exclusivamente por meio do Novo Processo de Exportações do Portal Único de Comércio Exterior.  

O Portal Único do Siscomex disponibiliza uma forma para registro da DU-E diretamente no site, porém muitos dos exportadores possuem um volume grande de notas fiscais e informações a serem inseridos em uma DU-E, tornando o processo de cadastro manual moroso e em alguns casos até mesmo inviável. Em função desta necessidade que surgiu a integração do módulo de Exportação do produto Datasul com o Siscomex. O objetivo principal é agilizar e automatizar a geração da DU-E através da utilização das informações existentes no ERP e após elaborada, integrá-la com o Portal Único do Siscomex. Obs.: Se a elaboração estiver a cargo do despachante, o processo não será alterado.

Os serviços disponibilizados pelo Portal Único do Siscomex seguem o mesmo protocolo de acesso, baseado no padrão SSL/TLS e no uso de um certificado digital. A API do Portal foi desenvolvida baseada na arquitetura REST e trabalha com os formatos XML e JSON, sendo que alguns serviços serão disponibilizados exclusivamente no formato XML. Dessa forma, a integração desenvolvida segue essas especificações para que seja possível conectar o ERP ao Portal Único do Siscomex.


Escopo

A integração da DU-E com o Siscomex está sendo desenvolvida e entregue de forma incremental. A primeira versão contempla o cadastro da DU-E no ERP, através de alguns facilitadores para geração dos dados necessários para registro e a integração individual da mesma com o Portal Único do Siscomex. Alguns itens ainda não estão disponíveis nesta primeira versão, eles são detalhados na sequência.

Para as próximas entregas, estão previstos os seguintes itens:

  • Consulta/Atualização da situação da DU-E conforme andamento no Portal Único do Siscomex;
  • Relacionamento de Notas Referenciadas e envio das mesmas para o Siscomex;
  • Tratamento de Retificação da DU-E;
  • Integração em lote de DU-E;
  • Desvinculação de Nota Fiscal de DU-E cancelada;

Fora do escopo:

  • Cadastro e integração de DU-E manual com o Siscomex (ou seja, DU-E sem notas fiscais);

No caso de dúvida sobre o escopo da integração e/ou necessidade diferenciada para sua empresa, favor entrar em contato com a equipe de produto. 


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

  • Aquisição de certificado digital: Para integração com o Siscomex é necessário possuir um certificado digital válido, do tipo A1;
  • A conexão para validação do certificado será realizada de forma direta via webservice com conectores utilizando a linguagem .Net. Com isso o servidor utilizado para integração deverá utilizar o sistema operacional Windows;
  • Versão mínima do produto: 12.1.21. Para versões anteriores, solicitar diretamente para equipe de produto.

Instalação/Atualização

  • Preenchimento dos dados de "Siscomex" nos parâmetros de exportação: Para configuração desta integração, existe uma nova pasta na rotina Parâmetros de Exportação (EX0180), denominada "Siscomex". Os dados desta pasta devem ser preenchidos para cada estabelecimento que se deseja realizar a integração de DU-E;
  • Preenchimento do código ISO 4217, referente às moedas: Para a integração da DU-E com o Siscomex, as moedas devem ser enviadas com o código ISO 4217, dessa forma, deve-se preencher esta informação da rotina Manutenção Moedas (CD0914);
  • Preenchimento do código ISO 3166-2, referente aos países: Para a integração da DU-E com o Siscomex, os países devem ser enviados com o código ISO 3166-2, dessa forma, deve-se preencher esta informação da rotina Manutenção País (CD0181);
  • Cadastro de Recinto Aduaneiros: Na nova rotina "Cadastro Recinto Aduaneiro" (CD2595) é necessário realizar o cadastro dos recintos aduaneiros que serão utilizados para cadastro da DU-E. Consultar os códigos no site da Receita (https://www35.receita.fazenda.gov.br/tabaduaneiras-web/private/pages/telaInicial.jsf - Recinto Aduaneiro) .

Controle de Versão

A integração disponibilizada segue o layout XSD da DU-E disponibilizado no Portal Único do Siscomex até maio/2018 (https://val.portalunico.siscomex.gov.br/docs/api/xsd/xsd-due.zip), considerando a operação de Inserir, do modelo de DU-E com nota fiscal eletrônica . Alterações neste modelo demandam desenvolvimento por parte da equipe de produto TOTVS, que precisam adequar o produto à alterações ou novas informações.


Suporte

O suporte a esta integração é de responsabilidade  da equipe TOTVS (módulo de Exportação).


Transações/Entidades/Mensagens únicas

Atualmente a integração conta com a troca de uma única mensagem entre o ERP e o Sistema Único do Siscomex, para a operação de criação da DU-E no Siscomex.

A mensagem segue o formato disponibilizado em (https://val.portalunico.siscomex.gov.br/docs/api/xsd/xsd-due.zip) até maio/2018.


O ERP envia a DU-E que é consistida pelo Portal Único do Siscomex. Se estiver OK, ele registra a DU-E e retorna para o ERP:

  • Código da DU-E no Siscomex;
  • Código RUC (Referência Única da Carga);

No caso de consistência do Siscomex, elas são apresentadas ao usuário, que deve realizar os ajustes e enviar a DU-E para registro novamente.

Fluxo das Informações


Registro da DU-E no Siscomex:

Conforme já citado nos tópicos anteriores, o registro da DU-E ocorre da seguinte forma:

  • A DU-E deve ser cadastrada no ERP (através da rotina Declaração Única de Exportação - EX7000);
  • Assim que estiver concluída, o usuário deve enviá-la para o Portal Único do Siscomex (opção na rotina EX7000);
  • Se aceita pelo Portal, a DU-E é registrada e recebe um código da DU-E e também um código RUC (Referência Única de Carga);
  • Esses dois códigos são retornados para o ERP e atualizados na DU-E. A partir deste momento a DU-E tem sua situação atualizada de "Não Integrada" para "Em elaboração" e não é mais permitida a sua alteração através do ERP.

Para Consulta de situação da DU-E, Retificação e Cancelamento consultar o tópico: "Como fazer".


Cadastros

No caso desta integração não existe envio/recebimento de cadastros individualmente, todas as informações necessárias são enviadas diretamente na DU-E. Apenas é necessário atualizar/cadastrar corretamente as entidades citadas na parte de instalação/atualização: 

  • Manutenção Moedas (CD0914):
  • Manutenção País (CD0181);
  • Cadastro Recinto Aduaneiro (CD2595);

Outras entidades que são utilizadas no cadastro da DU-E:

  • Manutenção Estabelecimentos (CD0403);
  • Manutenção Unidade Receita Federal (CD2557);
  • Cadastro de Incoterms (CD2554);
  • Enquadramento de Operação (CD2553);
  • Manutenção Classificação Fiscal (CD0603);

Processos

Detalhes do processo de integração serão detalhados no tópico "Como fazer", apresentado na sequência.

Alguns pontos importantes:

  • Regra para vínculo de Notas Fiscais em uma DU-E:
    • Emitente deve ser estrangeiro ou trading;
    • Natureza de operação deve iniciar com 7 (ou seja, ser de saída para o exterior);
    • Chave de acesso da NF-e deve estar informada;
    • Nota fiscal eletrônica deve estar com: Uso autorizado;
    • Não pode estar cancelada;
    • Não pode ter sido devolvida;
    • Não pode estar vinculada em outra DU-E;
    • Precisa ter um pedido de venda;
    • Deve ter a mesma moeda que a DU-E;
  • Quando é vinculada uma nota fiscal a uma DU-E, os itens da DU-E são gerados com base nas informações desta nota/processo de exportação (se houver):
    • A sugestão do VMCV é feita da seguinte forma:
      • xxxxxxxxxxxx
    • A sugestão do VMLE é feita da seguinte forma:
      • xxxxxxxxxxxx
    • O destaque é sugerido caso haja apenas um destaque informado para a classificação fiscal do item da nota;
    • A sugestão da unidade estatística é feita da seguinte forma: 
      • xxxxxxxxxxxxx

Limitações / Restrições Gerais

  • Utilização de sistema operacional Windows, em função do uso de bibliotecas .NET no desenvolvimento da parte de conexão;
  • Cada DU-E pode ter o máximo de 999 itens, caso haja necessidade de mais itens, deverá ser gerada nova DU-e;

Como fazer

Cadastro e integração de DU-E com o Siscomex: 

Para cadastrar e integrar uma DU-E com Siscomex, deve-se seguir os seguintes passos:

Obs.: Garantir que os pré-requisitos estejam atendidos e os itens de instalação/atualização já tenham sido realizados.

  • No Datasul, acessar a rotina Declaração Única de Exportação (EX7000);
  • Cabeçalho da DU-E:
    • Pressionar o botão "Incluir nova ocorrência":
      • Será gerado automaticamente um número interno para DU-E (este não precisa ser alterado);
      • Preencher as demais informações referente ao cabeçalho da DU-E (Pastas: Geral, Loc Despch, Loc Embarq e Complem);
      • Pontos importantes: 
        • O CNPJ/CPF do Declarante será sugerido conforme os parâmetros de exportação (EX0180) para o estabelecimento da DU-E;
        • Os dados de Responsável da aba "Geral" são sugeridos conforme usuário logado (nome e e-mail) e fornecedor do estabelecimento (telefone). Eles somente serão obrigatórios e enviados para o Siscomex caso algum item da DU-E esteja sujeito à verificação estatística da Secex.
      • Salvar o registro;
  • Vínculo de Notas na DU-E:
    • Acessar a pasta "Notas" da DU-E:
      • Pressionar o botão "Relacionar":
        • Caso ainda não tenha sido informado nada no "Facilitador de preenchimento de itens" (EX7000C), será aberta esta rotina para preenchimento das informações. Como o sistema não tem da onde sugerir esses dados para geração dos itens, caso o usuário informe nesta tela, esses dados serão utilizados na geração dos itens, não sendo necessário o preenchimento manual. Obs. Esta rotina (EX7000C) também está acessível através da tela principal da DU-E e pode ser acessada a qualquer momento para replicar as informações para os itens, se necessário;
        • Na sequência será aberto o filtro de Notas Fiscais, para que o usuário informe os parâmetros para busca das notas fiscais que deseja vincular na DU-E;
        • Confirmado o filtro, são apresentadas as notas fiscais disponíveis para vínculo nesta DU-E, conforme filtro informado e regra de vínculo de notas fiscais (apresentada no tópico "Processos");
        • Escolher as notas e vincular na DU-e com a utilização dos botões "Vincula Nota" ou "Vincula Todas";
        • As notas fiscais já vinculadas a DU-E são apresentadas na parte "Notas Fiscais Vinculadas";
        • Quando é feito o vínculo de uma nota fiscal em uma DU-E, os itens da DU-E são gerados com base nos itens da nota fiscal;
  • Manutenção de Itens da DU-E:
    • Caso haja necessidade de alteração ou inclusão de dados nos itens da DU-E que foram gerados:
      • Acessar a pasta "Itens DU-E", selecionar o item e pressionar o botão "Modificar":
        • Alterar as informações necessárias;
        • Se for necessário inserir dados de Drawback, deve ser informado pelo menos um enquadramento de Drawback e então preencher os dados na pasta "Drawback";
        • Caso o item exija alguma Licença, Permissão, Certificado ou Outros, esses dados devem ser informados na pasta "LPCO";
        • Na pasta "Justificativa" somente deve ser informado algo se o item em questão estiver sujeito a verificação estatística no Secex.
  • Enviar a DU-E para o Siscomex:
    • Para envio da DU-E para o Siscomex, no cabeçalho no EX7000, pressionar o botão "Envio/Consulta da DU-E para Siscomex";
    • Neste momento serão feitas algumas consistências no ERP e estando tudo OK a DU-E é enviada para o Siscomex;
      • O XML de envio da DU-E pode ser armazenado localmente (para futuras conferências/suporte). Esta configuração fica nos parâmetros de exportação (EX0180);
      • O Siscomex também faz as consistências pertinentes ao sistema deles e registra a DU-E caso esteja tudo OK:
        • Caso a DU-E seja registrada com sucesso, é retornado para o ERP o código da DU-E no Siscomex e código do RUC, ambos são atualizados no sistema e podem ser consultados no EX7000. A partir do momento que a DU-E se encontra integrada com o Siscomex, não são mais permitidas alterações no ERP;
        • No caso de erros é gerado um arquivo de log, que é aberto em tela com o detalhamento do que ocorreu. O usuário deve ajustar e enviar novamente a DU-E para o Siscomex. 


Consulta de situação da DU-E

  • De posse do código da DU-E, acessar diretamente o Portal Único do Siscomex e consultar a situação atual da mesma.

Retificação de DU-E:

  • De posse do código da DU-E, acessar diretamente o Portal Único do Siscomex e retificar as informações necessárias.

Cancelamento de DU-E:

  • De posse do código da DU-E, acessar diretamente o Portal Único do Siscomex e realizar o cancelamento da DU-E.

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)


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. 

 

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.