Árvore de páginas

Linha de Produto:

Datasul

Módulo:

MEX

Função:

Integração da DU-E com o Portal Único do Siscomex

Nome Físicoexp/exapi026.p

Considerações gerais


Para conhecimento da integração completa da DU-E com o Portal Único do Siscomex, consulte o Documento de Integração.

Objetivo 

Realizar as integrações da DU-E (Declaração Única de Exportação) com o Portal Único do Siscomex. Contempla as ações de:

  • Envio da DU-E para o Siscomex
  • Retificação da DU-E
  • Consulta de situação da DU-E no Siscomex

Funcionamento 

A API deve ser executada de forma persistente. Isso deve ser feito através da chamada de um comando RUN conforme exemplo a seguir.

A sintaxe para executar a API em modo persistente é: 

RUN exp/exapi026.p PERSISTENT SET h-handle.

A variável denominada h-handle irá receber o “handle” do programa, permitindo o acesso aos “métodos” internos da API.

 

Método Negócio 

Quando a API for executada em modo persistente, os seguintes métodos estarão disponíveis para execução: 


executeSendingByDue

Requisito

Possuir uma DU-E cadastrada no sistema (EX7000).

Sintaxe

RUN executeSendingByDue in handle (INPUT <Decimal>,

                                                             OUTPUT <Character>).

Descrição

Realiza a integração de uma DU-E cadastrada no sistema com o Portal Único do Siscomex.

  • Faz validações para garantir a consistência da DU-E antes do envio
  • Realiza a autenticação no Portal Único do Siscomex (através das informações existentes no EX0180 - Pasta "Siscomex")
  • Integra a DU-E com o Portal Único do Siscomex
  • Caso a integração tenha ocorrido com sucesso, atualiza as informações de DU-E Siscomex, RUC e situação da DU-E no ERP
  • Gera um XML com o resultado do processamento (DU-E integrada com sucesso, ou os erros que ocorreram na tentativa de integração com o Siscomex).

Parâmetros

Descrição

pCddDueEms

Número interno da DU-E

pcFilePathCaminho e nome do arquivo gerado que contém o resultado do processamento realizado

Retorno

Caminho e nome do arquivo gerado que contém o resultado do processamento realizado.



executeRectifyByDue

Requisito

Possuir uma DU-E cadastrada no sistema (EX7000).

Sintaxe

RUN executeRectifyByDue in handle (INPUT <Decimal>,

                                                             INPUT <Integer>,

                                                             OUTPUT <Character>).

Descrição

Realiza a retificação de uma DU-E cadastrada no sistema no o Portal Único do Siscomex.

  • Faz validações para garantir a consistência da DU-E antes do envio
  • Realiza a autenticação no Portal Único do Siscomex (através das informações existentes no EX0180 - Pasta "Siscomex")
  • Envia a retificação da DU-E para o Portal Único do Siscomex
  • Caso a integração tenha ocorrido com sucesso, atualiza a situação da DU-E no ERP
  • Gera um XML com o resultado do processamento (DU-E integrada com sucesso, ou os erros que ocorreram na tentativa de integração com o Siscomex).

Parâmetros

Descrição

pCddDueEms

Número interno da DU-E

pNumVersaoDUEVersão da DU-E
pcFilePathCaminho e nome do arquivo gerado que contém o resultado do processamento realizado

Retorno

Caminho e nome do arquivo gerado que contém o resultado do processamento realizado



updateDueStatus

Requisito

Possuir uma DU-E cadastrada no sistema (EX7000).

Sintaxe

RUN updateDueStatus in handle (INPUT <Decimal>,

                                                      INPUT <Integer>,

                                                      OUTPUT <Character>).

Descrição

Realiza a consulta de uma DU-E cadastrada no sistema no o Portal Único do Siscomex.

  • Faz validações para garantir a existência da DU-E e número DU-E Siscomex
  • Realiza a autenticação no Portal Único do Siscomex (através das informações existentes no EX0180 - Pasta "Siscomex")
  • Faz a consulta da DU-E no o Portal Único do Siscomex
  • Caso a integração tenha ocorrido com sucesso, atualiza a situação da DU-E no ERP
  • Gera um XML com o resultado do processamento (DU-E atualizada com sucesso, ou os erros que ocorreram na tentativa de consulta no Siscomex).

Parâmetros

Descrição

pCddDueEms

Número interno da DU-E

pNumVersaoDUEVersão da DU-E
pcFilePathCaminho e nome do arquivo gerado que contém o resultado do processamento realizado

Retorno

Caminho e nome do arquivo gerado que contém o resultado do processamento realizado



generateXMLFile

Requisito

Possuir uma DU-E cadastrada no sistema (EX7000).

Sintaxe

RUN generateXMLFile in handle (INPUT <Decimal>,

                                                      OUTPUT <Character>).

Descrição

Realiza a geração de XML de integração com o Portal Único do Siscomex, de uma DU-E cadastrada no sistema.

  • Faz validações para garantir a consistência da DU-E antes da geração
  • Gera um XML com o resultado do processamento (DU-E integrada com sucesso, ou os erros que ocorreram na tentativa de integração com o Siscomex).
  • Gera o XML de integração da DU-E no diretório informado no EX0180 (Pasta "Siscomex").
  • Gera um XML com o resultado do processamento no diretório temporário da sessão.

Parâmetros

Descrição

pCddDueEms

Número interno da DU-E

pcFilePathCaminho e nome do arquivo XML gerado

Retorno

Caminho e nome do arquivo XML gerado