Skip to content

Criar um diagnóstico

Esta requisição cria um diagnóstico para o estabelecimento, em status rascunho. A categoria é enviada por meio de um slug, que é resolvido internamente para a categoria de atuação correspondente ao estabelecimento.

Envio de compras em lote

Somente diagnósticos criados através desta API pública aceitam o envio posterior de compras em lote. Veja Enviar compras do diagnóstico.

bash
curl --location --request POST 'https://sandbox.fidelizii.com.br/api/v4/estabelecimentos/3954/diagnosticos' \
--header 'app-token: {{app-token}}' \
--header 'access-token: {{access-token}}' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
    "titulo": "Diagnóstico Loja Centro - Abril/2026",
    "categoria": "moda",
    "tags": ["pos", "adquirente-x"]
  }'
ParâmetroDescriçãoExemplo
tituloTítulo do diagnóstico (Obrigatório, máximo 255 caracteres)Diagnóstico Loja Centro - Abril/2026
categoriaSlug da categoria de atuação (Obrigatório). Valores aceitos: alimentacao, automotivo, beleza, farmacia, materiais-de-construcao, mercado, moda, perfumaria-e-cosmeticos, pet-shop, produtos-naturais, suplementosmoda
tagsLista de tags livres (Opcional, cada item com até 100 caracteres)["pos", "adquirente-x"]

Caso a requisição seja realizada com sucesso, você terá um retorno parecido com o exemplo abaixo:

json
{
    "success": true,
    "message": "Diagnóstico criado com sucesso.",
    "data": {
        "id_diagnostico": 123,
        "titulo": "Diagnóstico Loja Centro - Abril/2026",
        "categoria": "moda",
        "tags": ["pos", "adquirente-x"],
        "status": "rascunho",
        "criado_em": "2026-07-11 10:00:00"
    }
}

Categoria inválida

Caso a categoria enviada não seja um dos slugs aceitos, a requisição retornará erro de validação (422) no campo categoria.