---
title: "Altera um produto"
method: PATCH
path: "/v1/produtos/{codigo}"
tags: ["Produtos e motor fiscal"]
---

# Altera um produto

`PATCH /v1/produtos/{codigo}`

## Request

- Base URL: `https://api.sudrel.com.br/api`
- URL: `https://api.sudrel.com.br/api/v1/produtos/{codigo}`
- Auth: HTTP bearer

Só os campos enviados. Mudar campo fiscal (NCM, CEST, origem, EX da TIPI, produção própria ou perfil) apaga a aprovação do perfil. `ativo` desativa o produto.

## Path parameters

- `codigo` string, required

## Query parameters

- `empresa_id` string

## Request body

- ProdutoEntrada
  - `empresa_id` string
  - `codigo` string: Seu código (SKU), único por empresa.
  - `descricao` string
  - `ncm` string
  - `cest` string, nullable
  - `gtin` string, nullable: GTIN-8, 12, 13 ou 14, ou "SEM GTIN".
  - `origem` string
  - `unidade` string
  - `unidade_tributavel` string, nullable
  - `c_benef` string, nullable: Código de benefício fiscal da UF. A Bahia não exige; guardado como veio.
  - `ex_tipi` string, nullable: Exceção da TIPI. "" = nenhuma (declarado).
  - `producao_propria` boolean
  - `ativo` boolean
  - `perfil_fiscal_nome` string: O nome de um perfil fiscal JÁ aprovado da empresa (criado e aprovado no painel, em Emissão de NF-e › Produtos e perfis). O produto copia o tratamento e a aprovação do perfil. Mande `perfil_fiscal` OU `perfil_fiscal_nome`. Recusas: `perfil_fiscal_nao_encontrado`, `perfil_fiscal_nao_aprovado`.
  - `perfil_fiscal` object
    - `icms` 'tributado' | 'base_reduzida' | 'isento' | 'nao_tributado' | 'imune' | 'st_retida' | 'st_substituto'
    - `pis_cofins` 'tributado' | 'monofasico' | 'aliquota_zero' | 'outros'
    - `termo_acordo` boolean: Produto das atividades do Anexo Único do Decreto 7.799/2000 (Termo de Acordo de atacadista da BA).
    - `ibs_cbs` object, nullable
      - `cst` string
      - `classificacao_tributaria` string

## Response `200`

Alterado.

- Produto
  - `empresa_id` string
  - `codigo` string: Seu código (SKU), único por empresa.
  - `descricao` string
  - `ncm` string
  - `cest` string, nullable
  - `gtin` string, nullable: GTIN-8, 12, 13 ou 14, ou "SEM GTIN".
  - `origem` string
  - `unidade` string
  - `unidade_tributavel` string, nullable
  - `c_benef` string, nullable: Código de benefício fiscal da UF. A Bahia não exige; guardado como veio.
  - `ex_tipi` string, nullable: Exceção da TIPI. "" = nenhuma (declarado).
  - `producao_propria` boolean
  - `ativo` boolean
  - `perfil_fiscal_nome` string: O nome de um perfil fiscal JÁ aprovado da empresa (criado e aprovado no painel, em Emissão de NF-e › Produtos e perfis). O produto copia o tratamento e a aprovação do perfil. Mande `perfil_fiscal` OU `perfil_fiscal_nome`. Recusas: `perfil_fiscal_nao_encontrado`, `perfil_fiscal_nao_aprovado`.
  - `perfil_fiscal` object
    - `icms` 'tributado' | 'base_reduzida' | 'isento' | 'nao_tributado' | 'imune' | 'st_retida' | 'st_substituto'
    - `pis_cofins` 'tributado' | 'monofasico' | 'aliquota_zero' | 'outros'
    - `termo_acordo` boolean: Produto das atividades do Anexo Único do Decreto 7.799/2000 (Termo de Acordo de atacadista da BA).
    - `ibs_cbs` object, nullable
      - `cst` string
      - `classificacao_tributaria` string
    - `aprovado` boolean
    - `aprovado_por` string, nullable
    - `aprovado_em` string, date-time, nullable
  - `id` string
  - `ambiente` 'producao' | 'sandbox': Cadastro a que o produto pertence (o da chave que o criou).
  - `gtin_sefaz` object, nullable: O que o Cadastro Centralizado de GTIN da SEFAZ devolveu (cStat, descrição, NCM e CEST).
  - `gtin_conferido_em` string, date-time, nullable
  - `criado_em` string, date-time
  - `atualizado_em` string, date-time

## Other responses

- `401`: `nao_autenticado`: chave de API ausente, inválida ou revogada.
- `422`: `validacao`.

---

[API](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e.md) · [All operations](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e/llms.txt) · [OpenAPI document](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e/revisions/efd7baba9e37?raw)