API Docs v1 api.hubiss.com.br

Produtos

Cadastro completo de produtos, variações e fotos para publicar nos marketplaces.

Em resumo
Produto depende de loja e categoria. Respeite a ordem: loja → categoria → produto → foto.

O cadastro de produtos é o passo mais importante da integração: é ele que define a qualidade dos anúncios publicados.

Ordem correta do cadastro

  1. Cadastrar uma loja.
  2. Cadastrar a árvore de categorias da loja.
  3. Cadastrar o produto nas categorias da loja.
  4. Cadastrar as fotos do produto.
1 · Loja POST /stores 2 · Categorias POST /stores/{id}/categories 3 · Produto POST /stores/{id}/products 4 · Fotos POST .../pictures/url

Cada etapa depende da anterior — respeite a ordem.

Cadastre o mais completo possível
Preencha todos os dados que tiver e envie o máximo de fotos de alta qualidade (até 2 MB por imagem). Produto completo tem mais chance de vender.
Faltou algo?
Se a plataforma não oferece espaço para alguma informação importante, abra um chamado em hubiss.freshdesk.com para avaliarmos juntos.

Variações

Para produtos com variação (cor, tamanho, voltagem), consulte primeiro os tipos de variação disponíveis e envie as variações no cadastro do produto.

GET /variation-types
Listar Tipos de Variação

Listar os tipos de variação disponíveis para cadastro de produtos com variação

StatusQuando aconteceCorpo
401 401 —
404 404 —
Nome Local Tipo Descrição
name query string
padrão: cor

Filtrar por tipo de variação

Resposta
json
{
    "data": [
        {
            "id": 2,
            "name": "Cor"
        }
    ],
    "links": {
        "first": "https://hubiss.dev/api/v1/variation-types?page=1",
        "last": "https://hubiss.dev/api/v1/variation-types?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [
            {
                "url": null,
                "label": "« Previous",
                "active": false
            },
            {
                "url": "https://hubiss.dev/api/v1/variation-types?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Next »",
                "active": false
            }
        ],
        "path": "https://hubiss.dev/api/v1/variation-types",
        "per_page": 20,
        "to": 1,
        "total": 1
    }
}
{
    "error": "Unauthorized"
}
{
    "error": "Resource 9999 not found"
}
Exemplo
curl --request GET \
     --url 'https://api.hubiss.com.br/v1/variation-types' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer SEU_TOKEN'
use Illuminate\Support\Facades\Http;

$response = Http::withToken('SEU_TOKEN')
    ->acceptJson()
    ->get('https://api.hubiss.com.br/v1/variation-types');

$response->json();
const response = await fetch('https://api.hubiss.com.br/v1/variation-types', {
    method: 'GET',
    headers: {
        'Accept': 'application/json',
        'Authorization': 'Bearer SEU_TOKEN'
    }
});

const data = await response.json();
import requests

response = requests.GET(
    'https://api.hubiss.com.br/v1/variation-types',
    headers={'Authorization': 'Bearer SEU_TOKEN', 'Accept': 'application/json'},
)

print(response.json())
O token é usado apenas nesta requisição e não é armazenado.
GET /stores/{storeId}/products
Listar Produtos

Listar todas as categorias das listas de produtos cadastradas

StatusQuando aconteceCorpo
401 401 —
404 404 —
Nome Local Tipo Descrição
storeId * path integer
padrão: 1

O Código da loja é gerado automaticamente pela plataforma, assim que você realiza o cadastro da loja você terá essa ID

sku query string

Filtrar por SKU do produto ou da variação do produto.

Informar o código completo.

language_code query string
padrão: pt_BR

Filtrar por produtos em determinada linguagem.

Informar o código da linguagem a ser filtrado.

O código da linguagem pode ser encontrado aqui: https://api.hubiss.com.br/reference/linguagens#endpoint-listar-linguagens

brand_id query integer

Filtrar por código da marca.

Caso não saiba, você pode consultar aqui: https://api.hubiss.com.br/reference/marcas#endpoint-listar-marcas

name query string

Buscar por parte do texto no nome do produto.

description query string

Filtrar por parte do texto na descrição do produto

technical_description query string

Filtrar por parte do texto na descrição técnica do produto

included_itens query string

Filtrar por parte do texto na descrição de itens inclusos do produto

gtin query string

Filtrar por código de barras no produto ou na variação do produto

price[from] query number
padrão: 0.01

Filtrar por produtos com o preço a partir do valor informado

price[to] query number
padrão: 9999.99

Filtrar por produtos com o preço até o valor informado

stock[from] query integer
padrão: 1

Filtrar por produtos com o estoque a partir da quantidade informada.

Valores negativos também são aceitos

stock[to] query integer
padrão: 9999

Filtrar por produtos com o estoque até a quantidade informada.

Valores negativos são aceitos

status query string
padrão: active

Filtrar por status do produto.

Possíveis opções: active, inactive

days_for_shipping[from] query integer
padrão: 0

Filtrar por produtos com o prazo de envio do produto a partir da quantidade informada.

days_for_shipping[to] query integer
padrão: 99

Filtrar por produtos com o prazo de envio até a quantidade informada.

product_type query string
padrão: normal

Filtrar por produtos pelo tipo de produto.

Possíveis opções: normal, variations

created_at[from] query string
padrão: 2022-04-19T23:24:50

Filtrar por produtos cadastrados a partir da data informada

created_at[to] query string
padrão: 2099-04-19T23:24:51

Filtrar por produtos cadastrados até a data informada

updated_at[from] query string
padrão: 2022-04-19T23:24:50

Filtrar por produtos que sofreram alteração a partir da data informada

updated_at[to] query string
padrão: 2099-04-19T23:24:51

Filtrar por produtos que sofreram alteração até a data informada

Resposta
json
{
    "data": [
        {
            "id": 1,
            "brand_id": 1,
            "language_code": "pt_BR",
            "product_type": "variations",
            "product_format": "physical_product",
            "product_condition": "new",
            "sku": "sku1234",
            "name": "Novo produto de teste abc1231",
            "slug": "novo-produto-de-teste-abc1231",
            "price": "1.00",
            "old_price": "2.00",
            "description": "<p>Descri&ccedil;&atilde;o completa aqui teste</p>",
            "technical_description": "<p>T&eacute;cnica aqui teste</p>",
            "included_itens": "<p>&iacute;tens inclusos aqui teste</p>",
            "status": "active",
            "warranty_days": 90,
            "gtin": "",
            "ncm": "",
            "height": 11,
            "width": 12,
            "length": 13,
            "gross_weight": 0.25,
            "url": "https://www.hubiss.com.br/?teste=2",
            "stock": 11,
            "reserved_stock": 0,
            "days_for_shipping": 4,
            "release_date": "2022-01-01T00:00:00",
            "created_at": "2022-04-24T00:57:37",
            "updated_at": "2022-04-27T23:04:56",
            "dropshipping_crossdocking": {
                "allow_others_integrate": true
            },
            "semantic_fields": {
                "allow_auto_generate_titles": true,
                "base_title": ""
            },
            "pictures": [
                {
                    "id": 1,
                    "position": 1,
                    "url": "https://www.google.com/4b71852ea4fcc1cbb1204a431424f169.jpeg",
                    "has_qr_code": 0
                },
                {
                    "id": 2,
                    "position": 2,
                    "url": "https://www.google.com/3287a02858850ac79e04c44cb21d55d3.png",
                    "has_qr_code": 0
                }
            ],
            "videos": [
                {
                    "position": 0,
                    "url": "https://www.youtube.com/watch?v=1234567891011"
                }
            ],
            "variations": [
                {
                    "id": 1,
                    "sku": "var-1",
                    "stock": 3,
                    "reserved_stock": 0,
                    "gtin": "",
                    "variation_options": [
                        {
                            "option_id": 2,
                            "option_description": "Cor",
                            "value": "Azul"
                        },
                        {
                            "option_id": 4,
                            "option_description": "Voltagem",
                            "value": "110"
                        }
                    ],
                    "created_at": "2022-04-24T00:57:37",
                    "updated_at": "2022-04-24T00:57:37"
                },
                {
                    "id": 2,
                    "sku": "var-2",
                    "stock": 8,
                    "reserved_stock": 0,
                    "gtin": "",
                    "variation_options": [
                        {
                            "option_id": 2,
                            "option_description": "Cor",
                            "value": "Amarelo"
                        },
                        {
                            "option_id": 4,
                            "option_description": "Voltagem",
                            "value": "220"
                        }
                    ],
                    "created_at": "2022-04-24T01:13:20",
                    "updated_at": "2022-04-24T01:13:20"
                }
            ],
            "categories": [
                {
                    "id": 715
                }
            ]
        }
    ],
    "links": {
        "first": "https://hubiss.dev/api/v1/product-lists/14/products?page=1",
        "last": "https://hubiss.dev/api/v1/product-lists/14/products?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [
            {
                "url": null,
                "label": "&laquo; Previous",
                "active": false
            },
            {
                "url": "https://hubiss.dev/api/v1/product-lists/14/products?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Next &raquo;",
                "active": false
            }
        ],
        "path": "https://hubiss.dev/api/v1/product-lists/14/products",
        "per_page": 20,
        "to": 1,
        "total": 1
    }
}
{
    "error": "Unauthorized"
}
{
    "error": "Resource 9999 not found"
}
Exemplo
curl --request GET \
     --url 'https://api.hubiss.com.br/v1/stores/STOREID/products' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer SEU_TOKEN'
use Illuminate\Support\Facades\Http;

$response = Http::withToken('SEU_TOKEN')
    ->acceptJson()
    ->get('https://api.hubiss.com.br/v1/stores/STOREID/products');

$response->json();
const response = await fetch('https://api.hubiss.com.br/v1/stores/STOREID/products', {
    method: 'GET',
    headers: {
        'Accept': 'application/json',
        'Authorization': 'Bearer SEU_TOKEN'
    }
});

const data = await response.json();
import requests

response = requests.GET(
    'https://api.hubiss.com.br/v1/stores/STOREID/products',
    headers={'Authorization': 'Bearer SEU_TOKEN', 'Accept': 'application/json'},
)

print(response.json())
O token é usado apenas nesta requisição e não é armazenado.
POST /stores/{storeId}/products
Cadastrar Produto
StatusQuando aconteceCorpo
401 Token ausente ou invalido, ou a loja ja atingiu o limite de produtos permitido pela regra de aprovacao. —
404 Registro informado no caminho nao existe ou pertence a outra conta. {"error":"Resource 123 not found"}
422 422 —
Nome Local Tipo Descrição
storeId * path integer
padrão: 1

Código da sua loja cadastrada

CampoTipoDescrição
brand_id * integer

Código da marca.

Obtenha-o aqui: https://api.hubiss.com.br/reference/marcas#endpoint-listar-marcas

language_code * string

Código da linguagem. Obrigatório informar uma das mesmas linguagens informadas ao cadastrar a lista de produtos.

product_type * string
product_format * string
product_condition * string
sku string

Código identificador do produto, obrigatório informar se você estiver cadastrando produto normal.

name * string

Nome do produto

price * string

Valor do produto

old_price string

Valor antigo do produto (Em caso de promoção)

description string

Descrição completa do produto

technical_description string

Descrição técnica do produto

included_itens string

Descrição dos itens inclusos

status * string
warranty_days * integer

Dias de garantia

gtin string

Código de barras. Aceito apenas EAN válidos de 8 ou 13 dígitos.

Caso acredite que o sistema esteja com falha, por favor, abra um chamado em: https://hubiss.freshdesk.com/support/home

ncm string
height integer

Altura

width integer

Largura

length integer

Comprimento

gross_weight number

Peso bruto

url string

Link do produto: Caso queira usar como referência de site externo

days_for_shipping integer

Dias necessários para envio do produto após venda

release_date string

Caso queira gravar a data de lançamento do produto para futuras referências, informe a data no mesmo formato informado.

dropshipping_crossdocking object
videos array

Caso o produto contenha vídeos, informe os links dos vídeos

variations array
categories * array
Corpo enviado (JSON) json
{
    "brand_id": 2,
    "language_code": "pt_BR",
    "product_type": "variations",
    "product_format": "physical_product",
    "product_condition": "new",
    "sku": "111112",
    "name": "Novo produto de teste abc1231",
    "price": "1001.00",
    "old_price": "2000.00",
    "description": "<p>Descri&ccedil;&atilde;o completa aqui teste</p>",
    "technical_description": "<p>T&eacute;cnica aqui teste</p>",
    "included_itens": "<p>&iacute;tens inclusos aqui teste</p>",
    "status": "active",
    "warranty_days": 90,
    "gtin": "",
    "ncm": "",
    "height": 11,
    "width": 12,
    "length": 13,
    "gross_weight": 0.25,
    "url": "https://www.hubiss.com.br/?teste=2",
    "days_for_shipping": 4,
    "release_date": "2022-01-01T00:00:00",
    "dropshipping_crossdocking": {
        "allow_others_integrate": true
    },
    "videos": [
        "https://www.youtube.com/watch?v=1223456789"
    ],
    "variations": [
        {
            "sku": "var-1",
            "stock": 3,
            "gtin": "",
            "variation_options": [
                {
                    "option_id": 2,
                    "value": "Azul"
                },
                {
                    "option_id": 4,
                    "value": "110"
                }
            ]
        },
        {
            "sku": "var-2",
            "stock": 8,
            "gtin": "",
            "variation_options": [
                {
                    "option_id": 2,
                    "value": "Amarelo"
                },
                {
                    "option_id": 4,
                    "value": "220"
                }
            ]
        }
    ],
    "categories": [
        {
            "id": 715
        }
    ]
}
Resposta
json
{
    "id": 1,
    "brand_id": 1,
    "language_code": "pt_BR",
    "product_type": "variations",
    "product_format": "physical_product",
    "product_condition": "new",
    "sku": "sku1234",
    "name": "Novo produto de teste abc1231",
    "slug": "novo-produto-de-teste-abc1231",
    "price": "1.00",
    "old_price": "2.00",
    "description": "<p>Descri&ccedil;&atilde;o completa aqui teste</p>",
    "technical_description": "<p>T&eacute;cnica aqui teste</p>",
    "included_itens": "<p>&iacute;tens inclusos aqui teste</p>",
    "status": "active",
    "warranty_days": 90,
    "gtin": "",
    "ncm": "",
    "height": 11,
    "width": 12,
    "length": 13,
    "gross_weight": 0.25,
    "url": "https://www.hubiss.com.br/?teste=2",
    "stock": 11,
    "reserved_stock": 0,
    "days_for_shipping": 4,
    "release_date": "2022-01-01T00:00:00",
    "created_at": "2022-04-24T00:57:37",
    "updated_at": "2022-04-27T23:04:56",
    "dropshipping_crossdocking": {
        "allow_others_integrate": true
    },
    "semantic_fields": {
        "allow_auto_generate_titles": true,
        "base_title": ""
    },
    "pictures": [
        {
            "id": 1,
            "position": 1,
            "url": "https://www.google.com/4b71852ea4fcc1cbb1204a431424f169.jpeg",
            "has_qr_code": 0
        },
        {
            "id": 2,
            "position": 2,
            "url": "https://www.google.com/3287a02858850ac79e04c44cb21d55d3.png",
            "has_qr_code": 0
        }
    ],
    "videos": [
        {
            "position": 0,
            "url": "https://www.youtube.com/watch?v=1234567891011"
        }
    ],
    "variations": [
        {
            "id": 1,
            "sku": "var-1",
            "stock": 3,
            "reserved_stock": 0,
            "gtin": "",
            "variation_options": [
                {
                    "option_id": 2,
                    "option_description": "Cor",
                    "value": "Azul"
                },
                {
                    "option_id": 4,
                    "option_description": "Voltagem",
                    "value": "110"
                }
            ],
            "created_at": "2022-04-24T00:57:37",
            "updated_at": "2022-04-24T00:57:37"
        },
        {
            "id": 2,
            "sku": "var-2",
            "stock": 8,
            "reserved_stock": 0,
            "gtin": "",
            "variation_options": [
                {
                    "option_id": 2,
                    "option_description": "Cor",
                    "value": "Amarelo"
                },
                {
                    "option_id": 4,
                    "option_description": "Voltagem",
                    "value": "220"
                }
            ],
            "created_at": "2022-04-24T01:13:20",
            "updated_at": "2022-04-24T01:13:20"
        }
    ],
    "categories": [
        {
            "id": 715
        }
    ]
}
{
    "error": "Unauthorized"
}
{
    "success": false,
    "message": "Validation errors",
    "data": {
        "name": [
            "The name field is required."
        ]
    }
}
Exemplo
curl --request POST \
     --url 'https://api.hubiss.com.br/v1/stores/STOREID/products' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer SEU_TOKEN' \
     --header 'Content-Type: application/json' \
     --data '{    "brand_id": 2,    "language_code": "pt_BR",    "product_type": "variations",    "product_format": "physical_product",    "product_condition": "new",    "sku": "111112",    "name": "Novo produto de teste abc1231",    "price": "1001.00",    "old_price": "2000.00",    "description": "<p>Descri&ccedil;&atilde;o completa aqui teste</p>",    "technical_description": "<p>T&eacute;cnica aqui teste</p>",    "included_itens": "<p>&iacute;tens inclusos aqui teste</p>",    "status": "active",    "warranty_days": 90,    "gtin": "",    "ncm": "",    "height": 11,    "width": 12,    "length": 13,    "gross_weight": 0.25,    "url": "https://www.hubiss.com.br/?teste=2",    "days_for_shipping": 4,    "release_date": "2022-01-01T00:00:00",    "dropshipping_crossdocking": {        "allow_others_integrate": true    },    "videos": [        "https://www.youtube.com/watch?v=1223456789"    ],    "variations": [        {            "sku": "var-1",            "stock": 3,            "gtin": "",            "variation_options": [                {                    "option_id": 2,                    "value": "Azul"                },                {                    "option_id": 4,                    "value": "110"                }            ]        },        {            "sku": "var-2",            "stock": 8,            "gtin": "",            "variation_options": [                {                    "option_id": 2,                    "value": "Amarelo"                },                {                    "option_id": 4,                    "value": "220"                }            ]        }    ],    "categories": [        {            "id": 715        }    ]}'
use Illuminate\Support\Facades\Http;

$response = Http::withToken('SEU_TOKEN')
    ->acceptJson()
    ->withBody("{\n    \"brand_id\": 2,\n    \"language_code\": \"pt_BR\",\n    \"product_type\": \"variations\",\n    \"product_format\": \"physical_product\",\n    \"product_condition\": \"new\",\n    \"sku\": \"111112\",\n    \"name\": \"Novo produto de teste abc1231\",\n    \"price\": \"1001.00\",\n    \"old_price\": \"2000.00\",\n    \"description\": \"<p>Descri&ccedil;&atilde;o completa aqui teste<\/p>\",\n    \"technical_description\": \"<p>T&eacute;cnica aqui teste<\/p>\",\n    \"included_itens\": \"<p>&iacute;tens inclusos aqui teste<\/p>\",\n    \"status\": \"active\",\n    \"warranty_days\": 90,\n    \"gtin\": \"\",\n    \"ncm\": \"\",\n    \"height\": 11,\n    \"width\": 12,\n    \"length\": 13,\n    \"gross_weight\": 0.25,\n    \"url\": \"https:\/\/www.hubiss.com.br\/?teste=2\",\n    \"days_for_shipping\": 4,\n    \"release_date\": \"2022-01-01T00:00:00\",\n    \"dropshipping_crossdocking\": {\n        \"allow_others_integrate\": true\n    },\n    \"videos\": [\n        \"https:\/\/www.youtube.com\/watch?v=1223456789\"\n    ],\n    \"variations\": [\n        {\n            \"sku\": \"var-1\",\n            \"stock\": 3,\n            \"gtin\": \"\",\n            \"variation_options\": [\n                {\n                    \"option_id\": 2,\n                    \"value\": \"Azul\"\n                },\n                {\n                    \"option_id\": 4,\n                    \"value\": \"110\"\n                }\n            ]\n        },\n        {\n            \"sku\": \"var-2\",\n            \"stock\": 8,\n            \"gtin\": \"\",\n            \"variation_options\": [\n                {\n                    \"option_id\": 2,\n                    \"value\": \"Amarelo\"\n                },\n                {\n                    \"option_id\": 4,\n                    \"value\": \"220\"\n                }\n            ]\n        }\n    ],\n    \"categories\": [\n        {\n            \"id\": 715\n        }\n    ]\n}", 'application/json')
    ->post('https://api.hubiss.com.br/v1/stores/STOREID/products');

$response->json();
const response = await fetch('https://api.hubiss.com.br/v1/stores/STOREID/products', {
    method: 'POST',
    headers: {
        'Accept': 'application/json',
        'Authorization': 'Bearer SEU_TOKEN',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
    "brand_id": 2,
    "language_code": "pt_BR",
    "product_type": "variations",
    "product_format": "physical_product",
    "product_condition": "new",
    "sku": "111112",
    "name": "Novo produto de teste abc1231",
    "price": "1001.00",
    "old_price": "2000.00",
    "description": "<p>Descri&ccedil;&atilde;o completa aqui teste</p>",
    "technical_description": "<p>T&eacute;cnica aqui teste</p>",
    "included_itens": "<p>&iacute;tens inclusos aqui teste</p>",
    "status": "active",
    "warranty_days": 90,
    "gtin": "",
    "ncm": "",
    "height": 11,
    "width": 12,
    "length": 13,
    "gross_weight": 0.25,
    "url": "https://www.hubiss.com.br/?teste=2",
    "days_for_shipping": 4,
    "release_date": "2022-01-01T00:00:00",
    "dropshipping_crossdocking": {
        "allow_others_integrate": true
    },
    "videos": [
        "https://www.youtube.com/watch?v=1223456789"
    ],
    "variations": [
        {
            "sku": "var-1",
            "stock": 3,
            "gtin": "",
            "variation_options": [
                {
                    "option_id": 2,
                    "value": "Azul"
                },
                {
                    "option_id": 4,
                    "value": "110"
                }
            ]
        },
        {
            "sku": "var-2",
            "stock": 8,
            "gtin": "",
            "variation_options": [
                {
                    "option_id": 2,
                    "value": "Amarelo"
                },
                {
                    "option_id": 4,
                    "value": "220"
                }
            ]
        }
    ],
    "categories": [
        {
            "id": 715
        }
    ]
})
});

const data = await response.json();
import requests

response = requests.POST(
    'https://api.hubiss.com.br/v1/stores/STOREID/products',
    headers={'Authorization': 'Bearer SEU_TOKEN', 'Accept': 'application/json'},
    json={
    "brand_id": 2,
    "language_code": "pt_BR",
    "product_type": "variations",
    "product_format": "physical_product",
    "product_condition": "new",
    "sku": "111112",
    "name": "Novo produto de teste abc1231",
    "price": "1001.00",
    "old_price": "2000.00",
    "description": "<p>Descri&ccedil;&atilde;o completa aqui teste</p>",
    "technical_description": "<p>T&eacute;cnica aqui teste</p>",
    "included_itens": "<p>&iacute;tens inclusos aqui teste</p>",
    "status": "active",
    "warranty_days": 90,
    "gtin": "",
    "ncm": "",
    "height": 11,
    "width": 12,
    "length": 13,
    "gross_weight": 0.25,
    "url": "https://www.hubiss.com.br/?teste=2",
    "days_for_shipping": 4,
    "release_date": "2022-01-01T00:00:00",
    "dropshipping_crossdocking": {
        "allow_others_integrate": true
    },
    "videos": [
        "https://www.youtube.com/watch?v=1223456789"
    ],
    "variations": [
        {
            "sku": "var-1",
            "stock": 3,
            "gtin": "",
            "variation_options": [
                {
                    "option_id": 2,
                    "value": "Azul"
                },
                {
                    "option_id": 4,
                    "value": "110"
                }
            ]
        },
        {
            "sku": "var-2",
            "stock": 8,
            "gtin": "",
            "variation_options": [
                {
                    "option_id": 2,
                    "value": "Amarelo"
                },
                {
                    "option_id": 4,
                    "value": "220"
                }
            ]
        }
    ],
    "categories": [
        {
            "id": 715
        }
    ]
},
)

print(response.json())
O token é usado apenas nesta requisição e não é armazenado.
GET /stores/{storeId}/products/{productId}
Recuperar Produto

Retorna a Marca com essa id

StatusQuando aconteceCorpo
401 401 —
404 404 —
Nome Local Tipo Descrição
storeId * path integer
padrão: 1

ID da loja

productId * path integer
padrão: 1

ID do produto

Resposta
json
{
    "id": 1,
    "brand_id": 1,
    "language_code": "pt_BR",
    "product_type": "variations",
    "product_format": "physical_product",
    "product_condition": "new",
    "sku": "sku1234",
    "name": "Novo produto de teste abc1231",
    "slug": "novo-produto-de-teste-abc1231",
    "price": "1.00",
    "old_price": "2.00",
    "description": "<p>Descri&ccedil;&atilde;o completa aqui teste</p>",
    "technical_description": "<p>T&eacute;cnica aqui teste</p>",
    "included_itens": "<p>&iacute;tens inclusos aqui teste</p>",
    "status": "active",
    "warranty_days": 90,
    "gtin": "",
    "ncm": "",
    "height": 11,
    "width": 12,
    "length": 13,
    "gross_weight": 0.25,
    "url": "https://www.hubiss.com.br/?teste=2",
    "stock": 11,
    "reserved_stock": 0,
    "days_for_shipping": 4,
    "release_date": "2022-01-01T00:00:00",
    "created_at": "2022-04-24T00:57:37",
    "updated_at": "2022-04-27T23:04:56",
    "dropshipping_crossdocking": {
        "allow_others_integrate": true
    },
    "semantic_fields": {
        "allow_auto_generate_titles": true,
        "base_title": ""
    },
    "pictures": [
        {
            "id": 1,
            "position": 1,
            "url": "https://www.google.com/4b71852ea4fcc1cbb1204a431424f169.jpeg",
            "has_qr_code": 0
        },
        {
            "id": 2,
            "position": 2,
            "url": "https://www.google.com/3287a02858850ac79e04c44cb21d55d3.png",
            "has_qr_code": 0
        }
    ],
    "videos": [
        {
            "position": 0,
            "url": "https://www.youtube.com/watch?v=1234567891011"
        }
    ],
    "variations": [
        {
            "id": 1,
            "sku": "var-1",
            "stock": 3,
            "reserved_stock": 0,
            "gtin": "",
            "variation_options": [
                {
                    "option_id": 2,
                    "option_description": "Cor",
                    "value": "Azul"
                },
                {
                    "option_id": 4,
                    "option_description": "Voltagem",
                    "value": "110"
                }
            ],
            "created_at": "2022-04-24T00:57:37",
            "updated_at": "2022-04-24T00:57:37"
        },
        {
            "id": 2,
            "sku": "var-2",
            "stock": 8,
            "reserved_stock": 0,
            "gtin": "",
            "variation_options": [
                {
                    "option_id": 2,
                    "option_description": "Cor",
                    "value": "Amarelo"
                },
                {
                    "option_id": 4,
                    "option_description": "Voltagem",
                    "value": "220"
                }
            ],
            "created_at": "2022-04-24T01:13:20",
            "updated_at": "2022-04-24T01:13:20"
        }
    ],
    "categories": [
        {
            "id": 715
        }
    ]
}
{
    "error": "Unauthorized"
}
{
    "error": "Resource 9999 not found"
}
Exemplo
curl --request GET \
     --url 'https://api.hubiss.com.br/v1/stores/STOREID/products/PRODUCTID' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer SEU_TOKEN'
use Illuminate\Support\Facades\Http;

$response = Http::withToken('SEU_TOKEN')
    ->acceptJson()
    ->get('https://api.hubiss.com.br/v1/stores/STOREID/products/PRODUCTID');

$response->json();
const response = await fetch('https://api.hubiss.com.br/v1/stores/STOREID/products/PRODUCTID', {
    method: 'GET',
    headers: {
        'Accept': 'application/json',
        'Authorization': 'Bearer SEU_TOKEN'
    }
});

const data = await response.json();
import requests

response = requests.GET(
    'https://api.hubiss.com.br/v1/stores/STOREID/products/PRODUCTID',
    headers={'Authorization': 'Bearer SEU_TOKEN', 'Accept': 'application/json'},
)

print(response.json())
O token é usado apenas nesta requisição e não é armazenado.
PUT /stores/{storeId}/products/{productId}
Atualizar Produto
StatusQuando aconteceCorpo
401 401 —
404 Registro informado no caminho nao existe ou pertence a outra conta. {"error":"Resource 123 not found"}
422 422 —
Nome Local Tipo Descrição
storeId * path integer
padrão: 1

Código da sua loja

productId * path integer
padrão: 1

Código do produto cadastrado

CampoTipoDescrição
brand_id * integer

Código da marca.

Obtenha-o aqui: https://api.hubiss.com.br/reference/marcas#endpoint-listar-marcas

language_code * string

Código da linguagem. Obrigatório informar uma das mesmas linguagens informadas ao cadastrar a lista de produtos.

product_type * string

Obs. No momento não é permitido alterar o tipo de produto de normal para variations ou vice versa

product_format * string
product_condition * string
sku string

Código identificador do produto, obrigatório informar se você estiver cadastrando produto normal.

name * string

Nome do produto

price * string

Valor do produto

old_price string

Valor antigo do produto (Em caso de promoção)

description string

Descrição completa do produto

technical_description string

Descrição técnica do produto

included_itens string

Descrição dos itens inclusos

status * string
warranty_days * integer

Dias de garantia

gtin string

Código de barras. Aceito apenas EAN válidos de 8 ou 13 dígitos.

Caso acredite que o sistema esteja com falha, por favor, abra um chamado em: https://hubiss.freshdesk.com/support/home

ncm string
height integer

Altura

width integer

Largura

length integer

Comprimento

gross_weight number

Peso bruto

url string

Link do produto: Caso queira usar como referência de site externo

days_for_shipping integer

Dias necessários para envio do produto após venda

release_date string

Caso queira gravar a data de lançamento do produto para futuras referências, informe a data no mesmo formato informado.

dropshipping_crossdocking object
videos array

Caso o produto contenha vídeos, informe os links dos vídeos

variations array
categories * array
Corpo enviado (JSON) json
{
    "brand_id": 2,
    "language_code": "pt_BR",
    "product_type": "variations",
    "product_format": "physical_product",
    "product_condition": "new",
    "sku": "111112",
    "name": "Novo produto de teste abc1231",
    "price": "1001.00",
    "old_price": "2000.00",
    "description": "<p>Descri&ccedil;&atilde;o completa aqui teste</p>",
    "technical_description": "<p>T&eacute;cnica aqui teste</p>",
    "included_itens": "<p>&iacute;tens inclusos aqui teste</p>",
    "status": "active",
    "warranty_days": 90,
    "gtin": "",
    "ncm": "",
    "height": 11,
    "width": 12,
    "length": 13,
    "gross_weight": 0.25,
    "url": "https://www.hubiss.com.br/?teste=2",
    "days_for_shipping": 4,
    "release_date": "2022-01-01T00:00:00",
    "dropshipping_crossdocking": {
        "allow_others_integrate": true
    },
    "videos": [
        "https://www.youtube.com/watch?v=1223456789"
    ],
    "variations": [
        {
            "sku": "var-1",
            "stock": 3,
            "gtin": "",
            "variation_options": [
                {
                    "option_id": 2,
                    "value": "Azul"
                },
                {
                    "option_id": 4,
                    "value": "110"
                }
            ]
        },
        {
            "sku": "var-2",
            "stock": 8,
            "gtin": "",
            "variation_options": [
                {
                    "option_id": 2,
                    "value": "Amarelo"
                },
                {
                    "option_id": 4,
                    "value": "220"
                }
            ]
        }
    ],
    "categories": [
        {
            "id": 715
        }
    ]
}
Resposta
json
{
    "data": {
        "id": 2924,
        "brand_id": 2,
        "language_code": "pt_BR",
        "product_type": "variations",
        "product_format": "physical_product",
        "product_condition": "new",
        "sku": "111112",
        "name": "Novo produto de teste abc1231",
        "slug": "novo-produto-de-teste-abc1231-4",
        "price": "1001.00",
        "old_price": "2000.00",
        "description": "<p>Descri&ccedil;&atilde;o completa aqui teste</p>",
        "technical_description": "<p>T&eacute;cnica aqui teste</p>",
        "included_itens": "<p>&iacute;tens inclusos aqui teste</p>",
        "status": "active",
        "warranty_days": 90,
        "gtin": "",
        "ncm": "",
        "height": 11,
        "width": 12,
        "length": 13,
        "gross_weight": 0.25,
        "url": "https://www.hubiss.com.br/?teste=2",
        "stock": 11,
        "reserved_stock": 0,
        "days_for_shipping": 4,
        "release_date": "2022-01-01T00:00:00",
        "created_at": "2022-04-24T01:11:39",
        "updated_at": "2022-04-24T01:11:39",
        "dropshipping_crossdocking": {
            "allow_others_integrate": true
        },
        "semantic_fields": {
            "allow_auto_generate_titles": true,
            "base_title": ""
        },
        "images": [],
        "videos": [
            "https://www.youtube.com/watch?v=123456489"
        ],
        "variations": [
            {
                "id": 16652,
                "sku": "11111-var-12",
                "stock": 3,
                "reserved_stock": 0,
                "gtin": "",
                "variation_options": [
                    {
                        "option_id": 2,
                        "option_description": "Cor",
                        "value": "Azul"
                    },
                    {
                        "option_id": 4,
                        "option_description": "Voltagem",
                        "value": "110"
                    }
                ],
                "created_at": "2022-04-24T01:11:39",
                "updated_at": "2022-04-24T01:11:39"
            },
            {
                "id": 16653,
                "sku": "11111-var-22",
                "stock": 8,
                "reserved_stock": 0,
                "gtin": "",
                "variation_options": [
                    {
                        "option_id": 2,
                        "option_description": "Cor",
                        "value": "Amarelo"
                    },
                    {
                        "option_id": 4,
                        "option_description": "Voltagem",
                        "value": "220"
                    }
                ],
                "created_at": "2022-04-24T01:11:39",
                "updated_at": "2022-04-24T01:11:39"
            }
        ],
        "categories": [
            {
                "id": 715
            }
        ]
    },
    "success": true,
    "message": "Register Successfull Updated"
}
{
    "error": "Unauthorized"
}
{
    "success": false,
    "message": "Validation errors",
    "data": {
        "name": [
            "The name field is required."
        ]
    }
}
Exemplo
curl --request PUT \
     --url 'https://api.hubiss.com.br/v1/stores/STOREID/products/PRODUCTID' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer SEU_TOKEN' \
     --header 'Content-Type: application/json' \
     --data '{    "brand_id": 2,    "language_code": "pt_BR",    "product_type": "variations",    "product_format": "physical_product",    "product_condition": "new",    "sku": "111112",    "name": "Novo produto de teste abc1231",    "price": "1001.00",    "old_price": "2000.00",    "description": "<p>Descri&ccedil;&atilde;o completa aqui teste</p>",    "technical_description": "<p>T&eacute;cnica aqui teste</p>",    "included_itens": "<p>&iacute;tens inclusos aqui teste</p>",    "status": "active",    "warranty_days": 90,    "gtin": "",    "ncm": "",    "height": 11,    "width": 12,    "length": 13,    "gross_weight": 0.25,    "url": "https://www.hubiss.com.br/?teste=2",    "days_for_shipping": 4,    "release_date": "2022-01-01T00:00:00",    "dropshipping_crossdocking": {        "allow_others_integrate": true    },    "videos": [        "https://www.youtube.com/watch?v=1223456789"    ],    "variations": [        {            "sku": "var-1",            "stock": 3,            "gtin": "",            "variation_options": [                {                    "option_id": 2,                    "value": "Azul"                },                {                    "option_id": 4,                    "value": "110"                }            ]        },        {            "sku": "var-2",            "stock": 8,            "gtin": "",            "variation_options": [                {                    "option_id": 2,                    "value": "Amarelo"                },                {                    "option_id": 4,                    "value": "220"                }            ]        }    ],    "categories": [        {            "id": 715        }    ]}'
use Illuminate\Support\Facades\Http;

$response = Http::withToken('SEU_TOKEN')
    ->acceptJson()
    ->withBody("{\n    \"brand_id\": 2,\n    \"language_code\": \"pt_BR\",\n    \"product_type\": \"variations\",\n    \"product_format\": \"physical_product\",\n    \"product_condition\": \"new\",\n    \"sku\": \"111112\",\n    \"name\": \"Novo produto de teste abc1231\",\n    \"price\": \"1001.00\",\n    \"old_price\": \"2000.00\",\n    \"description\": \"<p>Descri&ccedil;&atilde;o completa aqui teste<\/p>\",\n    \"technical_description\": \"<p>T&eacute;cnica aqui teste<\/p>\",\n    \"included_itens\": \"<p>&iacute;tens inclusos aqui teste<\/p>\",\n    \"status\": \"active\",\n    \"warranty_days\": 90,\n    \"gtin\": \"\",\n    \"ncm\": \"\",\n    \"height\": 11,\n    \"width\": 12,\n    \"length\": 13,\n    \"gross_weight\": 0.25,\n    \"url\": \"https:\/\/www.hubiss.com.br\/?teste=2\",\n    \"days_for_shipping\": 4,\n    \"release_date\": \"2022-01-01T00:00:00\",\n    \"dropshipping_crossdocking\": {\n        \"allow_others_integrate\": true\n    },\n    \"videos\": [\n        \"https:\/\/www.youtube.com\/watch?v=1223456789\"\n    ],\n    \"variations\": [\n        {\n            \"sku\": \"var-1\",\n            \"stock\": 3,\n            \"gtin\": \"\",\n            \"variation_options\": [\n                {\n                    \"option_id\": 2,\n                    \"value\": \"Azul\"\n                },\n                {\n                    \"option_id\": 4,\n                    \"value\": \"110\"\n                }\n            ]\n        },\n        {\n            \"sku\": \"var-2\",\n            \"stock\": 8,\n            \"gtin\": \"\",\n            \"variation_options\": [\n                {\n                    \"option_id\": 2,\n                    \"value\": \"Amarelo\"\n                },\n                {\n                    \"option_id\": 4,\n                    \"value\": \"220\"\n                }\n            ]\n        }\n    ],\n    \"categories\": [\n        {\n            \"id\": 715\n        }\n    ]\n}", 'application/json')
    ->put('https://api.hubiss.com.br/v1/stores/STOREID/products/PRODUCTID');

$response->json();
const response = await fetch('https://api.hubiss.com.br/v1/stores/STOREID/products/PRODUCTID', {
    method: 'PUT',
    headers: {
        'Accept': 'application/json',
        'Authorization': 'Bearer SEU_TOKEN',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
    "brand_id": 2,
    "language_code": "pt_BR",
    "product_type": "variations",
    "product_format": "physical_product",
    "product_condition": "new",
    "sku": "111112",
    "name": "Novo produto de teste abc1231",
    "price": "1001.00",
    "old_price": "2000.00",
    "description": "<p>Descri&ccedil;&atilde;o completa aqui teste</p>",
    "technical_description": "<p>T&eacute;cnica aqui teste</p>",
    "included_itens": "<p>&iacute;tens inclusos aqui teste</p>",
    "status": "active",
    "warranty_days": 90,
    "gtin": "",
    "ncm": "",
    "height": 11,
    "width": 12,
    "length": 13,
    "gross_weight": 0.25,
    "url": "https://www.hubiss.com.br/?teste=2",
    "days_for_shipping": 4,
    "release_date": "2022-01-01T00:00:00",
    "dropshipping_crossdocking": {
        "allow_others_integrate": true
    },
    "videos": [
        "https://www.youtube.com/watch?v=1223456789"
    ],
    "variations": [
        {
            "sku": "var-1",
            "stock": 3,
            "gtin": "",
            "variation_options": [
                {
                    "option_id": 2,
                    "value": "Azul"
                },
                {
                    "option_id": 4,
                    "value": "110"
                }
            ]
        },
        {
            "sku": "var-2",
            "stock": 8,
            "gtin": "",
            "variation_options": [
                {
                    "option_id": 2,
                    "value": "Amarelo"
                },
                {
                    "option_id": 4,
                    "value": "220"
                }
            ]
        }
    ],
    "categories": [
        {
            "id": 715
        }
    ]
})
});

const data = await response.json();
import requests

response = requests.PUT(
    'https://api.hubiss.com.br/v1/stores/STOREID/products/PRODUCTID',
    headers={'Authorization': 'Bearer SEU_TOKEN', 'Accept': 'application/json'},
    json={
    "brand_id": 2,
    "language_code": "pt_BR",
    "product_type": "variations",
    "product_format": "physical_product",
    "product_condition": "new",
    "sku": "111112",
    "name": "Novo produto de teste abc1231",
    "price": "1001.00",
    "old_price": "2000.00",
    "description": "<p>Descri&ccedil;&atilde;o completa aqui teste</p>",
    "technical_description": "<p>T&eacute;cnica aqui teste</p>",
    "included_itens": "<p>&iacute;tens inclusos aqui teste</p>",
    "status": "active",
    "warranty_days": 90,
    "gtin": "",
    "ncm": "",
    "height": 11,
    "width": 12,
    "length": 13,
    "gross_weight": 0.25,
    "url": "https://www.hubiss.com.br/?teste=2",
    "days_for_shipping": 4,
    "release_date": "2022-01-01T00:00:00",
    "dropshipping_crossdocking": {
        "allow_others_integrate": true
    },
    "videos": [
        "https://www.youtube.com/watch?v=1223456789"
    ],
    "variations": [
        {
            "sku": "var-1",
            "stock": 3,
            "gtin": "",
            "variation_options": [
                {
                    "option_id": 2,
                    "value": "Azul"
                },
                {
                    "option_id": 4,
                    "value": "110"
                }
            ]
        },
        {
            "sku": "var-2",
            "stock": 8,
            "gtin": "",
            "variation_options": [
                {
                    "option_id": 2,
                    "value": "Amarelo"
                },
                {
                    "option_id": 4,
                    "value": "220"
                }
            ]
        }
    ],
    "categories": [
        {
            "id": 715
        }
    ]
},
)

print(response.json())
O token é usado apenas nesta requisição e não é armazenado.
DELETE /stores/{storeId}/products/{productId}
Excluir Produto

Exclui o produto com essa id

StatusQuando aconteceCorpo
401 401 —
404 404 —
Nome Local Tipo Descrição
storeId * path integer
padrão: 1

Código da loja

productId * path integer
padrão: 1

Código do produto

Resposta
json
204
{
    "error": "Unauthorized"
}
{
    "error": "Resource 9999 not found"
}
Exemplo
curl --request DELETE \
     --url 'https://api.hubiss.com.br/v1/stores/STOREID/products/PRODUCTID' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer SEU_TOKEN'
use Illuminate\Support\Facades\Http;

$response = Http::withToken('SEU_TOKEN')
    ->acceptJson()
    ->delete('https://api.hubiss.com.br/v1/stores/STOREID/products/PRODUCTID');

$response->json();
const response = await fetch('https://api.hubiss.com.br/v1/stores/STOREID/products/PRODUCTID', {
    method: 'DELETE',
    headers: {
        'Accept': 'application/json',
        'Authorization': 'Bearer SEU_TOKEN'
    }
});

const data = await response.json();
import requests

response = requests.DELETE(
    'https://api.hubiss.com.br/v1/stores/STOREID/products/PRODUCTID',
    headers={'Authorization': 'Bearer SEU_TOKEN', 'Accept': 'application/json'},
)

print(response.json())
O token é usado apenas nesta requisição e não é armazenado.
GET /stores/{storeId}/products/{productId}/pictures
Listar Fotos do Produto

Listar todas as fotos cadastradas no produto

StatusQuando aconteceCorpo
401 401 —
404 Registro informado no caminho nao existe ou pertence a outra conta. {"error":"Resource 123 not found"}
Nome Local Tipo Descrição
storeId * path integer
padrão: 1

Código da loja

productId * path integer
padrão: 1

Código do produto

Resposta
json
{
    "data": [
        {
            "id": 1,
            "position": 1,
            "url": "http://www.google.com/imagem1.jpg",
            "has_qr_code": null
        },
        {
            "id": 2,
            "position": 2,
            "url": "http://www.google.com/imagem2.jpg",
            "has_qr_code": null
        }
    ],
    "links": {
        "first": "https://hubiss.dev/api/v1/product-lists/14/products/2880/pictures?page=1",
        "last": "https://hubiss.dev/api/v1/product-lists/14/products/2880/pictures?page=2",
        "prev": null,
        "next": "https://hubiss.dev/api/v1/product-lists/14/products/2880/pictures?page=2"
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 2,
        "links": [
            {
                "url": null,
                "label": "&laquo; Previous",
                "active": false
            },
            {
                "url": "https://hubiss.dev/api/v1/product-lists/14/products/2880/pictures?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": "https://hubiss.dev/api/v1/product-lists/14/products/2880/pictures?page=2",
                "label": "2",
                "active": false
            },
            {
                "url": "https://hubiss.dev/api/v1/product-lists/14/products/2880/pictures?page=2",
                "label": "Next &raquo;",
                "active": false
            }
        ],
        "path": "https://hubiss.dev/api/v1/product-lists/14/products/2880/pictures",
        "per_page": 20,
        "to": 20,
        "total": 2
    }
}
{
    "error": "Unauthorized"
}
Exemplo
curl --request GET \
     --url 'https://api.hubiss.com.br/v1/stores/STOREID/products/PRODUCTID/pictures' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer SEU_TOKEN'
use Illuminate\Support\Facades\Http;

$response = Http::withToken('SEU_TOKEN')
    ->acceptJson()
    ->get('https://api.hubiss.com.br/v1/stores/STOREID/products/PRODUCTID/pictures');

$response->json();
const response = await fetch('https://api.hubiss.com.br/v1/stores/STOREID/products/PRODUCTID/pictures', {
    method: 'GET',
    headers: {
        'Accept': 'application/json',
        'Authorization': 'Bearer SEU_TOKEN'
    }
});

const data = await response.json();
import requests

response = requests.GET(
    'https://api.hubiss.com.br/v1/stores/STOREID/products/PRODUCTID/pictures',
    headers={'Authorization': 'Bearer SEU_TOKEN', 'Accept': 'application/json'},
)

print(response.json())
O token é usado apenas nesta requisição e não é armazenado.
POST /stores/{storeId}/products/{productId}/pictures/url
Cadastrar Foto do Produto (URL)

Cadastra a foto apenas com a URL informada. A imagem não é copiada para o servidor Hubiss.

StatusQuando aconteceCorpo
401 Token ausente ou inválido —
404 Produto inexistente ou de outra conta —
422 URL inválida ou formato de imagem não aceito —
Nome Local Tipo Descrição
storeId * path integer
padrão: 101

Código da loja

productId * path integer
padrão: 1

Código do produto

CampoTipoDescrição
url * string

URL da imagem. Aceita jpg, jpeg, gif, png e webp.

position integer

Ordem da foto na galeria. Se omitido, usa a próxima posição livre.

Corpo enviado (JSON) json
{
    "url": null,
    "position": null
}
Resposta
json
201
Token ausente ou inválido
Produto inexistente ou de outra conta
URL inválida ou formato de imagem não aceito
Exemplo
curl --request POST \
     --url 'https://api.hubiss.com.br/v1/stores/STOREID/products/PRODUCTID/pictures/url' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer SEU_TOKEN' \
     --header 'Content-Type: application/json' \
     --data '{    "url": null,    "position": null}'
use Illuminate\Support\Facades\Http;

$response = Http::withToken('SEU_TOKEN')
    ->acceptJson()
    ->withBody("{\n    \"url\": null,\n    \"position\": null\n}", 'application/json')
    ->post('https://api.hubiss.com.br/v1/stores/STOREID/products/PRODUCTID/pictures/url');

$response->json();
const response = await fetch('https://api.hubiss.com.br/v1/stores/STOREID/products/PRODUCTID/pictures/url', {
    method: 'POST',
    headers: {
        'Accept': 'application/json',
        'Authorization': 'Bearer SEU_TOKEN',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
    "url": null,
    "position": null
})
});

const data = await response.json();
import requests

response = requests.POST(
    'https://api.hubiss.com.br/v1/stores/STOREID/products/PRODUCTID/pictures/url',
    headers={'Authorization': 'Bearer SEU_TOKEN', 'Accept': 'application/json'},
    json={
    "url": null,
    "position": null
},
)

print(response.json())
O token é usado apenas nesta requisição e não é armazenado.
POST /stores/{storeId}/products/{productId}/pictures/base64
Cadastrar Foto do Produto (base64)

Envia a imagem em base64. O arquivo é convertido e salvo no storage da Hubiss, respeitando o limite configurado (padrão 5 MB).

StatusQuando aconteceCorpo
401 Token ausente ou inválido —
404 Produto inexistente ou de outra conta —
422 Arquivo ausente, grande demais ou extensão não suportada —
Nome Local Tipo Descrição
storeId * path integer
padrão: 101

Código da loja

productId * path integer
padrão: 1

Código do produto

CampoTipoDescrição
file * string

Imagem em base64 (data URI ou base64 puro). Aceita gif, jpg, jpeg e png.

position integer

Ordem da foto na galeria. Se omitido, usa a próxima posição livre.

Corpo enviado (JSON) json
{
    "file": null,
    "position": null
}
Resposta
json
201
Token ausente ou inválido
Produto inexistente ou de outra conta
Arquivo ausente, grande demais ou extensão não suportada
Exemplo
curl --request POST \
     --url 'https://api.hubiss.com.br/v1/stores/STOREID/products/PRODUCTID/pictures/base64' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer SEU_TOKEN' \
     --header 'Content-Type: application/json' \
     --data '{    "file": null,    "position": null}'
use Illuminate\Support\Facades\Http;

$response = Http::withToken('SEU_TOKEN')
    ->acceptJson()
    ->withBody("{\n    \"file\": null,\n    \"position\": null\n}", 'application/json')
    ->post('https://api.hubiss.com.br/v1/stores/STOREID/products/PRODUCTID/pictures/base64');

$response->json();
const response = await fetch('https://api.hubiss.com.br/v1/stores/STOREID/products/PRODUCTID/pictures/base64', {
    method: 'POST',
    headers: {
        'Accept': 'application/json',
        'Authorization': 'Bearer SEU_TOKEN',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
    "file": null,
    "position": null
})
});

const data = await response.json();
import requests

response = requests.POST(
    'https://api.hubiss.com.br/v1/stores/STOREID/products/PRODUCTID/pictures/base64',
    headers={'Authorization': 'Bearer SEU_TOKEN', 'Accept': 'application/json'},
    json={
    "file": null,
    "position": null
},
)

print(response.json())
O token é usado apenas nesta requisição e não é armazenado.
DELETE /stores/{storeId}/products/{productId}/pictures/{pictureId}
Excluir Foto do Produto

Exclui o produto com essa id

StatusQuando aconteceCorpo
401 401 —
404 404 —
Nome Local Tipo Descrição
storeId * path integer
padrão: 1

Código da loja

productId * path integer
padrão: 1

Código do produto

pictureId * path integer
padrão: 1

ID da foto do produto

Resposta
json
204
{
    "error": "Unauthorized"
}
{
    "error": "Resource 9999 not found"
}
Exemplo
curl --request DELETE \
     --url 'https://api.hubiss.com.br/v1/stores/STOREID/products/PRODUCTID/pictures/PICTUREID' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer SEU_TOKEN'
use Illuminate\Support\Facades\Http;

$response = Http::withToken('SEU_TOKEN')
    ->acceptJson()
    ->delete('https://api.hubiss.com.br/v1/stores/STOREID/products/PRODUCTID/pictures/PICTUREID');

$response->json();
const response = await fetch('https://api.hubiss.com.br/v1/stores/STOREID/products/PRODUCTID/pictures/PICTUREID', {
    method: 'DELETE',
    headers: {
        'Accept': 'application/json',
        'Authorization': 'Bearer SEU_TOKEN'
    }
});

const data = await response.json();
import requests

response = requests.DELETE(
    'https://api.hubiss.com.br/v1/stores/STOREID/products/PRODUCTID/pictures/PICTUREID',
    headers={'Authorization': 'Bearer SEU_TOKEN', 'Accept': 'application/json'},
)

print(response.json())
O token é usado apenas nesta requisição e não é armazenado.

Erros comuns

Sintoma Causa provável O que fazer
422 em sku SKU repetido Usar SKU único por conta
422 em categories Categoria obrigatória ausente ou de outra loja Enviar as categorias da mesma loja
422 em variations Variações incompletas ou SKU de variação repetido Enviar SKU e opções em cada variação
Foto por URL não aparece URL inacessível ou fora dos formatos jpg/gif/png/webp Hospedar em URL pública válida
422 em file (base64) Arquivo acima do limite (padrão 5 MB) ou extensão não suportada Reduzir a imagem e usar gif/jpg/jpeg/png

Atualizar um produto substitui as categorias e as variações enviadas: o que não vier no payload é removido.

Próximo passo
Siga para Pedidos.