Etape 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

Nom Description Format Obligatoire
marketplace Identifiant de la marketplace ans-..36
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 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) ans
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 email 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"
                }
        ]
}