mateusfbi / totvs-rm-soap

v4.5.0 2026-10-15 21:19 UTC

Requires

• php: ^8.2
• ext-soap: *
• ext-xml: *

Requires (Dev)

• illuminate/config: ^13.36
• illuminate/container: ^13.36
• illuminate/support: ^13.36
• laravel/pint: ^1.32
• phpoption/phpoption: ^1.10
• phpstan/phpstan: ^2.3
• phpunit/phpunit: ^11.0
• vlucas/phpdotenv: ^5.7

Suggests

• illuminate/support: Necessário apenas para usar o Service Provider e a Facade no Laravel

Replaces

• mateusfbi/totvs-rm-soap-laravel: v4.5.0

MIT

• Mateus Brandao

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

Published on Packagist.org on 2026-10-15 21:19 UTC

README

Biblioteca PHP para integração SOAP com o TOTVS RM. Funciona com Laravel (Provider/Facade) ou PHP puro / qualquer framework.

Atualizando de versão antiga? Veja o guia de migração. Referência de Report/Process/FormulaVisual: docs/SERVICES.md. Erros comuns: docs/TROUBLESHOOTING.md.

Requisitos

• PHP 8.3 ou superior
• Extensões SOAP e XML do PHP
• Composer
• Laravel (opcional — apenas se for usar Provider/Facade)

Instalação

composer require mateusfbi/totvs-rm-soap

Migrando de totvs-rm-soap-laravel

composer remove mateusfbi/totvs-rm-soap-laravel
composer require mateusfbi/totvs-rm-soap

O namespace mateusfbi\TotvsRmSoap\ permanece o mesmo — em geral não é preciso alterar os use.

Laravel

php artisan vendor:publish --tag=config

Configuração (Laravel)

Variáveis no .env:

TOTVSRM_WSURL=http://localhost:8051
TOTVSRM_USER=usuario
TOTVSRM_PASS=senha
TOTVSRM_CONNECTION_TIMEOUT=1800

URL por empresa em config/totvsrmsoap.php:

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

Ou via .env:

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

Uso com PHP puro

use mateusfbi\TotvsRmSoap\Connection\Config;
use mateusfbi\TotvsRmSoap\Connection\WebService;
use mateusfbi\TotvsRmSoap\Services\DataServer;
use mateusfbi\TotvsRmSoap\Services\ConsultaSQL;

$config = new Config(
    url: 'http://localhost:8051',
    user: 'usuario',
    pass: 'senha',
    companies: [
        '01' => 'http://rm-empresa01:8051',
    ],
);

$connection = new WebService($config);

// API fluente
$result = (new DataServer($connection))
    ->setDataServer('GlbColigadaDataBR')
    ->setContexto('CODSISTEMA=G;CODCOLIGADA=0;CODUSUARIO=mestre')
    ->setFiltro('1=1')
    ->readView();

// Ou via DTO
use mateusfbi\TotvsRmSoap\DataTransferObjects\ReadViewParams;

$result = (new DataServer($connection))->readViewWith(new ReadViewParams(
    dataServerName: 'GlbColigadaDataBR',
    filter: '1=1',
    context: 'CODSISTEMA=G;CODCOLIGADA=0;CODUSUARIO=mestre',
));

// Mapeando linhas para Records
use mateusfbi\TotvsRmSoap\DataTransferObjects\Record;

$records = array_map(fn (array $row) => new Record($row), $result['GlbColigada'] ?? []);
$cod = $records[0]->get('CODCOLIGADA');

$res = (new ConsultaSQL($connection))->forCompany('01')
    ->setSentenca('SENTENCA_EXEMPLO')
    ->setColigada(1)
    ->setSistema('G')
    ->setParametros(['P1' => 'VALOR'])
    ->RealizarConsultaSQL();

Exemplos em examples/php-puro.php e examples/laravel.md.

Uso com Laravel

Injeção de dependência

use mateusfbi\TotvsRmSoap\Services\DataServer;

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

Helper app() / Facade

Aliases: totvs.data_server, totvs.consulta_sql, totvs.report, totvs.process, totvs.formula_visual

use mateusfbi\TotvsRmSoap\Facades\TotvsRM;

$ds = TotvsRM::dataServer()->forCompany('01');

Testes

composer install
composer test

Qualidade (Pint + PHPStan + testes, igual ao CI):

composer ci

Integração (RM real):

export TOTVSRM_RUN_INTEGRATION=1
export TOTVSRM_WSURL=http://localhost:8051
export TOTVSRM_USER=usuario
export TOTVSRM_PASS=senha
composer test:integration

Suporte

Versão	PHP	Status
4.x	^8.3	Mantida
3.x e anteriores	—	Descontinuadas, atualize pela migração

Encontrou um bug? Abra uma issue em GitHub Issues com a versão do pacote (composer show mateusfbi/totvs-rm-soap), a versão do PHP e o trecho do XML/erro (sem credenciais).

Licença

MIT. Veja o arquivo LICENSE para mais detalhes.