README

Client Laravel d'accés al WS d'ANICOM. ANICOM és un registre d'animals de companyia de la Generalitat de Catalunya: https://mediambient.gencat.cat/ca/05_ambits_dactuacio/patrimoni_natural/animals_companyia_experimentacio/animals_companyia/anicom/

Instalació

composer require ajtarragona/anicom-client:dev-main"

Configuració

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

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

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

Això copiarà l'arxiu anicom.php a la carpeta config.

Ús

Un cop configurat, el paquet està a punt per fer-se servir. Ho pots fer de les següents maneres:

A través d'una Facade:

use Anicom;
...
public  function  test(){
    $animal=Anicom::consultaAnimal('123456');
    ...
}

Per Laravel < 5.6, cal registrar l'alias de la Facade a l'arxiu config/app.php :

'aliases'  =>  [
    ...
    'Anicom'  =>  Ajtarragona\Anicom\Facades\Anicom::class
]

Vía Injecció de dependències: Als teus controlladors, helpers, model:

use Ajtarragona\Anicom\Providers\AnicomProvider;
...

public  function  test(AnicomProvider  $client){
    $animal=$client->consultaAnimal('123456');
    ...
}

Vía funció helper:

...
public  function  test(){
    $animal=anicom()->consultaAnimal('123456');
    ...
}

Funcions

Camps propietari

...
public  function  test(){
    $animal=anicom()->altaPropietari([
        'tipus_persona' => 1,    
        'tip_document' => 1,    
        'document' => '12345678J',    
        'nom' => 'PEPITO',    
        'cognoms' => 'PEREZ LOPEZ',    
        'rao_social' => '',    
        'sexe' => 2,    
        'ambit' => 1,    
        'tipus_via' => 1,    
        'via' => 'FAKE STREET',   
        'numero' => 1,   
        'municipi' => 17118,    
        'telefon' => '666666666'
    ]);
    
}

Camps animal

...
public  function  test(){
    $animal=anicom()->altaAnimal([
        'identificacio' => '123456789012345',    
        'lloc_marcatge' => 1,    
        'especie' => 1,    //Gos
        'sexe' => 1,    //mascle
        'raca' => 2,    //fox terrier
        'idPkPare' => '11111116T'
        'nom_animal'=>'Bobby',
    ]);
    
}

Llocs de marcatge

Tipus de document identificador

Motius de baixa