Swagger Plugin NBS

De Wiki NBS
Ir para navegação Ir para pesquisar


Seta-topo.png

<< Voltar


Objetivo:

Estes end-points tem como objetivo permitir que softwares de terceiros ou da montadora possam se integrar com o sistema NBS.

Fábrica

TABELA DE END-POINTS:

Cliente


Swagger-Cliente.png

Grupo de EndPoints responsáveis por Incluir e Atualizar clientes


GET


GET/cliente/{codEmpresa} – Busca os dados do cliente

codEmpresa – código da empresa no sistema NBS

nome – filtra busca de cliente por nome

cpfCnpj – filtra busca de cliente pelo CPF/CNPJ

codCliente – filtra busca de cliente pelo código identificador do cliente

telefone – filtra busca de cliente pelo telefone (necessário informar DDD, ex: 65988776655)

page - Filtro para requisitar o numero de páginas que é pra trazer os resultados.

size - Filtro para requisitar a quantidade de registro obtido por página.


GET/cliente/tipo/{codEmpresa} – Busca o tipo de cliente

codEmpresa – código da empresa no sistema NBS.


GET/cliente/tipo/pessoa/{codEmpresa} – Busca o tipo de cliente

codEmpresa – código da empresa no sistema NBS.


GET/cliente/tipo/codigo/{codEmpresa} – Busca o código do tipo de cliente

codEmpresa – código da empresa no sistema NBS


GET/cliente/ramo/{codEmpresa} – Busca os ramos de atividade do cliente

codEmpresa – código da empresa no sistema NBS


GET/cliente/nacionalidade/{codEmpresa} – Busca as nacionalidades no sistema

codEmpresa – código da empresa no sistema NBS

descricaoNacionalidade – filtra nacionalidade pelo nome do País


GET/cliente/cidades{codEmpresa} – Busca a cidade do cliente.

codEmpresa – código da empresa no sistema NBS

cep – filtra a busca do cadastro de cidade pelo CEP

descricao – filtra a busca do cadastro de cidade pelo nome da cidade

POST


POST/cliente/{codEmpresa} – Insere novo cliente

codEmpresa – código da empresa no sistema NBS.

Utilizar os demais EndPoints para consultar os campos padrões a serem preenchidos


PUT


PUT/cliente/{codEmpresa}/{idCliente} – Atualiza os dados do cliente

codEmpresa – código da empresa no sistema NBS.

idCliente – Código identificador do cliente.

Utilizar os demais EndPoints do grupo Cliente para consultar os campos padrões a serem preenchidos

Evolutivo

TABELA DE END-POINTS:

Cruzar acesso


Cruzar acesso.png

Grupo de EndPoints responsáveis por cruzar direitos do acesso a funções existentes.

POST


POST/cruzar/acessos/inserir - Insere direito de acesso a função.

codAcesso: código do acesso cadastrado no sistema da NBS;

codFuncao: código da função cadastrada no sistema da NBS.

GET


GET/cruzar/acessos/acessosCruzados - Obtém uma lista dos acessos cruzados com suas respectivas funções ao qual estão cruzados.

codSistema - código dos sistemas cadastrados no banco de dados da NBS(filtro);

codVisao - código de visões cadastradas no sistema da NBS(filtro);

codAcesso: código do acesso cadastrado no sistema da NBS(filtro);

codFuncao: código da função cadastrada no sistema da NBS(filtro).

DELETE


DELETE/cruzar/acessos/excluir - Exclui cruzamento de acesso delegado a uma função.

codAcesso: código do acesso cadastrado no sistema da NBS;

codFuncao: código da função cadastrada no sistema da NBS.

Empresa Acesso


EmpresaAcesso.png

Grupo de endpoints responsáveis por listar os acessos existentes.

GET


GET/empresas/acesso/logs - Obtém a listagem dos logs de acessos contido no sistema NBS.

codAcesso: código do acesso cadastrado no sistema da NBS(filtro).

GET


GET/empresas/acesso/ - Obtém a listagem dos acessos contido no sistema NBS.

codAcesso: código do acesso cadastrado no sistema da NBS(filtro).

Empresas funções


Empresas Funções.png

Grupo de endpoints relacionados a obtenção e manipulação de dados das funções existentes.

POST


POST/empresas/funcao/incluir - Realiza o cadastro de funções.

descricao: Descrição do nome dado a função que será cadastrada;

max_desconto_balcao: máximo de desconto em porcentagem que a função poderá dar ao cliente;

vendedor_acessorios: Habilita ser listado no módulo vendas, campo Vendedor de Veículos(acessórios).

PATCH


PATCH/empresas/funcao/alterar/{codFuncao} - Realiza a alteração de alguns ou todos os campos das funções cadastradas.

codFuncao: código da função cadastrada no sistema NBS;

descricao: Descrição do nome dado a função que será cadastrada;

max_desconto_balcao: máximo de desconto em porcentagem que a função poderá dar ao cliente;

vendedor_acessorios: Habilita ser listado no módulo vendas, campo Vendedor de Veículos(acessórios).

GET


GET/empresas/funcao/- Lista todas as funções cadastradas no sistema da NBS.

codFuncao: código da função cadastrada no sistema da NBS (Filtro);

nomeFuncao: nome da função cadastrada no sistema da NBS(Filtro).

DELETE


DELETE/empresas/funcao/deletar - Deleta uma função existente.

codFuncao: código da função cadastrada no sistema da NBS.

Empresa Departamento


Departamento.png

Endpoint responsável pela listagem de departamentos cadastrados no sistema NBS

GET


GET/empresas/departamento - Lista todos os departamentos cadastrados no sistema da NBS.

codEmpresa: Código das empresas cadastradas no sistema da NBS;

codEmpresaDepartamento: Código dos departamentos cadastrados no sistema da NBS;

nomeDepartamento: Nome do departamento cadastrado;

codCaixaOperacional: Código das caixas operacionais cadastradas no sistema NBS.

Empresa Divisão


Divisão.png

Endpoint responsável pela listagem das divisões cadastrados no sistema NBS

GET


GET/empresas/departamento - Lista todas as divisões cadastradas no sistema da NBS.

codEmpresa: código das empresas cadastradas no sistema da NBS;

codEmpresaDepartamento: código dos departamentos cadastrados no sistema da NBS;

codDivisao: código das divisões cadastradas no sistema da NBS;

nomeDepartamento: nome do departamento cadastrado;

nomeDivisao: nome das divisões cadastradas.

Empresa Local/Estoque


Local-Estoque.png

Endpoint responsável pela listagem de estoque cadastrados no sistema NBS

GET


GET/empresas/departamento - Lista todos os locais de estoque da empresa.

nomeDoLocal: nome do local do estoque;

principal: define se o local de estoque é principal ou secundário;

codEmpresa: código da empresa cadastrada no sistema da NBS;

codLocalEstoque: código do local aonde está o estoque, este, cadastrado no sistema da NBS;

preferencia: Prioridade do local do estoque.

Empresa Funcionários


Funcionários.png

Endpoint responsável pela listagem de funcionários cadastrados no sistema NBS

GET


GET/empresas/departamento - Lista todos os funcionários cadastrados no sistema da NBS.

codEmpresa: código das empresas cadastradas no sistema da NBS;

codFuncionários: código dos funcionários cadastrados no;

nome: nome do Funcionário.

Empresa Desconto


Desconto.png

Endpoint responsável pela listagem de descontos cadastrados no sistema NBS

GET


GET/empresas/departamento - Lista todos os descontos cadastrados no sistema da NBS.

codNivel: código do nível de desconto cadastrado no sistema da NBS;

descricao: descrição do desconto cadastrado no sistema da NBS;

hierarquia: hierarquia de descontos cadastrados;

tipo: tipo de desconto.

Empresa Times


Times.png

Endpoint responsável pela listagem de times cadastrados no sistema NBS

GET


GET/empresas/departamento - Lista todos os times cadastrados no sistema da NBS.

codTime: Código dos times cadastrados no sistema da NBS;

descricaoTime: descrição dos times cadastrados no sistema NBS;

codEmpresa: código das empresas cadastradas no sistema da NBS;

codTecnico: código dos tipos técnicos cadastrados no sistema NBS.

Empresa usuários


Grupo de endpoints relacionados a obtenção e manipulação de dados relacionados aos usuários existentes.

PUT


PUT/empresas/usuarios/alterar - altera os usuarios cadastrados no sistema NBS.

login: login do usuário;

codEmpresa: códigos das empresas cadastrado no sistema NBS;

codDepartamento: códigos dos departamentos cadastrados no sistema NBS;

codDivisao: códigos das divisões cadastradas no sistema NBS;

codFuncao: código das funções cadastradas no sistema NBS;

nomeCompleto: nome completo do funcionário;

trocarSenhaLogar: opção binária onde marca "S" para sim e "N" para não.(obrigatório trocar senha ao logar?);

forcarLimiteOrcamento: opção binária onde marca "S" para sim e "N" para não.(usuário pode forçar limite de orçamento?);

codSegmento: código do segmento que o usuário esta cadastrado no sistema NBS;

baixaParcial: opção binária onde marca "S" para sim e "N" para não.(usuário terá baixa parcial?);

cpf: CPF do usuário;

email: email do usuário;

dtAdmissao: data de registro e inicio de tempo como prestador de serviço;

password: Senha do usuário;

time: Time ao qual está designado e cadastrado no sistema NBS;

codFuncionario: código de funcionário ao qual o usuário está cadastrado no sistema NBS;

supervisor: opção binária onde marca "S" para sim e "N" para não.(usuário é supervisor?);

ehRepresentante. opção binária onde marca "S" para sim e "N" para não(usuário é representante?);

dtNascimento: data de nascimento do usuário;

fone: telefone do usuário;

codLocalEstoque: código que possibilita a escolha do local de estoque que estão cadastrados no sistema NBS;

liberado: opção binária onde marca "S" para sim e "N" para não. (Usuário está liberado para receber entregas?);

codigoOpcional: Código opcional para adicionar em Aviso de vendas;

demitido: opção binária onde marca "S" para sim e "N" para não.(o usuário foi demitido?);

limiteOrcamento: valor do limite de orçamento;

gmConnect: opção binária onde marca "S" para sim e "N" para não;

re: (Campo para revisão);

tsa21: opção binária onde marca "S" para sim e "N" para não.(Tem certificado tsa21?);

dtDemissao: data de demissão do funcionário;

codChapaFuncionarioStr: código do funcionário da folha de pagamento ;

codEventoFuncionario: código de funcionário de pagamento de terceiros;

codAgendaFord: código do funcionário do sistema da Ford;

emailSmtp: protocolo do email do usuário;

percComissao: valor do porcentual que ganhará de comissão;

salarioBase: valor do salário base;

naoRecebeRecado: opção binária onde marca "S" para sim e "N" para não.(Usuário não recebe recado?);

percComissaoServ: porcentagem de comissão que o vendedor ganhará por serviço;

maximoDescBalcao: máximo de desconto que o vendedor poderá dar no balcão;

codNivelDesconto: código do nível de desconto disponível no sistema NBS;

maximoDescServRecap: porcentagem de desconto máximo que o funcionário poderá dar no serviço de recapagem;

codempresatoy2S: código do funcionário da empresa Toyota;

autorizapagfor: Identificação de autorização do usuário de pagamento eletrônico.

POST


POST/empresas/usuarios/pesquisa-avancada - Pesquisa avançada para identificar usuários cadastrados no sistema NBS.

login: login do usuário;

codEmpresa: códigos das empresas cadastrado no sistema NBS;

codDepartamento: códigos dos departamentos cadastrados no sistema NBS;

codDivisao: códigos das divisões cadastradas no sistema NBS;

codFuncao: código das funções cadastradas no sistema NBS;

nomeCompleto: nome completo do funcionário;

trocarSenhaLogar: opção binária onde marca "S" para sim e "N" para não.(obrigatório trocar senha ao logar?);

forcarLimiteOrcamento: opção binária onde marca "S" para sim e "N" para não.(usuário pode forçar limite de orçamento?);

codSegmento: código do segmento que o usuário esta cadastrado no sistema NBS;

baixaParcial: opção binária onde marca "S" para sim e "N" para não.(usuário terá baixa parcial?);

cpf: CPF do usuário;

email: email do usuário;

dtAdmissao: data de registro e inicio de tempo como prestador de serviço;

password: Senha do usuário;

time: Time ao qual está designado e cadastrado no sistema NBS;

codFuncionario: código de funcionário ao qual o usuário está cadastrado no sistema NBS;

supervisor: opção binária onde marca "S" para sim e "N" para não.(usuário é supervisor?);

ehRepresentante. opção binária onde marca "S" para sim e "N" para não(usuário é representante?);

dtNascimento: data de nascimento do usuário;

fone: telefone do usuário;

codLocalEstoque: código que possibilita a escolha do local de estoque que estão cadastrados no sistema NBS;

liberado: opção binária onde marca "S" para sim e "N" para não. (Usuário está liberado para receber entregas?);

codigoOpcional: Código opcional para adicionar em Aviso de vendas;

demitido: opção binária onde marca "S" para sim e "N" para não.(o usuário foi demitido?);

limiteOrcamento: valor do limite de orçamento;

gmConnect: opção binária onde marca "S" para sim e "N" para não;

re: (Campo para revisão);

tsa21: opção binária onde marca "S" para sim e "N" para não.(Tem certificado tsa21?);

dtDemissao: data de demissão do funcionário;

codChapaFuncionarioStr: código do funcionário da folha de pagamento ;

codEventoFuncionario: código de funcionário de pagamento de terceiros;

codAgendaFord: código do funcionário do sistema da Ford;

emailSmtp: protocolo do email do usuário;

percComissao: valor do porcentual que ganhará de comissão;

salarioBase: valor do salário base;

naoRecebeRecado: opção binária onde marca "S" para sim e "N" para não.(Usuário não recebe recado?);

percComissaoServ: porcentagem de comissão que o vendedor ganhará por serviço;

maximoDescBalcao: máximo de desconto que o vendedor poderá dar no balcão;

codNivelDesconto: código do nível de desconto disponível no sistema NBS;

maximoDescServRecap: porcentagem de desconto máximo que o funcionário poderá dar no serviço de recapagem;

codempresatoy2S: código do funcionário da empresa Toyota;

autorizapagfor: Identificação de autorização do usuário de pagamento eletrônico .

POST


POST/empresas/usuarios/incluir - adiciona usuários no sistema da NBS.

login: login do usuário;

codEmpresa: códigos das empresas cadastrado no sistema NBS;

codDepartamento: códigos dos departamentos cadastrados no sistema NBS;

codDivisao: códigos das divisões cadastradas no sistema NBS;

codFuncao: código das funções cadastradas no sistema NBS;

nomeCompleto: nome completo do funcionário;

trocarSenhaLogar: opção binária onde marca "S" para sim e "N" para não.(obrigatório trocar senha ao logar?);

forcarLimiteOrcamento: opção binária onde marca "S" para sim e "N" para não.(usuário pode forçar limite de orçamento?);

codSegmento: código do segmento que o usuário esta cadastrado no sistema NBS;

baixaParcial: opção binária onde marca "S" para sim e "N" para não.(usuário terá baixa parcial?);

cpf: CPF do usuário;

email: email do usuário;

dtAdmissao: data de registro e inicio de tempo como prestador de serviço;

password: Senha do usuário;

time: Time ao qual está designado e cadastrado no sistema NBS;

codFuncionario: código de funcionário ao qual o usuário está cadastrado no sistema NBS;

supervisor: opção binária onde marca "S" para sim e "N" para não.(usuário é supervisor?);

ehRepresentante. opção binária onde marca "S" para sim e "N" para não(usuário é representante?);

dtNascimento: data de nascimento do usuário;

fone: telefone do usuário;

codLocalEstoque: código que possibilita a escolha do local de estoque que estão cadastrados no sistema NBS;

liberado: opção binária onde marca "S" para sim e "N" para não. (Usuário está liberado para receber entregas?);

codigoOpcional: Código opcional para adicionar em Aviso de vendas;

demitido: opção binária onde marca "S" para sim e "N" para não.(o usuário foi demitido?);

limiteOrcamento: valor do limite de orçamento;

gmConnect: opção binária onde marca "S" para sim e "N" para não.;

re: (Campo para revisão);

tsa21: opção binária onde marca "S" para sim e "N" para não.(Tem certificado tsa21?);

dtDemissao: data de demissão do funcionário;

codChapaFuncionarioStr: código do funcionário da folha de pagamento ;

codEventoFuncionario: código de funcionário de pagamento de terceiros;

codAgendaFord: código do funcionário do sistema da Ford;

emailSmtp: protocolo do email do usuário;

percComissao: valor do porcentual que ganhará de comissão;

salarioBase: valor do salário base;

naoRecebeRecado: opção binária onde marca "S" para sim e "N" para não.(Usuário não recebe recado?);

percComissaoServ: porcentagem de comissão que o vendedor ganhará por serviço;

maximoDescBalcao: máximo de desconto que o vendedor poderá dar no balcão;

codNivelDesconto: código do nível de desconto disponível no sistema NBS;

maximoDescServRecap: porcentagem de desconto máximo que o funcionário poderá dar no serviço de recapagem;

codempresatoy2S: código do funcionário da empresa Toyota;

autorizapagfor: Identificação de autorização do usuário de pagamento eletrônico .

POST


POST/empresas/usuarios/incluir-criar-bd - adiciona usuários no banco de dados.

login: login do usuário;

codEmpresa: códigos das empresas cadastrado no sistema NBS;

codDepartamento: códigos dos departamentos cadastrados no sistema NBS;

codDivisao: códigos das divisões cadastradas no sistema NBS;

codFuncao: código das funções cadastradas no sistema NBS;

nomeCompleto: nome completo do funcionário;

trocarSenhaLogar: opção binária onde marca "S" para sim e "N" para não.(obrigatório trocar senha ao logar?);

forcarLimiteOrcamento: opção binária onde marca "S" para sim e "N" para não.(usuário pode forçar limite de orçamento?);

codSegmento: código do segmento que o usuário esta cadastrado no sistema NBS;

baixaParcial: opção binária onde marca "S" para sim e "N" para não.(usuário terá baixa parcial?);

cpf: CPF do usuário;

email: email do usuário;

dtAdmissao: data de registro e inicio de tempo como prestador de serviço;

password: Senha do usuário;

time: Time ao qual está designado e cadastrado no sistema NBS;

codFuncionario: código de funcionário ao qual o usuário está cadastrado no sistema NBS;

supervisor: opção binária onde marca "S" para sim e "N" para não.(usuário é supervisor?);

ehRepresentante. opção binária onde marca "S" para sim e "N" para não(usuário é representante?);

dtNascimento: data de nascimento do usuário;

fone: telefone do usuário;

codLocalEstoque: código que possibilita a escolha do local de estoque que estão cadastrados no sistema NBS;

liberado: opção binária onde marca "S" para sim e "N" para não. (Usuário está liberado para receber entregas?);

codigoOpcional: Código opcional para adicionar em Aviso de vendas;

demitido: opção binária onde marca "S" para sim e "N" para não.(o usuário foi demitido?);

limiteOrcamento: valor do limite de orçamento;

gmConnect: opção binária onde marca "S" para sim e "N" para não;

re: (Campo para revisão);

tsa21: opção binária onde marca "S" para sim e "N" para não.(Tem certificado tsa21?);

dtDemissao: data de demissão do funcionário;

codChapaFuncionarioStr: código do funcionário da folha de pagamento ;

codEventoFuncionario: código de funcionário de pagamento de terceiros;

codAgendaFord: código do funcionário do sistema da Ford;

emailSmtp: protocolo do email do usuário;

percComissao: valor do porcentual que ganhará de comissão;

salarioBase: valor do salário base;

naoRecebeRecado: opção binária onde marca "S" para sim e "N" para não.(Usuário não recebe recado?);

percComissaoServ: porcentagem de comissão que o vendedor ganhará por serviço;

maximoDescBalcao: máximo de desconto que o vendedor poderá dar no balcão;

codNivelDesconto: código do nível de desconto disponível no sistema NBS;

maximoDescServRecap: porcentagem de desconto máximo que o funcionário poderá dar no serviço de recapagem;

codempresatoy2S: código do funcionário da empresa Toyota;

autorizapagfor: Identificação de autorização do usuário de pagamento eletrônico .

POST


POST/empresas/usuarios/duplicar-usuarios - duplica usuário no sistema da NBS.

login: login do usuário;

newPassword: nova senha para o usuário;

codEmpresa: código da empresa cadastrado no sistema NBS;

codDepartamento: código de departamento cadastrado no sistema NBS;

codDivisao: código da divisão cadastrado no sistema NBS.

POST


POST/empresas/usuarios/demitir - demite/exclui usuário como um funcionário do sistema da NBS.

login: Login do usuário;

dataDemissao: data de demissão do funcionário.

POST


POST/empresas/usuarios/criar-db-one - cria o usuário no banco de dados.

login: login do usuário;

password: senha do usuário.

POST


POST/empresas/usuarios/criar-db-multiple

generalPassword: (Campo para revisão);

multipleLogin: (Campo para revisão).

POST


POST/empresas/usuarios/bloquear-db - bloquea o acesso do usuário ao banco de dados no sistema da NBS.

login: Login do usuário;

bloquear: opção binária onde marca "S" para sim e "N" para não.(Nesta opção, tem como padrão ser true);

porPeriodo: opção binária onde marca "S" para sim e "N" para não.(Bloqueia o usuário por um período pré-determinado);

inicio: data de inicio do bloqueio (opção só é valida se "porPeriodo" for marcado);

termino: data de termino do bloqueio (opção só é valida se "porPeriodo" for marcado).

POST


POST/empresas/usuarios/alterar-senha - altera a senha do usuário no sistema NBS.

login: login do usuário;

newPassword: nova senha para o usuário.

POST


POST/empresas/usuarios/alterar-multiplos - altera múltiplas informações de múltiplos usuários no sistema NBS.

codFuncao: código da função cadastrado no sistema NBS;

codDepartamento: código do departamento cadastrado no sistema NBS;

codDivisao: código da divisão cadastrado no sistema da NBS;

demitido: opção binária onde marca "S" para sim e "N" para não.(o usuário foi demitido?);

dtDemissao: data de demissão do usuário;

multipleLogin: (Campo para revisão).

GET


GET/empresas/usuarios/pesquisar - lista usuários existentes no sistema NBS.

codEmpresa: código das empresas cadastradas no sistema DA NBS;

nomeCompleto: nome completo do usuário;

login: login do usuário;

usuarioPrincipal: identifica o usuário principal na funcionalidade de múltiplo usuário;

codDepartamento: código do departamento cadastrado no sistema da NBS;

departamento: departamento do funcionário;

codFuncao: código da função cadastrada no sistema da NBS;

funcao: atribuição do funcionário;

codDivisao: código da divisão cadastrada no sistema da NBS;

divisao: subtipo do departamento, divisão em que o funcionário está;

cpf: CPF do funcionário;

page: numero de páginas de registro deseja ver;

numRegistroPorpagina: numero de registros que serão atribuídos há pagina.