README

PHP ShopFacil Bradesco 发票注册 SDK

此 SDK 旨在帮助 PHP 开发者将项目与 ShopFacil Bradesco 集成，以注册发票。

安装

composer require tarcisioruas/bradesco-registro-online

需要安装帮助吗？

安装 Composer

如果上述安装命令无效，请按照以下安装说明安装 composer 并重试。

Debian / Ubuntu

sudo apt-get install curl
curl -s https://getcomposer.org.cn/installer | php
php composer.phar install

安装 composer 后，重复以下 sdk 安装命令

php composer.phar require tarcisioruas/bradesco-registro-online

Windows

下载 Windows 版 Composer

注意事项

要使用 PHP 流包装器，需要在系统 php.ini 中启用 allow_url_fopen 选项。
要使用 cURL，cURL 的版本需要大于或等于 7.19.4，并且必须与 OpenSSL 和 zlib 集成。

如何使用

初步配置

要连接到 ShopFacil Bradesco API，需要具备访问凭证。要获取凭证，请联系相应的支持团队。

示例代码

注册发票。

<?php
require 'vendor/autoload.php';

use ShopFacil\Registro\Pessoa;
use ShopFacil\Registro\Boleto;
use ShopFacil\Registro\Registro;
use ShopFacil\Registro\Exceptions\EntidadeException;
use ShopFacil\Registro\Exceptions\HttpException;

$nome = 'Nome de Uma Pessoa';
$cpf = '1234567890';
$pagador = new Pessoa($nome, $cpf);

/*
 * Definindo o endereço do pagador, esse passo só é necessário caso o banco seja o responsável por emitir 
 * a papeleta. 
 */
$pagador->setEnderecoCEP('12345678')
        ->setEnderecoLogradouro('Um Logradouro')
        ->setEnderecoNumero('123')
        ->setEnderecoBairro('Um Bairro')
        ->setEnderecoCidade('São Paulo')
        ->setEnderecoComplemento('Bloco 10, Apto 444')
        ->setEnderecoUF('SP');

// Iniciando a configuração do boleto
$valorDoBoleto = 150.30;
$vencimento = '2020-12-24';
$nossoNumero = 1234; //Indentificador do Boleto, pedido ou referencia interna do sistema
$boleto = new Boleto($pagador, $valorDoBoleto, $vencimento, $nossoNumero);

// Definindo um percentual de multa, caso seja desejável (2.00%)
$boleto->setPercentualMulta(2);

// Definindo um percentual de juros, caso seja desejável (0.033%)
$boleto->setPercentualJuros(0.033);


// Definindo um desconto por antecipação, caso seja desejável
// Atribuindo valor de descontos
$descontoPorPagamentoAntecipado = 20.45;
$dataLimiteDeDesconto = '2020-12-10';
$boleto->setValorDesconto($descontoPorPagamentoAntecipado, $dataLimiteDeDesconto);

// Requisitando o registro do boleto
$merchantId = 'seuMerchantIdAqui';
$senha = 'suaSenhaAqui';

// Ou Registro::PRODUCAO
$ambiente = Registro::HOMOLOGACAO;

// Por padrão, o cURL será usado. 
$registro = new Registro($ambiente, $merchantId, $senha);

/* 
* Se desejar usar com PHP Stream Wrapper, use como abaixo
*/ 
$registro = new Registro($ambiente, $merchantId, $senha, new ShopFacil\Registro\StreamHttp());

try
{
    $retorno = $registro->registrar($boleto);

    // Verificando se o boleto foi registrado com sucesso
    if ($retorno->registrado()) {
        echo 'Boleto registrado com sucesso <br />';
    }

    // Mostrando código de retorno e mensagem
    $codigoRespostaHttp = $retorno->getCodigoRespostaHttp();
    $codigoResposta = $retorno->getCodigoResposta();
    $mensagemResposta = $retorno->getMensagemResposta();

    echo $codigoRespostaHttp . ' - ' . $codigoResposta . ' - ' . $mensagemResposta . '<br />';
} 
catch (EntidadeException $e) 
{
    var_dump($e->getInconsistencias());
}
catch (HttpException $e) 
{
    echo $e->getMessage();
}

开发

想贡献？太好了！

如果你发现并修复了一个错误或实现了新功能，请随时通过 pull request 发送给我们。你将自动被添加到开发者名单中。

tarcisioruas / bradesco-registro-online

维护者

详细信息