For the complete documentation index, see llms.txt. This page is also available as Markdown.

Update a data source

Fully updates a data source.

name and supplier_code are both required and must stay unique across all data sources.

Setting is_active to false removes every basket item on the storefront that references this data source. The data source record itself is kept and can be reactivated later.

put
/data_sources/{id}/
Authorizations
AuthorizationstringRequired

Token credential sent in the Authorization header, in the form: Token <your-token>. Requires a staff (admin) account.

Path parameters
idintegerRequired

The unique identifier of the data source.

Body

The body of a data source create or full update request.

namestring · max: 64Required

The seller's display name. Must be unique across all data sources.

slugstring · max: 64 · nullableOptional

A URL-safe identifier. Optional; must be unique when given.

titlestring · max: 255 · nullableOptional

The seller's full / legal name. Optional.

supplier_codestring · max: 50Required

The seller's unique business code. Must be unique across all data sources.

addressstring · nullableOptional

Postal address. Optional.

emailstring · nullableOptional

Contact e-mail address. Optional.

phone_numberstring · max: 128 · nullableOptional

Contact phone number. Optional.

fax_numberstring · max: 128 · nullableOptional

Fax number. Optional.

kep_addressstring · nullableOptional

Registered electronic-mail (KEP) address. Optional.

mersis_numberstring · max: 16 · nullableOptional

Central Registry (MERSIS) number. Optional.

trade_associationstring · max: 255 · nullableOptional

Trade association / chamber the seller belongs to. Optional.

extrasobjectOptional

Free-form JSON for extra data. Optional; defaults to an empty object.

price_listinteger · nullableOptional

The identifier of the price list supplying this seller's prices. Optional. Must reference an existing price list when given.

stock_listinteger · nullableOptional

The identifier of the stock list supplying this seller's stock. Optional. Must reference an existing stock list when given.

is_activebooleanOptional

Whether the data source is active. On create, omitting it stores the record as active.

Default: true
Responses
200

The updated data source.

application/json

A data source — the commercial and legal identity of a seller / supplier, bound to the price and stock lists it sells under.

pkintegerRead-onlyOptional

The unique identifier of the data source.

namestring · max: 64Optional

The seller's display name. Unique across all data sources.

slugstring · max: 64 · nullableOptional

A URL-safe identifier. Unique when set.

titlestring · max: 255 · nullableOptional

The seller's full / legal name.

supplier_codestring · max: 50Optional

The seller's unique business code.

addressstring · nullableOptional

Postal address.

emailstring · nullableOptional

Contact e-mail address.

phone_numberstring · max: 128 · nullableOptional

Contact phone number.

fax_numberstring · max: 128 · nullableOptional

Fax number.

kep_addressstring · nullableOptional

Registered electronic-mail (KEP) address.

mersis_numberstring · max: 16 · nullableOptional

Central Registry (MERSIS) number.

trade_associationstring · max: 255 · nullableOptional

Trade association / chamber the seller belongs to.

extrasobjectOptional

Free-form JSON for extra, integration-specific data.

price_listinteger · nullableOptional

The identifier of the price list supplying this seller's prices.

stock_listinteger · nullableOptional

The identifier of the stock list supplying this seller's stock.

is_activebooleanOptional

Whether the data source is active.

put/data_sources/{id}/
PUT /api/v1/remote/1/data_sources/{id}/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 125

{
  "name": "Main Supplier",
  "supplier_code": "SUP-001",
  "title": "Main Supplier Co.",
  "price_list": 2,
  "stock_list": 2,
  "is_active": true
}
{
  "pk": 8,
  "name": "Main Supplier",
  "slug": "main-supplier",
  "title": "Main Supplier Co.",
  "supplier_code": "SUP-001",
  "address": "123 Example Street",
  "email": "seller@example.com",
  "phone_number": "+902121234567",
  "fax_number": null,
  "kep_address": "seller@hs01.kep.tr",
  "mersis_number": "0123456789012345",
  "trade_association": "Chamber of Commerce",
  "extras": {},
  "price_list": 2,
  "stock_list": 2,
  "is_active": true
}

Last updated

Was this helpful?