Início > Ação de vendas > Chamariz+Mix
Versão: 2.0
Chamariz+Mix
Última Atualização: 06/02/2024
Chamariz+Mix é um tipo de campanha de produtos presente na plataforma da Yandeh.
Os endpoints a seguir tem o objetivo de proporcionar o gerenciamento de campanhas chamariz+mix na plataforma.
Parâmetros da requisição
id: Integer
Id da campanha.
Ex: 159
status: String
Observação: O status será desconsiderado caso seja enviado em conjunto com o Id.
Opções: ativo, ativo_mkt, ativo_app, inativo, finalizado e rascunho.
Ex: ativo
Sintaxe da resposta
Caso ocorra tudo certo com a requisição e retorne o status code 200, essa será a resposta que você receberá:
acoes_venda
Corpo da ação de venda retornada.
Tipo: JSON.
data
Dados retornados pela API.
Tipo: Lista de JSON.
id
Id da campanha.
Tipo: Integer.
nome
Nome da campanha.
Tipo: String.
seller
Seller da campanha.
Tipo: String.
status
Status da campanha.
Opções: "ativo", "ativo_mkt", "ativo_app", "inativo", "finalizado" e "rascunho",
Tipo: String.
criador
Nome do usuário criador.
Tipo: String.
data_fim
Data de finalização da campanha.
Tipo: Datetime.
descricao
Descrição da campanha.
Tipo: String.
tipo_acao
Tipo de campanha. Para está integração, o valor será "chamariz+mix".
Tipo: String.
ids_filhos
Ids de campanhas filhas.
Tipo: Lista de Integer.
plataforma
Plataforma onde a campanha será exibida.
Opções: "marketplace", "smartforce" e "marketplace+smartforce".
Tipo: String.
data_inicio
Data de inicio da campanha.
Tipo: Datetime.
cross_sellers
Ids de outros sellers incluídos na campanha.
Tipo: Lista de Integer.
is_cross_seller
Verificador booleano para campanhas cross seller.
Tipo: Boolean.
nome_integracao
Nome da integração.
Tipo: String.
total
Total de campanhas.
Tipo: Integer.
GET Chamariz+Mix
Última Atualização: 04/02/2025
Este endpoint irá listar campanhas chamariz+mix cadastradas pelo fornecedor.
Endpoint GET
https://yandeh-seller-integration.yandeh.com.br/v2/acao_venda/chamariz+mix
Neste endpoint, existem duas formas de configurar o público-alvo, pelo campo "publico_alvo" com os cnpjs dos clientes ou pelo campo "grupo_cliente" com os ids de grupos de clientes.
As duas formas representadas por um json com as informações da respectiva configuração.
A regra para isso, é de que não possam ser enviadas informações de público-alvo e grupo de clientes simuntaneamente.
Público-alvo
Elementos da Requisição
nome
Nome para a campanha.
Tipo: String.
tipo_acao
Nome do tipo de ação. Informar "chamariz+mix" para esta integração.
Tipo: String.
plataforma
Plataforma de exibição da campanha.
Tipo: String.
nome_interno
Nome para a campanha internamente.
Tipo: String.
valor_maximo
Valor máximo que a campanha pode atingir.
Tipo: Float.
volume_maximo
Volume máximo de itens para a campanha.
Tipo: Float.
data_inicio
Data de inicio da campanha.
Tipo: Datetime.
data_fim
Data do fim da campanha.
Tipo: Datetime.
descricao
Descrição da campanha.
Tipo: String.
descricao_integracao
Descrição para a integração da campanha.
Tipo: String.
banner_campanha
URL para a imagem do banner da tela de campanha.
Tipo: String.
banner_home
URL para a imagem de banner para a home.
Tipo: String.
banner_mobile
URL para o banner mobile.
Tipo: String.
limite_uso_cliente
Habilita ou desabilita o limite de uso do cliente.
Tipo: Boolean.
auto_upload_banner
Habilitador de auto upload do banner.
Tipo: Banner.
tipo_beneficio
Tipo de beneficio da campanha.
Opções: desconto_fixo, desconto_percentual, valor_fixo.
Tipo: String.
exibir_banner
Habilitador para a exibição do banner.
Tipo: Boolean.
produtos
Produtos da campanha.
Tipo: Lista de JSON.
publico_alvo
Nome do público-alvo do produto.
Tipo: String.
ean_ou_dun
Código ean ou dun do produto.
Tipo: String.
beneficio
Beneficio da campanha.
Tipo: Integer.
quantidade_embalagem
Quantidade de itens na embalagem.
Tipo: Integer.
origem_verba
Origem verba.
Tipo: String.
ordem
Posição na ordem dos produtos.
Tipo: Integer.
status
Status de produto "ativo" ou "inativo".
Tipo: String.
limite
Limite de produtos para a campanha.
Tipo: Integer.
isencao_encargos
Indicador booleano de isenção de encargos.
Tipo: Boolean.
publico_alvo
Configuração de clientes para o público-alvo.
Tipo: Lista de JSON.
nome
Nome do público-alvo
Tipo: String.
banner
Configuração do banner.
Tipo: JSON.
descricao
Descrição do banner.
Tipo: String.
descricao_integracao
Descrição da integração.
Tipo: String.
exibir_banner
Booleano para a exibição do banner.
Tipo: Boolean.
banner_home
URL para o banner da home.
Tipo: String.
banner_campanha
URL para o banner da campanha.
Tipo: String.
banner_mobile
URL para o banner mobile.
Tipo: String.
auto_upload_banner
Booleano para o auto-upload do banner.
Tipo: Boolean.
publico_alvo
Lista de clientes para o publico alvo.
Tipo: Lista de JSON.
cnpj
Cnpj do cliente.
Tipo: String.
status
Status do cliente.
Opções: "ativo" ou "inativo".
Tipo: String.
todos_clientes
Booleano para considerar ou não todos os clientes.
Tipo: Boolean.
mix_produtos
Lista de mix de produtos.
Tipo: Lista de JSON.
publico_alvo
Nome do público-alvo.
Tipo: String.
ean_ou_dun
Código ean ou dun do produto.
Tipo: String.
ordem
Posição na ordem dos produtos.
Tipo: Integer.
status
Status de produto "ativo" ou "inativo".
Tipo: String.
meta_mix
Lista de meta mix.
Tipo: Boolean.
publico_alvo
Nome do publico alvo.
Tipo: String.
quantidades_skus_distintos
Quantidade de SKU's.
Tipo: Integer.
soma_valor_mix
Valor da soma do mix.
Tipo: Integer.
Grupo de clientes
Para realizar o envio da campanha para grupos de clientes, é necessário informa-los como o exemplo a seguir:
Com a remoção do campo "publico_alvo" deve ser adicionado o seguinte campo:
grupo_cliente
Lista de grupos de clientes.
Tipo: Lista de Integer.
Sintaxe da Resposta
Caso ocorra tudo certo com a requisição e retorne o status code 200, essa será a resposta que você receberá:
Elementos da Resposta
status
Verificador booleano de sucesso ou falha na requisição.
Tipo: Boolean.
Respostas para erros
Caso ocorra algum erro durante a requisição, os possíveis erros são:
422 Validation Error
acao_id
Id da ação de vendas criada.
Tipo: Integer.
errors
Erros ocorridos na requisição.
Tipo: Lista.
Erro para públicos-alvo com o mesmo valor no campo ordem.
POST Chamariz + Mix
Última Atualização: 04/02/2025
Este método cadastra campanhas chamariz+mix na plataforma da abastece shop.
Endpoint POST
Sintaxe da Requisição
Para que a requisição do método Post seja bem-sucedida, é necessário que
seja passado os seguintes valores dentro de um JSON:
PUT Chamariz+mix
Última Atualização: 03/06/2025
Este método modifica campanhas chamariz+mix do fornecedor.
Endpoint PUT
https://yandeh-seller-integration.yandeh.com.br/v2/acao_venda/chamariz+mix/{id_campanha}
Parâmetros da requisição
id *: Integer
Obs: Id da campanha.
Ex: 1.
Sintaxe da Requisição
Para que a requisição do método Put seja bem-sucedida, é necessário que
seja passado os seguintes valores dentro de um JSON:
Elementos da Requisição
data_inicio*
Data de início da campanha.
Tipo: Datetime.
data_fim*
Data de finalização da campanha.
Tipo: Datetime.
status
Status "inativo" para inativar campanhas.
Caso não seja enviado, apenas a vigência da campanhas será alterada.
Tipo: String.
produtos
Lista de produtos para alterar o limite total do produto.
Tipo: Array de JSON
ean_ou_dun
O EAN ou DUN do produto que deseja alterar.
Tipo: String
limite_produto_total
O limite total do produto que vai vender na campanha.
Tipo: Integer
publico_alvo
Público alvo cadastrado na campanha
Tipo: Array de JSON
nome
Nome do público alvo cadastrado na campanha
Tipo: String
publico_alvo
Público alvo que vai ser alterado
Tipo: Array de JSON
cnpj
CNPJ do cliente que vai ser alterado
Tipo: String
status
Status que deseja alterar do cliente
Tipo: String
Exemplo: "ativo" ou "inativo"
grupo_cliente
Grupo de cliente que vai ser alterado
Tipo: Array de JSON
publico_alvo
Público alvo que vai ser alterado
Tipo: String
id
ID do grupo de cliente que vai ser alterado
Tipo: Integer
acao
Ação que deseja alterar o grupo de cliente
Tipo: String
Exemplo: "incluir" ou "excluir"
Sintaxe da Resposta
Caso ocorra tudo certo com a requisição e retorne o status code 200, essa será a resposta que você receberá:
Respostas para erros
Caso ocorra algum erro durante a requisição, os possíveis erros são:
400 Bad Request
Id ação e venda inválido.
422 Unprocessable Entity
Mensagem descrevendo o erro