mateusfbi/totvs-rm-soap-laravel

Biblioteca de Conexão SOAP para integração com TOTVS RM usando Laravel

v2.0.4 2026-02-05 16:09 UTC

Requires

• php: ^8.0

MIT

• Mateus Brandão

• soap
• laravel
• rm
• totvs
• totvs-rm

README

Este projeto é uma implementação em PHP para integração com o serviço SOAP da Totvs RM com o Framework Laravel.

Requisitos

• PHP 8.0 ou superior
• Framework Laravel
• Extensão SOAP,XML do PHP
• Composer

Instalação

Instale as dependências via Composer: composer install mateusfbi/totvs-rm-soap-laravel

publicar o arquivo de configuração no diretório config php artisan vendor:publish --tag=config

Configuração

1. Adicione e configure as variáveis de ambiente no arquivo .env.

• TOTVSRM_WSURL=http://localhost:8051
• TOTVSRM_USER=usuario
• TOTVSRM_PASS=senha

1. Configurar URL por empresa (coligada) no arquivo config/totvsrmsoap.php (recomendado):

// config/totvsrmsoap.php
'companies' => [
    '01' => 'http://rm-empresa01:8051',
    '02' => 'http://rm-empresa02:8051',
],

Opcionalmente, é possível usar .env com a variável TOTVSRM_COMPANIES no formato:

TOTVSRM_COMPANIES="01|http://rm-empresa01:8051;02|http://rm-empresa02:8051"

3. Configure o timeout da conexão (opcional):

No `.env`:

TOTVSRM_CONNECTION_TIMEOUT=1800 # tempo em segundos

Ou no arquivo `config/totvsrmsoap.php`:
```php
'connection_timeout' => env('TOTVSRM_CONNECTION_TIMEOUT', 1800),

Uso

Para utilizar os serviços, você pode injetar as classes de serviço diretamente em seus controllers ou outros serviços, ou usar o helper app() do Laravel. O provedor de serviços se encarregará de instanciar as classes com suas dependências.

Exemplo com Injeção de Dependência

use Illuminate\Routing\Controller;
use mateusfbi\TotvsRmSoap\Services\DataServer;

class MeuController extends Controller
{
    public function buscarDados(DataServer $ds)
    {
        $ds->setDataServer("GlbColigadaDataBR");
        $ds->setContexto("CODSISTEMA=G;CODCOLIGADA=0;CODUSUARIO=mestre");
        $ds->setFiltro("1=1");
        $result = $ds->readView();

        if (array_key_exists('GColigada', $result)) {
            $result = $result['GColigada'];
        } else {
            $result = [];
        }

        dd($result);
    }
}

Exemplo com o helper app()

Você também pode obter uma instância de um serviço usando os aliases registrados:

• totvs.consulta_sql
• totvs.data_server
• totvs.formula_visual
• totvs.process
• totvs.report

$ds = app('totvs.data_server');
$ds->setDataServer("GlbColigadaDataBR");
$ds->setContexto("CODSISTEMA=G;CODCOLIGADA=0;CODUSUARIO=mestre");
$ds->setFiltro("1=1");
$result = $ds->readView();

// ...

Uso com URL por empresa

Todos os serviços expõem forCompany($codigo) para selecionar a URL base a partir do mapeamento configurado. Ex.:

use mateusfbi\TotvsRmSoap\Facades\TotvsRM;

// Via Facade
$ds = TotvsRM::dataServer()->forCompany('01');
$ds->setDataServer('GlbColigadaDataBR');
$ds->setContexto('CODSISTEMA=G;CODCOLIGADA=1;CODUSUARIO=mestre');
$ds->setFiltro('1=1');
$result = $ds->readView();

// Via helper app()
$sql = app('totvs.consulta_sql')->forCompany('02');
$sql->setSentenca('SENTENCA_EXEMPLO');
$sql->setColigada(2);
$sql->setSistema('G');
$sql->setParametros(['P1' => 'VALOR']);
$res = $sql->RealizarConsultaSQL();

Licença

Este projeto está licenciado sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.