Produtos
Cadastro completo de produtos, variações e fotos para publicar nos marketplaces.
O cadastro de produtos é o passo mais importante da integração: é ele que define a qualidade dos anúncios publicados.
Ordem correta do cadastro
- Cadastrar uma loja.
- Cadastrar a árvore de categorias da loja.
- Cadastrar o produto nas categorias da loja.
- Cadastrar as fotos do produto.
Cada etapa depende da anterior — respeite a ordem.
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.
/variation-types
Listar os tipos de variação disponíveis para cadastro de produtos com variação
| Status | Quando acontece | Corpo |
|---|---|---|
| 401 | 401 | — |
| 404 | 404 | — |
| Nome | Local | Tipo | Descrição |
|---|---|---|---|
name
|
query | stringpadrão: cor |
Filtrar por tipo de variação |
{
"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"
}
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())
/stores/{storeId}/products
Listar todas as categorias das listas de produtos cadastradas
| Status | Quando acontece | Corpo |
|---|---|---|
| 401 | 401 | — |
| 404 | 404 | — |
| Nome | Local | Tipo | Descrição |
|---|---|---|---|
storeId
*
|
path | integerpadrã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 | stringpadrã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 | numberpadrão: 0.01 |
Filtrar por produtos com o preço a partir do valor informado |
price[to]
|
query | numberpadrão: 9999.99 |
Filtrar por produtos com o preço até o valor informado |
stock[from]
|
query | integerpadrão: 1 |
Filtrar por produtos com o estoque a partir da quantidade informada. Valores negativos também são aceitos |
stock[to]
|
query | integerpadrão: 9999 |
Filtrar por produtos com o estoque até a quantidade informada. Valores negativos são aceitos |
status
|
query | stringpadrão: active |
Filtrar por status do produto. Possíveis opções: active, inactive |
days_for_shipping[from]
|
query | integerpadrão: 0 |
Filtrar por produtos com o prazo de envio do produto a partir da quantidade informada. |
days_for_shipping[to]
|
query | integerpadrão: 99 |
Filtrar por produtos com o prazo de envio até a quantidade informada. |
product_type
|
query | stringpadrão: normal |
Filtrar por produtos pelo tipo de produto. Possíveis opções: normal, variations |
created_at[from]
|
query | stringpadrão: 2022-04-19T23:24:50 |
Filtrar por produtos cadastrados a partir da data informada |
created_at[to]
|
query | stringpadrão: 2099-04-19T23:24:51 |
Filtrar por produtos cadastrados até a data informada |
updated_at[from]
|
query | stringpadrão: 2022-04-19T23:24:50 |
Filtrar por produtos que sofreram alteração a partir da data informada |
updated_at[to]
|
query | stringpadrão: 2099-04-19T23:24:51 |
Filtrar por produtos que sofreram alteração até a data informada |
{
"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ção completa aqui teste</p>",
"technical_description": "<p>Técnica aqui teste</p>",
"included_itens": "<p>í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": "« Previous",
"active": false
},
{
"url": "https://hubiss.dev/api/v1/product-lists/14/products?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"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"
}
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())
/stores/{storeId}/products
| Status | Quando acontece | Corpo |
|---|---|---|
| 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 | integerpadrão: 1 |
Código da sua loja cadastrada |
| Campo | Tipo | Descriçã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 |
{
"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ção completa aqui teste</p>",
"technical_description": "<p>Técnica aqui teste</p>",
"included_itens": "<p>í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
}
]
}
{
"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ção completa aqui teste</p>",
"technical_description": "<p>Técnica aqui teste</p>",
"included_itens": "<p>í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."
]
}
}
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ção completa aqui teste</p>", "technical_description": "<p>Técnica aqui teste</p>", "included_itens": "<p>í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ção completa aqui teste<\/p>\",\n \"technical_description\": \"<p>Técnica aqui teste<\/p>\",\n \"included_itens\": \"<p>í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ção completa aqui teste</p>",
"technical_description": "<p>Técnica aqui teste</p>",
"included_itens": "<p>í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ção completa aqui teste</p>",
"technical_description": "<p>Técnica aqui teste</p>",
"included_itens": "<p>í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())
/stores/{storeId}/products/{productId}
Retorna a Marca com essa id
| Status | Quando acontece | Corpo |
|---|---|---|
| 401 | 401 | — |
| 404 | 404 | — |
| Nome | Local | Tipo | Descrição |
|---|---|---|---|
storeId
*
|
path | integerpadrão: 1 |
ID da loja |
productId
*
|
path | integerpadrão: 1 |
ID do produto |
{
"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ção completa aqui teste</p>",
"technical_description": "<p>Técnica aqui teste</p>",
"included_itens": "<p>í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"
}
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())
/stores/{storeId}/products/{productId}
| Status | Quando acontece | Corpo |
|---|---|---|
| 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 | integerpadrão: 1 |
Código da sua loja |
productId
*
|
path | integerpadrão: 1 |
Código do produto cadastrado |
| Campo | Tipo | Descriçã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 |
{
"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ção completa aqui teste</p>",
"technical_description": "<p>Técnica aqui teste</p>",
"included_itens": "<p>í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
}
]
}
{
"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ção completa aqui teste</p>",
"technical_description": "<p>Técnica aqui teste</p>",
"included_itens": "<p>í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."
]
}
}
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ção completa aqui teste</p>", "technical_description": "<p>Técnica aqui teste</p>", "included_itens": "<p>í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ção completa aqui teste<\/p>\",\n \"technical_description\": \"<p>Técnica aqui teste<\/p>\",\n \"included_itens\": \"<p>í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ção completa aqui teste</p>",
"technical_description": "<p>Técnica aqui teste</p>",
"included_itens": "<p>í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ção completa aqui teste</p>",
"technical_description": "<p>Técnica aqui teste</p>",
"included_itens": "<p>í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())
/stores/{storeId}/products/{productId}
Exclui o produto com essa id
| Status | Quando acontece | Corpo |
|---|---|---|
| 401 | 401 | — |
| 404 | 404 | — |
| Nome | Local | Tipo | Descrição |
|---|---|---|---|
storeId
*
|
path | integerpadrão: 1 |
Código da loja |
productId
*
|
path | integerpadrão: 1 |
Código do produto |
204
{
"error": "Unauthorized"
}
{
"error": "Resource 9999 not found"
}
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())
/stores/{storeId}/products/{productId}/pictures
Listar todas as fotos cadastradas no produto
| Status | Quando acontece | Corpo |
|---|---|---|
| 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 | integerpadrão: 1 |
Código da loja |
productId
*
|
path | integerpadrão: 1 |
Código do produto |
{
"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": "« 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 »",
"active": false
}
],
"path": "https://hubiss.dev/api/v1/product-lists/14/products/2880/pictures",
"per_page": 20,
"to": 20,
"total": 2
}
}
{
"error": "Unauthorized"
}
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())
/stores/{storeId}/products/{productId}/pictures/url
Cadastra a foto apenas com a URL informada. A imagem não é copiada para o servidor Hubiss.
| Status | Quando acontece | Corpo |
|---|---|---|
| 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 | integerpadrão: 101 |
Código da loja |
productId
*
|
path | integerpadrão: 1 |
Código do produto |
| Campo | Tipo | Descriçã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. |
{
"url": null,
"position": null
}
201
Token ausente ou inválido
Produto inexistente ou de outra conta
URL inválida ou formato de imagem não aceito
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())
/stores/{storeId}/products/{productId}/pictures/base64
Envia a imagem em base64. O arquivo é convertido e salvo no storage da Hubiss, respeitando o limite configurado (padrão 5 MB).
| Status | Quando acontece | Corpo |
|---|---|---|
| 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 | integerpadrão: 101 |
Código da loja |
productId
*
|
path | integerpadrão: 1 |
Código do produto |
| Campo | Tipo | Descriçã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. |
{
"file": null,
"position": null
}
201
Token ausente ou inválido
Produto inexistente ou de outra conta
Arquivo ausente, grande demais ou extensão não suportada
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())
/stores/{storeId}/products/{productId}/pictures/{pictureId}
Exclui o produto com essa id
| Status | Quando acontece | Corpo |
|---|---|---|
| 401 | 401 | — |
| 404 | 404 | — |
| Nome | Local | Tipo | Descrição |
|---|---|---|---|
storeId
*
|
path | integerpadrão: 1 |
Código da loja |
productId
*
|
path | integerpadrão: 1 |
Código do produto |
pictureId
*
|
path | integerpadrão: 1 |
ID da foto do produto |
204
{
"error": "Unauthorized"
}
{
"error": "Resource 9999 not found"
}
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())
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.