Webservice para consulta de boletos de autorização visão instituto – CRA21 XML

Descrever a realização da obtenção de boletos de autorização por Webservice.

• Homologação (ambiente de testes):
  craUF.cra21.com.br/craUF/xml/instituto.php?wsdl
  Ex: http://cradf.cra21.com.br/cradf/xml/instituto.php?wsdl

  ATENÇÃO: no ambiente de homologação utilizar o protocolo HTTP

• Produção (ambiente de funcionamento do sistema):
  craUF.crabr.com.br/craUF/xml/instituto.php?wsdl
  Ex: https://cradf.crabr.com.br/cradf/xml/instituto.php?wsdl

  ATENÇÃO: no ambiente de produção utilizar o protocolo HTTPS

Observação:

Caso retorne timeout antes desse tempo, verifique as configurações de espera da resposta pela sua aplicação.

• Os dados (parâmetros) devem ser enviados via protocolo SOAP
• Ao consumir o WebService, em todos os serviços, a autenticação deverá ser realizada utilizando autenticação básica.
  • Deverão ser passados os parâmetros de usuário e senha, fornecidos pela CRA.
  • Após a autenticação serão validados os parâmetros de entrada e por último a crítica do arquivo
• Serviços disponíveis:

  • BoletoAutorizacao

    download de boletos de autorização

• Parâmetros dos serviços disponíveis:

• • Download
    

    numeroTitulo	número do título
    protocolo	protocolo do título
    documentoDevedor	documento do devedor

• O encoding do XML deve estar de acordo com ISO-8859-1.
• Assim como no HTML, o XML possui entidades, que devem ser substituídas conforme tabela abaixo:

  • De	Para
    <	& lt;
    >	& gt;
    &	& amp;
    ‘	& apos;
    “	& quot;

Estrutura da resposta do serviço

Atributos

Exemplos de requisição e resposta

Exemplo de requisição do serviço

1
2
3
4
5
6
7
8
9
10

<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:localhost">
   <soapenv:Header/>
   <soapenv:Body>
      <urn:BoletoAutorizacao soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
         <numeroTitulo xsi:type="xsd:string">999999999</numeroTitulo>
         <protocolo xsi:type="xsd:string">999999999</protocolo>
         <documentoDevedor xsi:type="xsd:string">999999999</documentoDevedor>
      </urn:BoletoAutorizacao>
   </soapenv:Body>
</soapenv:Envelope>

Exemplo de resposta do serviço

• Resposta

1
2
3
4
5
6
7
8
9

<relatorio>
  <boleto>JVBERi0xLjMKMyAwIG9iago</boleto>
  <nomeMunicipio>Nome do Município</nomeMunicipio>
  <nomeCartorio>Nome do cartório do município</nomeCartorio>
  <valorTitulo>99999.99</valorTitulo>
  <saldoTitulo>99999.99</saldoTitulo>
  <nossoNumero>99999999</nossoNumero>
  <nomeDevedor>Nome do Devedor</nomeDevedor>
</relatorio>