NBS
Integração com o sistema NBS para agendamento de serviços Mitsubishi — agenda, clientes, ordens de serviço e veículos.
Objetivo
Prover acesso gateway (síncrono) a todas as operações do sistema NBS de agendamento de oficina: consulta de horários, criação/alteração/cancelamento de agendamentos, busca de clientes, revisões, consultores, OS e veículos.
Como funciona
A integração roda como um microserviço HTTP independente na porta 4001. Todos os 14 handlers são do tipo gateway — proxy síncrono onde a API recebe o request, chama a NBS e retorna a resposta.
Autenticação via OAuth2 Client Credentials — o token é obtido automaticamente a partir de client_id e client_secret.
Handlers
| Handler | Método | Endpoint NBS | Descrição |
|---|---|---|---|
list-schedules | GET | /v1/agenda/{codEmpresa} | Lista agendamentos com filtros |
get-available-slots | GET | /v1/agenda/horarios/{codEmpresa} | Horários disponíveis para agendamento |
create-schedule | POST | /v1/agenda/{codEmpresa} | Cria novo agendamento |
update-schedule | PUT | /v1/agenda/{codEmpresa} | Altera agendamento existente |
cancel-schedule | DELETE | /v1/agenda/{codEmpresa} | Cancela agendamento |
get-customer | GET | /v1/cliente/{codEmpresa} | Busca cliente por CPF ou placa |
list-revision-customers | GET | /v1/cliente/revisao/{codEmpresa} | Clientes próximos da revisão |
check-revision-status | POST | /v1/cliente/revisao/status/{codEmpresa} | Verifica necessidade de revisão |
list-consultants | GET | /v1/consultor/{codEmpresa} | Lista consultores e horários |
get-company | GET | /v1/empresa/{codEmpresa} | Lista empresas/lojas ativas |
list-os-types | GET | /v1/os/tipo/{codEmpresa} | Tipos de ordem de serviço |
get-os-history | GET | /v1/os/{codEmpresa} | Histórico de OS por chassi |
list-services | GET | /v1/servico/{codEmpresa} | Serviços disponíveis |
list-vehicles | GET | /v1/veiculo/{codEmpresa} | Modelos de veículos |
Referência
- API Interna — endpoints do serviço gateway
- API Externa — endpoints da NBS consumidos pela integração