edujugon/laradoo

Odoo ERP API for Laravel

Laradoo

, _(*1)

Odoo ERP API for Laravel. Odoo website, _(*2)

, _(*3)

Compatibility

Installation

type in console:, _(*4)

composer require edujugon/laradoo

Register Laradoo service by adding it to the providers array., _(*5)

'providers' => array(
        ...
        Edujugon\Laradoo\Providers\OdooServiceProvider::class
    )

Let's add the Alias facade, add it to the aliases array., _(*6)

'aliases' => array(
        ...
        'Odoo' => Edujugon\Laradoo\Facades\Odoo::class,
    )

Publish the package's configuration file to the application's own config directory, _(*7)

php artisan vendor:publish --provider="Edujugon\Laradoo\Providers\OdooServiceProvider" --tag="config"

Configuration

After publishing the package config file, the base configuration for laradoo package is located in config/laradoo.php, _(*8)

Also, you can dynamically update those values calling the available setter methods:, _(*9)

host($url), username($username), password($password), db($name), apiSuffix($name), _(*10)

Usage samples

Instance the main Odoo class:, _(*11)

$odoo = new \Edujugon\Laradoo\Odoo();

You can get the Odoo API version just calling the version method:, _(*12)

$version = $odoo->version();

This methods doesn't require to be connected/Logged into the ERP., _(*13)

Connect and log into the ERP:, _(*14)

$odoo = $odoo->connect();

All needed configuration data is taken from laradoo.php config file. But you always may pass new values on the fly if required., _(*15)

$this->odoo = $this->odoo
            ->username('my-user-name')
            ->password('my-password')
            ->db('my-db')
            ->host('https://my-host.com')
            ->connect();

// Note: host should contain 'http://' or 'https://', _(*16)

After login, you can check the user identifier like follows:, _(*17)

$userId= $this->odoo->getUid();

You always can check the permission on a specific model:, _(*18)

$can = $odoo->can('read', 'res.partner');

Permissions which can be checked: 'read','write','create','unlink', _(*19)

Method `search provides a collection of ids based on your conditions:, _(*20)

$ids = $odoo->where('customer', '=', true)
            ->search('res.partner');

You can limit the amount of data using limit method and use as many as condition you need:, _(*21)

$ids = $odoo->where('is_company', true)
            ->where('customer', '=', true)
            ->limit(3)
            ->search('res.partner');

If need to get a list of models, use the get method:, _(*22)

$models = $odoo->where('customer', true)
                ->limit(3)
                ->get('res.partner');

Instead of retrieving all properties of the models, you can reduce it by adding fields method before the method get, _(*23)

$models = $odoo->where('customer', true)
                ->limit(3)
                ->fields('name')
                ->get('res.partner');

If not sure about what fields a model has, you can retrieve the model structure data by calling fieldsOf method:, _(*24)

$structure = $odoo->fieldsOf('res.partner');

Till now we have only retrieved data from the ERP but you can also Create and Delete records., _(*25)

In order to create a new record just call create method as follows:, _(*26)

$id = $odoo->create('res.partner',['name' => 'Jonh Odoo']);

The method returns the id of the new record., _(*27)

For Deleting records we have the delete method:, _(*28)

$result = $odoo->where('name', 'Jonh Odoo')
            ->delete('res.partner');

Notice that before calling delete method you have to use where., _(*29)

You can also remove records by ids like follows:, _(*30)

$result = $odoo->deleteById('res.partner',$ids);

Update any record of your ERP:, _(*31)

$updated = $odoo->where('name', 'John Odoo')
            ->update('res.partner',['name' => 'John Odoo Odoo','email' => 'Johndoe@odoo.com']);

Notice that all delete and update methods always returns true except if there was an error., _(*32)

call method is also available for those who want to set a custom API call:, _(*33)

$odoo->call('res.partner', 'search',[
        [
            ['is_company', '=', true],
            ['customer', '=', true]
        ]
    ],[
        'offset'=>1,
        'limit'=>5
    ]);

Full API list