Início > Ação de vendas > Combo
Versão: 2.0
Combo
Última Atualização: 05/02/2025
Esta integração permite que sejam gerenciadas campanhas do tipo combo.
Este endpoint retorna as campanhas combo cadastradas pelo fornecedor.
Parâmetros da requisição
id: Integer
Id da campanha. Ex: 159
Observação: Realizando o filtro com o id da campanha todos os itens da campanha são retornados
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á:
Elementos da requisição
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á "combo".
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 Combo
Última Atualização: 04/02/2025
Endpoint GET
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. Este nome será exibido para o usuário no Abastece Shop e Smartforce
Tipo: String.
*tipo_acao
Nome do tipo de ação. Informar "combo" para esta integração.
Tipo: String.
*plataforma
Plataforma de exibição da campanha, podendo ser: marketplace, smartforce ou marketplace+smartforce
Tipo: String.
*nome_interno
Nome para a campanha internamente.
Tipo: String.
valor_maximo
Valor máximo em reais que a campanha pode atingir. Quando a campanha atingir o valor máximo determinado ela será encerrada
Tipo: Float.
volume_maximo
Volume máximo de itens para a campanha. Quando a campanha atingir o volume máximo determinado ela será encerrada
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 que irá aparecer para o cliente na tela de campanha
Tipo: String.
banner_home
URL para a imagem do banner que irá aparecer na home do cliente no Abastece Shop
Tipo: String.
banner_mobile
URL para a imagem do banner que irá aparecer para o cliente na tela de campanha, porém nos aplicativos
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.
auto_upload_banner
Booleano para o auto-upload do banner.
Tipo: Boolean.
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.
combo_volume_maximo
Configuração de quantidade máxima para o público-alvo.
Tipo: Lista de JSON.
publico_alvo
Nome do público-alvo.
Tipo: String.
quantidade_maxima_combo
Limite máximo de combos permitidos por pedido.
Tipo: Integer.
limite_produto_total
Limite total de combos permitidos durante toda a vigência da campanha.
Observação: Este limite só é aplicado quando o campo 'plataforma' estiver configurado como "smartforce".
Tipo: Integer.
acao_id
Id da ação de vendas criada.
Tipo: Integer.
errors
Erros ocorridos na requisição.
Tipo: Lista.
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
Caso seja enviado mais de um combo com a mesma ordem:
POST Combo
Última Atualização: 04/02/2025
Este método cadastra campanhas combo na plataforma da abastece shop.
Endpoint POST
https://yandeh-seller-integration.yandeh.com.br/v2/acao_venda/combo
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 Combo
Última Atualização: 04/02/2025
Este método modifica campanhas combo na plataforma.
Endpoint PUT
https://yandeh-seller-integration.yandeh.com.br/v2/acao_venda/combo/{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.
combo_volume_maximo
Volume máximo disponível para a campanha combo por público-alvo.
Tipo: Array de JSON.
publico_alvo
Nome do público-alvo.
Tipo: String.
limite_produto_total
Quantidade total de produtos 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.