A integração Anymarket conta com os seguintes fluxos:
Envio de produtos para Anymarket;
O envio dos produtos é engatilhado a partir de sua alteração na api-v2 ou em lote, via Admin
Recebimento de pedidos;
A Anymarket envia webhooks de pedidos para a Vnda, e a partir disto nós buscamos os dados do pedido no hub e cadastramos na api-v2.
Pedidos de produtos que não existem na Vnda não serão integrados.
Observações:
Clientes que já possuem integração Anymarket ativa antes de vir para Vnda terão seu catálogo substituído, pois não temos a relação de ids que estão cadastrados na plataforma, e nem sempre o outro campo utilizado (partnerId) para esta relação estará igual aos skus da Vnda.
Caso o SKU na Anymarket esteja igual aos SKUs da Vnda, o de/para de IDs será automático.
Envio de produtos para Anymarket
Acessar https://hub.vnda.com.br/ e cadastrar uma nova loja com a integração "AnyMarket"
Preencher as seguintes configurações:
Host: URL da loja. Exemplo: www.vnda.com.br
Endereço da API: Produção: http://api.anymarket.com.br | Testes: http://sandbox-api.anymarket.com.br
Token da API: preencher com o token fornecido pela AnyMarket (pode ser diferente entre produção e sandbox)
Enviar produtos: define se os produtos da API Vnda serão enviados (Sim/Não)
Enviar produtos inativos: define se produtos inativos também devem ser enviados para AnyMarket (Sim/Não)
Enviar estoques: define se irá enviar saldo de estoque para Anymarket (Sim/Não)
Integrar estoques: define o envio da notificação de estoque para a Anymarket (Sim/Não)
Preencher marca com: campo de texto utilizado para preencher a marca do produto, exemplo "Brilia".
Deixar em branco se as marcas forem preenchidas através de tags.
Preencher modelo com: campo de texto utilizado para preencher o modelo do produto. Exemplo "Brilia".
Deixar em branco se os modelos forem preenchidos através de tags.
Tempo de garantia dos produtos: campo numérico que define, em dias, o tempo de garantia do produto. Exemplo: “3” (meses)
Texto sobre a garantia: campo de texto que define como será apresentada a garantia do produto. Exemplo: "Garantia contra defeitos de fabricação."
Fator de preço do produto: campo numérico utilizado como fator de multiplicação de preço do produto. Exemplo: o produto na Vnda custa R$10,00, mas o lojista quer vender o produto com um valor maior nos marketplaces. Ao adicionar o valor "5" na configuração, o produto será disponibilizado na Anymarket por R$50,00.
Criação automática de produtos no marketplace: define se o produto irá chegar na AnyMarket e já será encaminhado para os marketplaces cadastrados na conta do cliente (Sim/Não).
Tipo da tag categoria: define o nome da tag cadastrado na api-v2, e que iremos utilizar para fazer os mapeamentos para AnyMarket.
ID da categoria padrão: campo numérico que define o id da categoria que será enviado para AnyMarket, caso a tag anymarket-categoria não esteja inserida no produto (campo obrigatório)
Para atualizar estoques, preço e enviar notas para a Anymarket é necessário cadastrar as webhooks abaixo:
stocks-changed: https://hub.vnda.com.br/api/stocks/vnda/notification?shop_host=urldaloja
prices-changed: https://hub.vnda.com.br/api/prices/vnda/notification?shop_host=urldaloja
invoice-created: https://hub.vnda.com.br/api/invoices/vnda/notification?shop_host=urldaloja
Para enviar estoque para Anymarket precisa deixar como Sim os campos Enviar estoques e Integrar estoques.
4. Cadastrar os mapeamentos de produto no HUB:
Categoria:
GRUPO: preencher com "Categoria"
DE: preencher com o nome da tag vinculada no produto.
PARA: preencher com o id da categoria AnyMarket
Atributos (deve estar cadastrado no atributo 1 da Vnda)
GRUPO: Nome de propriedade
DE: preencher com o nome do atributo cadastrado na Vnda. Ex: Cor, Tamanho...
PARA: preencher com o nome do atributo cadastrado na Anymarket
Valores de Atributos:
GRUPO: Propriedade de variante
DE: preencher com o valor do atributo do produto cadastrado na Vnda
PARA: preencher com o valor do atributo para ser preenchido na Anymarket
---------------------------------------------------------------------------
Cadastro de tags Marca, Modelo Características e Categorias
Características (exemplo de tag)
Não necessita de mapeamento.
Nome: Preencher com o Nome do grupo de características + Identificação da característica. Exemplo:
cor-centauro-roxo;Espaços, letras maiúsculas e caracteres especiais serão removidos/substituídos automaticamente.
Título: Copiar e colar o Nome do grupo de características. Exemplo:
Cor Centauro.Subtítulo: Copiar e colar o Nome da característica. Exemplo:
Roxo.Tipo:
anymarket-caracteristicas.
Marca (exemplo de tag)
Não necessita de mapeamento.
Nome: Copiar e colar o Nome da marca. Exemplo:
safe-runners;Espaços, letras maiúsculas e caracteres especiais serão removidos/substituídos automaticamente.
Título: Copiar e colar o Nome da marca. Exemplo:
Safe Runners;Tipo:
anymarket-marca.
Modelo (exemplo de tag)
Não necessita de mapeamento.
Nome: Copiar e colar o Nome do modelo. Exemplo:
zero-no-cabelos;Espaços, letras maiúsculas e caracteres especiais serão removidos/substituídos automaticamente.
Título: Copiar e colar o Nome do modelo. Exemplo:
Zero No Cabelos.Subtítulo: Copiar e colar Nome do modelo. Exemplo:
Zero No Cabelos.Tipo:
anymarket-modelo.
Categoria (exemplo de tag)
Necessário mapear no HUB, utilizando o nome da categoria.
Nome: Copiar e colar o Nome da categoria. Exemplo:
acessorios-para-corrida;Espaços, letras maiúsculas e caracteres especiais serão removidos/substituídos automaticamente.
Título: Copiar e colar o Nome da categoria. Exemplo:
Acessórios para corrida.Tipo:
anymarket-categoria.
---------------------------------------------------------------------------
A busca de categorias foi implementada pelo id da integração, o qual não está disponível no painel da AnyMarket. Este problema será corrigido na tarefa
VST-2089: [AnyMarket] Alterar mapping de categoria para o nome ao invés de idCANCELADO , e até lá a busca dos ids deve ser feita pelo postman da seguinte forma:
Produção:
-h 'gumgaToken: {anymarket_token}'
Staging:
-h 'gumgaToken: {anymarket_token}'
---------------------------------------------------------------------------
As variações (atributos/propriedades) da AnyMarket podem ser consultadas via painel ou API:
Painel AnyMarket:
-h 'gumgaToken: {anymarket_token}'
Recebimento de pedidos
1 - Cadastrar o token fornecido pela AnyMarket (pode ser diferente entre produção e sandbox) em Admin > Configurações > Anymarket > Token
2 - Acessar o painel da Anymarket e cadastrar o endpoint abaixo em Configurações > Parâmetro > Sistema - Callback URLs:
https://host-da-loja/api/v2/orders/anymarket (alterar host-da-loja pela url do seller)
3 - Selecionar "pedidos" e salvar
4 - A partir disso os pedidos recebidos na Anymarket serão integrados no Admin