Ajouter des représentants

Vous pouvez ajouter des représentants et bénéficiaires depuis l'endpoint POST /company.

Vous pouvez également ajouter ou modifier des représentants et bénéficiaires depuis l'endpoint PATCH /company.

Représentants

Un représentant peut être une personne physique ou morale.

Personne physique

Renseigner person en cas de personne physique :

Payload JSON

{
  "representatives": [{
    "transaction-identifier": "Jeanne-id",
    "person": {
      "address": {
        "city": "Paris",
        "country": "fra",
        "line1": "11 rue",
        "zip-code": "75007"
      },
      "birth": {
        "country": "fra",
        "date": "1992-02-28",
        "department": "75018",
        "place": "Paris"
      },
      "country-residence": "fra",
      "first-name": "Jeanne",
      "last-name": "Doe",
      "nationality": "fra"
    },
    "position": "ei_gerant"
  }]
}

import requests
import json

url = "https://api-partners.stancer.com/api/partners/company?id=comp_pQ2rLuQrMUwufhyqbzYXe58D"

payload = json.dumps({
  "representatives": [
    {
      "transaction-identifier": "Jeanne-id",
      "person": {
        "address": {
          "city": "Paris",
          "country": "fra",
          "line1": "11 rue",
          "zip-code": "75007"
        },
        "birth": {
          "country": "fra",
          "date": "1992-02-28",
          "department": "75018",
          "place": "Paris"
        },
        "country-residence": "fra",
        "first-name": "Jeanne",
        "last-name": "Doe",
        "nationality": "fra"
      },
      "position": "ei_gerant"
    }
  ]
})
headers = {
  'Content-Type': 'application/json'
}

response = requests.request("PATCH", url, headers=headers, data=payload)

print(response.json())

Renseigner l'identifiant du représentant lorsque vous souhaitez le mettre à jour :

Payload JSON

{
  "representatives": [{
    "person": {
      "id": "pers_ixk24J12a8xEk4IirtGb3HQn",
      "last-name": "Dupont"
    }
  }]
}

import requests
import json

url = "https://api-partners.stancer.com/api/partners/company?id=comp_pQ2rLuQrMUwufhyqbzYXe58D"

payload = json.dumps({
  "representatives": [
    {
      "person": {
        "id": "pers_ixk24J12a8xEk4IirtGb3HQn",
        "last-name": "Dupont",
      },
    }
  ]
})
headers = {
  'Content-Type': 'application/json'
}

response = requests.request("PATCH", url, headers=headers, data=payload)

print(response.json())

Personne morale

Renseigner company pour une personne morale :

Payload JSON

{
  "representatives": [{
    "company": {
      "legal-form": "fra_ei",
      "country": "fra",
      "legal-id": "34237633200082",
      "legal-name": "ILIAD",
      "headquarters-address": {
        "city": "Paris",
        "country": "fra",
        "line1": "54 rue",
        "zip-code": "75001"
      },
      "activity-reference": "49.32Z",
      "representatives": [{
        "person": {
          "address": {
            "city": "Paris",
            "country": "fra",
            "line1": "32 rue",
            "zip-code": "75007"
          },
          "birth": {
            "country": "fra",
            "date": "1993-09-28",
            "department": "75006",
            "place": "Paris"
          },
          "country-residence": "fra",
          "first-name": "John",
          "last-name": "Doe",
          "nationality": "fra"
        },
        "position": "ei_gerant"
      }]
    },
    "position": "ei_gerant"
  }]
}

import requests
import json

url = "https://api-partners.stancer.com/api/partners/company?id=comp_mNQDwnraMLmyWNZUXfvvVIgF"

payload = json.dumps({
  "representatives": [
    {
      "company": {
        "legal-form": "fra_ei",
        "country": "fra",
        "legal-id": "34237633200082",
        "legal-name": "ILIAD",
        "headquarters-address": {
          "city": "Paris",
          "country": "fra",
          "line1": "54 rue",
          "zip-code": "75001"
        },
        "activity-reference": "49.32Z",
        "representatives": [
          {
            "person": {
              "address": {
                "city": "Paris",
                "country": "fra",
                "line1": "32 rue",
                "zip-code": "75007"
              },
              "birth": {
                "country": "fra",
                "date": "1993-09-28",
                "department": "75006",
                "place": "Paris"
              },
              "country-residence": "fra",
              "first-name": "John",
              "last-name": "Doe",
              "nationality": "fra"
            },
            "position": "ei_gerant"
          }
        ]
      },
      "position": "ei_gerant"
    }
  ]
})
headers = {
  'Content-Type': 'application/json'
}

response = requests.request("PATCH", url, headers=headers, data=payload)

print(response.json())

Une personne morale doit être renseignée avec au moins un représentant.

Position

Utiliser l'endpoint GET /legal-form-position?legal-form=<code> pour récupérer le code des positions possibles en fonction de la forme juridique de la société :

import requests

url = "https://api-partners.stancer.com/api/partners/legal-form-position?legal-form=fra_ei"

payload = {}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.json())

Réponse :

[
    {
        "code": "ei_gerant",
        "name": "Gérant"
    }
]

Bénéficiaires

Un bénéficiaire est une personne physique.

Payload JSON

{
  "owners": [{
    "person": {
      "address": {
        "city": "Paris",
        "country": "fra",
        "line1": "10 rue",
        "zip-code": "75008"
      },
      "birth": {
        "country": "fra",
        "date": "1991-01-28",
        "department": "75017",
        "place": "Paris"
      },
      "country-residence": "fra",
      "first-name": "Jean",
      "last-name": "Dupont",
      "nationality": "fra"
    },
    "capital": 1.0,
    "control": true,
    "votes": 1.0
  }]
}

import requests
import json

url = "https://api-partners.stancer.com/api/partners/company?id=comp_mNQDwnraMLmyWNZUXfvvVIgF"

payload = json.dumps({
  "owners": [
    {
      "person": {
        "address": {
          "city": "Paris",
          "country": "fra",
          "line1": "10 rue",
          "zip-code": "75008"
        },
        "birth": {
          "country": "fra",
          "date": "1991-01-28",
          "department": "75017",
          "place": "Paris"
        },
        "country-residence": "fra",
        "first-name": "Jean",
        "last-name": "Dupont",
        "nationality": "fra"
      },
      "capital": 1.0,
      "control": True,
      "votes": 1.0
    }
  ]
})
headers = {
  'Content-Type': 'application/json'
}

response = requests.request("PATCH", url, headers=headers, data=payload)

print(response.json())

capital et votes correspondent au pourcentage que possède le bénéficiaire sur la société (0.0 = 0%, 1.0 = 100%).

control indique si le bénéficiaire à un pouvoir de contrôle sur la société.

transaction-identifier (optionnel)

Un identifiant que vous spécifiez pour vous aider à reconnaître le représentant ou bénéficiaire que vous avez créé ou mis à jour.

Il vous sera renvoyé avec les objets des représentants, bénéficiaires et documents d'identité.

Supprimer un représentant ou bénéficiaire

Utiliser l'endpoint DELETE /company-head?company=<comp>&id=<pers/comp>&type=<representative/owner> afin de supprimer un représentant ou bénéficiaire :

import requests

url = "https://api-partners.stancer.com/api/partners/company-head?company=comp_mNQDwnraMLmyWNZUXfvvVIgF&id=pers_LBhl5B2miYW2O95gGrw5G5pI&type=representative"

payload = {}
headers = {}

response = requests.request("DELETE", url, headers=headers, data=payload)

print(response.json())