Datos de referencia del producto · API Referencia

Marcas

Crear y encontrar marcas, mapearlas a Ozon y 1C, gestionar logotipos, y fusionar copias de forma segura.

9 puntos finales/api/brandEstablesDescripción legible por máquina ↗

{ }

Para los productos sin marca, primero crea un registro dedicado No brand y usa su identificador en las tarjetas de producto.

/api/brand

Flujos de trabajo listos para su uso

Encuentra o crea una marca antes de crear un producto

Busque el nombre exacto primero. Si las filas están vacías, cree la marca y almacena la marca ID para la tarjeta de producto.

Llame GET /api/brand/find con consulta y cuenta=verdad.
Compare el nombre de caso-insensiblemente en su solicitud.
Si no existe coincidencia, envíe POST /api/brand con nombre.
Utilice la marcaId de la respuesta al crear el modelo de producto.

GETEncuentra marcas POSTCrear una marca

Sincronizar el directorio con 1C

Mantenga la llave 1C en un CId y obtenga páginas en lugar de cargar todo el directorio en una sola solicitud.

Solicite 50 500 registros a la vez, ordenados por BRANDID.
Establezca count=true en la primera solicitud para recibir total.
Crear registros faltantes o actualizar coincidencias encontradas por brandOneCId.

GETEncuentra marcas POSTCrear una marca PUTActualizar una marca

Eliminar un duplicado sin perder enlaces de producto

Merge traslada los modelos de producto del duplicado a la marca principal y luego elimina el duplicato.

Traiga y verifique ambos identificadores de marca.
Pasar el nombre de marca principal y eliminar el nombre duplicado.
Traiga de nuevo la marca principal y verifique los productos relacionados.

GETObtenga una marca por identificación POSTDuplicados de fusión

Modelo de datos

Fields regresó en Brand.

Los campos de logotipo aparecen después de que se carga una imagen. Los campos del modelo compartido que no participan en este API se omiten intencionalmente.

Brand10 campos

brandIdinteger

Identificador de marca dentro de la cuenta SelSup actual.

read-only

namestring

Los espacios de ventaja y de seguimiento se eliminan cuando se guardan.

Obligatorio

logoUrlstring

La dirección de dirección de la dirección de inicio del logotipo actual.

read-only

logoSizeinteger

Tamaño del logotipo en bytes.

read-only

logoWidthinteger

Ancho del logotipo en píxeles.

read-only

logoHeightinteger

Alteza del logotipo en píxeles.

read-only

deletedboolean

Si la marca está archivada.

ozonNamestring

Nombre de marca en el catálogo de Ozon.

nullable

ozonIdinteger · int64

Identificación de marca en Ozon.

nullable

oneCIdstring

Identificación externa de marca en 1C.

nullable

Contrato de error

Cómo se devuelven los errores de aplicación

El código error es idéntico en todas las localizaciones, mientras que el mensaje orientado al usuario es traducido por el servidor.

Exproteccion

Código estable legible por máquina para la lógica de integración.

Exproteccion

Mensaje listo para la pantalla en el idioma del usuario de tokens API.

Exproteccion

Valores interpolados por el servidor en la plantilla de mensaje localizado.

文

localMessage utiliza el campo lang del usuario que posee el token API. El lenguaje de documentación y el encabezado Accept-Language no lo cambian; el ruso se utiliza cuando el usuario no tiene un idioma configurado.

RUEl lugar del usuario es ru

{
  "error": "error_brand_already_exists",
  "localMessage": "Бренд Base уже существует",
  "params": {
    "name": "Base"
  }
}

ESEspañol (es)

{
  "error": "error_brand_already_exists",
  "localMessage": "La marca Base ya existe",
  "params": {
    "name": "Base"
  }
}

Puntos finales

GET

Encuentra marcas

/api/brand/find

Token con acceso a lectura

El punto final principal para listas, búsqueda y sincronización. devuelve marcas de la cuenta corriente y admite una paginado estable.

total se devuelve sólo cuando count=true. Deshabilitar el recuento para las páginas posteriores.

Parámetros de consulta

Campo	Tipo	Obligatorio	Descripción
`query`	string	No	Substring para buscar en el nombre de la marca.
`deleted`	boolean	No	Es verdad para archivado, falso para activo.
`brandOneCId`	string	No	Identificador externo 1C exacto.
`hasOzonId`	boolean	No	Es verdad que sólo devuelven marcas que se hayan mapeado a Ozon.
`limit`Valor predeterminado: 50	integer	No	Registros por página, hasta 500.
`page`Valor predeterminado: 1	integer	No	Número de página a partir de 1.
`count`Valor predeterminado: false	boolean	No	Incluya el número total de partidas.
`sortBy`	stringNAME, BRANDID	No	Nombre para la marca, marca para el identificador interno.
`ascending`Valor predeterminado: false	boolean	No	Verdadero para ascender, falso para bajar.

curl --request GET 'https://api.selsup.ru/api/brand/find?query=Base&limit=50&page=1&count=true&sortBy=NAME&ascending=true' \
  --header 'Authorization: YOUR_API_TOKEN'

const response = await fetch('https://api.selsup.ru/api/brand/find?query=Base&limit=50&page=1&count=true&sortBy=NAME&ascending=true', {
  method: 'GET',
  headers: { Authorization: process.env.SELSUP_API_TOKEN },
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const result = await response.json();

const response: Response = await fetch('https://api.selsup.ru/api/brand/find?query=Base&limit=50&page=1&count=true&sortBy=NAME&ascending=true', {
  method: 'GET',
  headers: { Authorization: process.env.SELSUP_API_TOKEN! },
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

const result: unknown = await response.json();

import os
import requests

response = requests.get(
    'https://api.selsup.ru/api/brand/find?query=Base&limit=50&page=1&count=true&sortBy=NAME&ascending=true',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()
result = response.json()

<?php

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/brand/find?query=Base&limit=50&page=1&count=true&sortBy=NAME&ascending=true',
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

import (
    "fmt"
    "io"
    "net/http"
    "os"
)

func main() {
    req, err := http.NewRequest("GET", "https://api.selsup.ru/api/brand/find?query=Base&limit=50&page=1&count=true&sortBy=NAME&ascending=true", nil)
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/brand/find?query=Base&limit=50&page=1&count=true&sortBy=NAME&ascending=true"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .method("GET", HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

Respuesta exitosa

200

Campo Tipo Obligatorio Descripción

rows Brand[] Sí Marcas en la página actual.

Estructura de los elementos del array Brand

Campo	Tipo	Obligatorio	Descripción
`brandId`	integer	No	Identificador de marca dentro de la cuenta SelSup actual.
`name`	string	Sí	Los espacios de ventaja y de seguimiento se eliminan cuando se guardan.
`logoUrl`	string	No	La dirección de dirección de la dirección de inicio del logotipo actual.
`logoSize`	integer	No	Tamaño del logotipo en bytes.
`logoWidth`	integer	No	Ancho del logotipo en píxeles.
`logoHeight`	integer	No	Alteza del logotipo en píxeles.
`deleted`Valor predeterminado: false	boolean	No	Si la marca está archivada.
`ozonName`	string	No	Nombre de marca en el catálogo de Ozon.
`ozonId`	integer · int64	No	Identificación de marca en Ozon.
`oneCId`	string	No	Identificación externa de marca en 1C.

totalCondición: count=true integer No Competiciones totales; sólo se presentan cuando cuenta=verdadero.

page integer Sí Número de página actual.

hasNextPage boolean Sí cuando se dispone de otra página.

{
  "rows": [
    {
      "brandId": 8124,
      "name": "Base",
      "deleted": false,
      "ozonName": "BASE"
    }
  ],
  "total": 1,
  "page": 1,
  "hasNextPage": false
}

Errores3

Los errores de aplicación se devuelven normalmente como JSON con error, localMessage y params. Cómo se devuelven los errores de aplicación ↑

401auth_required

Se requiere la autenticación

Authorization está faltando, vacío o contiene un token inválido.

400error_access_denied

Acceso denegado

El token existe, pero su papel no puede realizar esta operación.

500error_unknown

Ocurrió un error desconocido. Si el problema persiste, escriba al servicio de soporte

Fallo interno: ahorra tiempo en la solicitud y apoyo de contacto; no vuelva a intentar una mutación ciegamente.

GET

Lista de todas las marcas

/api/brand/all

Token con acceso a lectura

Retorna todas las marcas de la cuenta, ordenadas por nombre.

Para directorios grandes y sincronización recurrente, utilice /find con paginado.

curl --request GET 'https://api.selsup.ru/api/brand/all' \
  --header 'Authorization: YOUR_API_TOKEN'

const response = await fetch('https://api.selsup.ru/api/brand/all', {
  method: 'GET',
  headers: { Authorization: process.env.SELSUP_API_TOKEN },
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const result = await response.json();

const response: Response = await fetch('https://api.selsup.ru/api/brand/all', {
  method: 'GET',
  headers: { Authorization: process.env.SELSUP_API_TOKEN! },
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

const result: unknown = await response.json();

import os
import requests

response = requests.get(
    'https://api.selsup.ru/api/brand/all',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()
result = response.json()

<?php

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/brand/all',
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

import (
    "fmt"
    "io"
    "net/http"
    "os"
)

func main() {
    req, err := http.NewRequest("GET", "https://api.selsup.ru/api/brand/all", nil)
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/brand/all"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .method("GET", HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

Respuesta exitosa

200

Estructura de los elementos del array Brand[]

Campo	Tipo	Obligatorio	Descripción
`brandId`	integer	No	Identificador de marca dentro de la cuenta SelSup actual.
`name`	string	Sí	Los espacios de ventaja y de seguimiento se eliminan cuando se guardan.
`logoUrl`	string	No	La dirección de dirección de la dirección de inicio del logotipo actual.
`logoSize`	integer	No	Tamaño del logotipo en bytes.
`logoWidth`	integer	No	Ancho del logotipo en píxeles.
`logoHeight`	integer	No	Alteza del logotipo en píxeles.
`deleted`Valor predeterminado: false	boolean	No	Si la marca está archivada.
`ozonName`	string	No	Nombre de marca en el catálogo de Ozon.
`ozonId`	integer · int64	No	Identificación de marca en Ozon.
`oneCId`	string	No	Identificación externa de marca en 1C.

[
  {
    "brandId": 8124,
    "name": "Base",
    "deleted": false
  },
  {
    "brandId": 8125,
    "name": "Air",
    "deleted": false
  }
]

Errores3

Los errores de aplicación se devuelven normalmente como JSON con error, localMessage y params. Cómo se devuelven los errores de aplicación ↑

401auth_required

Se requiere la autenticación

Authorization está faltando, vacío o contiene un token inválido.

400error_access_denied

Acceso denegado

El token existe, pero su papel no puede realizar esta operación.

500error_unknown

Ocurrió un error desconocido. Si el problema persiste, escriba al servicio de soporte

Fallo interno: ahorra tiempo en la solicitud y apoyo de contacto; no vuelva a intentar una mutación ciegamente.

GET

Obtenga una marca por identificación

/api/brand/{brandId}

Token con acceso a lectura

Retorna una marca de la cuenta corriente con su identificador interno.

La implementación actual devuelve un valor vacío para un brandId desconocido en lugar de HTTP 404.

Parámetros de trayectoria

Campo	Tipo	Obligatorio	Descripción
`brandId`	integer	Sí	Identificador de marca en SelSup.

curl --request GET 'https://api.selsup.ru/api/brand/8124' \
  --header 'Authorization: YOUR_API_TOKEN'

const response = await fetch('https://api.selsup.ru/api/brand/8124', {
  method: 'GET',
  headers: { Authorization: process.env.SELSUP_API_TOKEN },
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const result = await response.json();

const response: Response = await fetch('https://api.selsup.ru/api/brand/8124', {
  method: 'GET',
  headers: { Authorization: process.env.SELSUP_API_TOKEN! },
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

const result: unknown = await response.json();

import os
import requests

response = requests.get(
    'https://api.selsup.ru/api/brand/8124',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()
result = response.json()

<?php

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/brand/8124',
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

import (
    "fmt"
    "io"
    "net/http"
    "os"
)

func main() {
    req, err := http.NewRequest("GET", "https://api.selsup.ru/api/brand/8124", nil)
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/brand/8124"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .method("GET", HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

Respuesta exitosa

200

Campos de objetos Brand

Campo	Tipo	Obligatorio	Descripción
`brandId`	integer	No	Identificador de marca dentro de la cuenta SelSup actual.
`name`	string	Sí	Los espacios de ventaja y de seguimiento se eliminan cuando se guardan.
`logoUrl`	string	No	La dirección de dirección de la dirección de inicio del logotipo actual.
`logoSize`	integer	No	Tamaño del logotipo en bytes.
`logoWidth`	integer	No	Ancho del logotipo en píxeles.
`logoHeight`	integer	No	Alteza del logotipo en píxeles.
`deleted`Valor predeterminado: false	boolean	No	Si la marca está archivada.
`ozonName`	string	No	Nombre de marca en el catálogo de Ozon.
`ozonId`	integer · int64	No	Identificación de marca en Ozon.
`oneCId`	string	No	Identificación externa de marca en 1C.

{
  "brandId": 8124,
  "name": "Base",
  "deleted": false,
  "ozonName": "BASE",
  "ozonId": 100582
}

Errores3

Los errores de aplicación se devuelven normalmente como JSON con error, localMessage y params. Cómo se devuelven los errores de aplicación ↑

401auth_required

Se requiere la autenticación

Authorization está faltando, vacío o contiene un token inválido.

400error_access_denied

Acceso denegado

El token existe, pero su papel no puede realizar esta operación.

500error_unknown

Ocurrió un error desconocido. Si el problema persiste, escriba al servicio de soporte

Fallo interno: ahorra tiempo en la solicitud y apoyo de contacto; no vuelva a intentar una mutación ciegamente.

POST

Crear una marca

/api/brand

Token con acceso a escribir

Crea una marca en la cuenta corriente. nombre es suficiente para el caso común.

Los nombres se comparan de manera insensible al caso; Base y base se tratan como la misma marca.

Organismo de solicitud

application/json

Campo	Tipo	Obligatorio	Descripción
`name`	string	Sí	Un nombre de marca único y no vacío.
`ozonName`	string	No	Nombre del directorio de Ozon, cuando se sepa.
`ozonId`	integer · int64	No	Identificación de marca Ozon cuando se envían tarjetas sin una importación previa.
`oneCId`	string	No	Clave de marca externa estable en 1C.

curl --request POST 'https://api.selsup.ru/api/brand' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Base",
  "ozonName": "BASE",
  "ozonId": 100582,
  "oneCId": "BRAND-001"
}'

const response = await fetch('https://api.selsup.ru/api/brand', {
  method: 'POST',
  headers: {
    Authorization: process.env.SELSUP_API_TOKEN,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Base",
    "ozonName": "BASE",
    "ozonId": 100582,
    "oneCId": "BRAND-001"
  }),
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const result = await response.json();

const response: Response = await fetch('https://api.selsup.ru/api/brand', {
  method: 'POST',
  headers: {
    Authorization: process.env.SELSUP_API_TOKEN!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Base",
    "ozonName": "BASE",
    "ozonId": 100582,
    "oneCId": "BRAND-001"
  }),
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

const result: unknown = await response.json();

import os
import requests

response = requests.post(
    'https://api.selsup.ru/api/brand',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
    json={
        'name': 'Base',
        'ozonName': 'BASE',
        'ozonId': 100582,
        'oneCId': 'BRAND-001'
    },
)
response.raise_for_status()
result = response.json()

<?php

$payload = <<<'JSON'
{
  "name": "Base",
  "ozonName": "BASE",
  "ozonId": 100582,
  "oneCId": "BRAND-001"
}
JSON;

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/brand',
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN'), 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $payload,
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

import (
    "fmt"
    "io"
    "net/http"
    "os"
    "strings"
)

func main() {
    req, err := http.NewRequest("POST", "https://api.selsup.ru/api/brand", strings.NewReader(`{
  "name": "Base",
  "ozonName": "BASE",
  "ozonId": 100582,
  "oneCId": "BRAND-001"
}`))
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))
    req.Header.Set("Content-Type", "application/json")

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/brand"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .header("Content-Type", "application/json")
            .method("POST", HttpRequest.BodyPublishers.ofString("""
{
  "name": "Base",
  "ozonName": "BASE",
  "ozonId": 100582,
  "oneCId": "BRAND-001"
}
"""))
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

Respuesta exitosa

200

Campos de objetos Brand

Campo	Tipo	Obligatorio	Descripción
`brandId`	integer	No	Identificador de marca dentro de la cuenta SelSup actual.
`name`	string	Sí	Los espacios de ventaja y de seguimiento se eliminan cuando se guardan.
`logoUrl`	string	No	La dirección de dirección de la dirección de inicio del logotipo actual.
`logoSize`	integer	No	Tamaño del logotipo en bytes.
`logoWidth`	integer	No	Ancho del logotipo en píxeles.
`logoHeight`	integer	No	Alteza del logotipo en píxeles.
`deleted`Valor predeterminado: false	boolean	No	Si la marca está archivada.
`ozonName`	string	No	Nombre de marca en el catálogo de Ozon.
`ozonId`	integer · int64	No	Identificación de marca en Ozon.
`oneCId`	string	No	Identificación externa de marca en 1C.

{
  "brandId": 8124,
  "name": "Base",
  "deleted": false,
  "ozonName": "BASE",
  "ozonId": 100582,
  "oneCId": "BRAND-001"
}

Errores6

Los errores de aplicación se devuelven normalmente como JSON con error, localMessage y params. Cómo se devuelven los errores de aplicación ↑

401auth_required

Se requiere la autenticación

Authorization está faltando, vacío o contiene un token inválido.

400error_access_denied

Acceso denegado

El token existe, pero su papel no puede realizar esta operación.

400error_empty_brand_name

No se ha especificado nombre de marca

nombre está ausente, vacío o contiene sólo espacio en blanco.

400error_brand_already_exists

La marca {name} ya existe

El nombre de la cuenta ya tiene una coincidencia insensible al caso. params.name contiene el nombre conflictivo.

400error_subscription_expired

Su tarifa ha expirado. Pague la tarifa para continuar usando el servicio.

Pagar el precio para continuar utilizando el servicio.

500error_unknown

Ocurrió un error desconocido. Si el problema persiste, escriba al servicio de soporte

Fallo interno: ahorra tiempo en la solicitud y apoyo de contacto; no vuelva a intentar una mutación ciegamente.

PUT

Actualizar una marca

/api/brand/{brandId}

Token con acceso a escribir

Replace los campos de marca editables. El ID proviene de la URL; no envíe brandId en JSON.

Este es PUT, así que incluye todos los valores que necesita para conservar. Los campos de logotipo son administrados por puntos finales separados.

Parámetros de trayectoria

Campo	Tipo	Obligatorio	Descripción
`brandId`	integer	Sí	Marca para actualizar.

Organismo de solicitud

application/json

Campo	Tipo	Obligatorio	Descripción
`name`	string	Sí	Un nuevo nombre único.
`deleted`Valor predeterminado: false	boolean	No	El estado de archivado.
`ozonName`	string	No	Nombre de marca en Ozon.
`ozonId`	integer · int64	No	Identificación de marca en Ozon.
`oneCId`	string	No	Identificador de marca en 1C.

curl --request PUT 'https://api.selsup.ru/api/brand/8124' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Base Studio",
  "deleted": false,
  "ozonName": "BASE STUDIO",
  "ozonId": 100582,
  "oneCId": "BRAND-001"
}'

const response = await fetch('https://api.selsup.ru/api/brand/8124', {
  method: 'PUT',
  headers: {
    Authorization: process.env.SELSUP_API_TOKEN,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Base Studio",
    "deleted": false,
    "ozonName": "BASE STUDIO",
    "ozonId": 100582,
    "oneCId": "BRAND-001"
  }),
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const result = await response.json();

const response: Response = await fetch('https://api.selsup.ru/api/brand/8124', {
  method: 'PUT',
  headers: {
    Authorization: process.env.SELSUP_API_TOKEN!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Base Studio",
    "deleted": false,
    "ozonName": "BASE STUDIO",
    "ozonId": 100582,
    "oneCId": "BRAND-001"
  }),
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

const result: unknown = await response.json();

import os
import requests

response = requests.put(
    'https://api.selsup.ru/api/brand/8124',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
    json={
        'name': 'Base Studio',
        'deleted': False,
        'ozonName': 'BASE STUDIO',
        'ozonId': 100582,
        'oneCId': 'BRAND-001'
    },
)
response.raise_for_status()
result = response.json()

<?php

$payload = <<<'JSON'
{
  "name": "Base Studio",
  "deleted": false,
  "ozonName": "BASE STUDIO",
  "ozonId": 100582,
  "oneCId": "BRAND-001"
}
JSON;

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/brand/8124',
    CURLOPT_CUSTOMREQUEST => 'PUT',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN'), 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $payload,
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

import (
    "fmt"
    "io"
    "net/http"
    "os"
    "strings"
)

func main() {
    req, err := http.NewRequest("PUT", "https://api.selsup.ru/api/brand/8124", strings.NewReader(`{
  "name": "Base Studio",
  "deleted": false,
  "ozonName": "BASE STUDIO",
  "ozonId": 100582,
  "oneCId": "BRAND-001"
}`))
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))
    req.Header.Set("Content-Type", "application/json")

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/brand/8124"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .header("Content-Type", "application/json")
            .method("PUT", HttpRequest.BodyPublishers.ofString("""
{
  "name": "Base Studio",
  "deleted": false,
  "ozonName": "BASE STUDIO",
  "ozonId": 100582,
  "oneCId": "BRAND-001"
}
"""))
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

Respuesta exitosa

200

Campos de objetos Brand

Campo	Tipo	Obligatorio	Descripción
`brandId`	integer	No	Identificador de marca dentro de la cuenta SelSup actual.
`name`	string	Sí	Los espacios de ventaja y de seguimiento se eliminan cuando se guardan.
`logoUrl`	string	No	La dirección de dirección de la dirección de inicio del logotipo actual.
`logoSize`	integer	No	Tamaño del logotipo en bytes.
`logoWidth`	integer	No	Ancho del logotipo en píxeles.
`logoHeight`	integer	No	Alteza del logotipo en píxeles.
`deleted`Valor predeterminado: false	boolean	No	Si la marca está archivada.
`ozonName`	string	No	Nombre de marca en el catálogo de Ozon.
`ozonId`	integer · int64	No	Identificación de marca en Ozon.
`oneCId`	string	No	Identificación externa de marca en 1C.

{
  "brandId": 8124,
  "name": "Base Studio",
  "deleted": false,
  "ozonName": "BASE STUDIO",
  "ozonId": 100582,
  "oneCId": "BRAND-001"
}

Errores6

Los errores de aplicación se devuelven normalmente como JSON con error, localMessage y params. Cómo se devuelven los errores de aplicación ↑

401auth_required

Se requiere la autenticación

Authorization está faltando, vacío o contiene un token inválido.

400error_access_denied

Acceso denegado

El token existe, pero su papel no puede realizar esta operación.

400error_empty_brand_name

No se ha especificado nombre de marca

nombre está ausente, vacío o contiene sólo espacio en blanco.

400error_brand_already_exists

La marca {name} ya existe

El nombre de la cuenta ya tiene una coincidencia insensible al caso. params.name contiene el nombre conflictivo.

400error_subscription_expired

Su tarifa ha expirado. Pague la tarifa para continuar usando el servicio.

Pagar el precio para continuar utilizando el servicio.

500error_unknown

Ocurrió un error desconocido. Si el problema persiste, escriba al servicio de soporte

Fallo interno: ahorra tiempo en la solicitud y apoyo de contacto; no vuelva a intentar una mutación ciegamente.

DELETE

Eliminar, archivar o restaurar una marca

/api/brand/{brandId}

Token con acceso a escribir

Con deleted=true, SelSup intenta un borrador duro. Si existen referencias, archivará la marca en su lugar. deleted = false la restaura.

Parámetros de trayectoria

Campo	Tipo	Obligatorio	Descripción
`brandId`	integer	Sí	Identificación de marca.

Parámetros de consulta

Campo	Tipo	Obligatorio	Descripción
`deleted`	boolean	Sí	verdadera para eliminar o archivar; falsa para restaurar.

curl --request DELETE 'https://api.selsup.ru/api/brand/8124?deleted=true' \
  --header 'Authorization: YOUR_API_TOKEN'

const response = await fetch('https://api.selsup.ru/api/brand/8124?deleted=true', {
  method: 'DELETE',
  headers: { Authorization: process.env.SELSUP_API_TOKEN },
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const result = await response.json();

const response: Response = await fetch('https://api.selsup.ru/api/brand/8124?deleted=true', {
  method: 'DELETE',
  headers: { Authorization: process.env.SELSUP_API_TOKEN! },
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

const result: unknown = await response.json();

import os
import requests

response = requests.delete(
    'https://api.selsup.ru/api/brand/8124?deleted=true',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()
result = response.json()

<?php

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/brand/8124?deleted=true',
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

import (
    "fmt"
    "io"
    "net/http"
    "os"
)

func main() {
    req, err := http.NewRequest("DELETE", "https://api.selsup.ru/api/brand/8124?deleted=true", nil)
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/brand/8124?deleted=true"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .method("DELETE", HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

Respuesta exitosa

200

brand_has_been_removed

La marca fue eliminada de forma permanente.

brand_signed_as_deleted

Las referencias evitaron la eliminación, así que la marca fue archivada.

brand_has_been_restore

La marca fue restaurada del archivo.

"brand_signed_as_deleted"

Errores3

Los errores de aplicación se devuelven normalmente como JSON con error, localMessage y params. Cómo se devuelven los errores de aplicación ↑

401auth_required

Se requiere la autenticación

Authorization está faltando, vacío o contiene un token inválido.

400error_access_denied

Acceso denegado

El token existe, pero su papel no puede realizar esta operación.

500error_unknown

Ocurrió un error desconocido. Si el problema persiste, escriba al servicio de soporte

Fallo interno: ahorra tiempo en la solicitud y apoyo de contacto; no vuelva a intentar una mutación ciegamente.

POST

Cargar un logotipo

/api/brand/{brandId}/image

Token con acceso a escribir

Se carga una imagen como multipart/form-data. Se reemplaza un logotipo existente.

Envía el archivo binario en archivo; este punto final no acepta JSON.

Parámetros de trayectoria

Campo	Tipo	Obligatorio	Descripción
`brandId`	integer	Sí	Identificación de marca.

Organismo de solicitud

multipart/form-data

Campo	Tipo	Obligatorio	Descripción
`file`	binary	Sí	Ficha de imagen en un formato soportado.

curl --request POST 'https://api.selsup.ru/api/brand/8124/image' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --form 'file=@./logo.png'

const form = new FormData();
form.append('file', fileInput.files[0]);

const response = await fetch('https://api.selsup.ru/api/brand/8124/image', {
  method: 'POST',
  headers: { Authorization: process.env.SELSUP_API_TOKEN },
  body: form,
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const result = await response.json();

const form: FormData = new FormData();
form.append('file', fileInput.files![0]);

const response: Response = await fetch('https://api.selsup.ru/api/brand/8124/image', {
  method: 'POST',
  headers: { Authorization: process.env.SELSUP_API_TOKEN! },
  body: form,
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

const result: unknown = await response.json();

import os
import requests

response = requests.post(
    'https://api.selsup.ru/api/brand/8124/image',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
    files={'file': open('./logo.png', 'rb')},
)
response.raise_for_status()
result = response.json()

<?php

$payload = ['file' => new CURLFile('./logo.png')];

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/brand/8124/image',
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
    CURLOPT_POSTFIELDS => $payload,
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

import (
    "bytes"
    "fmt"
    "io"
    "mime/multipart"
    "net/http"
    "os"
    "path/filepath"
)

func main() {
    var body bytes.Buffer
    writer := multipart.NewWriter(&body)
    file, err := os.Open("./logo.png")
    if err != nil { panic(err) }
    defer file.Close()

    part, err := writer.CreateFormFile("file", filepath.Base(file.Name()))
    if err != nil { panic(err) }
    if _, err = io.Copy(part, file); err != nil { panic(err) }
    writer.Close()

    req, err := http.NewRequest("POST", "https://api.selsup.ru/api/brand/8124/image", &body)
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))
    req.Header.Set("Content-Type", writer.FormDataContentType())

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        String boundary = "SelSupBoundary" + System.currentTimeMillis();
        byte[] file = Files.readAllBytes(Path.of("./logo.png"));
        byte[] head = ("--" + boundary + "\r\n" +
            "Content-Disposition: form-data; name=\"file\"; filename=\"logo.png\"\r\n" +
            "Content-Type: image/png\r\n\r\n").getBytes(StandardCharsets.UTF_8);
        byte[] tail = ("\r\n--" + boundary + "--\r\n").getBytes(StandardCharsets.UTF_8);
        byte[] payload = new byte[head.length + file.length + tail.length];
        System.arraycopy(head, 0, payload, 0, head.length);
        System.arraycopy(file, 0, payload, head.length, file.length);
        System.arraycopy(tail, 0, payload, head.length + file.length, tail.length);

        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/brand/8124/image"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .header("Content-Type", "multipart/form-data; boundary=" + boundary)
            .method("POST", HttpRequest.BodyPublishers.ofByteArray(payload))
            .build();
        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

Respuesta exitosa

200

Campos de objetos Brand

Campo	Tipo	Obligatorio	Descripción
`brandId`	integer	No	Identificador de marca dentro de la cuenta SelSup actual.
`name`	string	Sí	Los espacios de ventaja y de seguimiento se eliminan cuando se guardan.
`logoUrl`	string	No	La dirección de dirección de la dirección de inicio del logotipo actual.
`logoSize`	integer	No	Tamaño del logotipo en bytes.
`logoWidth`	integer	No	Ancho del logotipo en píxeles.
`logoHeight`	integer	No	Alteza del logotipo en píxeles.
`deleted`Valor predeterminado: false	boolean	No	Si la marca está archivada.
`ozonName`	string	No	Nombre de marca en el catálogo de Ozon.
`ozonId`	integer · int64	No	Identificación de marca en Ozon.
`oneCId`	string	No	Identificación externa de marca en 1C.

{
  "brandId": 8124,
  "name": "Base",
  "logoUrl": "https://files.selsup.ru/brand/8124.png",
  "logoSize": 18420,
  "logoWidth": 512,
  "logoHeight": 512,
  "deleted": false
}

Errores7

Los errores de aplicación se devuelven normalmente como JSON con error, localMessage y params. Cómo se devuelven los errores de aplicación ↑

401auth_required

Se requiere la autenticación

Authorization está faltando, vacío o contiene un token inválido.

400error_access_denied

Acceso denegado

El token existe, pero su papel no puede realizar esta operación.

400error_brand_to_found

Marca {name} no encontrada

La documentación conserva el código error exactamente como lo devuelve el API.

400error_wrong_image_format

Formato de imagen incorrecto para el archivo: {name}

El archivo no pudo ser decodificado como un formato de imagen soportado.

400error_max_upload_size_exceeded

Tamaño máximo de archivo excedido

La solicitud de múltiples partes excede el límite de carga del servidor.

400error_subscription_expired

Su tarifa ha expirado. Pague la tarifa para continuar usando el servicio.

Pagar el precio para continuar utilizando el servicio.

500error_unknown

Ocurrió un error desconocido. Si el problema persiste, escriba al servicio de soporte

Fallo interno: ahorra tiempo en la solicitud y apoyo de contacto; no vuelva a intentar una mutación ciegamente.

DELETE

Eliminar un logotipo

/api/brand/{brandId}/image

Token con acceso a escribir

Elimina el archivo del logotipo y restablece sus dimensiones en el registro de marca.

Parámetros de trayectoria

Campo	Tipo	Obligatorio	Descripción
`brandId`	integer	Sí	Identificación de marca.

curl --request DELETE 'https://api.selsup.ru/api/brand/8124/image' \
  --header 'Authorization: YOUR_API_TOKEN'

const response = await fetch('https://api.selsup.ru/api/brand/8124/image', {
  method: 'DELETE',
  headers: { Authorization: process.env.SELSUP_API_TOKEN },
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const result = await response.json();

const response: Response = await fetch('https://api.selsup.ru/api/brand/8124/image', {
  method: 'DELETE',
  headers: { Authorization: process.env.SELSUP_API_TOKEN! },
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

const result: unknown = await response.json();

import os
import requests

response = requests.delete(
    'https://api.selsup.ru/api/brand/8124/image',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()
result = response.json()

<?php

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/brand/8124/image',
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

import (
    "fmt"
    "io"
    "net/http"
    "os"
)

func main() {
    req, err := http.NewRequest("DELETE", "https://api.selsup.ru/api/brand/8124/image", nil)
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/brand/8124/image"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .method("DELETE", HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

Respuesta exitosa

200

Campos de objetos Brand

Campo	Tipo	Obligatorio	Descripción
`brandId`	integer	No	Identificador de marca dentro de la cuenta SelSup actual.
`name`	string	Sí	Los espacios de ventaja y de seguimiento se eliminan cuando se guardan.
`logoUrl`	string	No	La dirección de dirección de la dirección de inicio del logotipo actual.
`logoSize`	integer	No	Tamaño del logotipo en bytes.
`logoWidth`	integer	No	Ancho del logotipo en píxeles.
`logoHeight`	integer	No	Alteza del logotipo en píxeles.
`deleted`Valor predeterminado: false	boolean	No	Si la marca está archivada.
`ozonName`	string	No	Nombre de marca en el catálogo de Ozon.
`ozonId`	integer · int64	No	Identificación de marca en Ozon.
`oneCId`	string	No	Identificación externa de marca en 1C.

{
  "brandId": 8124,
  "name": "Base",
  "logoSize": 0,
  "logoWidth": 0,
  "logoHeight": 0,
  "deleted": false
}

Errores7

Los errores de aplicación se devuelven normalmente como JSON con error, localMessage y params. Cómo se devuelven los errores de aplicación ↑

401auth_required

Se requiere la autenticación

Authorization está faltando, vacío o contiene un token inválido.

400error_access_denied

Acceso denegado

El token existe, pero su papel no puede realizar esta operación.

400error_brand_to_found

Marca {name} no encontrada

La documentación conserva el código error exactamente como lo devuelve el API.

400error_empty_brand_logo

La marca no tiene imagen

Se solicitó la eliminación del logotipo de una marca sin logotipos.

400error_cant_remove_brand_logo

No se puede eliminar la imagen de la marca

El almacenamiento no pudo eliminar el archivo ni actualizar el registro de marca.

400error_subscription_expired

Su tarifa ha expirado. Pague la tarifa para continuar usando el servicio.

Pagar el precio para continuar utilizando el servicio.

500error_unknown

Ocurrió un error desconocido. Si el problema persiste, escriba al servicio de soporte

Fallo interno: ahorra tiempo en la solicitud y apoyo de contacto; no vuelva a intentar una mutación ciegamente.

POST

Duplicados de fusión

/api/brand/{brandId}/merge/{removeBrandId}

Token con acceso a escribir

Mueve los modelos de producto de RemoveBrandId a BrandId, y luego elimina permanentemente Remove BrandId.

Esto no puede ser deshacido. se conserva la marca; eliminarLa marca es el duplicado que se debe eliminar.

Parámetros de trayectoria

Campo	Tipo	Obligatorio	Descripción
`brandId`	integer	Sí	Identificador de marca principal.
`removeBrandId`	integer	Sí	Duplicar el identificador de marca para eliminar.

curl --request POST 'https://api.selsup.ru/api/brand/8124/merge/9012' \
  --header 'Authorization: YOUR_API_TOKEN'

const response = await fetch('https://api.selsup.ru/api/brand/8124/merge/9012', {
  method: 'POST',
  headers: { Authorization: process.env.SELSUP_API_TOKEN },
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const response: Response = await fetch('https://api.selsup.ru/api/brand/8124/merge/9012', {
  method: 'POST',
  headers: { Authorization: process.env.SELSUP_API_TOKEN! },
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

import os
import requests

response = requests.post(
    'https://api.selsup.ru/api/brand/8124/merge/9012',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()

<?php

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/brand/8124/merge/9012',
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

import (
    "fmt"
    "io"
    "net/http"
    "os"
)

func main() {
    req, err := http.NewRequest("POST", "https://api.selsup.ru/api/brand/8124/merge/9012", nil)
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/brand/8124/merge/9012"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .method("POST", HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

Respuesta exitosa

200

La respuesta no tiene cuerpo.

Errores5

Los errores de aplicación se devuelven normalmente como JSON con error, localMessage y params. Cómo se devuelven los errores de aplicación ↑

401auth_required

Se requiere la autenticación

Authorization está faltando, vacío o contiene un token inválido.

400error_access_denied

Acceso denegado

El token existe, pero su papel no puede realizar esta operación.

400error_brand_not_found

Marca no encontrada: {name}

Una de las marcas solicitadas para la fusión no existe en la cuenta corriente.

400error_subscription_expired

Su tarifa ha expirado. Pague la tarifa para continuar usando el servicio.

Pagar el precio para continuar utilizando el servicio.

500error_unknown

Ocurrió un error desconocido. Si el problema persiste, escriba al servicio de soporte

Fallo interno: ahorra tiempo en la solicitud y apoyo de contacto; no vuelva a intentar una mutación ciegamente.

Marcas

Flujos de trabajo listos para su uso

Encuentra o crea una marca antes de crear un producto

Sincronizar el directorio con 1C

Eliminar un duplicado sin perder enlaces de producto

Fields regresó en Brand.

Cómo se devuelven los errores de aplicación

Puntos finales

Encuentra marcas

Parámetros de consulta

Respuesta exitosa

Lista de todas las marcas

Respuesta exitosa

Obtenga una marca por identificación

Parámetros de trayectoria

Respuesta exitosa

Crear una marca

Organismo de solicitud

Respuesta exitosa

Actualizar una marca

Parámetros de trayectoria

Organismo de solicitud

Respuesta exitosa

Eliminar, archivar o restaurar una marca

Parámetros de trayectoria

Parámetros de consulta

Respuesta exitosa

Cargar un logotipo

Parámetros de trayectoria

Organismo de solicitud

Respuesta exitosa

Eliminar un logotipo

Parámetros de trayectoria

Respuesta exitosa

Duplicados de fusión

Parámetros de trayectoria

Respuesta exitosa

Token para las solicitudes de ensayo

Parámetros reales de la solicitud

Respuesta en vivo API