1. Création
WsOne
  • 🏠 Accueil
  • 👋 Introduction
  • ⚙ Workflows / Use Cases
  • 📚 Dictionnaire de donnĂ©es
  • ❌ Codes erreurs
  • WS Person
    • Clients
      • CrĂ©ation
        • createPersonAndIdentifier
          POST
        • createPerson
          POST
        • createIdentifier
          POST
        • associateNewIdentifier
          POST
        • associateIdentifier
          POST
        • replaceIdentifier
          POST
      • Consultation / Recherche
        • getPerson
        • searchPerson
        • getAccounts
        • getFullPerson
        • searchPersonLite
        • getBadge
      • Update
        • updatePerson
    • Offres
      • getAvailableOffers
      • getEnableOffers
      • editOffer
    • Formulaires
      • getForm
      • updateForm
    • Magasins
      • getEntities
      • getEntityParents
  • WS Transaction
    • sendTransaction
    • validTransaction
    • sendAndValidTransaction
    • sendAndValidFullTransaction
    • verifyTransaction
    • cancelTransactionsNotValidated
    • sendSimpleTransaction
    • refundTransaction
    • getLastTransaction
  • Schemas
    • Response
      • AccountResponse
      • NewIdentifierResponse
      • PersonResponse
      • IdentifierResponse
      • SegmentationResponse
      • SubscriptionResponse
      • EntityResponse
      • EmailResponse
      • CellPhoneResponse
      • ContactsReponse
      • InfoPersonResponse
      • GetPersonReponse
      • AccountResponse
      • classifications
      • OfferReponse
      • AddressResponse
    • Request
      • IdentifierRequest
      • EntityRequest
      • ContactRequest
      • PersonRequest
      • PersonProfilRequest
      • NewIdentifierRequest
      • AdressRequest
      • EmailRequest
      • CellPhoneRequest
      • FullPersonRequest
      • SubscriptionRequest
      • FormAnsweredRequest
      • AssociatedIdentifierRequest
      • AccountAdvantageRequest
      • ReceiptRequest
      • DetailsRequest
  1. Création

createPersonAndIdentifier

POST
/rest/2.0/personWebService/createPersonAndIdentifier
Maintainer:Martin DA COSTA NETO
Permet de créer un nouveau client fidélité, selon deux modes :
Mode 1
Mode 2
Demande de création d'une carte dématérialisée + un autre identifiant déjà défini (compte web, UUID, etc..).
L'objet NewIdentifierRequest doit ĂȘtre prĂ©sent.
Si le compte est créé en mode 1, alors il faut faire appel au getPerson avec l'identifiant renseigné afin de récupérer la carte dématérialisée.
Si le compte est créé en mode 2, le WS répond avec le n° de carte dématérialisée générée.

Exemple 1 :#

Suite à une inscription sur le site, je créé un client fidélité avec carte dématérialisée + un compte web "email-test@email.fr".
Dans l'appel il faut renseigner :
identifierType = 10 (compte web) + identifierValue = email@email.fr.
newIdentifierType = 1 pour demander la carte de fidélité.
Une fois le compte créé, et si je veux récupérer le n° de carte dématérialisée, il faut ensuite faire un getPerson avec comme paramÚtre :
identifierType = 10 (compte web)
identifierValue = email@email.fr

Exemple 2 :#

Suite à un embasement en caisse, le client me donne ses informations et je souhaite lui créer une carte dématérialisée.
Dans l'appel il faut donc renseigner :
newIdentifierType = 1 pour demander la carte de fidélité.
Une fois le compte créé, le WS renvoi automatiquement le n° de carte.

Request

Authorization
Send your HTTP requests with an
Authorization
header that contains the word Basic followed by a space and a base64-encoded string username:password
Example:
Authorization: Basic *****************
Header Params

Body Params application/json

Example
{
    "NewIdentifierRequest": {
        "identifierType": 1,
        "identifierValue": "1110987654321"
    },
    "newIdentifierType": 1,
    "PersonProfilRequest": {
        "ContactsRequest": {
            "AddressRequest": {
                "allowCompanySolicitation": 1,
                "allowTrustedSolicitation": 0,
                "address1": "ADDR 2",
                "address2": "ADDR 3",
                "address3Name": "DE LA LIBERTE",
                "address3Num": 13,
                "address3Type": 5,
                "address4": "ADDR 4",
                "city": "LILLE",
                "country": "FRANCE",
                "zipCode": "59000"
            },
            "EmailRequest": {
                "allowCompanySolicitation": 1,
                "allowTrustedSolicitation": 0,
                "emailValue": "email-test@email.fr"
            },
            "CellPhoneRequest": {
                "allowCompanySolicitation": 1,
                "allowTrustedSolicitation": 0,
                "model": "S24",
                "brand": "Samsung",
                "dialingCode": "33",
                "number": "0612345678"
            }
        },
        "EntityRequest": {
            "entityIdentifier": "123456"
        },
        "PersonRequest": {
            "birthDate": "01/01/2000",
            "firstName": "JEAN",
            "lastName": "DUPOND",
            "title": 1
        }
    },
    "SubscriptionRequest": [
        {
            "activate": true,
            "id": 1
        },
        {
            "activate": true,
            "id": 2
        }
    ],
    "source": "API-DOG"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/rest/2.0/personWebService/createPersonAndIdentifier' \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "NewIdentifierRequest": {
        "identifierType": 1,
        "identifierValue": "1110987654321"
    },
    "newIdentifierType": 1,
    "PersonProfilRequest": {
        "ContactsRequest": {
            "AddressRequest": {
                "allowCompanySolicitation": 1,
                "allowTrustedSolicitation": 0,
                "address1": "ADDR 2",
                "address2": "ADDR 3",
                "address3Name": "DE LA LIBERTE",
                "address3Num": 13,
                "address3Type": 5,
                "address4": "ADDR 4",
                "city": "LILLE",
                "country": "FRANCE",
                "zipCode": "59000"
            },
            "EmailRequest": {
                "allowCompanySolicitation": 1,
                "allowTrustedSolicitation": 0,
                "emailValue": "email-test@email.fr"
            },
            "CellPhoneRequest": {
                "allowCompanySolicitation": 1,
                "allowTrustedSolicitation": 0,
                "model": "S24",
                "brand": "Samsung",
                "dialingCode": "33",
                "number": "0612345678"
            }
        },
        "EntityRequest": {
            "entityIdentifier": "123456"
        },
        "PersonRequest": {
            "birthDate": "01/01/2000",
            "firstName": "JEAN",
            "lastName": "DUPOND",
            "title": 1
        }
    },
    "SubscriptionRequest": [
        {
            "activate": true,
            "id": 1
        },
        {
            "activate": true,
            "id": 2
        }
    ],
    "source": "API-DOG"
}'

Responses

🟱200Success
application/json
Body

Examples
{
    "responseCode": "000",
    "infos": "Request successfully processed",
    "NewIdentifierResponse": null
}
Modified at 2026-01-05 13:52:36
Previous
WS Person
Next
createPerson
Built with