Modulo EDI Broker

Permite integrar o sistema com a rede Saphety e, deste modo, enviar via webservice documentos de faturação eletrónica a clientes registados nessa entidade.

Quais os serviços existentes da Saphety?

Existem 2 serviços:

- Integração com Portal SIN (Saphety Invoice Network);

- Integração com SaphetyDoc (substitui o SaphetyBox).

O que utilizar para comunicação? SaphetySIN ou SaphetyDOC?

SaphetySIN - plano Básico Saphety - permite envio em CIUS-PT (envio de ficheiro) por Webservice.

SaphetyDOC - permite o Envio de faturas e receção de encomendas em XML padrão via Webservice (disponível a partir da V202402).

Quais os requisitos necessários para comunicar documentos eletrónicos em xml através da Saphety ?

Os requisitos mínimos são:

• PHC ON ativo, Módulos PHC CS Gestão, PHC CS Assinaturas Qualificadas, PHC CS Documentos Eletrónicos e PHC CS EDI Broker;
• Geografia de Portugal;
• Ter saldo de Assinaturas Qualificadas Digital Sign (parceria atual);
• Parâmetro geral "Utiliza Certificado - Digital Sign" ativo;
• Parâmetros "Digital Sign": ID do Autorizador, Obter Autorização de Comunicação e Secret preenchidos;
• Parâmetro geral "Utiliza Documento Eletrónico" ativo.

Como passar de SaphetyBox para SaphetyDoc? (Para clientes atuais SaphetyBox)

Para clientes atuais é necessário:

1. Preencher os parâmetros SaphetyDoc webservice: Username, Password e URL;
2. Preencher os parâmetros Digital Sign: Utiliza Certificado, ID do Autorizador, Obter Autorização de Comunicação e Secret;
3. Preencher a plataforma EDI na ficha de cliente com SaphetyDoc;

4. Ativar assinaturas nas séries dos Doc. de Faturação;

5. Para receção de encomendas - Ativar o Método de Receção por Webservice no alerta que importa Dossiers.

Quais os locais da aplicação para a comunicação/envio de documentos em SaphetyDoc ou Saphety SIN?

Pode efetuar a comunicação através dos seguintes locais:

1. Via Doc. Eletrónico no ecrã de Faturação;
2. Via Doc. Eletrónico no ecrã de Emissão Automática de Documentos Eletrónicos

3. Via Monitor de Comunicação de Documentos Eletrónicos.

Também é possível o envio para SaphetyDoc via EDI?

Tendo os parâmetros SaphetyDoc na aplicação PHC preenchidos e a plataforma EDI no cliente se pretender realizar a comunicação via EDI pode fazer pelos seguintes meios:

1. De forma automática ao gravar, no ecrã de faturação, caso a respetiva série tenha a opção "Ao gravar comunica o documento eletrónico via Webservice" configurada com o valor "Sim" ou "Sim e anexa";
2. De forma manual através do botão "Enviar EDI", no ecrã de Faturação, caso a respetiva série tenha a opção "Ao gravar comunica o documento eletrónico via Webservice" configurada com o valor "Não";

3. De forma manual, no ecrã "Integração com EDI";

4. De forma manual através do módulo Servidor (plano Enterprise), através das configurações definidas no ecrã "Integração com EDI".

Como analisar os estados dos documentos?

Pode verificar o estado de um determinado documento através do ícone "SaphetyDoc" localizado no próprio documento comunicado, ou através da opção diversa "Resultado da comunicação de documentos eletrónicos" desse documento, ou então no "Monitor de Comunicação de Documentos Eletrónicos".

No monitor tem a descrição dos estados que podem existir. O mesmo aplica-se ao Saphety SIN.

Qual o URL necessário para utilizar SaphetyDOC no PHC?

Nos parâmetros é necessário que com o username e password enviados pela Saphety se coloque também o URL certo no parâmetro. Como existem diferentes URL conforme se está em «testes/qualidade» ou em «Produção» é importante que o URL seja corretamente definido para os diferentes "estágios“.

Assim o URL é:

• Testes/qualidade - https://www-qa.netdocs.com.pt/TradeHttp/MessageServiceRest
• Produção (real) - https://wsrest.netdocs.com.pt/TradeHttp/MessageServiceRest

Qual o URL necessário para utilizar Saphety SIN no PHC?

Nos parâmetros é necessário que com o username e password enviados pela Saphety se coloque também o URL certo no parâmetro. Como existem diferentes URL conforme se está em «testes/qualidade» ou em «Produção» é importante que o URL seja corretamente definido para os diferentes "estágios“.

Assim o URL é:

• Testes/qualidade - dcn-solution.saphety.com/Dcn.Sandbox.WebApi
• Produção (real) - dcn-solution.saphety.com/Dcn.Business.WebApi

Como é definido o Username?

É definido pela Saphety no acordo com o Cliente e normalmente é composto por:

Saphety SIN: Email que utiliza para entrar na plataforma

SaphetyDoc: Pelo NIF ou pelo GLN do cliente

As credenciais para o webservice da SaphetyDoc são diferentes das credenciais de acesso ao portal da SaphetyDoc (ao contrário do que ocorre com a Saphety SIN).

Como incluir o PDF no XML produzido?

Atualmente, apenas os utilizadores do serviço SaphetyDoc podem incluir o PDF no XML.

Se pretender comunicar documentos de faturação e adicionar o PDF, deverá utilizar um executável da versão v202404 (lançada a partir de novembro/2024), disponível no FTP.

Caso a série do documento esteja configurada para a comunicação de documentos eletrónicos e para incluir o PDF, o ficheiro PDF será enviado para a SaphetyDoc embebido no ficheiro XML e, juntamente com o XML, num ficheiro ZIP.

Desta forma, o documento visualizado na plataforma da Saphety e enviado ao cliente será o definido na série do documento de faturação, em vez do documento nativo da Saphety.

Nota: Se existir alguma implementação para o PDF embebido no XML na configuração do documento XML associado à série do documento de faturação, esta deve ser removida para garantir que a comunicação seja efetuada corretamente.

Posso mapear campos no XML?

Utilizando o XML padrão, poderá mapear novos campos de modo a que os mesmos sejam adicionados ao referido documento.

Esta configuração é realizada ao nível da própria configuração do XML padrão, tal como foi exemplificado na questão anterior, onde foi mapeado o pdf em base 64.

Porquê a obrigatoriedade de DIgitalSign, se a Saphety faz assinaturas?

Uma vez que passou a ser obrigatório por lei (Decreto-Lei n.º 28/2019, de 15 de fevereiro) que todas as faturas, e documentos fiscalmente relevantes enviados eletronicamente, possuam uma assinatura digital qualificada, com o módulo PHC CS Assinaturas Qualificadas as empresas têm a garantia de que nenhum documento que é emitido pelo software PHC é enviado sem assinatura eletrónica, uma vez que é o factor que comprova a integridade dos dados e garante que está conforme a lei. Desta forma as empresas ficam 100% protegidas com o documento que contém uma assinatura da própria empresa, garantindo todo o valor probatório. Isto, sem prejuízo de após a emissão pelo software PHC, outros processos conferirem elementos adicionais de sugerança ou auditoria. Com o PHC CS, a emissão de faturas eletrónicas em formato estruturado, usando o módulo PHC CS EDI Broker, são sempre enviadas com a respetiva assinatura qualificada.