Create a supplier

Admin, inventory manager, or branch manager. Registers a supplier, active from creation. Absent contact fields are stored empty, and type, lead time, and reliability default.

POST/api/v1/suppliers

Authorization

AuthorizationBearer token (JWT) · headerrequired

JWT from POST /api/v1/auth/login sent as Authorization Bearer.

Request body

requiredapplication/json

namestringrequired

tax_numberstring

contact_personstring

phonestring

emailstring

addressstring

supplier_typestring

lead_time_daysinteger

min -9007199254740991 · max 9007199254740991

reliability_scorenumber

Responses

201

Supplier created

idstringrequired

namestringrequired

tax_numberstringrequired

contact_personstringrequired

phonestringrequired

emailstringrequired

addressstringrequired

supplier_typestringrequired

lead_time_daysintegerrequired

min -9007199254740991 · max 9007199254740991

reliability_scorenumberrequired

is_activebooleanrequired

created_atstringrequired

updated_atstringrequired

401

Not authenticated

detailstringrequired

403

Caller is not an admin, inventory manager, or branch manager

detailstringrequired

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer token (JWT)Remember on this deviceInclude my values in samples

Bodyapplication/json

namestring*tax_numberstringcontact_personstringphonestringemailstringaddressstringsupplier_typestringlead_time_daysintegerreliability_scorenumber

Request

curl -X POST 'http://localhost:8000/api/v1/suppliers' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "string",
  "tax_number": "string",
  "contact_person": "string",
  "phone": "string",
  "email": "string",
  "address": "string",
  "supplier_type": "string",
  "lead_time_days": -9007199254740991,
  "reliability_score": 0
}'

const response = await fetch("http://localhost:8000/api/v1/suppliers", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"name\": \"string\",\n  \"tax_number\": \"string\",\n  \"contact_person\": \"string\",\n  \"phone\": \"string\",\n  \"email\": \"string\",\n  \"address\": \"string\",\n  \"supplier_type\": \"string\",\n  \"lead_time_days\": -9007199254740991,\n  \"reliability_score\": 0\n}"
});

import requests

response = requests.post(
    "http://localhost:8000/api/v1/suppliers",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"name\": \"string\",\n  \"tax_number\": \"string\",\n  \"contact_person\": \"string\",\n  \"phone\": \"string\",\n  \"email\": \"string\",\n  \"address\": \"string\",\n  \"supplier_type\": \"string\",\n  \"lead_time_days\": -9007199254740991,\n  \"reliability_score\": 0\n}",
)

Response

{
  "id": "string",
  "name": "string",
  "tax_number": "string",
  "contact_person": "string",
  "phone": "string",
  "email": "string",
  "address": "string",
  "supplier_type": "string",
  "lead_time_days": -9007199254740991,
  "reliability_score": 0,
  "is_active": true,
  "created_at": "string",
  "updated_at": "string"
}

{
  "detail": "string"
}

{
  "detail": "string"
}