PHP download

Download the PHP package vitorccs/bradesco-api-php without Composer

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

Table of contents
Download vitorccs/bradesco-api-php
More information about vitorccs/bradesco-api-php
Files in vitorccs/bradesco-api-php

Vendor vitorccs
Package bradesco-api-php
Short Description SDK PHP para a API de Registro de Boletos do Bradesco
License GPL-3.0
Homepage https://github.com/vitorccs/bradesco-api-php

Keywords boleto bradesco cobranca registro titulo

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?

Example code of vitorccs/bradesco-api-php

Informations about the package bradesco-api-php

Bradesco API - SDK PHP

SDK PHP para a API de Registro On-line de Boletos de Cobrança Bradesco

Requisitos

PHP >= 7.1

Descrição

SDK em PHP para integração com os serviços de Registro On-line de Boletos de Cobrança Bradesco

Manual_Registro_de_Boleto_Bancario_Online_Janeiro 2019.pdf

Instalação

Via Composer

Parâmetros

Parâmetro	Obrigatório	Padrão	Comentário
BRADESCO_CERT_PATH	Sim	-	Caminho do certificado PKCS#7 em formato .pfx
BRADESCO_CERT_PASSWORD	Sim	-	Senha do certificado
BRADESCO_SANDBOX	Não	true	Utilizar ambiente de Homologação (true) ou Produção (false)
BRADESCO_TIMEOUT	Não	30	Timeout em segundos para estabelecer conexão com a API
BRADESCO_FOLDER_PATH	Não	""	Caminho para esta biblioteca gerar arquivos temporários, necessários parar realizar a criptografia. Os arquivos são criados com hash randômica e excluídos automaticamente, sem a necessidade de se preocupar em limpá-los periodicamente.

Como usar

1) Os parâmetros podem ser definidos por váriaveis de ambiente:

ou passados por array:

2) Em seguida, basta utilizar o comando abaixo passando os dados do boleto em formato array.

Normalização de dados

Foram adicionadas diversas funções para normalizar os dados conforme exigido pela API do Bradesco:

Campos ausentes são inseridos com seus respectivos valores padrão (página 19 do manual).
Valores em null são trocados para vazio "".
Valores em integer ou float são convertidos para string.
Valores com caracteres especiais (ção) são substituídos por caracteres básicos (cao).
Valores de nome e endereço do pagador são recortados para a quantidade máxima de caracteres.
Datas no formato "yyyy-mm-dd" ou "dd/mm/yyy" são normalizadas para "dd.mm.yyyy".
Moedas no formato 14.90 ou "14,90" são normalizadas para "1490".
Números de CPF e CNPJ "123.456.789-01" são normalizadas para "00012345678901".

Exemplo de implementação

Dicas

Mesmo em ambiente Sandbox é necessário utilizar o arquivo e senha correta do certificado, e utilizar os dados reais do beneficiário (nuCPFCNPJ, filialCPFCNPJ, ctrlCPFCNPJ, nuNegociacao). Também é necessário que a sua carteira de boletos já esteja autorizada junto ao Bradesco para utilizar a API de Registro On-line.
Como qualquer serviço, a API do Bradesco não possui 100% de disponibilidade. É recomendável armazenar o status de sucesso, e prever algum tratamento de retentativa para os casos que não retornaram sucesso.
A exceção BradescoApiException é lançada quando é detectado alguma mensagem de erro retornada pela própria API Bradesco, e a exceção BradescoRequestException para problemas diversos de servidor e conexão (erros HTTP 4xx e 5xx)
A única exceção que não exige retentativa, é a de código 69 pois representa que o Boleto já se encontra registrado

OpenSSL 3

A partir da versão 3 do OpenSSL, o certificado .pfx pode apresentar erro de leitura e será necessário habilitar o modo "legacy" (veja no StackOverflow)

Testes

Caso queira contribuir, por favor, implementar testes de unidade em PHPUnit.

Para executar: 1) Faça uma cópia de phpunit.xml.dist em phpunit.xml na raíz do projeto 2) Altere os parâmtros ENV com os dados de seu acesso 3) Execute o comando abaixo no terminal dentro da pasta deste projeto:

All versions of bradesco-api-php with dependencies

PHP Build Version

Package Version

Version v1.6.2 Release 17. Oct 2022
create-project require 0 people choosed require and
0 people choosed create-project.

Download

Download latest version of bradesco-api-php from vendor vitorccs

Requires php Version >=7.1
ext-json Version *
ext-openssl Version *
guzzlehttp/guzzle Version ^6.3.3|^7.0.1

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 vitorccs/bradesco-api-php contains the following files

Loading the files please wait ....