Skip to main content

Ajuda

  1. Registo de Fornecedores – Acesso ao Portal do Fornecedor
  2. Utilização de Web Services

1 — Registo de Fornecedores – Acesso ao Portal do Fornecedor

Demonstração de um registo de fornecedor externo na UBI para acesso ao portal e WS EDI.

Aceder a https://registo.ubi.pt e clicar no cartão “Fornecedores”.
Exemplo de um fornecedor de teste criado.
Depois deste registo, o mesmo será tratado normalmente pelo processo de registo.
Registo -> Validação/Rejeição.
No caso da validação, o fornecedor é criado na base de dados e recebe o seguinte e-mail:
No caso de um fornecedor já existente na base de dados se tentar registar, será mostrada a seguinte mensagem:
Quando o fornecedor clica em “Requerer acesso” é enviado para o e-mail do próprio, um link para podermos validar que é o próprio a requerer o acesso.
Exemplo do e-mail:
Ao clicar no link “Requerer Chave”, será redirecionado para o EDI onde será feita a validação.
Ao clicar no link “Requerer Chave”, será redirecionado para o EDI onde será feita a validação.
Se o url for válido será criada a hash de acesso e a mesma será enviada por e-mail.
Depois disso o fornecedor deverá clicar em “LogIn” (conto superior direito) para entrar no Portal EDI com o seu e-mail e a hash enviada.
Preencher o formulário de SingIn / Login
Ao entrar com sucesso, ficará em sessão o “user” (e-mail) que utilizou para entrar.

2 — Utilização de Web Services

Para estabelecer um canal de comunicações com os sistemas de informação da UBI deverá seguir o processo de Registo de Fornecedores descrito em 1 - Registo de Fornecedores – Acesso ao Portal do Fornecedor.
É neste processo que será definido acesso (credenciais) para possibilitar o envio automático de documentos (pe., faturas) para os sistemas de informação da UBI.

Depois é necessário configurar as aplicações para usar essas credenciais para consumir o nosso web service para o envio de documentos.

O endereço público (endpoint) para o nosso é: https://wsedi.ubi.pt/CanalEntradaDocumentos.asmx

Os métodos disponíveis e resptivos parâmetros no canal de entrada de documentos são:

1 - SubmeterDocumento

Usado para submeter um ficheiro do tipo xml (CIUS PT/UBL).

Exemplo de entrada com parâmetros:

POST /CanalEntradaDocumentos.asmx HTTP/1.1
Host: wsedi.ubi.pt
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "https://wsedi.ubi.pt/CanalEntradaDocumentos.asmx/SubmeterDocumento"
                 
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                   xmlns:xsd="http://www.w3.org/2001/XMLSchema"
                   xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Header>
        <UserCredentials xmlns="https://wsedi.ubi.pt/CanalEntradaDocumentos.asmx">
            <Username>string</Username>
            <Password>string</Password>
        </UserCredentials>
    </soap:Header>
    <soap:Body>
        <SubmeterDocumento xmlns="https://wsedi.ubi.pt/CanalEntradaDocumentos.asmx">
            <novoDocumento>base64Binary</novoDocumento>
            <nomeDocumento>string</nomeDocumento>
        </SubmeterDocumento>
    </soap:Body>
</soap:Envelope>
Exemplo de resposta:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
            <soap:Body>
            <SubmeterDocumentoResponse xmlns="https://wsedi.ubi.pt/CanalEntradaDocumentos.asmx">
            <SubmeterDocumentoResult>Erro. Credenciais inválidas.</SubmeterDocumentoResult>
        </SubmeterDocumentoResponse>
    </soap:Body>
</soap:Envelope>
2 - SubmeterDocumentoBase64

Usado para submeter uma string no formato Base64 resultante da conversão do xml (CIUS PT/UBL).

Exemplo de entrada com parâmetros:

POST /CanalEntradaDocumentos.asmx HTTP/1.1
Host: wsedi.ubi.pt
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "https://wsedi.ubi.pt/CanalEntradaDocumentos.asmx/SubmeterDocumento"
                  
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
               xmlns:xsd="http://www.w3.org/2001/XMLSchema"
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Header>
        <UserCredentials xmlns="http://tempuri.org/">
            <Username>string</Username>
            <Password>string</Password>
        </UserCredentials>
    </soap:Header>
    <soap:Body>
        <SubmeterDocumentoBase64 xmlns="http://tempuri.org/">
            <novoDocumentoBase64>string</novoDocumentoBase64>
        </SubmeterDocumentoBase64>
    </soap:Body>
</soap:Envelope>
Exemplo de resposta:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <soap:Body>
        <SubmeterDocumentoBase64Response xmlns="https://wsedi.ubi.pt/CanalEntradaDocumentos.asmx">
            <SubmeterDocumentoBase64Result>Erro: Documento Base64 está vazio ou nulo:</SubmeterDocumentoBase64Result>
        </SubmeterDocumentoBase64Response>
    </soap:Body>
</soap:Envelope>