|
Este artigo aplica-se a: |
Sage X3 |
Versão: |
|
|
Domínio: |
Distribuição |
|
|
Problema / Sumário
Pretende-se descrever como resolver os erros na comunicação AT via WebService.
Descrição da Solução / Detalhes
Na comunicação de guias de transporte e de faturas à AT podem ocorrer diversos erros. Neste documento pretende-se identificar as causas dos erros mais comuns.
- Erro ao abrir conexão com o Servidor Java Bridge
Verificar se o componente Java Bridge Server se encontra instalado e com o serviço iniciado.
- Erros emitidos pelo servidor distante:
Verificar se os Bundles utilizados são os mais recentes e estão na diretoria correta:
- O utilizador da AT não se encontra definido
Deve existir um utilizador corretamente definido no parâmero geral USRCOMAT. Este parâmetro pertence ao capítulo LOC, grupo POR (definido ao nível da sociedade):
- Senha inválida
Verificar se o utilizador que está parametriza no parâmetro geral USRCOMAT está registado na AT. O utilizador que está parametrixado no X3 para comunicar com a AT deve ter a mesma palavra passe que o subtilizador definido no portal das finanças.
Nota: A partir do PU8 a password considerada não é a que o utilizador utiliza para entrar na aplicação (Syracuse), mas sim a que está definida ao nível do dossier (modo clássico).
Para verificar se a palavra passe está bem definida ao nível do X3:
- Entrar com o utilizador usado para fazer a comunicação dos documentos de transporte (definido no parâmetro geral);
- Ir à função Modificação palavra-chave (Exploração-> Utilizadores ->...);
- Mudar a palavra passe do X3 para a que está definida no utilizador do site da AT. No caso de apenas ter definido palavra passe ao nível do Syracuse deixe o campo 'Palavra-chave antiga' em branco e defina a nova palavra-chave.
A palavra passe não deve exceder os 10 caracteres.
- Senha não preenchida:
O utilizador do X3 utilizado na comunicação AT deve ter a password definida.
- http transport error
Verificar a ligação à internet.
- Erro validade da credencial expirada
Trata-se de um problema relacionado com o facto de o servidor não estar com a data\hora de sistema devidamente atualizada. O documento de implementação da comunicação de documentos de transporte recomenda a sincronização com o observatório astronómico de Lisboa.
- Connection timed out
Este erro indicia que não é possível estabelecer uma conexão com o web service devido a segurança na rede informática em questão. Verificar definições de proxy servers, firewall, etc.
- Remote host closed connection during handshake
Problema com os certificados utilizados. Verificar que se está a usar os certificados mais recentes. (Para PU9 ou anterior. V11 os certificados são disponibilizados em patch)
- Erro "statusCode":"500","message":"env:Client: Internal Error" (V11)
Este erro está geralmente associado ao encoding das descrições que vão na comunicação.
Estas descrições podem ser: endereços, descrição artigo, nome cliente, nome sociedade, nome estabelecimento.
Para solucionar pode ser suficiente reescrever o texto. Para as guias já criadas será necessária a alteração nas tabelas SDELIVERY e SDELIVERYD.
Este problema pode acontecer quando as descrições são feitas por cópia do texto a partir de ficheiros de texto (.doc, .txt, etc...).
- Erro Unexpected token (V11)
Este erro está normalmente associado aos mesmos motivos do ponto 10.
- Erro chave de pedido não preenchida (código 20)
Este erro está relacionado com os certificados utilizados. Verificar se estão a ser utilizados os certificados mais recentes, inclusivamente o certificado da chave publica. (na V11 é disponibilizado através de patch)
- Erro chave pública inválida
Certificado de chave pública desatualizado. Na V11 é disponibilizado em patch (disponível no portal mySage) e no PU9 é disponibilizado no ficheiro saPubKey.jks (também disponível no portal mySage).
- Erro socket hang up
Este erro está relacionado com o facto de estar a fazer a comunicação em modo de testes (parâmetro geral TSTCOMAT a ‘sim’) e não ter o certificado para o efeito.