Skip to main content

Endpoint

POST https://api.tiny.com.br/api2/produto.alterar.php

Parâmetros

ParâmetroTipoOcorrênciaDescrição
tokenstringobrigatórioChave gerada para identificar sua empresa
produtoobjectobrigatórioDados do produto conforme layout
formatostringobrigatórioFormato do retorno (json)

Estrutura do parâmetro “produto”

CampoTipoTamanhoOcorrênciaDescrição
produtos[]list-obrigatórioElemento para representar conjunto de Produtos
produtos[].produto.sequenciainteiro-obrigatórioNúmero sequencial para identificar cada produto
produtos[].produto.idint-opcionalNúmero de identificação do Produto na Olist
produtos[].produto.codigostring30opcionalCódigo do produto
produtos[].produto.nomestring120obrigatórioNome do produto
produtos[].produto.unidadestring3obrigatórioUnidade do produto
produtos[].produto.precodecimal-obrigatórioPreço de venda do produto
produtos[].produto.preco_promocionaldecimal-opcionalPreço promocional do produto
produtos[].produto.ncmstring10opcionalNCM do produto
produtos[].produto.origemstring1obrigatórioCódigo conforme Tabela Origem
produtos[].produto.gtinstring14opcionalGTIN/EAN do produto
produtos[].produto.gtin_embalagemstring14opcionalGTIN/EAN da embalagem do produto
produtos[].produto.localizacaostring50condicionalLocalização física no estoque
produtos[].produto.peso_liquidodecimal-opcionalPeso líquido do produto (Kg)
produtos[].produto.peso_brutodecimal-opcionalPeso bruto do produto (Kg)
produtos[].produto.estoque_minimodecimal-opcionalQuantidade mínima do produto no estoque
produtos[].produto.estoque_maximodecimal-opcionalQuantidade máxima do produto no estoque
produtos[].produto.id_fornecedorint-opcionalNúmero de identificação do fornecedor na Olist
produtos[].produto.codigo_fornecedorstring15opcionalCódigo do fornecedor na Olist
produtos[].produto.codigo_pelo_fornecedorstring20opcionalCódigo do produto pelo fornecedor
produtos[].produto.unidade_por_caixastring3opcionalItens por embalagem
produtos[].produto.preco_custodecimal-opcionalPreço de custo do produto
produtos[].produto.situacaostring1obrigatórioSituação do produto: “A” (Ativo) ou “I” (Inativo)
produtos[].produto.tipostring1obrigatórioIndica se é produto (“P”) ou serviço (“S”)
produtos[].produto.classe_ipistring5opcionalSomente para bebidas e cigarros, classe conforme Tabela
produtos[].produto.valor_ipi_fixodecimal-opcionalValor IPI fixo para tributação específica
produtos[].produto.cod_lista_servicosstring5opcionalCódigo conforme Tabela Lista de Serviços
produtos[].produto.descricao_complementartext-opcionalDescrição exibida em propostas e pedidos de venda
produtos[].produto.obstext-opcionalObservações gerais sobre o produto
produtos[].produto.garantiatext20opcionalGarantia do produto
produtos[].produto.cesttext9opcionalCódigo CEST do produto
produtos[].produto.dias_preparacaoint9opcionalDias corridos para disponibilizar o produto
produtos[].produto.marcastring-opcionalMarca do produto
produtos[].produto.tipo_embalagemint-opcionalTipo da embalagem do produto
produtos[].produto.altura_embalagemdecimal-opcionalAltura da embalagem em cm
produtos[].produto.largura_embalagemdecimal-opcionalLargura da embalagem em cm
produtos[].produto.comprimento_embalagemdecimal-opcionalComprimento da embalagem em cm
produtos[].produto.diametro_embalagemdecimal-opcionalDiâmetro da embalagem em cm
produtos[].produto.categoriastring-opcionalCategoria do produto
produtos[].produto.anexos[]list-opcionalLista contendo imagens e anexos do produto
produtos[].produto.anexos[].anexostring-opcionalURL de acesso ao anexo/imagem do produto
produtos[].produto.imagens_externas[]list-opcionalLista contendo imagens externas do produto
produtos[].produto.imagens_externas[].imagem_externa.urlstring-obrigatórioURL da imagem externa
produtos[].produto.classe_produtostring1opcionalClassificação: S (Simples), K (Kit), V (Com variações), F (Fabricado), M (Matéria-prima)
produtos[].produto.kit[]list-condicionalLista contendo os itens do kit do produto
produtos[].produto.kit[].item.id_produtoint-obrigatórioNúmero de identificação do produto na Olist
produtos[].produto.kit[].item.quantidadedecimal-obrigatórioQuantidade do produto dentro do kit
produtos[].produto.grade[]array-opcionalGrade da variação
produtos[].produto.variacoes[]list-opcionalLista contendo variações do produto
produtos[].produto.variacoes[].variacao.idint-opcionalNúmero de identificação da variação na Olist
produtos[].produto.variacoes[].variacao.codigostring-opcionalCódigo da variação
produtos[].produto.variacoes[].variacao.precodecimal-opcionalPreço da variação
produtos[].produto.variacoes[].variacao.preco_promocionaldecimal-opcionalPreço promocional da variação
produtos[].produto.variacoes[].variacao.grade[]array-opcionalGrade da variação
produtos[].produto.tags[]array-opcionalTags do produto
produtos[].produto.seo.seo_titlestring120opcionalTítulo exibido nos resultados de busca Google
produtos[].produto.seo.seo_keywordsstring255opcionalKeywords para SEO, valores separados por vírgula
produtos[].produto.seo.link_videostring100opcionalLink do vídeo
produtos[].produto.seo.seo_descriptionstring255opcionalDescrição exibida nos resultados de busca Google
produtos[].produto.seo.slugtext-opcionalIdentificação legível no link do produto
Campos id, codigo e nome são utilizados para localizar o produto que será alterado. Ordem de busca: id → codigo → nome.
Campos com valores decimais utilizam ”.” (ponto) como separador (ex: “5.25”).
Valores possíveis para tipo_embalagem: 1 (Envelope), 2 (Pacote/Caixa), 3 (Rolo/Cilindro).
Campo categoria espera árvore de categorias usando separador ”>>” (ex: “Categoria pai >> Categoria filha”).
Campo classe_produto: S (Simples), K (Kit), V (Com variações), F (Fabricado), M (Matéria-prima). Padrão: ‘S’.
Campo kit obrigatório se classe_produto = ‘K’.
Array grade onde chave é tipo de variação (ex: Tamanho, Cor) e valor é o valor da variação (ex: GG, Branco).
Array tags contém identificadores de tags pré-cadastradas. Somente uma tag por grupo permitida. Se não enviado, tags atuais do produto são mantidas.
Campo preco_promocional considerado somente se empresa tiver extensão “Preço promocional” instalada.

Retorno

CampoTipoTamanhoOcorrênciaDescrição
retornoobject-obrigatórioElemento raiz do retorno
retorno.status_processamentoint-obrigatórioConforme tabela “Status de Processamento”
retorno.statusstring-obrigatórioStatus do retorno: “OK” ou “Erro”
retorno.codigo_erroint-obrigatórioConforme tabela “Códigos de erro”
retorno.erros[]list-condicionalLista dos erros encontrados
retorno.erros[].errostring-condicionalMensagem descrevendo o erro
retorno.registros[]list-condicionalLista de resultados da pesquisa
retorno.registros[].registroobject-condicionalElemento para representar um Produto
retorno.registros[].registro.sequenciaint-condicionalNúmero sequencial de cada produto
retorno.registros[].registro.statusstring-condicionalStatus do registro: “OK” ou “Erro”
retorno.registros[].registro.codigo_erroint-condicionalConforme tabela “Códigos de erro”
retorno.registros[].registro.erros[]list-condicionalLista dos erros encontrados
retorno.registros[].registro.erros[].errostring-condicionalMensagem descrevendo o erro
retorno.registros[].registro.idint-condicionalNúmero de identificação do Produto na Olist
retorno.registros[].registro.variacoeslist-condicionalLista com informações das variações enviadas
retorno.registros[].registro.variacoes[].variacaoobject-condicionalElemento que representa uma variação
retorno.registros[].registro.variacoes[].variacao.idint-condicionalIdentificador da variação

Exemplo de chamada

curl -X POST https://api.tiny.com.br/api2/produto.alterar.php \
  -d "token=SEU_TOKEN_AQUI" \
  -d "produto={...JSON do produto...}" \
  -d "formato=JSON"

Exemplos de retorno

Sucesso

{
  "retorno": {
    "status_processamento": 3,
    "status": "OK",
    "registros": [
      {
        "registro": {
          "sequencia": "1",
          "status": "OK",
          "id": "49644544"
        }
      },
      {
        "registro": {
          "sequencia": "2",
          "status": "OK",
          "id": "49644545",
          "variacoes": [
            {
              "variacao": {
                "id": "31232333"
              }
            },
            {
              "variacao": {
                "id": "43234442"
              }
            }
          ]
        }
      }
    ]
  }
}

Erro - Token inválido

{
  "retorno": {
    "status_processamento": 1,
    "status": "Erro",
    "codigo_erro": 2,
    "erros": [
      {
        "erro": "token invalido"
      }
    ]
  }
}

Erro - Produto não localizado

{
  "retorno": {
    "status_processamento": 2,
    "status": "Erro",
    "registros": [
      {
        "registro": {
          "sequencia": "1",
          "status": "Erro",
          "codigo_erro": "32",
          "erros": [
            {
              "erro": "Produto não localizado pelo id"
            }
          ]
        }
      }
    ]
  }
}