Bloqueio da atualização de atributos (Cadeado)

Este artigo explica como funciona o bloqueio de atualização de atributos pelo ícone de cadeado no ANYMARKET, recurso usado para controlar se características do produto podem ou não ser atualizadas via API.

Neste artigo:

• Pré-requisitos
• Como configurar / Como usar
• Passo a passo
• Boas práticas
• Dúvidas comuns

Pré-requisitos

• Ter acesso ao cadastro de produtos no ANYMARKET.
• Possuir atributos cadastrados no produto.
• Entender se as atualizações do produto são feitas via API, tela ou planilha.

Como configurar / Como usar

O ANYMARKET disponibiliza uma opção para bloquear ou desbloquear características dos produtos, permitindo maior controle sobre atualizações realizadas via API.

Esse recurso é útil quando determinado atributo não deve ser sobrescrito por integrações externas. Por exemplo, na Amazon é obrigatório informar a característica RBN. Nesse caso, é possível bloquear essa característica para que ela não seja alterada em futuras atualizações via API.

O status do atributo é identificado pelo ícone de cadeado:

• Cadeado fechado com fundo azul: atributo bloqueado para atualizações via API.
• Cadeado aberto com fundo transparente: atributo desbloqueado para atualizações via API.

As regras de bloqueio funcionam da seguinte forma:

• Quando o atributo é inserido por API, por padrão o cadeado vem desbloqueado.
• Quando o atributo é inserido por tela ou planilha, por padrão o cadeado vem bloqueado.
• Pela API, o atributo só poderá ser atualizado ou excluído se estiver desbloqueado.
• Pela tela ou planilha, o atributo poderá ser atualizado independentemente de estar bloqueado ou desbloqueado.

Passo a passo

Para controlar a atualização de atributos pelo cadeado:

1. Acesse o cadastro do produto.
2. Localize o atributo desejado.
3. Verifique o status do ícone de cadeado.
4. Deixe o cadeado fechado caso não queira que o atributo seja alterado via API.
5. Deixe o cadeado aberto caso permita alteração ou exclusão do atributo via API.

Exemplo:

Imagine um produto com os atributos 1, 2 e 3. Os atributos 1 e 2 estão com o cadeado fechado, e o atributo 3 está com o cadeado aberto.

Ao realizar uma atualização via API, os atributos 1 e 2 não serão alterados. Já o atributo 3 poderá ser alterado ou excluído, caso não seja enviado novamente pela API.

Se as alterações forem feitas pela tela ou por planilha, elas serão refletidas em todos os atributos, independentemente de o cadeado estar aberto ou fechado.

Ao realizar um PUT de produtos, por exemplo, será necessário verificar se o atributo está bloqueado na tela. Se estiver bloqueado, ele não deverá ser alterado nem excluído. Se estiver desbloqueado, poderá ser alterado ou excluído.

Para excluir um atributo via API, basta não enviá-lo na atualização do produto, desde que ele esteja desbloqueado.

Boas práticas

• Bloqueie atributos obrigatórios ou sensíveis que não devem ser sobrescritos via API.
• Revise o status do cadeado antes de realizar atualizações em massa via API.
• Use tela ou planilha quando precisar alterar atributos independentemente do bloqueio.
• Para atributos exigidos por marketplaces, como RBN na Amazon, mantenha o cadeado fechado quando a informação precisar ser preservada.

Dúvidas comuns

O que significa o cadeado fechado?
Significa que o atributo está bloqueado para alterações ou exclusões via API.

O que significa o cadeado aberto?
Significa que o atributo pode ser alterado ou excluído via API.

A tela e a planilha respeitam o bloqueio do cadeado?
Não. Pela tela ou planilha, o atributo pode ser atualizado independentemente de estar bloqueado ou desbloqueado.

Como um atributo pode ser excluído via API?
Para excluir um atributo via API, basta não enviá-lo na atualização do produto, desde que ele esteja desbloqueado.

Qual é o comportamento padrão do cadeado?
Atributos inseridos por API vêm desbloqueados por padrão. Atributos inseridos por tela ou planilha vêm bloqueados por padrão.