Criação de Promoções

A criação de promoções será realizada utilizando a rota POST /merchants/{merchantId}/promotions. Ao realizar a solicitação para a rota, o fluxo realizará as validações necessárias e processamento, e posteriormente as promoções serão enviadas ao APP.

Envio dos dados

Exemplo para promoções do tipo: FIXED PERCENTAGE e FIXED_PRICE

{
    "aggregationTag": "123456",
    "promotions": [
        {
            "promotionName": "Promoção  teste",
            "channels": [
                "IFOOD-APP"
            ],
            "items": [
                {
                    "ean": "3213434343",
                    "discountValue": 22.99,
                    "initialDate": "2024-10-23",
                    "finalDate": "2024-10-30",
                    "promotionType": "FIXED",
                }
            ]
        }
    ]
}

Exemplo para promoções do tipo: LXPY (leve X pague Y)

{
    "aggregationTag": "123456",
    "promotions": [
        {
            "promotionName": "Promoção teste do tipo LXPY",
            "channels": [
                "IFOOD-APP"
            ],
            "items": [
                {
                    "ean": "3213434343",
                    "discountValue": null,
                    "initialDate": "2024-10-23",
                    "finalDate": "2024-10-30",
                    "promotionType": "LXPY",
                    "progressiveDiscount": {
                        "quantityToBuy": 3,
                        "quantityToPay": 2
                    }
                }
            ]
        }
    ]
}

Exemplo para promoções do tipo: ATACAREJO

{
    "aggregationTag": "123456",
    "promotions": [
        {
            "promotionName": "Promoção teste do tipo Atacarejo",
            "channels": [
                "IFOOD-APP"
            ],
            "items": [
                {
                    "ean": "3213434343",
                    "discountValue": 3,
                    "initialDate": "2024-10-23",
                    "finalDate": "2024-10-30",
                    "promotionType": "ATACAREJO",
                    "progressiveDiscount": {
                        "quantityToBuy": 6
                    }
                }
            ]
        }
    ]
}

Exemplo para promoções do tipo: PERCENTAGE_X_UNIT_DISCOUNT (X% off na Y unidade)

{
    "aggregationTag": "123456",
    "promotions": [
        {
            "promotionName": "Promoção teste - 50% de desconto na 3 unidade",
            "channels": [
                "IFOOD-APP"
            ],
            "items": [
                {
                    "ean": "3213434343",
                    "discountValue": 50.0,
                    "initialDate": "2024-10-23",
                    "finalDate": "2024-10-30",
                    "promotionType": "PERCENTAGE_PER_X_UNITS",
                    "progressiveDiscount": {
                        "quantityToBuy": 3
                    }
                }
            ]
        }
    ]
}

Informações dos campos

Tipos de promoções

• Tipos de promoções (promotionType) suportados pela integração.

  • FIXED: determina o valor do desconto em R$.
  • PERCENTAGE: determina o valor do desconto do item em porcentagem.
  • FIXED_PRICE: determina o valor final do item.
  • LXPY: determina o valor de desconto dado um combo de itens.
  • ATACAREJO: aplica o valor do desconto a partir de uma quantidade X de itens.
  • PERCENTAGE_PER_X_UNITS: aplica o desconto percentual a cada x quantidade do item.

• Campos usados em conjunto

  • Para promoções do tipo: FIXED , PERCENTAGE, FIXED_PRICE deve ser enviado promotionType e o discountValue. EX:

    {
            "promotionType": "tipo da promoção",
            "discountValue": "valor do desconto ou valor do item"
    }

  • Para promoções do tipo LXPY deve ser enviado o promotionType e o progressiveDiscount (objeto completo) EX:

        {
            "promotionType": "LXPY", 
            "progressiveDiscount":{
                "quantityToBuy": 3, 
                "quantityToPay": 2
            }
        }

  • Para promoções do tipo ATACAREJO deve ser enviado o promotionType, o progressiveDiscount e o discountValue EX:

        {
            "promotionType": "ATACAREJO", 
            "discountValue": "valor final do item",
            "progressiveDiscount":{
                "quantityToBuy": 3, 
            }
        }

  • Para promoções do tipo PERCENTAGE_PER_X_UNITS deve ser enviado o promotionType, o progressiveDiscount.quantityToBuy e o discountValue EX:

        {
            "promotionType": "PERCENTAGE_PER_X_UNITS", 
            "discountValue": "valor do desconto aplicado a cada x unidades do item",
            "progressiveDiscount":{
                "quantityToBuy": 3, 
            }
        }

Exemplo de utilização:

• Em um exemplo que o item tem o valor R$ 10,00

Retorno da requisição

• Sucesso

  • HTTP status code 202
  • Response body

    {
    "aggregationId": "String",
    "message": "We have successfully received your request to create promotions"
    }

  • O aggregationId retornado, será o identificador para acompanhamento do seu pedido de criação de promoção.

• Erro

  • Quando ocorrer algum erro ao realizar o processamento, será retornado o HTTP status code 400 ou 422

    {
    "type": "Business Exception || Unprocessable Entity",
    "title": "Business Exception || Unprocessable Entity",
    "status": 400 || 422,
    "detail": "Detail error",
    "instance": "07228dab-644c-4bec-b8a3-073397a839a0"
    }

  • Quando ocorrer algum erro em algum parâmetro ou no body, será retornado o HTTP status code 412

    HTTP status code 412

    {
    "type": "Precondition Failed || Invalid Argument",
    "title": "Invalid Request Body || Invalid Argument",
    "status": 412,
    "detail": "Detail error",
    "instance": "07228dab-644c-4bec-b8a3-073397a839a0"
    }

Critérios de Homologação

Verifique os critérios para realizar sua homologação.