TUTORIAL DO SISTEMA CE MERCANTE Atualizado em: 06/2013 Atualizado por: Amilton José dos Santos Junior Versão: 1.0
1
Sistema desenvolvimento para auxiliar as Comissárias de Despacho, Agentes de Carga e Despachantes Aduaneiros, que necessitam ser informadas quando um Conhecimento de Embarque CE for registrado no sistema do Mercante. Notifica os responsáveis pela área operacional (agenciamento de cargas), de maneira automatizada através de e-mail, referente aos Conhecimentos de Embarque - CE que estão sendo registrados no Sistema do Mercante. Efetua consultas automáticas dos novos Conhecimentos de Embarque ao sistema Mercante, em tempo real. RECURSOS DISPONÍVEIS Consulta automatizada dos Conhecimentos de Embarque - CE, logo após seu registro dentro do sistema do Mercante. Emissão da notificação via e-mail ao Departamento ou responsáveis pelo processo, contendo cada Número de CE no corpo do próprio e-mail. Tela de log das consultas que são realizadas, com data e hora da execução, alertando se houveram novos Conhecimentos Registrados e se foram enviados e-mails de notificação. Permite a integração a sistemas legados, já que faz leitura de arquivos contendo CNPJ, período, portos, etc, que são utilizados como filtro no momento de consultar o sistema do mercante. Seu sistema poderá gerar esses arquivos de filtros para consultas específicas, ou você mesmo deixar pré configurados. Para consultas, não é necessário informar períodos, basta informar quantos dias deseja subtrair ou somar à data atual (obtida automaticamente a cada dia). BENEFÍCIOS Envia consultas manuais ao Mercante para captura de de dados e informações, reduzindo erros de digitação complementar e otimizando o tempo dos operadores. Redução de custos para sua empresa. Agilidade no atendimento, uma vez que terá acesso mais rápido aos Conhecimentos registrados. Não requer instalação, necessita apenas de uma máquina com qualquer Sistema Operacional (Modo Gráfico), Navegador (Browser) e acesso a internet. 2
Requisitos para o Sistema: Este é o aplicativo. Um único arquivo (.jar) executável (Basta dar duplo click nele) Não requer instalação nem banco de dados. Necessita da instalação comum (JRE) do Java 6 ou superior. *Essa instalação pode ser aquela que o próprio navegador instala quando se deseja executar aplicativos em Java. 3
Ele fará uso do Internet Explorer para fazer suas consultas pois o sistema Mercante do governo só funciona com este navegador. Tela principal com 3 opções: - Iniciar (iniciar consultas automáticas a cada x minutos); - Cancelar Interação (Parar consultas); - Parâmetros (configurar o sistema); Tela de Parâmetros: Intervalo (min) - Intervalo em minutos entre uma execução e outra; Diretório Consulta - Diretório onde estarão os arquivos com parâmetros da consulta (CNPJ do cliente, período desejado, portos e etc); Diretório Retorno - Diretório de retorno, onde serão armazenados os números de CE já consultados; URL Mercante - URL do site do Mercante; Hostname Mail - Hostname do servidor de e-mail que enviará e-mails de notificação; 4
From Nome E-mail que irá aparecer nos e-mails enviados; From e-mail - Conta de e-mail de onde serão enviados; Usuário (Mail) - Usuário da conta de e-mail; Senha (Mail) - Senha da conta de e-mail; Porta SMTP (Mail) Servidor de Autenticação de E-mails; Assunto (Mail) - Assunto a ser enviado nos e-mails; To Nome (Mail) E-mail a aparecer no To dos e-mails enviados; To e-mails (Mail) Grupo de destinatários separados por (;) ponto e vírgula; Usar Primeiro Certificado - Quando marcado, o sistema irá utilizar o primeiro certificado que encontrar instalado no navegador. Quando não, irá aguardar o usuário selecionar um certificado; SSL (Mail) - Marcar caso a conta de e-mail utilize protocolo SSL TLS (Mail) - Marcar caso a conta de e-mail utilize protocolo TLS 5
Modelos de arquivo de entrada para consultas (arquivo a ser colocado no Diretório Consulta ): O arquivo é no formato XML, podendo ser gerado por aplicações externas 1. O arquivo Consulta_1.xml possui data nas tag datainicio e datafim, isto indicará ao sistema de consulta que ele deverá usar tais datas para início e fim. Para este caso, o sistema vai apagar este XML da pasta após realizar a consulta com estes parâmetros, pois a referencia seria datas fixas. 2. O arquivo Consulta_2.xml possui número inteiro ao invés de data nas tag datainicio e datafim, isto indicará ao sistema de consulta que ele deverá pegar a Data Atual do dia e subtrair x dias para Data início e somar x dias para Fim. No exemplo ilustrado no print, se hoje for dia 05/05/2013, o sistema faria a consulta de 04/05/2013 a 06/05/2013. Para este caso, o sistema vai manter este XML na pasta. Desta maneira esta consulta acontecerá sempre que ele executar a cada x minutos (configurado nos parâmetros) 6
Observação Importante! Caso o cliente deseje fazer a consulta para diversos consignatários ele deve ter em sua estrutura arquivos Consulta_1.xml, Consulta_2.xml, Consulta_3.xml,.. respectivamente configurados para cada CNPJ e PORTO, que será consultado. Dica Útil: Caso seja necessário configurar os parâmetros do CE Mercante em outros equipamentos o mesmo poderá ser feito através do arquivo, que fora criado no perfil de usuário em que o aplicativo fora configurado pela primeira vez. Para localizar o arquivo configmercante.properties no perfil do usuário digite em Iniciar a seguinte linha de comando: %Userprofile% 7
8