API legada/Referência completa/Embalagens e caixas

GETDados de caixa dos produtos

Devolve as variantes de produto associadas a configurações de caixa.

Este endpoint devolve dados das variantes de produto associadas a configurações de caixa. Com ele você descobre quais produtos estão vinculados a quais caixas, o que ajuda na gestão de estoque e na manutenção do catálogo. Os resultados podem ser filtrados por parâmetros de consulta. A autenticação é obrigatória: use Basic Authentication com as suas credenciais de API.

GET/api/productBoxesVariantsSeller

Lista as variantes de produto vinculadas a caixas

Cabeçalhos

Authorizationstringobrigatório

Basic Auth: combinação usuário:senha codificada em Base64 (o par email:api_key).

Parâmetros de consulta

limitinteger

Número máximo de variantes de produto a devolver

product_idsstring

Lista de IDs de produtos separados por vírgula para filtrar

box_idinteger

Filtra as variantes pelo ID da caixa

box_typestring

GC

Filtra as variantes pelo tipo de caixa: "G" para caixas de grade ou "C" para caixas fechadas

Exemplo de requisição

bash

curl -X GET "$BASE_URL/api/productBoxesVariants/?box_id=15&limit=10" \
  -u "$EMAIL:$API_KEY"

Resposta

200Variantes de caixa retornadas

json

{
  "variants": [
    {
      "variant_id": 65824,
      "product_id": 145632,
      "product_code": "7898765432108",
      "product_feature_id": 575,
      "variant_name": "F8",
      "box_id": 15,
      "box_type": "G",
      "status": "A"
    },
    {
      "variant_id": 65825,
      "product_id": 145633,
      "product_code": "7898765432109",
      "product_feature_id": 575,
      "variant_name": "F8",
      "box_id": 15,
      "box_type": "G",
      "status": "A"
    }
  ]
}

Campos da resposta

variantsarray

Array de objetos de variante de produto associados a configurações de caixa

variants[].variant_idinteger

Identificador único da variante do produto

variants[].product_idinteger

Identificador do produto ao qual esta variante pertence

variants[].product_codestring

Código universal do produto (código de barras)

variants[].product_feature_idinteger

ID da característica usada para o tamanho da caixa (normalmente 575, a característica de tamanho)

variants[].variant_namestring

Nome da variante da caixa (por exemplo, "F8", "F12")

variants[].box_idinteger

Identificador da configuração de caixa associada a esta variante

variants[].box_typestring

Tipo da caixa: "G" para caixa de grade (sortimento), "C" para caixa fechada (conjunto completo)

variants[].statusstring

Status da variante: "A" para ativa, "D" para desativada

Códigos de status

Código de status	Descrição
`200 OK`	Requisição bem-sucedida, variantes de caixa dos produtos devolvidas
`401 Unauthorized`	As credenciais de autenticação estão ausentes ou são inválidas
`500 Internal Server Error`	Ocorreu um erro no servidor

Veja também