Étape 1: Créer le vendeur
Cette étape permet de créer la demande d’enrôlement du vendeur en faisant un POST sur la ressource REGISTRATION avec ses informations complètes.
POST : https://secure.lyra.com/marketplace/registrations/
A la création d’un nouveau vendeur, les éléments suivants sont contrôlés par l’API et font l’objet d’un code de retour d’erreur 40X s’ils ne sont pas valides :
- Vérification que les champs obligatoires sont renseignés
- Vérification qu’au moins un représentant légal est spécifié et que ses coordonnées sont précisées
- Vérification que chaque adresse mail spécifiée est unique dans le système
- Vérification qu’il y a une (et une seule) activité principale renseignée
- Pour chaque activité, un identifiant doit être renseigné (SIRET ou legal_identifier)
- Vérification qu’il n’y a pas de doublon sur les identifiants d’activité au cas où plusieurs activités sont renseignées (i.e. le SIRET ne doit être rattaché qu’à une seule activité).
Le tableau ci-dessous liste les champs à fournir en appel à la création d'une demande d’enrôlement
Vérifiez que chaque devise supportée par la Marketplace est correctement assignée à un IBAN;
Nom | Description | Format | Obligatoire |
---|---|---|---|
marketplace | Identifiant de la marketplace | ans..36 | X |
reference | Référence technique de l’enrôlement | ans..255 | X |
description | Description de l’enrôlement | ans..255 | |
person_type | PM : Personne morale PP : Personne Physique |
X | |
title | Pour les personnes physiques : MR, MS ou MRS | Si person_type = PP | |
first_name | Pour les personnes physiques : Prénom | Si person_type = PP | |
last_name | Pour les personnes physiques : Nom | Si person_type = PP | |
name | Nom du vendeur | ans..255 | X |
trading_name | Pour les personnes morales : Nom commercial | ans..255 | Si person_type = PM |
nature | Raison sociale | ans..255 | |
iban | IBAN de paiement | ans..34 | X |
vat_number | Numéro de TVA | ans..16 | X |
legal_form | Forme juridique | ans..4 | X |
economic_agent | Code ISO d’agent économique (exemple : "ISO_301") | ans..255 | X |
external_ref | Référence externe du vendeur (Pourra être utilisé comme identifiant des vendeurs dans les autres API) | ans.50 | |
turnover | Chiffre d’affaire estimé (en centimes) | numérique | X |
cashout_delay | Délai de déblocage des fonds (en jours) | ans..180 | |
address | Adresse de la société du vendeur | X | |
address.street_number | Numéro de voie | ans..5 | |
address.street | Type de voie | ans..255 | |
address.district | Complément d’adresse | ans..127 | |
address.zipcode | Code postal | ans..64 | X |
address.city | Ville | ans..128 | X |
address.state | Etat/Province | ans..127 | |
address.country | Code pays sur 2 lettres (code ISO 3166-1 alpha-2) | ans..2 | X |
board | Représentant légal [LEGAL_REP] et liste des bénéficiaires effectifs [BENEFICIARY] | A minima le représentant légal | |
board.role | Qualité de la personne au sein de la société | [LEGAL_REP| BENEFICIARY] | X |
board.title | Civilité de la personne | [MR|MS|MRS] | X |
board.first_name | Prénom de la personne | ans..63 | X |
board.last_name | Nom de la personne | ans..63 | X |
board.birth_date | Date de naissance de la personne | Date au format YYYY-MM-DD | X |
board.birth_city | Ville de naissance de la personne | ans..128 | X |
board.nationality | Nationalité de la personne (code ISO 3166-1 alpha-2 du pays) | ans..2 | X |
board.phone_number | Numéro de téléphone de la personne | ans..32 | X |
board.email | Adresse e-mail de la personne | ans..150 | X |
board.address | Adresse personnelle de la personne (Note : les mêmes champs que pour l’adresse d’entreprise sont nécessaires pour l’adresse de chacune des personnes transmises) | X | |
activities | Liste des activités du vendeur | ||
activity.name | Enseigne de la boutique | Texte | X |
activity.url | Adresse Internet de la boutique | ans..200 | |
activity.registration_date | Date d’immatriculation de l’activité | Date au format YYYY-MM-DD | X |
activity.siret | Identifiant SIRET de l’activité | ans..14 | |
activity.legal_identifier | Identifiant légal de l’activité | ans..20 | |
activity.mcc | Code MCC (merchant category code) | ans..4 | X |
activity.naf_code | Code NAF | ans..5 | |
activity.is_principal | Indique s’il s’agit de l’activité principale du vendeur | [true|false] | X |
Exemple d'appel POST REGISTRATION
{ "marketplace": "d085b6bb-4b8e-4f23-b84a-c9e5fafaf3dd", "reference": "registration002", "description": "Vendeur Acme Corp 20180116", "person_type": "PM", "name": "Acme Corporation", "trading_name": "Acme Corp.", "nature": "SARL", "iban": "FR76300040000XXXXXXXXXX0143", "vat_number": "FRXX123456789", "legal_form": 5710, "economic_agent": "ISO_305", "external_ref": "acmeref", "turnover": 100000000, "address":{ "zipcode": "12345", "street_number": "4", "country":"FR", "street": "rue des Souris", "city": "BOUVISE" }, "board": [ { "role": "LEGAL_REP","title": "MR", "first_name": "Thomas", "last_name": "Coyote", "birth_date": "1949-09-17", "birth_city": "BURBANK", "nationality": "FR", "phone_number": "0123456789", "email": "thomas@acme.com", "address": { "zipcode": "12345", "street_number": "12", "country": "FR", "street": "grande rue", "city": "PARIS" } } ], "activities": [ { "name": "Acme Tennis Ball", "url": "http://www.acmezzz.com", "registration_date": "2017-03-24", "siret": "99556699889944", "mcc": "5995", "naf": "4623Z", "legal_identifier": "995566998", "is_principal": "true" } ] }