Início > Vendedor
Versão: 2.0
Vendedor
Última Atualização: 16/01/2025
Integração dedicada a gerenciar informações do vendedor.
Sintaxe da Requisição
Para que a requisição do método POST seja bem-sucedida, é necessário que sejam enviados os seguintes valores dentro de um JSON:
Elementos da Requisição
Tipo: Array de JSON.
Lista de metas.
metas (obrigatório ou vazio)
Tipo: String.
Email do vendedor.
email_vendedor*
período da meta.
Tipo: JSON.
Dados para a meta de faturamento.
Tipo: JSON.
faturamento*
periodo*
Mês do período.
Tipo: Integer.
mes*
ano*
Tipo: Integer.
Ano do período.
Meta de faturamento.
Tipo: Double.
meta (Obrigatório ou zero)
faixas (Obrigatório ou vazio)
Faixas.
Tipo: Array de Double.
atual
Unidade utilizada na submeta.
Valores: valor/numero/peso/volume.
Tipo: String.
unidade_submeta*
Unidade utilizada na positivação.
Valores: numero/valor.
Tipo: String.
Tipo: Double.
Metas.
Faixa.
Tipo: Array de Double.
faixa (Obrigatório ou vazio)
metas (Obrigatório ou zero)
unidade*
positivacao*
Tipo: JSON.
Positivação da meta.
Atual.
Tipo: Double.
atual
Atual.
Tipo: Double.
Nome da submeta.
Tipo: String.
nome*
atual
Tipo: Integer.
Atual.
Valor da submeta.
Tipo: Double.
valor (Obrigatório ou zero)
submetas (Obrigatório ou vazio)
Tipo: JSON.
Dados da submeta.
Sintaxe da Resposta da API
Caso ocorra tudo certo com a requisição e retorne o status code 202, essa será a resposta que você receberá:
Sintaxe da Resposta do webhook
O resultado desta consulta será enviado via webhook para o fornecedor. A sintaxe resposta para o status code 200 com sucesso, será a seguinte:
Respostas para erros API
Caso ocorra algum erro durante a requisição, os possíveis erros são:
400 Bad Request
Exemplo de erro para emails inválidos
500 Internal server error
Respostas para erros webhook
Caso ocorra algum erro durante a requisição, os possíveis erros são:
200 Ok
Em situações de erro, os detalhes serão enviados no corpo do webhook:
POST Vendedor - Apurar meta
Última Atualização: 16/01/2024
O endpoint permite o envio de metas e apurações dos vendedores para a plataforma Smart Force. Ele processa múltiplos cadastros em uma única requisição no formato POST, sobrescrevendo os dados anteriores.