tutorial do sistema ce mercante

TUTORIAL DO SISTEMA CE MERCANTE
Atualizado em:
06/2013
Atualizado por:
Amilton José dos Santos Junior
Versão:
1.0
Tutorial de Atualização do Site - Bysoft
BYSOFT - Soluções em Sistemas para Comércio Exterior
Rua Muniz de Sousa, 591 – Aclimação – São Paulo – CEP 01534-000 | +55 11 3585-6000
1
Tutorial de Atualização do Site - Bysoft
BYSOFT - Soluções em Sistemas para Comércio Exterior
Rua Muniz de Sousa, 591 – Aclimação – São Paulo – CEP 01534-000 | +55 11 3585-6000
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
Tutorial de Atualização do Site - Bysoft
BYSOFT - Soluções em Sistemas para Comércio Exterior
Rua Muniz de Sousa, 591 – Aclimação – São Paulo – CEP 01534-000 | +55 11 3585-6000
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
Tutorial de Atualização do Site - Bysoft
BYSOFT - Soluções em Sistemas para Comércio Exterior
Rua Muniz de Sousa, 591 – Aclimação – São Paulo – CEP 01534-000 | +55 11 3585-6000
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
Tutorial de Atualização do Site - Bysoft
BYSOFT - Soluções em Sistemas para Comércio Exterior
Rua Muniz de Sousa, 591 – Aclimação – São Paulo – CEP 01534-000 | +55 11 3585-6000
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
Tutorial de Atualização do Site - Bysoft
BYSOFT - Soluções em Sistemas para Comércio Exterior
Rua Muniz de Sousa, 591 – Aclimação – São Paulo – CEP 01534-000 | +55 11 3585-6000
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
Tutorial de Atualização do Site - Bysoft
BYSOFT - Soluções em Sistemas para Comércio Exterior
Rua Muniz de Sousa, 591 – Aclimação – São Paulo – CEP 01534-000 | +55 11 3585-6000
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
Tutorial de Atualização do Site - Bysoft
BYSOFT - Soluções em Sistemas para Comércio Exterior
Rua Muniz de Sousa, 591 – Aclimação – São Paulo – CEP 01534-000 | +55 11 3585-6000
8
Tutorial de Atualização do Site - Bysoft
BYSOFT - Soluções em Sistemas para Comércio Exterior
Rua Muniz de Sousa, 591 – Aclimação – São Paulo – CEP 01534-000 | +55 11 3585-6000