odoo-addon-cooperator-sponsorship 16.0.1.0.1

Sponsorship module for cooperators in Som Connexió.

Integrate sponsored partners to the cooperative management.

Sponsees do not need to aport capital share to become a cooperative partner if a cooperative member sponsors them.

Table of contents

• Configuration

• Usage

  • Sponsorship relation

  • Sponsorship API

    • Check partner sponsorship data

    • Check if partner can sponsor

• Contributors

Configuration

On the company, set a default maximum sponsees number per partner.

Usage

Sponsorship relation

Cooperative members can sponsor new partners, being linked by a one2many relation, being the maximum number of sponsees customizable by company. They also have a sponsorship_hash, a code to identify them as sponsors, along with their vat number, through the API.

A wizard allows every sponsee to aport capital share and become members themselves

Sponsorship API

Variables to fill in these example curls:

• API_KEY: authorized key from the odoo server’s API-KEY

• ODOO_URL: target ODOO server’s URL

Check partner sponsorship data

curl -X GET \
 -H  "accept: application/json" \
 -H  "api-key: $API_KEY" \
 -H  "Content-Type: application/json" \
 "$ODOO_URL/api/partner/sponsees?ref=1234"

Where ref is the partner’s ref code. The returned data includes:

• sponsorship_code: code hash

• sponsees_max: Maximum number of sponsees per partner

• sponsees_number: Number of partner’s sponsees

• sponsees: List of names and surnames of partner’s sponsees

Check if partner can sponsor

curl -X GET \
 -H  "accept: application/json" \
 -H  "api-key: $API_KEY" \
 -H  "Content-Type: application/json" \
 "$ODOO_URL/api/partner/check_sponsor?vat=1234567A&sponsor_code=888B"

Required input params:

• vat: partner’s vat

• sponsor_code: Maximum number of sponsees per partner

Retured data:

• result: “allowed” or “not_allowed”

• message: “ok” or explanation for now allowed result

The usage is full integrated with the ORM of Odoo using listeners.

More info about the listeners: https://odoo-connector.com/api/api_components.html#listeners

Contributors

• Som Connexió SCCL <https://somconnexio.coop/>

  • Gerard Funonsas [e-mail]

  • Borja Gimeno [e-mail]

• Coopdevs Treball SCCL <https://coopdevs.coop/>

  • Daniel Palomar [e-mail]

  • Cesar Lopez [e-mail]

  • Carla Berenguer [e-mail]