lucasnribeiro/bling-php-sdk

Bling PHP SDK

0.0.10 2022-06-23 14:48 UTC

Requires

• guzzlehttp/guzzle: ^7.0.1
• spatie/array-to-xml: ^2.11

Requires (Dev)

• nesbot/carbon: ^2.33
• phpunit/phpunit: ^8.0
• symfony/dotenv: ^5.0

MIT

• Lucas Ribeiro

• api
• sdk
• Bling

README

This package provides PHP SDK to the Bling API v2 (https://manuais.bling.com.br/manual/?categoria=api-v2&tipo=api).

Installation

Install this package with composer.

composer require rits-tecnologia/bling-php-sdk

Usage

$bling = new Bling(env('BLING_API_KEY'));

// repositories
$bling->products();
$bling->orders();
$bling->logistics();
$bling->nfes();
$bling->nfces();
$bling->nfses();

Examples

// list all orders
$bling->orders()->all([
    'dataEmissao' => '01/01/2020 TO 31/12/2020'
]);

// find order
$bling->orders()->find(1);

// create new order and NF-e
$bling->orders()->create([
    'pedido' => [
        'cliente' => [
            'nome' => 'Organisys Software',
            'tipoPessoa' => 'J',
            'cpf_cnpj' => '00000000000000',
            'ie_rg' => '3067663000',
            'endereco' => 'Rua Visconde de São Gabriel',
            'numero' => '392',
            'complemento' => 'Sala 54',
            'bairro' => 'Cidade Alta',
            'cep' => '95.700-000',
            'cidade' => 'Bento Gonçalves',
            'uf' => 'RS',
            'fone' => '54 8115-3376',
            'email' => '[e-mail]',
        ],
        'transporte' => [
            'transportadora' => 'Transportadora XYZ',
            'tipo_frete' => 'R',
            'servico_correios' => 'SEDEX',
            'dados_etiqueta' => [
                'nome' => 'Endereço de entrega',
                'endereco' => 'Rua Visconde de São Gabriel',
                'numero' => '392',
                'complemento' => 'Sala 59',
                'municipio' => 'Bento Gonçalves',
                'uf' => 'RS',
                'cep' => '95.700-000',
                'bairro' => 'Cidade Alta',
            ],
            'volumes' => [
                'volume' => [
                    [
                        'servico' => 'SEDEX - CONTRATO',
                        'codigoRastreamento' => '',
                    ],
                    [
                        'servico' => 'PAC - CONTRATO',
                        'codigoRastreamento' => '',
                    ],
                ],
            ],
        ],
        'itens' => [
            'item' => [
                [
                    'codigo' => '001',
                    'descricao' => 'Caneta 001',
                    'un' => 'Pç',
                    'qtde' => '10',
                    'vlr_unit' => '1.68',
                ],
                [
                    'codigo' => '002',
                    'descricao' => 'Caderno 002',
                    'un' => 'Un',
                    'qtde' => '3',
                    'vlr_unit' => '3.75',
                ],
                [
                    'codigo' => '003',
                    'descricao' => 'Teclado 003',
                    'un' => 'Cx',
                    'qtde' => '7',
                    'vlr_unit' => '18.65',
                ],
            ],
        ],
        'parcelas' => [
            'parcela' => [
                [
                    'data' => '01/09/2009',
                    'vlr' => '100',
                    'obs' => 'Teste obs 1',
                ],
                [
                    'data' => '06/09/2009',
                    'vlr' => '50',
                    'obs' => '',
                ],
                [
                    'data' => '11/09/2009',
                    'vlr' => '50',
                    'obs' => 'Teste obs 3',
                ],
            ],
        ],
        'vlr_frete' => '15',
        'vlr_desconto' => '10',
        'obs' => 'Testando o campo observações do pedido',
        'obs_internas' => 'Testando o campo observações internas do pedido'
    ],
], true);

// update order
$bling->orders()->update(1, [
    'pedido' => [
        'situacao' => 3
    ]
]);