Desconto pré-acordado por item

Os vendedores são convidados periodicamente a participar nas diversas campanhas que são realizadas no site. Nesse tipo de campanha, o vendedor faz um pré-acordo de desconto para determinados itens com um agente comercial do Mercado Livre, onde são estabelecidos o preço, o desconto oferecido e o benefício concedido.
Se você recebeu um convite e deseja participar, você pode fazê-lo com os seguintes recursos.


Visão do vendedor




Conteúdo

→Consultar os detalhes de uma campanha com desconto pré-acordado
    ↳Status
→Consultar os itens de uma campanha com um desconto pré-acordado
    ↳Status dos itens
→Aceitar desconto pré-acordado por item
→Eliminar desconto pré-acordado



Consultar detalhes de uma campanha com desconto pré-acordado

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/seller-promotions/promotions/MLA686?promotion_type=PRE_NEGOTIATED'

Resposta:


{
   "id": "P-MLM394001",
   "type": "PRE_NEGOTIATED",
   "status": "started",
   "start_date": "2021-03-30T18:30:15.525Z",
   "finish_date": "2021-12-27T17:59:59.525Z",
   "deadline_date": "2021-05-27T17:59:59.525Z",
   "name": "Prueba descuento x item sin benefit",
   "offers": [
       {
           "id": "MLM848619385-f588cf87-e298-498e-82ad-285b16dd11d5",
           "original_price": 101,
           "new_price": 21,
           "status": "active",
           "start_date": "2021-05-10T16:00:00Z",
           "end_date": "2021-05-11T15:00:00Z",
           "benefits": {
               "type": "REBATE",
               "meli_percent": 9.9,
               "seller_percent": 69.3
           }
       }
   ]
}



Campos específicos desta campanha


Offers: Detalhe do desconto pré-acordado

  • id: Id da oferta
  • original_price: preço original do item.
  • new_price: preço final do item
  • status: status do item na promoção
  • start_date: data início da oferta na promoção
  • end_date: data de término da oferta na promoção

  • Benefits: detalhe dos benefícios da promoção
        • type: tipo de benefício
        • meli_percent: porcentagem contribuída pelo Mercado Livre
        • seller_percent: porcentagem de contribuição do vendedor


    Status

    Esses são os diferentes status pelos quais pode passar uma campanha com desconto pré-acordado.

    Status Descrição
    pending Promoção aprovada que ainda não começou.
    started Promoção ativa
    finished Promoção finalizada


    Consultar itens de uma campanha com um desconto pré-acordado

    Para conhecer os itens que fazem parte de uma campanha com desconto pré-acordado, pode-se fazer a seguinte consulta:


    Chamada:

    curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/seller-promotions/promotions/MLM686/items?promotion_type=PRE_NEGOTIATED'

    Resposta:

    
    {
       "results": [
           {
               "id": "MLM848619385",
               "status": "candidate",
               "price": 21,
               "original_price": 101,
               "offer_id": "MLM848619385-0e2f3064-0e13-425d-b4a7-0dee85414835",
               "meli_percentage": 24.8,
               "seller_percentage": 54.5,
               "start_date": "2021-05-11T22:00:00Z",
               "end_date": "2021-05-13T01:00:00Z"
           }
       ],
       "paging": {
           "total": 1
       }
    }
    

    Ao criar uma nova campanha, todos os itens aplicáveis ​​a ela são selecionados. O status inicial (status) dos itens é "candidate" e têm um "offer_id" único. Assim que o vendedor incorpora um item à campanha, seu status muda e passa a ser programmed ou active.



    Status dos itens

    Na tabela a seguir você encontra os possíveis status que os itens podem assumir neste tipo de campanha.

    Status Descrição
    candidate Item candidato a participar da promoção
    programmed Item com promoção aprovada e programada
    active Item ativo na campanha


    Aceita desconto pré-acordado por item

    Uma vez que tenha sido acordado um desconto para um item, com o seguinte recurso, o vendedor pode confirmar o pré-acordo.

    Chamada:

    
    curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' \
    -d '{
       "deal_id":"$DEAL_ID",
        "offer_id":"$OFFER_ID",
       "promotion_type":"$PROMOTION_TYPE"
    }'
    https://api.mercadolibre.com/seller-promotions/items/$ITEM_ID
    
    

    Exemplo:

    
    
    curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' \
    -d '{
       "deal_id":"P-MLM394001",
        "offer_id":"MLM848619385-f588cf87-e298-498e-82ad-285b16dd11d5",
       "promotion_type":"PRE_NEGOTIATED"
    }'
    https://api.mercadolibre.com/seller-promotions/items/MLM848619385
    
    

    Resposta:

    
    
    {
       "offer_id": "MLM848619385-f588cf87-e298-498e-82ad-285b16dd11d5",
       "price": 21,
       "original_price": 101
    }
    
    

    Parâmetros

    deal_id: identificação da promoção.
    offer_id: identificação da oferta acordada.
    promotion_type: tipo de promoção (PRE_NEGOTIATED).



    Eliminar desconto pré-acordado

    Com este recurso você pode eliminar a oferta do item.

    Chamada:

    curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/seller-promotions/items/$ITEM_ID?promotion_type=$PROMOTION_TYPE&deal_id=$DEAL_ID&offer_id=$OFFER_ID'

    Exemplo:

    curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/seller-promotions/items/MLB1834747833?promotion_type=PRE_NEGOTIATED&deal_id=P-MLM394001&offer_id=MLM1834747833-9eafadd4-16d2-49ae-b272-9a7a34585cb8'

    Resposta: Status 200 OK

    Nota:
    Lembre-se de que, se excluir um desconto pré-acordado, o item não será mais um candidato.

    Seguinte: Desconto individual

    ou registre-se para receber as últimas notícias sobre nossa API