ajtarragona/tsystems-client

Client per serveis de l'ERP de Tsystems (Tercers, Padró, Vialer)

v2.0.9 2024-11-25 09:01 UTC

Requires

• php: ^7.1.3|^8.0
• jtrumbull/xml-parser: >=1.0
• laravel/framework: >=6.0

MIT

• Txomin Medrano Martorell

• laravel
• laravel5

README

Client per serveis de l'ERP de Tsystems (Tercers, Padró, Vialer).

Credits: Ajuntament de Tarragona.

Instalació

composer require ajtarragona/tsystems-client

Configuració

Pots configurar el paquet a través de l'arxiu .env de l'aplicació. Aquests son els parámetres disponibles :

TSYSTEMS_DEBUG 
TSYSTEMS_WS_URL 
TSYSTEMSAPI_WS_USER 
TSYSTEMS_WS_PASSWORD
TSYSTEMS_ID_INSTITUCION

• Nota: En els Serveis de Padró, si la nostra aplicació no defineix TSYSTEMS_ID_INSTITUCION per cada crida es farà una crida prèvia per recuperar-lo

Alternativament, pots publicar l'arxiu de configuració del paquet amb la comanda:

php artisan vendor:publish --tag=ajtarragona-tsystems-config

Això copiarà l'arxiu a config/tsystems.php.

Ús

Un cop configurat, el paquet està a punt per fer-se servir.

Ho pots fer de les següents maneres:

Vía Injecció de dependències:

Als teus controlladors, helpers, model:

use Ajtarragona\Tsystems\Services\TsystemsTercersService;

...
public function test(TsystemsTercersService $tercers){
	$tercer=$tercers->getPersonByIdNumber(123456);
	...
}

Disposem de tres serveis: TsystemsTercers, TsystemsPadro, TsystemsVialer

A través d'una Facade:

use TsystemsTercers;
...
public function test(){
	$tercer=TsystemsTercers::getPersonByIdNumber(123456);
	...
}

Disposem d'una Facade per cada servei: TsystemsTercersService, TsystemsPadroService, TsystemsVialerService , tots al namespace Ajtarragona\Tsystems\Services

Vía funció helper:

...
public function test(){
	$tercer=ts_tercers()->getPersonByIdNumber(123456);
	...
}

Disposem 'un helper per cada servei: ts_tercers(), ts_padro(), ts_vialer()

Funcions

Tercers

Vialer

Padró