Créer un fournisseur

Crée un fournisseur. Nécessite une clé Write.

POST/suppliers

Autorisation

AuthorizationJeton Bearer (clé API) · headerobligatoire

Clé API de l’organisation.

Corps de la requête

obligatoireapplication/json

namestringobligatoire

min length 1

externalIdstring

Identifiant externe facultatif

companystring

citystring

streetstring

plzstring

emailstring

payoutEmailstring

orderEmailstring

phonestring

contactPersonstring

contactPhonestring

dailyMailstring

supplierMarginnumber

ibanstring

bicstring

bankNamestring

payoutsEnabledboolean

Réponses

200

Fournisseur créé

successbooleanobligatoire

idstringobligatoire

400

Paramètres ou corps invalides.

statusCodeintegerobligatoire

Code de statut HTTP

messagestringobligatoire

Message d’erreur lisible

timestampstring<date-time>obligatoire

Moment de l’erreur (UTC).

pathstringobligatoire

URL de la requête (chemin et chaîne de requête).

403

Clé API absente, inconnue ou inactive, ou clé Read sur une opération d’écriture.

statusCodeintegerobligatoire

Code de statut HTTP

messagestringobligatoire

Message d’erreur lisible

timestampstring<date-time>obligatoire

Moment de l’erreur (UTC).

pathstringobligatoire

URL de la requête (chemin et chaîne de requête).

Essayer

Serveur

URL de baseURL de base personnaliséeRemplace le serveur sélectionné si renseignée.

Autorisation

Jeton Bearer (clé API)Mémoriser sur cet appareilUtiliser mes valeurs dans les exemples

Bodyapplication/json

namestring*externalIdstringIdentifiant externe facultatifcompanystringcitystringstreetstringplzstringemailstringpayoutEmailstringorderEmailstringphonestringcontactPersonstringcontactPhonestringdailyMailstringsupplierMarginnumberibanstringbicstringbankNamestringpayoutsEnabledboolean

Requête

curl -X POST 'https://dashboard.scango.ch/api/v1/suppliers' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Exemple SA",
  "company": "Exemple SA",
  "city": "Zürich",
  "street": "Bahnhofstrasse 1",
  "plz": "8001",
  "email": "orders@example.ch"
}'

const response = await fetch("https://dashboard.scango.ch/api/v1/suppliers", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: "{\n  \"name\": \"Exemple SA\",\n  \"company\": \"Exemple SA\",\n  \"city\": \"Zürich\",\n  \"street\": \"Bahnhofstrasse 1\",\n  \"plz\": \"8001\",\n  \"email\": \"orders@example.ch\"\n}"
});

import requests

response = requests.post(
    "https://dashboard.scango.ch/api/v1/suppliers",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    data="{\n  \"name\": \"Exemple SA\",\n  \"company\": \"Exemple SA\",\n  \"city\": \"Zürich\",\n  \"street\": \"Bahnhofstrasse 1\",\n  \"plz\": \"8001\",\n  \"email\": \"orders@example.ch\"\n}",
)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => 'https://dashboard.scango.ch/api/v1/suppliers',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer YOUR_TOKEN',
    'Accept: application/json',
    'Content-Type: application/json',
  ],
  CURLOPT_POSTFIELDS => '{
  "name": "Exemple SA",
  "company": "Exemple SA",
  "city": "Zürich",
  "street": "Bahnhofstrasse 1",
  "plz": "8001",
  "email": "orders@example.ch"
}',
]);

$response = curl_exec($curl);

Réponse

{
  "success": true,
  "id": "newSupplierId"
}

{
  "statusCode": 400,
  "message": "Validation failed for Field: name, Error: Required",
  "timestamp": "2024-04-20T12:00:00.000Z",
  "path": "/api/v1/suppliers"
}

{
  "statusCode": 403,
  "message": "Unknown Error",
  "timestamp": "2024-04-20T12:00:00.000Z",
  "path": "/api/v1/products"
}