---
title: "/api_inicio"
method: POST
path: "/api_inicio"
---

# /api_inicio

`POST /api_inicio`

API responsável por iniciar o fluxo de geração e resgate dos bônus a partir dos dados do cliente.

## Headers

- `Authorization` string, required
- `CodEmpresa` string, required
- `Celular` string, required
- `Content-Type` string, required
- `System-Name` string, required
- `User-Agent` string, required

## Request body

- object
  - `cod_loja` integer, required — ID da loja fornecido pelo T.I. do CRM&Bonus.
  - `customer_name` string, required — Nome do cliente.
  - `customer_cel` string, required — Número de celular do cliente com DDD e sem o uso da máscara.
  - `customer_email` string — Endereço de e-mail do cliente.
  - `customer_birth` string — Data de nascimento do cliente (dia/mês/ano).
  - `customer_cpf` string — Número de CPF do cliente.
  - `category_custom` string — Código utilizado para filtrar campanhas específicas quando o endpoint /api_campanha_disponivel for chamado. O valor desse campo precisa ser igual a categoria da campanha desejada.

## Response `200`

200

- object
  - `status` true | false — Se houve sucesso/falha em sua solicitação
  - `message` string — Mensagem de sucesso/falha da sua solicitação. [Confira as mensagens de erro](https://crmbonus-api.readme.io/reference/erros-pdv-v1#post-api_inicio) desta rota.
  - `data` object — Conteúdo do retorno
    - `loja_id` integer — ID correspondente à esta loja
    - `customer_id` integer — ID do consumidor
    - `solicita_pin` boolean — - `true` → obriga requisição à `/api_validar_pin` - `false` → descarta
    - `sms` string — Conteúdo do SMS enviado ao consumidor.

---

[API](https://skmtc.net/crmbonus/apis/bi-crmb-nus.md) · [All operations](https://skmtc.net/crmbonus/apis/bi-crmb-nus/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/crmbonus/bi-crmb-nus/versions/7f3ebb042f1a/schema)