DOCUMENTAÇÃO

Serviços Web

As entradas e os retornos dos WebServices descritos neste documento são efetuados utilizando-se um padrão flexível e reconhecido internacionalmente que é o XML (eXtensible MarkUp Language).

Estes WebServices são desenvolvidos em VB.NET framework 3.5.

Todos os XML's retornam o Zero para indicar sucesso ou um Código do erro. Os WebServices que retornam dados para a aplicação terão atributos específicos e estão documentados.

Para obter o WSDL do WEBSERVICE, acrescente à URL informada a seguinte string: ?WSDL

Exemplo: www.teste.com.br/teste.aspx?WSDL

  • Como Utilizar?

Todos os métodos descritos neste manual necessitam de uma chave de cliente para autenticação. Esta chave é cadastrada utilizando-se a aba WebServices do módulo de configuração (Menu Minha Empresa>>Configuração do Portal QualiSign). Para chegar a esta aba, selecione o Menu Minha Empresa (ou minha Conta se for Pessoa Física) em, em seguida o sub-menu Configuração.

Preencha a tag sessao com o valor cadastrado na aba weservices para esta chave de cliente, conforme exemplo abaixo:

<documentoeletronico>
    <sessao> @chavedecliente</sessao>
    <documentos>
        <documento docto_nome_arquivo="CONTRATO_CAMBIO_MOND_24082012_6.TXT" 
        docto_referencia="MOND 24082012 TESTE" docto_dtinicio="24/08/2012" 
        docto_dtfim="24/08/2012" docto_fl_validade="S" docto_cod_tipodoc="72" docto_cod_moeda="1">
            Q09OVFJBVE8gREUgQ0FNQklPIC0gTU9OREVMTEkgMjQwODIwMTIgNg==
            <politica_assinatura docto_fl_bacen="N" docto_fl_ass_digital="S" docto_fl_grava_docto="S" 
            docto_fl_ass_portal="N" docto_fl_car_tempo="N" />
            <seguranca_documento docto_cod_tipo_acesso="1" />
            <partes>
                <parte parte_papel_nome="CONTRATANTE"  parte_empr_cnpj="45007630000126" parte_empr_ordem="1"></parte>
                <parte parte_papel_nome="CONTRATADA" parte_papel_empr_cnpj="" parte_empr_cnpj="04455612000120" 
                parte_empr_ordem="2"></parte>
            </partes>
        </documento>
    </documentos>
</documentoeletronico>

É importante lembrar que neste exemplo está sendo considerado que as partes já foram previamente cadastradas no Portal QualiSign. Caso queiram que o Portal QualiSign autocadastre as partes, é necessário passar as informações das TAGS <DetalheParte> para as empresas e <DetalheRepr> para os representantes.