Incluir uma promoção

post

https://sandbox.mercos.com/api/v1/promocoes

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

📌 Header de resposta

Em caso de sucesso (201 - Created), o ID Mercos do recurso criado será retornado no header meuspedidosid.

⚠️
Importante
Ao alterar uma promoção, em algumas situações, podemos retornar um novo ID. Certifique-se de atualizá-lo no ERP.

Body Params

nome

string

required

Nome da promoção.

slug

string

Slug da promoção. O slug é a parte final da URL da promoção, disponível nas contas com e-commerce B2B. Deve ser composto apenas por letras minúsculas (sem acentos), números, “-” ou “_” e sem espaços. Exemplo: slug-da-promocao-1

data_inicial

string

required

Data inicial da promoção.

data_final

string

required

Data final da promoção.

regras

array of objects

required

Lista contendo as regras desta promoção.

regras*

representada_id

integer | null

Identificador da representada. Opcional: quando não informado, o Mercos usa a representada associada à integração. Utilize este campo se a sua conta não é uma indústria com divisões. Se for, utilize divisao_id no lugar dele.

divisao_id

integer | null

Identificador da divisão. Opcional: quando não informado, o Mercos usa a divisão associada à integração. Utilize este campo se a sua conta é uma indústria com divisões. Nas demais contas, utilize representada_id.

Headers

ApplicationToken

string

required

Identifica sua aplicação.

CompanyToken

string

required

Representa o cliente da sua aplicação.

Responses

Language

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

Importante

201Created

401Unauthorized

412Precondition Failed

429Too Many Requests