{"id":2832,"date":"2021-07-15T19:02:22","date_gmt":"2021-07-15T22:02:22","guid":{"rendered":"https:\/\/help.roicommerce.com.br\/?p=2832"},"modified":"2021-10-05T21:52:44","modified_gmt":"2021-10-06T00:52:44","slug":"produto-api-roi-commerce","status":"publish","type":"post","link":"https:\/\/help.roicommerce.com.br\/index.php\/2021\/07\/15\/produto-api-roi-commerce\/","title":{"rendered":"PRODUTO – API ROI COMMERCE"},"content":{"rendered":"\n

Ednpoint:<\/strong> \/api\/produto <\/p>\n\n\n\n

Padr\u00f5es<\/h4>\n\n\n\n

Para incluir um produto simples ou varia\u00e7\u00e3o, deve-se seguir um padr\u00e3o, o qual \u00e9 aplicado para os produtos cadastrados manualmente no sistema. <\/p>\n\n\n\n

Produto Simples<\/h4>\n\n\n\n

Enviar a tag ‘formato’ = ‘S’ e n\u00e3o enviar ou deixar em branco as tags ‘codigo_variacao’ e ‘fk_variacao_id’. Assim o sistema entender\u00e1 que trata-se de um produto SIMPLES<\/p>\n\n\n\n

Produto Varia\u00e7\u00e3o<\/h4>\n\n\n\n

Primeiramente, ser\u00e1 necess\u00e1rio cadastrar o produto PAI. Para isso, envie a tag ‘formato’ = ‘V’, informe a tag ‘codigo’ e n\u00e3o envie ou deixe em branco as tags ‘codigo_variacao’ e ‘fk_variacao_id’. Assim o sistema entender\u00e1 que trata-se de um produto PAI VARIA\u00c7\u00c3O<\/p>\n\n\n\n

Para cadastrar os produtos filhos, envie a tag ‘formato’ = ‘V’, informe a tag ‘codigo’ e preencha as tags ‘codigo_variacao’ e ‘fk_variacao_id’. Assim o sistema entender\u00e1 que trata-se de um produto FILHO VARIA\u00c7\u00c3O<\/p>\n\n\n\n

Tabela de campos <\/p>\n\n\n\n

Tabela de campos do PRODUTO<\/h4>\n\n\n\n
\n
CAMPO<\/strong><\/th>INFORMA\u00c7\u00c3O<\/strong><\/th>TIPO<\/strong><\/th>OPCIONA<\/strong>L<\/th><\/tr><\/thead>
codigo<\/td>C\u00f3digo do produto
<\/td>		STRING(20)<\/td>Obrigat\u00f3rio<\/td><\/tr>
codigo_variacao<\/td>C\u00f3digo do produto
variacao<\/td>		STRING(20)<\/td>Opcional -> SIMPLES
Obrigat\u00f3rio->FILHO
VARIA\u00c7\u00c3O<\/td><\/tr>
formato<\/td>Formato do produto<\/td>STRING(1)<\/td>Obrigat\u00f3rio<\/td><\/tr>
fk_variacao_id<\/td>ID da Varia\u00e7\u00e3o que
ser\u00e1 associada ao
produto filho<\/td>		INTEGER(11)<\/td>Opcional -> SIMPLES
Obrigat\u00f3rio->FILHO
VARIA\u00c7\u00c3O<\/td><\/tr>
tipo<\/td>Tipo de produto<\/td>STRING(5)<\/td>Opcional<\/td><\/tr>
descricao<\/td>Nome do produto<\/td>STRING(200)<\/td>Obrigat\u00f3rio<\/td><\/tr>
altura<\/td>Altura do produto
em cent\u00edmetros<\/td>		DECIMAL(10,2)<\/td>Opcional<\/td><\/tr>
largura<\/td>Largura do produto
em cent\u00edmetros<\/td>		DECIMAL(10,2)<\/td>Opcional<\/td><\/tr>
comprimento<\/td>Comprimento do
produto em
cent\u00edmetros<\/td>		DECIMAL(10,2)<\/td>Opcional<\/td><\/tr>
peso_liquido<\/td>Peso l\u00edquido do
produto em kilos<\/td>		DECIMAL(10,2)<\/td>Opcional<\/td><\/tr>
sku_fornecedor<\/td>Referencia do
produto no fornecedor<\/td>		STRING(15)<\/td>Opcional<\/td><\/tr>
codigo_barras<\/td>GTIN \/ EAN do produto<\/td>STRING(20)<\/td>Opcional<\/td><\/tr>
peso_bruto<\/td>Peso bruto do
produto em kilos<\/td>		DECIMAL(10,2)<\/td>Opcional<\/td><\/tr>
preco_custo<\/td>Pre\u00e7o de custo
do produto<\/td>		DECIMAL(10,2)<\/td>Opcional<\/td><\/tr>
ncm<\/td>NCM do produto<\/td>STRING(10)<\/td>Opcional<\/td><\/tr>
prazo_cross_docking<\/td>Prazo de manuseio
do produto<\/td>		INTEGER(3)<\/td>Opcional<\/td><\/tr>
preco_venda<\/td>Pre\u00e7o de Venda
do produto<\/td>		DECIMAL(10,2)<\/td>Opcional<\/td><\/tr>
preco_venda_
promocional<\/td>		Pre\u00e7o de Venda
Promocional
do produto<\/td>		DECIMAL(10,2)<\/td>Opcional<\/td><\/tr>
preco_adc_integra<\/td>Valor a ser observado
na integra\u00e7\u00e3o Magalu<\/td>		STRING(20)<\/td>Opcional<\/td><\/tr>
preco_adc_skyhub<\/td>Valor a ser observado
na integra\u00e7\u00e3o B2W<\/td>		STRING(20)<\/td>Opcional<\/td><\/tr>
preco_adc_via_varejo<\/td>Valor a ser observado
na integra\u00e7\u00e3o
Via Varejo<\/td>		STRING(20)<\/td>Opcional<\/td><\/tr>
preco_adc_amazon<\/td>Valor a ser observado
na integra\u00e7\u00e3o Amazon<\/td>		STRING(20)<\/td>Opcional<\/td><\/tr>
preco_adc_madeira_
madeira<\/td>		Valor a ser observado
na integra\u00e7\u00e3o Madeira<\/td>		STRING(20)<\/td>Opcional<\/td><\/tr>
preco_adc_carrefour<\/td>Valor a ser observado
na integra\u00e7\u00e3o Carrefour<\/td>		STRING(20)<\/td>Opcional<\/td><\/tr>
preco_adc_dafiti<\/td>Valor a ser observado
na integra\u00e7\u00e3o Dafiti<\/td>		STRING(20)<\/td>Opcional<\/td><\/tr>
preco_adc_leroy<\/td>Valor a ser observado
na integra\u00e7\u00e3o Leroy<\/td>		STRING(20)<\/td>Opcional<\/td><\/tr>
preco_adc_opencart<\/td>Valor a ser observado
na integra\u00e7\u00e3o
Opencart ROI
COMMERCE<\/td>		STRING(20)<\/td>Opcional<\/td><\/tr>
prazo_garantia<\/td>Prazo de garantia
do produto em
meses<\/td>		INTEGER(5)<\/td>Opcional<\/td><\/tr>
msg_garantia<\/td>Mensagem de garantia<\/td> STRING(100)<\/td>Opcional<\/td><\/tr>
produto_bloqueado<\/td>Status do produto<\/td>INTEGER(1)<\/td>Opcional<\/td><\/tr>
fk_marca_id<\/td>ID da marca do
produto<\/td>		INTEGER(11)<\/td>Obrigat\u00f3rio<\/td><\/tr>
seo_url<\/td>URL encurtada
do produto<\/td>		STRING(300)<\/td>Opcional<\/td><\/tr>
descricao_comple
mentar_texto<\/td>		Descri\u00e7\u00e3o detalhada
do produto<\/td>		STRING(4000)<\/td>Opcional<\/td><\/tr>
meta_titulo<\/td>Meta t\u00edtulo do
produto<\/td>		STRING(200)<\/td>Opcional<\/td><\/tr>
meta_descricao<\/td>Meta descri\u00e7\u00e3o
do produto<\/td>		STRING(320)<\/td>Opcional<\/td><\/tr>
tags<\/td>Tags do produto<\/td>STRING(300)<\/td>Opcional<\/td><\/tr>
kit<\/td>Se \u00e9 Kit ou N\u00e3o.
0 – N\u00c3O ou 1 – SIM<\/td>		INTEGER(1)<\/td>Opcional<\/td><\/tr>
minimo_venda<\/td>Quantidade m\u00ednima
para fechar pedido
(OPENCART)<\/td>		INTEGER(11)<\/td>Opcional<\/td><\/tr>
atributos<\/td>Atributos do produto<\/td>STRING<\/td>Opcional<\/td><\/tr>
categorias<\/td>Categorias do produto<\/td>STRING<\/td>Opcional<\/td><\/tr>
imagens<\/td>Imagens do produto<\/td>STRING<\/td>Opcional<\/td><\/tr><\/tbody><\/table><\/figure>\n<\/div><\/div>\n\n\n\n

Observa\u00e7\u00f5es sobre os campos:<\/strong><\/p>\n\n\n\n

imagens: <\/strong>Informar o nome do arquivo das imagens que ser\u00e3o utilizadas no sistema separadas por v\u00edrgula (,).
Ex.: imagem1.jpg, imagem2.jpg, imagem3.jpg
N\u00e3o utilizar caracteres especiais no mome das fotos. Enviar sempre arquivos .jpg<\/p>\n\n\n\n

categorias: <\/strong>Informar o id de todas as categorias que se\u00e3o vinculadas ao produto separadas por v\u00edrgula (,).
Ex.: 25654,2644,264,262
Para acessar o id das categorias, basta acessar Menu->Gest\u00e3o de Produtos->Categorias<\/p>\n\n\n\n

atributos<\/strong>: Informar o id do atributo e o valor que representar\u00e1 esse atributo. Para separar o id do valor, utilizar dois pontos (:) e para separar um grupo de atributos (id:valor) do outro, utilizar v\u00edrgula (,).
Ex: 245:VERDE,5446:INOX, 545:EL\u00c9TRICO<\/p>\n\n\n\n

tags<\/strong>: Informar as tags que ser\u00e3o associadas ao produto separadas por v\u00edrgula:
Ex.: azul,inox,eletrico<\/p>\n\n\n\n

fk_marca_id<\/strong>: ID da marca que ser\u00e1 associada ao produto. Inserir apenas 1 ID.<\/p>\n\n\n\n

fk_variacao_id<\/strong>: ID da varia\u00e7\u00e3o que ser\u00e1 associada ao produto filho. Inserir apenas 1 ID.<\/p>\n\n\n\n

descricao_complementar_texto<\/strong>: Para enviar a descri\u00e7\u00e3o detalhada do produto, enviar uma string sem quebra de linhas. Caso necessite formatar o texto com quebras de linhas, utilizar somente a tag <br \/>. Todas as outras tags enviadas ser\u00e3o removidas.<\/p>\n\n\n\n

preco_adc_…: Essas tags s\u00e3o utilizadas para ativar o recurso de precifica\u00e7\u00e3o din\u00e2mica do ROI COMMERCE. O valor informado nessas tags ser\u00e3o levado em considera\u00e7\u00e3o ao enviar pre\u00e7o para cada integra\u00e7\u00e3o. Para conhecer mais sobre o recurso, acessar o link abaixo:<\/p>\n\n\n\n

https:\/\/help.roicommerce.com.br\/index.php\/2021\/07\/05\/precificacao-dinamica-roi-commerce\/<\/a><\/p>\n\n\n\n

Enviar uma string com o valor. Pode ser adicionado ao valor o sinal de negativo (-) que ir\u00e1 deduzir do valor padr\u00e3o do produto e\/ou o sinal de percentual (%) que ir\u00e1 aplicar um percentual ao valor do produto.<\/p>\n\n\n\n

Ex.: “-20.65%” -> Ser\u00e1 deduzido 20,65% do valor do produto ao passar para integra\u00e7\u00e3o.
“20.65” -> Ser\u00e1 adicionado 20,65 reais ao valor do produto ao passar para integra\u00e7\u00e3o.<\/p>\n\n\n\n

<\/p>\n\n\n\n

Documenta\u00e7\u00e3o completa dos recursos da API ROI COMMERCE<\/p>\n\n\n\n

https:\/\/app.swaggerhub.com\/apis-docs\/wjr-digital\/roi-commerce\/1.0.0<\/a><\/p>\n\n\n\n


<\/p>\n","protected":false},"excerpt":{"rendered":"

Nesse artigo, voc\u00ea ter\u00e1 informa\u00e7\u00f5es sobre os recursos da API para tratamento de produto.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"_links":{"self":[{"href":"https:\/\/help.roicommerce.com.br\/index.php\/wp-json\/wp\/v2\/posts\/2832"}],"collection":[{"href":"https:\/\/help.roicommerce.com.br\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/help.roicommerce.com.br\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/help.roicommerce.com.br\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/help.roicommerce.com.br\/index.php\/wp-json\/wp\/v2\/comments?post=2832"}],"version-history":[{"count":30,"href":"https:\/\/help.roicommerce.com.br\/index.php\/wp-json\/wp\/v2\/posts\/2832\/revisions"}],"predecessor-version":[{"id":3012,"href":"https:\/\/help.roicommerce.com.br\/index.php\/wp-json\/wp\/v2\/posts\/2832\/revisions\/3012"}],"wp:attachment":[{"href":"https:\/\/help.roicommerce.com.br\/index.php\/wp-json\/wp\/v2\/media?parent=2832"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/help.roicommerce.com.br\/index.php\/wp-json\/wp\/v2\/categories?post=2832"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/help.roicommerce.com.br\/index.php\/wp-json\/wp\/v2\/tags?post=2832"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}