Posso enviar e receber documentos sem certificado?
Não. Para enviar e receber documentos, é necessário possuir um certificado/selo digital que comprove a legalidade desses documentos.
Posso ser notificado sempre que recebo encomendas ou faturas de outras entidades?
A YET permite que, para cada tipo de documento e cada entidade emissora, seja possível definir o recetor do PDF por email com a informação da encomenda/fatura.
Para isso, deverá criar um ticket no portal My YetSpace solicitanto essa ativação
Onde insiro o número de encomendas nas faturas no FLEX?
Deverá indicar no campo N.º de Encomendas (ou N.º do Pedido de Compra) disponível no separador Documento do portal FLEX.
Inseri o meu email em CC, mas não recebo as faturas que são enviadas por EDI. Porquê?
A funcionalidade do envio com cópia (CC) apenas está disponível em PDF.
Posso anexar um ficheiro ao envio de uma fatura eletrónica?
Sim. Para tal, deverá:
Gravar o documento em Rascunhos;
Editar o rascunho e adicionar o anexo no separador Anexos;
Ativar a opção Exportar em Transações Eletrónicas.
Posso personalizar o endereço de envio dos documentos?
Sim. Para personalizar o endereço de envio dos documentos, siga os seguintes passos:
Aceder ao portal MyYetSpace;
No menu, selecionar a opção Configurações;
Na secção Configurações Envio De PDFs, no campo Endereço de envio selecionar a opção Personalizado.
Após efetuar esta alteração, é criado um ticket de tipo Parametrização de Email e a Cegid Yet é notificada para finalizar a personalização do endereço de envio.
Para utilizar o endereço de envio personalizado, é necessário configurar o DNS do domínio (ver como).
Como configurar o DNS do domínio de email?
É necessário configurar o DNS do domínio para utilizar o endereço de envio personalizado. Recomendamos que contacte o responsável técnico pela gestão do DNS do domínio para esta operação.
Para configurar o DNS do domínio, siga os seguintes passos:
1. Adicionar um registo TXT às configurações de DNS do domínio. Por exemplo:
Servidor próprio de email: v=spf1 mx a ptr include:einvoice.yetspace.com ~all
Office 365: v=spf1 include:spf.protection.outlook.com include:einvoice.yetspace.com ~all
Google: v=spf1 include:einvoice.yetspace.com include:_spf.google.com ~all
2. Validar a correta implementação aqui.
3. Adicionar um registo DKIM às configurações de DNS do domínio
TXT name: yetmail._domainkey.domíniocliente (ex: yetmail._domainkey.yetspace.com).
TXT value: v=DKIM1; h=sha256; k=rsa; t=y;
p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC7xA78jAMBETl6SwG
MVbPI0ZM0kTmF92j9pdMrlrB6eGbQjKUSMIioGABqj6JsdjZRLiK1nHaKR+lqAIXf
M7OixjOaCMOLoCVoj2LxneztbCuZIz7mlKyG61XpeT1APgAO7IQugIlfH6F4G6Ar
Hh+qpwAMS7IYe4QyZy0eW7WtZwIDAQAB
4. Validar a correta implementação aqui.
Caso tenha o protocolo DMARC1 ativo, deverá garantir que está como relaxed, conforme o seguinte exemplo:
v=DMARC1;p=none;sp=none;adkim=r;aspf=r;pct=100;fo=0;rf=afrf;ri=86400
5. Validar a implementação aqui.
É apresentado o erro "Relação comercial inexistente - Contactar suporte para pedir a criação desta relação comercial". Como procedo?
Neste caso, deverá:
Verificar endereços na ficha da entidade: deverá garantir que os endereços inseridos no separador Transações Eletrónicas estão corretos e que correspondem às informações enviadas no pedido de ligação;
Garantir que não existem espaços em branco: deverá verificar se existem espaços em branco no início ou no final dos endereços e, de seguida, reenviar o documento na janela de Transações Eletrónicas;
Assegurar que existe relação comercial: se não solicitou uma relação comercial anteriormente, deverá abrir um ticket através do portal MyYetSpace para pedir a criação da relação comercial necessária;
Se nenhum dos procedimentos anteriores resolveu o problema, deverá abrir um ticket de suporte no portal MyYetSpace, detalhando o problema e referindo todos os procedimentos que já realizou.
O que são os mapeamentos de unidades por entidade e de integração?
Os mapeamentos de unidades por Entidade são utilizados para alterar a SIGLA da unidade sem modificar as quantidades. Por exemplo, um artigo é enviado em UN (1200) com informação do pack em BX (200). Com os mapeamentos configurados, a encomenda é integrada na unidade configurada mantendo a quantidade 1200.
Para obter este comportamento, é necessário ativar a opção Utiliza Unidades de Cliente no separador Transações Eletrónicas da ficha de cliente.
Relativamente aos mapeamentos de unidades de Integração, são utilizados para alterar simultaneamente a SIGLA da unidade e as quantidades. Usando o exemplo anterior, enviar o mesmo artigo em UN (1200) com informação do pack em BX (200). Com os mapeamentos configurados, a encomenda é integrada na unidade CX com a quantidade 200, que é a quantidade alternativa enviada pelo cliente.
Como posso obter o código GLN?
Para solicitar o código GLN deverá enviar um email para info@gs1pt.org com os seguintes dados:
Nome da Entidade
Número de Contribuinte
Nota: O Número Global de Localização (GLN) é um identificador global único usado para identificar entidades legais e funcionais ou locais físicos, sendo necessário para todas as ligações estabelecidas com retalho.
Posso personalizar o endereço de envio dos documentos na minha própria caixa de email? (Microsoft)
Sim. É possível enviar emails individuais através do próprio identificador do email usado. Para tal, siga os seguintes passos:
Aceder a Microsoft Azure | Microsoft Entra ID;
Aceder a Gerir | Registo de Aplicações | Novo Registo;
Inserir o Nome;
Indicar os Tipos de Contas Suportadas (contas apenas nesse diretório organizacional);
No campo URL de Redirecionamento, selecionar a opção WEB e introduzir o link https://login.microsoftonline.com/common/oauth2/nativeclient;
Aceder a Gerir | Permissões API | Adicionar Permissão para Mail.Send e User.Read;
Aceder a Gerir | Autenticação | Adicionar uma Plataforma | Aplicativos Móveis e de Desktop e introduzir o link https://yet.cegid.cloud/CoreV2/api/v1.3/Support/OfficeOauthToken;
Assim, ao selecionar a configuração criada no Registo de Aplicações, será apresentada a informação a configurar no Portal em Configurações | Configurações Envio De PDFs | Endereço de Envio | MICROSOFT:
Nome
Email de envio
Application (Client) ID
Directory (TENANT) ID
Posso personalizar o endereço de envio dos documentos na minha própria caixa de email? (Gmail)
Sim. No entanto, é necessário obter as chaves de acesso à API.
Para configurar, siga os seguintes passos:
Aceder ao Google Cloud (Google Cloud Plataform);
Selecionar a opção Criar Projeto;
Identificar o nome do projeto e a organização;
No projeto, aceder a APIS e Serviços | Ativar APIs e Serviços | Ativar;
Na secção Credenciais, selecionar a opção Criar Credenciais e, seguida, a opção Oauth client ID;
No registo da aplicação, configurar o ecrã de consentimento Oauth através dos seguintes campos:
Nome;
Email de suporte;
Logo (opcional);
Adicionar Scopes: deverá selecionar ./auth/gmail.send e ./auth/userinfo.profile;
Configurar utilizador de testes;
Aceder a Credenciais | Criar Credenciais | ID Cliente OAuth;
Selecionar o tipo de aplicação Desktop;
Efetuar o download do ficheiro gerado ou guardar o ID do Cliente e Segredo do Cliente;
Na Cegid Yet devem ser configurados o ID do cliente e o Secret disponibilizados no ficheiro em questão. O Tenant é o valor identificado no ID do projeto.
Posso parametrizar diferentes idiomas no envio de faturas?
Sim. Para configurar outros idiomas nas faturas em PDF, siga os seguintes passos:
No MyYETSpace, aceder ao separador Configurações;
Selecionar a opção Parametrização de Emails;
Inserir uma Nova Configuração com o idioma pretendido (por exemplo, Inglês) e definir o texto no respetivo idioma;
Na ficha do cliente, configurar o País e o Idioma para garantir que a fatura é enviada no idioma correto, de acordo com o template definido.
Enviei um documento e foi apresentado o erro "Validador HOSP EDICOM: O fornecedor não está configurado para receber faturas em produção". Como resolvo?
As entidades hospitalares cujo Broker é a EDICOM necessitam de um passo adicional junto da mesma, além da ativação da conexão entre os Brokers (solicitação direta do fornecedor à equipa de gestão da Unidade Hospitalar da autorização de envio de documentos por EDI).
O documento ficou em erro após o envio ("Delivery date cannot be less than the departure date"). Porquê?
O documento enviado foi rejeitado por erro nas datas. Ao preencher o cabeçalho do documento a enviar, deverá garantir a coerência das datas, ou seja, a data de carga não pode ser superior à data de descarga.
Para corrigir, basta editar documento, corrigir a data e enviar novamente.
O documento foi rejeitado pelo cliente com o erro "[DT-CIUS-PT-020_6.x] - O BT-22". Como resolvo?
O documento foi rejeitado uma vez que o campo relativo à chave de certificação AT não se encontrava no formato pretendido.
Para corrigir, siga os seguintes passos:
No separador Dados de Certificação, garantir o seguinte formato (incluindo espaços): qxXQ - Processado por programa certificado nº 12345/AT Esta informação encontra-se na fatura, normalmente no rodapé da mesma sendo os quatro primeiros caracteres gerados mediante a fatura e o nº do programa estático mediante o software que usam para registar a faturação.
Editar o documento em questão, corrigir dados AT e enviar novamente.
Erros relacionados:
[DT-CIUS-PT-020_6.1] - O BT-22 quando prefixado com '# NUMBER @ ATCERTIFIEDPROGRAM #', deve atender ao formato definido: alfanumérico com tamanho entre 1 e 20.
[DT-CIUS-PT-020_6.2] - O BT-22 não atende ao formato definido: é obrigatório prefixar o valor com o seguinte '# NUMBER @ ATCERTIFIEDPROGRAM #' e bastar com '#'.
[DT-CIUS-PT-020_6.3] - O BT-22 quando prefixado com '# NUMBER @ ATCERTIFIEDPROGRAM #', é obrigatório se um elemento com o prefixo '# HASHCODE @ ATCERTIFIEDPROGRAM #' ou '# DESCRIPTION @ ATCERTIFIEDPROGRAM #' foi ou será referenciado.
[DT-CIUS-PT-020_6.3] - O BT-22 quando prefixado com '# NUMBER @ ATCERTIFIEDPROGRAM #', é obrigatório se um elemento com o prefixo '# HASHCODE @ ATCERTIFIEDPROGRAM #' ou '# DESCRIPTION @ ATCERTIFIEDPROGRAM #' foi ou será referenciado.
Quais os erros SMTP mais comuns?
Os seguintes erros são os mais comuns:
Erro: failed - smtp; 550-5.1.1 The email account that you tried to reach does not exist.
Motivo: O endereço de email de destino não existe.
Solução:
Validar se o email de destino está corretamente escrito (espaços ou caracteres em falta);
Verificar junto do destinatário o endereço de email.
Erro: failed - smtp; 550-The account has been suspended for inactivity.
Motivo: O endereço de email encontra-se suspenso por inatividade.
Solução: Solicitar junto do destinatário um endereço de email válido.
Erro: failed - smtp; 550 5.4.1 Recipient address rejected: Access denied.
Motivo: O remetente está bloqueado no serviço de email de destino.
Solução: É necessário solicitar ao destinatário que coloque o email emissor na listagem dos remetentes fidedignos.
Erro: failed - smtp;550 5.1.10 RESOLVER.ADR.RecipientNotFound.
Motivo: O endereço de email é inválido.
Solução: É necessário solicitar junto do destinatário um endereço de email válido
Erro: failed - smtp;554 5.4.14 Hop count exceeded - possible mail loop.
Motivo: Indica um problema de loop de email ou roteamento no Exchange Online.
Solução: Devem verificar se o domínio do destinatário está configurado como domínio aceite Exchange Online.
O documento foi rejeitado pelo cliente com o erro "O documento não possui uma nota de encomenda ou um numero de contrato válido". Como resolvo?
O envio de documentos para a Infraestruturas de Portugal deve conter, obrigatoriamente, o número de pedido SAP (Nota de Encomenda), composto por 10 algarismos (no máximo). Caso contrário, serão rejeitadas.
Neste caso, deverá editar o documento, indicar o número SAP no campo N.º de encomenda e reenviar.
O documento foi rejeitado com o erro "The PDF is mandatory". Como resolvo?
Deverá editar o documento em erro, adicionar o pdf no separador Anexos e reenviar.
O documento foi rejeitado com o erro "O numero de compromisso obrigatorio". Como resolvo?
Deverá editar o documento em erro e preencher o n.º de compromisso no cabeçalho. Posteriormente, deverá reenviar o documento.
O documento foi rejeitado com o erro "Caso o valor devido para pagamento (BT-115) seja positivo, a data de vencimento do pagamento (BT-9) ou os termos de pagamento (BT-20) devem estar presentes". Como resolvo?
Neste caso, deverá:
Editar o documento;
No cabeçalho, preencher a data de vencimento;
Corrigir a data de carga;
Reenviar o documento.
O documento foi rejeitado com o erro: "O documento XML tem erros: Uma Nota de Crédito deve conter a Referência da Fatura Precedente." Como resolvo?
Neste caso, deverá:
Editar o documento;
No cabeçalho, inserir o n.º de fatura que deu origem à Nota de Crédito;
Reenviar o documento.
O documento foi rejeitado com o erro: "O documento XML tem erros: O fornecedor e o cliente do documento devem ser diferentes". Como resolvo?
Deverá editar o documento e, no separador Entidades, corrigir as entidades. Posteriormente, deverá reenviar o documento.
No envio de documentos, aparece o erro "O código GLN do fornecedor não está definido". Como resolvo?
Caso tenha apenas um GLN associado à sua entidade deve:
Aceder ao Administrador;
Selecionar Empresa | Propriedades;
No separador Outros, indicar o código GLN associado à sua entidade no campo Código de Localização (GLN);
Reenviar o documento após preencher o campo.
Caso tenha mais do que um GLN e utilize um diferente para vários clientes, deve:
Aceder a Clientes;
Selecionar a opção Campos de Utilizador;
No campo GLN Contrato Fornecedor, indicar o código GLN da sua entidade;
Reenviar o documento após preencher o campo.
O documento foi rejeitado pelo cliente com o erro: "[BE-CIUS-PT-01] - O número do documento FT XXXX/2024 já existe".
O erro indica que o documento já foi processado pelo seu cliente.
O documento foi rejeitado pelo cliente com o erro: Não foi encontrado PAD para a nota de encomenda.
O erro é devolvido pelo sistema do seu cliente e indica que não existe uma autorização de despesa válida para o documento enviado. Deverá entrar em contacto com o seu cliente.
O documento foi rejeitado pelo cliente com o erro: Delivery date cannot be less than the departure date.
A data de entrega que está a ser comunicada é anterior à data de envio. Deverá corrigir as datas e reenviar.
O documento apresentou o erro: [BR-AA-10] - Um VATBReakdown (BG-23) com código de categoria de IVA (BT-118) ""Taxa inferior"" não deve ter um código de motivo de isenção de IVA (BT-121) ou texto de motivo de isenção de IVA (BT-120).
O erro indica que uma das linhas do documento tem uma taxa de IVA reduzimo e, simultaneamente, um motivo de isenção de IVA associado. Deverá validar se a linha é isenta de IVA, ou retirar o motivo de isenção de IVA.
É devolvido o seguinte erro na receção/envio: "A connection attempt failed because the connected party did not properly respond after a period of time, or established connection failed because connected host has failed to respond 132.220.98.67:25"
Este erro está relacionado com falta de permissões no acesso ao serviço da YET, ou seja, a tentativa de ligação falhou devido à falta de resposta do servidor na porta 132.220.98.67:25.
Solução: deverá garantir que as portas 25 e 110 não têm restrições de acesso para o servidor de email mail.ediint.primaverabss.com.
Alternativamente, poderá configurar a comunicação via protocolo HTTPS, adicionando a seguinte informação ao ficheiro Config.ini:
[TTE]
HTTPS = 1
Onde posso obter o MDN (Message Disposition Notification) de um documento enviado e outros ficheiros associados à transação?
Pode obter os ficheiros associados à transação enviada no Menu Repositório do portal My YetSpace.
Para isso, deve pesquisar pelo documento pretendido e clicar no ícone com formato de pasta zipada, que se encontra à direita.
Será descarregada uma pasta zipada com todos os ficheiros associados: mdn, message status, pdf e xml do documento.
No envio de documentos, é apresentada a seguinte mensagem: The SMTP server does not support authentication.
O erro "The SMTP server does not support authentication" no Primavera ocorre devido a uma falha na comunicação entre o ERP e o servidor SMTP, relacionado com a autenticação. Para corrigir, no ficheiro config.ini do ERP Primavera, deverá adicionar os campos abaixo:
[TTE]
HTTPS = 1
Após a correção, deverá reabrir o Primavera e reenviar os documentos.
Após o envio, o documento apresenta o seguinte erro: The operation was canceled.
O envio do documento em formato pdf para o email do cliente falhou, deverá proceder ao reenvio.
Após o envio, o documento apresenta o seguinte erro: Não foi possível enviar email.
O envio do documento em formato pdf para o email do cliente falhou, deverá proceder ao reenvio.
Após o envio, o documento apresenta o seguinte erro: Nenhum contacto para enviar.
O envio do documento em formato pdf para o email do cliente falhou, não existe nenhum contacto de email associado ao cliente.
neste caso deve:
Aceder a portal da Yet | clientes;
Selecionar a entidade;
Adicionar um email válido.
O documento foi rejeitado pelo cliente com o erro [DT-CIUS-PT-025] The BT-27 does not meet the defined format: alphanumeric with size between 1 and 200.
O documento foi rejeitado pelo cliente com o erro descrito porque o nome do fornecedor (entidade emissora da fatura) deve ter entre 1 e 200 caracteres.
Deverá corrigi-lo e reenviar o documento.
O documento foi rejeitado com o erro: [DT-CIUS-PT-151] The BT-5 must be coded using ISO code list 4217 alpha-3.
O documento foi rejeitado com o erro descrito porque o código da moeda do documento deve pertencer à lista ISO.
Deverá corrigi-lo e reenviar o documento.
O documento foi rejeitado com o erro: [DT-CIUS-PT-048] The BT-50 does not meet the defined format: alphanumeric with size between 1 and 200.
O documento foi rejeitado com o erro descrito porque a morada do cliente do documento ultrapassa os 200 caracteres.
Deverá corrigi-la e reenviar o documento.
É possível configurar um corpo de email por cada serviço?
Sim. É possível configurar de acordo com a natureza da fatura (serviços, águas, educação, etc).
Para tal, deverá:
Aceder a Definições | Categoria de Documento;
Parametrizar o Prefixo a utilizar e a descrição do serviço (o prefixo deve ser configurado como está nas faturas).
Aceder a Definições | Parametrizações de email;
Identificar a categoria configurada em Categoria do Documento;
Configurar o corpo de email associado ao mesmo.
Enviei um documento por email e foi devolvido o erro: "failed - x - postfix: host or domain name not found"
Este erro indica que foi detetada uma falha na comunicação entre o email e o servidor do seu cliente porque o domínio não existe ou não foi encontrado. Deverá contactar o seu cliente para analisar o erro.
No envio de documentos, é apresentado o erro "Encomenda (YY) para o Fornecedor (XXXX) não encontrada". Como resolvo?
Este erro está relacionado com o número de encomenda indicado no seu documento. O número de encomenda associado à sua entidade não existe do lado do destinatário.
Deverá entrar em contacto com o seu cliente e corrigir a informação solicitada.
No envio de documentos, é apresentado o erro: “O campo v/referência ou o CDU Código Faturacao devem ser preenchidos”
O erro apresentado indica que está em falta o código de faturação definido com o seu cliente.
Neste caso, deverá consultar os campos obrigatórios em: https://helpcenter.ila.cegid.com/yet/faqs/?faq_id=157423
O que é o código SSCC?
O SSCC éum código que identifica de forma única unidades logísticas (paletes, caixas, etc.).
Este código é composto por 18 dígitos e é obrigatório para a comunicação de Guias de Remessa por EDI no retalho.
Enviei um documento por email e foi apresentado o erro: “failed - smtp; 550 sender's policy prohibits this message: quarantine”
Este erro foi apresentado porque a mensagem foi rejeitada pelo servidor do cliente devido à configuração incorreta da política DMARC.
Neste caso, deverá validar as parametrizações em: https://helpcenter.ila.cegid.com/yet/faqs/?faq_id=127212
Enviei um documento e foi apresentado o erro: “At least one reference must be specified”
O erro apresentado indica que o número da encomenda não foi preenchido.
Neste caso, deverá:
Inserir o número da encomenda em Editor de Vendas | V/Refer;
Reenviar o documento.
O preço base dos artigos já inclui IVA. Como enviar os valores corretamente?
Para enviar corretamente os valores do ERP com IVA incluído, deverá seguir os seguintes passos:
No cabeçalho do documento a enviar, aceder a Informações Gerais | Configuração;
Selecionar a opção IVA incluído;
Nas linhas, inserir os valores de acordo com o que está na fatura.
Nota: esta configuração pode ser definida como predefinição nos parâmetros da organização para todos os documentos futuros.
Trabalho com preços que possuem mais de duas casas decimais, mas o sistema apenas permite duas. Como posso enviar os valores corretamente sem perder a precisão?
Para enviar os preços com a precisão do seu ERP, deverá seguir os seguintes passos:
No cabeçalho do documento a enviar, aceder a Informações Gerais | Configuração;
Ajustar os campos Preço unitário redondo e Preço redondo;
Definir o número de casas decimais usado no ERP (p. ex.: quatro);
Nas linhas, inserir os valores de acordo com o que está na fatura.
Nota: esta configuração pode ser definida como predefinição nos parâmetros da organização, aplicando-se automaticamente a todos os documentos futuros.
Os documentos enviados a partir do Primavera mantêm a assinatura digital quando são armazenados no repositório?
Não. Os documentos PDF gerados no Primavera perdem a assinatura digital quando são transferidos para o repositório.
Ao tentar enviar documentos, é apresentada a mensagem “MOT reference is missing”. O que significa e como posso resolver?
A mensagem apresentada indica que o campo Código de Isenção não está identificado nos produtos que fornece sem IVA incluído.
Neste caso, deverá indicar o motivo da isenção no campo correspondente.
O campo "Guia de Remessa" não deveria ser automaticamente preenchido através da integração com a encomenda?
O campo Guia de Remessa é de preenchimento manual, pelo que não é automaticamente preenchido por integração.
Para preencher este campo, deve fazê-lo através dos campos de utilizador.
Um fornecedor pretende começar a enviar documentos via EDI. Quais os passos a seguir?
Neste caso, deverá validar se o seu serviço permite a receção de documentos via EDI.
Caso permitia, deverá informar o fornecedor de que deverá entrar em contacto com o respetivo broker, que, por sua vez, entrará em contacto connosco através dos canais habituais estabelecidos.
Como posso consultar o estado do meu pacote de créditos?
Para consultar o estado do seu pacote de créditos, siga os seguintes passos:
Aceder ao portal yet.cegid.cloud;
Na opção Subscrições, é possível consultar as seguintes informações:
Pacote ativo (data de validade e número de créditos disponíveis);
Histórico de pacotes anteriores.
Nota: a renovação do pacote é realizada automaticamente com um pacote igual. Caso pretenda um número de créditos diferente, deverá registar um ticket de informações.
É apresentado o seguinte erro: “Erro 535: 5.7.8 Error: authentication failed: UGFzc3dvcmQ6”
O erro apresentado indica uma falha na ativação da ficha de cliente. Neste caso, deverá entrar em contacto com a CEGID YET.