PHPackages                             ajtarragona/tsystems-client - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. ajtarragona/tsystems-client

ActiveLibrary[API Development](/categories/api)

ajtarragona/tsystems-client
===========================

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

v2.0.15(7mo ago)08571MITPHPPHP ^7.1.3|^8.0

Since Sep 24Pushed 5mo ago1 watchersCompare

[ Source](https://github.com/ajtarragona/tsystems-client)[ Packagist](https://packagist.org/packages/ajtarragona/tsystems-client)[ RSS](/packages/ajtarragona-tsystems-client/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (2)Versions (42)Used By (1)

Tsystems Laravel Client
=======================

[](#tsystems-laravel-client)

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

*Credits*: Ajuntament de Tarragona.

Instalació
----------

[](#instalació)

```
composer require ajtarragona/tsystems-client
```

Configuració
------------

[](#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
--

[](#ú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:

[](#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`:

[](#a-través-duna-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`:

[](#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
--------

[](#funcions)

### Tercers

[](#tercers)

FuncióParàmetresRetorn**getPersonByIdNumber**`id`: identificador (DNI) del tercerUn objecte `TSPerson`**getPersonByDboid**`id`: identificador internUn objecte `Tercer`**searchPersons**`name`: nom a buscar
`search_type`: 1-conté, 2-comença per, 3: acaba en, 4: és igual aUn array d'objectes `TSPerson`**createPerson**`persondata[]`: array amb els valors de l'objecte `TSPerson`Un array d'objectes `TSPerson`**updatePerson**`dboid`: Id intern del tercer a modificar
 `persondata[]`: array amb els valors de l'objecte `TSPerson` a modificar### Vialer

[](#vialer)

FuncióParàmetresRetorn**getCountriesByName**`name`: nom a buscarUn array d'objectes `TSCountry`**getCountryByCode**`code`: codi a buscarun objecte `TSCountry`**getAllCountries**Un array d'objectes `TSCountry`**getProvinciesByName**`name`: nom a buscarUn array d'objectes `TSProvince`**getAllProvincies**`countrycode*`: code de pais (per defecte Espanya)Un array d'objectes `TSProvince`**getProvinciesByName**`name`: nom a buscar
`countrycode*`: code de paisUn array d'objectes `TSProvince`**getProvinciaByCode**`code`: codi a buscar
`countrycode*`: code de paisUn objecte `TSProvince`**getAllMunicipis**`provcode*`: codi de provincia (per defecte Tarragona)Un array d'objectes `TSMunicipality`**getMunicipisByName**`name`: nom a buscar
`provcode*`: codi de provincia (per defecte Tarragona)Un array d'objectes `TSMunicipality`**getMunicipiByCode**`code`: codi a buscar
`provcode*`: codi de provincia (per defecte Tarragona)Un objecte `TSMunicipality`**getAcronymList**Un array d'objectes `TSAcronym`**getCarrersByName**`name`: nom a buscar
`provcode*`: codi de provincia (per defecte Tarragona)Un array d'objectes `TSStreet`**getCarrerByCode**`code`: codi a buscar
`provcode*`: codi de provincia (per defecte Tarragona)Un objecte `TSStreet`### Padró

[](#padró)

FuncióParàmetresRetorn**getCurrentInstitucion**Un objecte `TSInstitucion` de la institució de l'ajuntament**getInstitucion**`codigoProvincia*`: codi de provincia
`codigoMunicipio*` codi de municipiUn objecte `TSInstitucion`**getHabitanteByDNI**`dni`: dni a buscarUn objecte `TSHabitante`**getPDFHabitanteByDNI**`dni`: dni a buscardocument binari en base64**getHabitantesByDNI**`dni`: dni a buscarUn array d'objectes `TSHabitante`**getHabitantesByPasaporte**`pasaporte`: pasaporte a buscarUn array d'objectes `TSHabitante`**getHabitantesByTarjetaResidencia**`id`: codi de la tarjeta de residencia a buscarUn array d'objectes `TSHabitante`**getHabitantesByNombre**`nombre`: nom a buscar
`apellido1`: primer cognom
`apellido`: segon cognomUn array d'objectes `TSHabitante`**getNumHabitantesByDNI**`dni`: dni a buscarUn numero enter**getNumHabitantesByPasaporte**`pasaporte`: pasaporte a buscarUn numero enter**getNumHabitantesByTarjetaResidencia**`id`: codi de la tarjeta de residencia a buscarUn numero enter**getNumHabitantesByNombre**`nombre`: nom a buscar
`apellido1`: primer cognom
`apellido`: segon cognomUn numero enter

###  Health Score

44

—

FairBetter than 92% of packages

Maintenance68

Regular maintenance activity

Popularity17

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity68

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~36 days

Total

41

Last Release

236d ago

Major Versions

v0.0.1 → v1.0.02021-09-24

v1.0.23 → v2.0.02024-09-13

PHP version history (2 changes)v0.0.2PHP >=7.0.0

v2.0.0PHP ^7.1.3|^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/eae0bc56bebf7416d9c7ad9f0c8a7aa91e8911c8f8a8a34207d90a201df3deff?d=identicon)[ajtarragona](/maintainers/ajtarragona)

---

Top Contributors

[![ajtarragona](https://avatars.githubusercontent.com/u/45968689?v=4)](https://github.com/ajtarragona "ajtarragona (63 commits)")

---

Tags

laravellaravel5

### Embed Badge

![Health badge](/badges/ajtarragona-tsystems-client/health.svg)

```
[![Health](https://phpackages.com/badges/ajtarragona-tsystems-client/health.svg)](https://phpackages.com/packages/ajtarragona-tsystems-client)
```

###  Alternatives

[darkaonline/l5-swagger

OpenApi or Swagger integration to Laravel

2.9k34.0M112](/packages/darkaonline-l5-swagger)[knuckleswtf/scribe

Generate API documentation for humans from your Laravel codebase.✍

2.3k12.2M45](/packages/knuckleswtf-scribe)[scottybo/laravel-google-my-business

A package for Laravel which implements the Google My Business API

3360.3k](/packages/scottybo-laravel-google-my-business)[scriptdevelop/whatsapp-manager

Paquete para manejo de WhatsApp Business API en Laravel

762.6k](/packages/scriptdevelop-whatsapp-manager)[travoltron/plaid

Laravel specific wrapper for Plaid. Bankdata for developers.

274.8k](/packages/travoltron-plaid)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)