Download the PHP package tiexpert/ws-boleto-santander without Composer

On this page you can find all versions of the php package tiexpert/ws-boleto-santander. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package ws-boleto-santander

Build Status Coverage Status Latest Stable Version Total Downloads License
SensioLabsInsight

WSBoletoSantander

WS Boleto Santander é um conjunto de classes criadas para facilitar a integração entre aplicativos feitos em PHP e a geração de boletos online no banco Santander.

Índice

  • Funcionalidades
  • Requisitos
  • Guia Básico de Uso
    • Instalação da Biblioteca
    • Montagem do Boleto
    • Registrando o Boleto
  • Questões Importantes
  • Mais Documentação
  • Licença
  • Aviso Legal

Funcionalidades

Requisitos

Suporte para PHP 5.6 e 7.0 terminará em dezembro de 2018.

É fortemente recomendável que se migre para versões superiores.

Com as seguintes extensões ativas:

Guia Básico de Uso

Instalação da Biblioteca

WS Boleto Santander pode ser instalado via Composer usando o comando:

O Composer automaticamente verificará seu ambiente para determinar se seu servidor pode rodar a biblioteca WSBoletoSantander.

Montagem do Boleto

Para registrar o boleto serão necessárias as seguintes classes:

Agora, em seu script, defina o convênio.

Se o arquivo de configuração estiver já pronto, as informações de convênio já estarão corretas. Caso não, você pode definí-las agora.

Então, defina as informações do pagador do boleto.

Se não desejar instanciar Pagador já com os dados é possível. Pagador tem um construtor padrão sem argumentos e cada propriedade tem um método set para definir valor como, por exemplo, setNome, setCidade, setCEP,etc.

Por fim, um objeto composto que são as informações do título bancário.

Comece definindo as instruções do título.

As instruções mais corriqueiras são configuráveis via config.ini. Mas, todas as propriedades como $multa, $multarApos, $juros, $tipoDesconto, $valorDesconto, $dataLimiteDesconto, $valorAbatimento, $tipoProtesto, $protestarApos, $baixarApos tem métodos set.

Propriedades que são representações de data devem ser usadas instâncias de DateTime, ou uma string no formato "dmY". Exemplo: $instrucao->setDataLimiteDesconto("28032017"), ou seja, o desconto deve ser aplicado até 28/03/2017.

Enfim, usaremos essas instruções para compor as informações do título na classe Titulo.

Assim como as demais classes, todas as propriedades têm seus respectivos set.

Importante salientar que toda instância de Título deve conter uma instância de InstrucoesDeTitulo. Caso contrário, um erro acontecerá na exportação do XML.

Agora, com todas as partes prontas, basta montar o boleto.

Registrando o Boleto

Com o boleto já montado, ou seja, com seus objetos e campos populados, deve-se fazer o registro em dois passos: solicitar um tíquete de registro de boleto e depois ratificá-lo.

Primeiramente, vamos preparar o serviço injetando um comunicador no cliente do serviço.

Agora, devemos solicitar um tíquete com o método solicitarTicketInclusao.

Qualquer erro que o WebService retornar será lançado como um Exception pelo método.

Se nada deu errado, então, uma instância de Ticket é criada com uma autenticação de segurança do banco. Nesse momento, será necessário determinar um número sequencial único (NSU) que será a identificação de seu boleto. Para cada registro de boleto, este NSU deverá ser único por dia e por convênio, ou seja, não se pode usar o mesmo NSU no mesmo dia para o mesmo convênio.

Com o tíquete pronto, basta passá-lo como parâmetro no método incluirTitulo.

$resultado = $svc->incluirTitulo($ticket);

Este método retorna true em caso de registro com sucesso, ou false. Embora, em casos de falha, o mais provável é que seja lançado um Exception com o motivo da falha.

Questões Importantes

Antes de qualquer tentativa de comunicação com o banco, deve-se primeiro pedir para eles cadastrarem seu certificado digital lá. Sem isso, não tem como o serviço do banco saber a autenticidade de quem o está requisitando.

Outra coisa, seu certificado digital também deve respeitar algumas regras.

Primeiro, ele deve ser do tipo cliente ou ambos, ou seja, ele deve de qualquer forma prover meios de comprovar sua identidade.

Aba de informações gerais do certificado

Além disso, seu certificado deve ter 4 informações importantes:

1) O tamanho da chave chave-pública deve ser de 2048 bits.

Tamanho da chave-pública

2) Deve conter número de série.

Chave Serial

3) Possuir uma impressão digital.

Impressão Digital do Certificado

4) E, um Common Name.

Common Name

Para facilitar o processo de comunicação com o serviço do Santander, é interessante baixar o certificado da CA deles, que atualmente é Entrust Root Certificate Authority—G2.

Ele pode ser encontrado aqui: https://www.entrust.com/get-support/ssl-certificate-support/root-certificate-downloads/

Também será necessário exportar seu certificado digital para o formato PEM.

Com ambos os arquivos, configure-os no arquivo config.ini do WSBoletoSantander.

Exemplo:

Mais Documentação

Em breve, na Wiki do projeto.

Licença

WS Boleto Santander é distribuído sob a Licença Apache 2.0 e não pode ser usado de forma diferente que a expressa por essa licença.

Maiores informações, acesse http://www.apache.org/licenses/LICENSE-2.0.

Aviso Legal

O autor deste projeto não tem nenhuma afiliação, vínculo ou qualquer outra relação com o banco Santander S.A.

O software é oferecido aqui "como está" e nenhuma garantia é proferida. Portanto, o uso deste software é de inteira responsabilidade do utilizador.


All versions of ws-boleto-santander with dependencies

PHP Build Version
Package Version
Requires php Version >=5.6
ext-dom Version *
ext-xmlwriter Version *
ext-curl Version *
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package tiexpert/ws-boleto-santander contains the following files

Loading the files please wait ....