Variações

[
  {
    "id": "uuid-da-variacao",
    "store_id": "uuid-da-loja",
    "category_id": "uuid-da-categoria",
    "title": "30 dias",
    "slug": "30-dias",
    "description": null,
    "images": ["https://cdn.seudominio.com/30d.jpg"],
    "hide_product": false,
    "is_bundle": false,
    "price": 19.9,
    "comparison_price": null,
    "min_quantity": 1,
    "inventory_amount": 50,
    "parent_id": "uuid-do-combo",
    "position": 0,
    "sales_count": 10,
    "chat_enabled": false,
    "chat_welcome_message": null,
    "instructions": null,
    "created_at": "2024-01-01T00:00:00.000Z",
    "updated_at": "2024-01-01T00:00:00.000Z",
    "_count": { "license_keys": 0 }
  }
]

[
  {
    "id": "uuid-da-variacao",
    "store_id": "uuid-da-loja",
    "category_id": "uuid-da-categoria",
    "title": "30 dias",
    "slug": "30-dias",
    "description": null,
    "images": ["https://cdn.seudominio.com/30d.jpg"],
    "hide_product": false,
    "is_bundle": false,
    "price": 19.9,
    "comparison_price": null,
    "min_quantity": 1,
    "inventory_amount": 50,
    "parent_id": "uuid-do-combo",
    "position": 0,
    "sales_count": 10,
    "chat_enabled": false,
    "chat_welcome_message": null,
    "instructions": null,
    "created_at": "2024-01-01T00:00:00.000Z",
    "updated_at": "2024-01-01T00:00:00.000Z",
    "_count": { "license_keys": 0 }
  }
]

Uma variação é um produto simples (is_bundle: false) com parent_id igual ao UUID do combo. Criar, editar estoque, preço, imagens, categoria, chat, instruções e o resto usa as mesmas rotas de produto. Guia completo: Produtos e variações.

Listar variações de um combo

string

required

Token no formato Bearer <seu_token>.

uuid

required

UUID do combo (is_bundle: true). 404 se não existir; 400 se não for combo.

GET /api/v1/product/{id}/variants

A resposta é um array de produtos filhos, ordenados por position. Cada item tem preço, estoque, imagens (URL pronta ou o link que você cadastrou) e _count.license_keys. As chaves em si vêm em GET /api/v1/product/{idDaVariacao}.

[
  {
    "id": "uuid-da-variacao",
    "store_id": "uuid-da-loja",
    "category_id": "uuid-da-categoria",
    "title": "30 dias",
    "slug": "30-dias",
    "description": null,
    "images": ["https://cdn.seudominio.com/30d.jpg"],
    "hide_product": false,
    "is_bundle": false,
    "price": 19.9,
    "comparison_price": null,
    "min_quantity": 1,
    "inventory_amount": 50,
    "parent_id": "uuid-do-combo",
    "position": 0,
    "sales_count": 10,
    "chat_enabled": false,
    "chat_welcome_message": null,
    "instructions": null,
    "created_at": "2024-01-01T00:00:00.000Z",
    "updated_at": "2024-01-01T00:00:00.000Z",
    "_count": { "license_keys": 0 }
  }
]

Criar variação

POST /api/v1/product

Body igual ao criar produto simples, com parent_id = id do combo. O pai precisa existir na loja e ter is_bundle: true.

{
  "is_bundle": false,
  "parent_id": "uuid-do-combo",
  "category_id": "uuid-da-categoria",
  "title": "90 dias",
  "description": null,
  "images": ["https://cdn.seudominio.com/90d.jpg"],
  "hide_product": false,
  "chat_enabled": false,
  "chat_welcome_message": null,
  "pricing": { "price": 49.9, "comparison": null },
  "inventory_amount": 20,
  "license_keys": [],
  "min_quantity": null,
  "instructions": null
}

Editar variação (estoque, preço, imagem, tudo)

PATCH /api/v1/product/{idDaVariacao}

Mesmo contrato de atualizar produto. is_bundle é sempre false. Exemplos: Estoque

{ "is_bundle": false, "inventory_amount": 5 }

Preço + capa por URL

{
  "is_bundle": false,
  "title": "90 dias (promo)",
  "pricing": { "price": 39.9, "comparison": 49.9 },
  "images": ["https://cdn.seudominio.com/90d-promo.jpg"]
}

Trocar as keys (estoque vira o tamanho da lista)

{
  "is_bundle": false,
  "license_keys": ["AAA-1", "AAA-2", "AAA-3"]
}

Ocultar, categoria, chat, instruções, quantidade mínima

{
  "is_bundle": false,
  "hide_product": true,
  "category_id": "uuid-da-categoria-folha",
  "chat_enabled": true,
  "chat_welcome_message": "Olá! Qual o seu ID?",
  "min_quantity": 1,
  "instructions": "A key chega no e-mail em até 5 minutos."
}

Mover para outro combo (ou parent_id: null para virar produto raiz)

{ "is_bundle": false, "parent_id": "uuid-de-outro-combo" }

Excluir variação

DELETE /api/v1/product/{idDaVariacao}

Remove só aquela variação. Excluir o combo (DELETE no id do bundle) apaga as variações em cascata.

Obter uma variação (inclui license_keys)

GET /api/v1/product/{idDaVariacao}

Funciona como obter produto. Inclui license_keys (id, value, product_id, store_id, created_at, updated_at) e parent: { id, title }.

Introdução

Loja

Produtos

Categorias

Cupons

Pedidos

Listar variações de um combo

Criar variação

Editar variação (estoque, preço, imagem, tudo)

Excluir variação

Obter uma variação (inclui license_keys)

​Listar variações de um combo

​Criar variação

​Editar variação (estoque, preço, imagem, tudo)

​Excluir variação

​Obter uma variação (inclui license_keys)

Listar variações de um combo

Criar variação

Editar variação (estoque, preço, imagem, tudo)

Excluir variação

Obter uma variação (inclui license_keys)