vandojunqueira/pdvmobi-sdk

SDK para integração com PDVMobi (POS Controle)

v1.0.0 2025-08-02 20:39 UTC

This package is auto-updated.

Last update: 2025-08-02 21:02:39 UTC


README

PHP Version License GitHub issues SDK PHP para integração com a API PDVMobi (POS Controle), com suporte para Laravel e PHP puro.

Instalação

Recomenda-se instalar via Composer:

composer require vandojunqueira/pdvmobi-sdk

Requisitos

  • PHP 8.1 ou superior

  • Para usar no Laravel e aproveitar o ServiceProvider, instale também:

    composer require illuminate/support

Uso

PHP Puro

require 'vendor/autoload.php';

use PDVMobi\PDVMobi;

$pdv = new PDVMobi();
$pdv->setAuthorization('seu_token_aqui');

$usuarios = $pdv->users->listar();
print_r($usuarios);

Laravel

O SDK detecta automaticamente o ambiente Laravel. Você pode registrar o Service Provider em config/app.php:

'providers' => [
    // ...
    PDVMobi\Laravel\PDVMobiServiceProvider::class,
],

Uso no Laravel:

use PDVMobi\PDVMobi;

$pdv = app(PDVMobi::class);
$pdv->setAuthorization('seu_token_aqui');

$produtos = $pdv->products->listar();

Configuração

Variáveis de ambiente:

Variável Descrição Valor padrão
PDV_MOBI_BASE_URL URL base da API PDVMobi https://api.poscontrole.com.br
PDV_MOBI_SUBSCRIPTION_KEY Chave para assinatura nas requisições (null)

Desenvolvimento

  • Código PSR-4 em src/

  • Testes com PHPUnit em tests/

  • Para evitar erros de IDE (Intelephense), rode:

    composer require illuminate/support --dev

Contribuição

Sinta-se à vontade para abrir issues e pull requests!

Licença

MIT © Vando Junqueira

Contato