Ajouter ou débiter des bonus

POST/api/crm/v2/clients_bonuses.addv2

operationId: clientsBonuses.add

Effectue une opération manuelle de crédit (type=accrual) ou de débit (type=withdraw) de bonus : avec mode=one — pour un seul client selon phone_format_id et phone_number, avec mode=all — pour tous les clients du réseau, avec possibilité de filtrer par gender. Les dates sont converties en UTC selon le fuseau horaire du point de vente. Indisponible tant que l’automatisation système est activée ; le client doit avoir les bonus activés. L’opération de masse retourne not_accrualed_for_phones — les numéros pour lesquels l’opération a échoué.

Autorisation

api-token + language + role

Corps de la requête `application/json`

object

modestringobligatoire

Valeurs:oneall

typestringobligatoire

Valeurs:accrualwithdraw

chain_idintegerobligatoire

Exemple: 7124

date_availablestring (DataTimeFormat)

Exemple: 17:45 06/05/2024

date_expirationstring (DataTimeFormat)

Exemple: 17:45 06/05/2024

descriptionstring

Pour type=accrual

sumnumberobligatoire

Exemple: 125.5

phone_format_idinteger (PhoneFormatId)

Code du pays : 1-🇷🇺(+7|8), 2-🇦🇿(+994|0), 3-🇧🇾(+375|80), 4-🇰🇿(+7|8), 6-🇷🇸(+381|0), 7-🇹🇷(+90|0), 8-🇺🇦(+380|0), 9-🇵🇹(+351|0), 10-🇰🇬(+996|0), 11-🇺🇸(+1), 12-🇫🇷(+33|0), 13-🇲🇩(+373|0), 15-🇪🇪(+372), 18-🇬🇪(+995), 19-🇺🇿(+998), 22-🇵🇱(+48|0), 23-🇹🇯(+992|8), 25-🇷🇴(+40|0), 44-🇨🇭(+41|0)

Exemple: 1

phone_numberstring

Pour mode=one

Exemple: 999-999-99-99

genderstring

Pour mode=all

Valeurs:manwoman

Réponses

object

statusstringobligatoire

Valeurs:successerror

Exemple: success

dataobject

curl -X POST 'https://foodsoul.pro/api/crm/v2/clients_bonuses.add' \
  -H 'Authorization: Bearer fs_api_YOUR_TOKEN' \
  -H 'language: fr' \
  -H 'role: partner' \
  -H 'Content-Type: application/json' \
  -d '{"mode":"one","type":"accrual","chain_id":7124,"date_available":"17:45 06/05/2024","date_expiration":"17:45 06/05/2024","description":"string","sum":125.5,"phone_format_id":1,"phone_number":"999-999-99-99","gender":"man"}'

<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://foodsoul.pro/api/crm/v2/clients_bonuses.add', [
    'headers' => [
        'Authorization' => 'Bearer fs_api_YOUR_TOKEN',
        'language' => 'fr',
        'role' => 'partner',
    ],
    'json' => [
        'mode' => 'one',
        'type' => 'accrual',
        'chain_id' => 7124,
        'date_available' => '17:45 06/05/2024',
        'date_expiration' => '17:45 06/05/2024',
        'description' => 'string',
        'sum' => 125.5,
        'phone_format_id' => 1,
        'phone_number' => '999-999-99-99',
        'gender' => 'man',
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch("https://foodsoul.pro/api/crm/v2/clients_bonuses.add", {
    method: "POST",
    headers: {
        "Authorization": "Bearer fs_api_YOUR_TOKEN",
        "language": "fr",
        "role": "partner",
        "Content-Type": "application/json"
    },
    body: JSON.stringify({
        "mode": "one",
        "type": "accrual",
        "chain_id": 7124,
        "date_available": "17:45 06/05/2024",
        "date_expiration": "17:45 06/05/2024",
        "description": "string",
        "sum": 125.5,
        "phone_format_id": 1,
        "phone_number": "999-999-99-99",
        "gender": "man"
    }),
})
const data = await response.json()

import requests

response = requests.request(
    "POST",
    "https://foodsoul.pro/api/crm/v2/clients_bonuses.add",
    headers={
        "Authorization": "Bearer fs_api_YOUR_TOKEN",
        "language": "fr",
        "role": "partner",
    },
    json={
        "mode": "one",
        "type": "accrual",
        "chain_id": 7124,
        "date_available": "17:45 06/05/2024",
        "date_expiration": "17:45 06/05/2024",
        "description": "string",
        "sum": 125.5,
        "phone_format_id": 1,
        "phone_number": "999-999-99-99",
        "gender": "man",
    },
)
data = response.json()

Réponse 200

{
  "status": "success",
  "data": {}
}

Les requêtes sont envoyées à foodsoul.pro — l’hôte de ce portail, il n’est pas possible d’en choisir un autre.

Ajouter ou débiter des bonus

Autorisation

Corps de la requête application/json

Réponses

Corps de la requête `application/json`