Produto | Linx DMS |
---|---|
Menu | - |
Data |
|
Autor | |
Área | Linx DMS |
Este documento tem como finalidade documentar a utilização da API com as funcionalidades utilizadas no processo de pós vendas através de uma aplicação móvel.
Esta funcionalidade pode ser utilizada por qualquer parceiro da Linx que possua um acordo para a utilização desta API, juntamente com os clientes.
Ambiente
Verifique o endereço do ambiente a ser utilizado na documentação Barramento.
Autenticação
O tipo de autenticação utilizada por estes endPoints é a Autenticação V2.
Abaixo segue a documentação dos endPoints disponibilizados na API para serem utilizados no contexto de pós vendas através de uma aplicação móvel:
Exemplo de consumo da API
Abaixo segue um exemplo de como consumir a API utilizando o ambiente desejado e o token de autenticação:
Endereço de exemplo | http://IP:PORTA/LinxDMSAPI/v2?function=/Faturamento/CondicoesPagamento/ObterLista/Oficina/1/1/458 | ||||
---|---|---|---|---|---|
Método | GET | ||||
Header |
|
Faturamento
Atualizar opt-in/opt-out do cliente
Rota | v2?function=/Faturamento/Cliente/AtualizaOptInCliente |
---|---|
Método | POST |
Descrição | Endpoint responsável por atualizar o aceite de contato do cliente. |
Observação | - |
Request | { "CodigoCliente": 0, "OptIn": true } |
Response |
Consulta condições de pagamento
Rota | v2?function=/Faturamento/CondicoesPagamento/ObterLista/Oficina/{Empresa}/{Revenda}/{Contato} |
---|---|
Método | GET |
Descrição | Endpoint responsável por retornar uma lista com as condições de pagamento aptas a serem utilizadas para a empresa, revenda e contato consultados. |
Observação | - |
Request | - |
Response |
Consulta vendedores
Rota | v2?function=/Faturamento/Cadastros/Vendedores/FatMntVendedor/ObterVendedores/{Empresa}/{Revenda} |
---|---|
Método | GET |
Descrição | Endpoint responsável por retornar uma lista dos vendedores da empresa e revenda consultada. |
Observação | - |
Request | - |
Response |
Consulta usuários
Rota | v2?function=/Faturamento/Cadastros/Vendedores/FatMntVendedor/ListaUsuarios |
---|---|
Método | GET |
Descrição | Endpoint responsável por retornar uma lista de usuários. |
Observação | - |
Request | - |
Response |
Mobile
Consulta peças
Rota | v2?function=/CheckinOficina/BuscarPecas |
---|---|
Método | POST |
Descrição | Endpoint responsável por retornar uma lista com peças em estoque consultadas. |
Observação | Neste endPoint é necessário verificar o código de erro retornado na propriedade Resposta.Erro. Quando retornado diferente de 0 houve erros. |
Request | { "Filial": { //Exemplo: 1.1 "CodigoFilial": "string", //Exemplo: NISS "Bandeira": "string" }, "CodigoAgenda": "string", "Descricao": "string", "CodigoUsuario": "string", "PrecoSiteVW": true } |
Response |
Consulta serviços
Rota | v2?function=/CheckinOficina/BuscarServicos |
---|---|
Método | POST |
Descrição | Endpoint responsável por retornar uma lista com os serviços consultados. |
Observação | Neste endPoint é necessário verificar o código de erro retornado na propriedade Resposta.Erro. Quando retornado diferente de 0 houve erros. |
Request | { "Filial": { //Exemplo: 1.1 "CodigoFilial": "string", //Exemplo: NISS "Bandeira": "string" }, "Descricao": "string", "CodigoModeloVeiculo": "string" } |
Response |
Oficina
Consulta agenda dos consultores
Rota | v2?function=/Oficina/CheckinOficinaMetodos/CarregarAgendasApollo |
---|---|
Método | POST |
Descrição | Endpoint responsável por retornar uma lista com as os agendamentos realizados na data informada para a empresa e revenda consultadas. |
Observação | Neste endPoint é necessário verificar o código de erro retornado na propriedade Resposta.Erro. Quando retornado diferente de 0 houve erros. |
Request | { "Empresa": 0, "Revenda": 0, "DataAgenda": "2022-04-13T16:32:40.913Z", //Exemplo: NISS "Bandeira": "string" } |
Response |
Consulta atendimento
Rota | v2?function=/Oficina/Atendimento/{Empresa}/{Revenda}/{Contato} |
---|---|
Método | GET |
Descrição | Endpoint responsável por retornar o atendimento da empresa e revenda consultada. |
Observação | - |
Request | - |
Response |
Consulta categorias de ordem de serviço
Rota | v2?function=/Oficina/CheckinOficinaMetodos/ListaCategoriaOS |
---|---|
Método | POST |
Descrição | Endpoint responsável por retornar uma lista com as categorias de ordem de serviço aptas a serem utilizadas pela empresa, revenda e contato consultados. |
Observação | Neste endPoint é necessário verificar o código de erro retornado na propriedade Resposta.Erro. Quando retornado diferente de 0 houve erros. |
Request | { "Empresa": 0, "Revenda": 0, "Contato": 0 } |
Response |
Consulta cliente
Rota | v2?function=/Oficina/CheckinOficinaMetodos/BuscarClienteCheckin |
---|---|
Método | POST |
Descrição | Endpoint responsável por retornar as informações do cliente consultado. |
Observação | Caso for enviado na requisição o valor da propridade CodigoCliente diferente de zero, a busca pelo cliente ocorrerá pelo código informado. Caso contrário irá buscar o cliente pela propriedade Cgccpf e Tppessoa. Neste endPoint é necessário verificar o código de erro retornado na propriedade Resposta.Erro. Quando retornado diferente de 0 houve erros. |
Request | { "Cgccpf": "string", //F -> Fisica J-> Juridica "Tppessoa": "string", "CodigoCliente": 0 } |
Response |
Consulta mecânicos
Rota | v2?function=/Oficina/Mecanico/ObterListaMecanico/{Empresa}/{Revenda} |
---|---|
Método | GET |
Descrição | Endpoint responsável por retornar uma lista com os mecânicos da empresa e revenda consultadas. |
Observação | - |
Request | - |
Response |
Consulta motivos de paralização do serviço do CDT
Rota | v2?function=/Oficina/CDT/ObterMotivoParalizarCDT/{Empresa}/{Revenda} |
---|---|
Método | GET |
Descrição | Endpoint responsável por retornar uma lista com os motivos de paralização de serviço do CDT |
Observação | - |
Request | - |
Response |
Consulta ordem de serviço
Rota | v2?function=/Oficina/OrdemServico/{Empresa}/{Revenda}/{NroOs} |
---|---|
Método | GET |
Descrição | Endpoint responsável por retornar a ordem de serviço da empresa e revenda consultada. |
Observação | - |
Request | - |
Response |
Consulta ordens de serviço
Rota | v2?function=/Oficina/OrdemServico/ListaSimples |
---|---|
Método | POST |
Descrição | Endpoint responsável por retornar uma lista com as ordens de serviço consultadas de acordo com o filtro realizado. |
Observação | Se a consulta ocorrer somente pela Empresa e Revenda serão retornadas as ordens de serviço com data de abertura a partir do primeiro dia do mês atual. |
Request | { "Empresa": 0, "Revenda": 0, "NomeCliente": "string", //Enviar null caso não queira pesquisar pelo NroOs "NroOs": 0, "Chassi": "string", "Placa": "string", //Enviar null caso não queira pesquisar pela Aberta "Aberta": true, //Enviar null caso não queira pesquisar pela DataAberturaInicio "DataAberturaInicio": "2022-04-13T16:34:43.504Z", //Enviar null caso não queira pesquisar pela DataAberturaFinal "DataAberturaFinal": "2022-04-13T16:34:43.504Z" } |
Response |
Consulta tipos de serviços
Rota | v2?function=/Oficina/Cadastros/OfiTipoServico/ObterListaSimples/{Empresa}/{Revenda} |
---|---|
Método | GET |
Descrição | Endpoint responsável por retornar uma lista com os tipos de serviços da empresa e revenda consultadas. |
Observação | - |
Request | - |
Response |
Consulta veículo
Rota | v2?function=/Oficina/CheckinOficinaMetodos/BuscarVeiculo |
---|---|
Método | POST |
Descrição | Endpoint responsável por retornar as informações do veículo consultado. |
Observação | Neste endPoint é necessário verificar o código de erro retornado na propriedade Resposta.Erro. Quando retornado diferente de 0 houve erros. |
Request | { "Empresa": 0, "Revenda": 0, "Placa": "string", "Chassi": "string" } |
Response |
Gerar ordem de serviço por tipo
Rota | v2?function=/Oficina/CheckinOficinaMetodos/GerarOSPorTipo |
---|---|
Método | POST |
Descrição | Endpoint responsável por gerar ordens de serviço por tipo. |
Observação | - |
Request | { "Empresa": 0, "Revenda": 0, "UsuarioLogado": 0, "Cliente": 0, "Contato": 0, "Modelo": "string", //Somente números. "Kilometragem": "string", "Chassi": "string", //Somente números. "NroPrisma": "string", "CorPrisma": "string", "DataEmissao": "2022-04-04T20:13:41.393Z", "HoraEmissao": "2022-04-04T20:13:41.393Z", "HoraConclusao": "2022-04-04T20:13:41.393Z", //Data prevista. "DataConclusao": "2022-04-04T20:13:41.393Z", "HoraInicioServico": "2022-04-04T20:13:41.393Z", "DataInicioServico": "2022-04-04T20:13:41.393Z", //0 -> Vazio 1 -> 1/4 2 -> 1/2 3 -> 3/4 4 -> Cheio 5 -> 1/8 6 -> 3/8 7 -> 5/8 8 -> 7/8 "NivelCombustivel": 0, "CategoriaOSExt": "string", "CategoriaOSInt": "string", "CategoriaOSGar": "string", "CategoriaOSRev": "string", //Identificador do motivo - somente números "MotivoAtendimento": "string", "ResponsavelVeiculo": "string", "Observacao": "string", "Perguntas": { //S/N - Caso cliente tenha contrato de manutenção, enviar "S" para liberar abertura de OS "PerguntaLiberadoContratoManutencao": "string", //S/N - Caso UsuarioLogado não tenha permissão 143, enviar "S" para liberar abertura de OS "PerguntaAutorizacaoAtendimento": "string", //S/N - Caso Pârametro "Utiliza Industrializacao" esteja marcado no sistema, enviar "S" para liberar abertura de OS "PerguntaMecanicoUsuario": "string", //S/N - Caso queira enviar SMS para cliente "PerguntaGeraContato": "string" }, "CodigoAgenda": 0, "ServicoExterno": "string", "ServicoInterno": "string", "ServicoGarantia": "string", "TipoTransacaoExterna": "string", "TipoTransacaoInterna": "string", "TipoTransacaoGarantia": "string", "NrosOSGar": [ "string" ] } |
Response |
Gerar ordem de serviço única
Rota | v2?function=/Oficina/CheckinOficinaMetodos/GerarOSUnica |
---|---|
Método | POST |
Descrição | Endpoint responsável por gerar uma ordem de serviço única. |
Observação | - |
Request | { "Empresa": 0, "Revenda": 0, "UsuarioLogado": 0, "Cliente": 0, "Contato": 0, "Modelo": "string", //Somente números. "Kilometragem": "string", "Chassi": "string", //Somente números. "NroPrisma": "string", "CorPrisma": "string", "DataEmissao": "2022-04-04T20:13:41.393Z", "HoraEmissao": "2022-04-04T20:13:41.393Z", "HoraConclusao": "2022-04-04T20:13:41.393Z", //Data prevista. "DataConclusao": "2022-04-04T20:13:41.393Z", "HoraInicioServico": "2022-04-04T20:13:41.393Z", "DataInicioServico": "2022-04-04T20:13:41.393Z", //0 -> Vazio 1 -> 1/4 2 -> 1/2 3 -> 3/4 4 -> Cheio 5 -> 1/8 6 -> 3/8 7 -> 5/8 8 -> 7/8 "NivelCombustivel": 0, "CategoriaOS": "string", //Identificador do motivo - somente números "MotivoAtendimento": "string", "ResponsavelVeiculo": "string", "Observacao": "string", "Perguntas": { //S/N - Caso cliente tenha contrato de manutenção, enviar "S" para liberar abertura de OS "PerguntaLiberadoContratoManutencao": "string", //S/N - Caso UsuarioLogado não tenha permissão 143, enviar "S" para liberar abertura de OS "PerguntaAutorizacaoAtendimento": "string", //S/N - Caso Pârametro "Utiliza Industrializacao" esteja marcado no sistema, enviar "S" para liberar abertura de OS "PerguntaMecanicoUsuario": "string", //S/N - Caso queira enviar SMS para cliente "PerguntaGeraContato": "string" }, "CodigoAgenda": 0, "ServicoExterno": "string", "ServicoInterno": "string", "ServicoGarantia": "string", "TipoTransacaoExterna": "string", "TipoTransacaoInterna": "string", "TipoTransacaoGarantia": "string", "NrosOSGar": [ "string" ] } |
Response |
Inserir peça na ordem de serviço
Rota | v2?function=/Oficina/OrdemServico/MntOrdemServico/IncluiPecaOS |
---|---|
Método | POST |
Descrição | Endpoint responsável por inserir uma peça na ordem de serviço. |
Observação | - |
Request | { "dadosDoItem": { "ItemEstoque": 9999999, "Quantidade": 0, "ValorUnitario": 0, "Desconto": 0, "DescontoLinxPromo": 0, "ContadorItem": 0, "CodigoItemPedidoCompra": 0, "OrdemCompraCliente": "string", "NroSolicitacao": 0, "Kit": 0, "KitEditavel": "string", "PermitirItemCoringa": true, "ItemCoringa": "string", "Aprovacao": 0 }, "dadosOrigem": { "configuracaoOrigem": { "Empresa": 1, "Revenda": 1, "Usuario": 99999, "CodigoOrigem": 0 }, "parametrosSelecao": { "Empresa": 0, "Revenda": 0, "Contato": 0, "Solicitacao": 99999, "OrdemServico": 0, "OrdemCompra": 0, "CodigoKit": 99999, "CodigoServico": 0, "Pedido": "string", "Promocao": 0, "Cotacao": 0, "NumeroNotaFiscal": 0, "SerieNotaFiscal": "string", "TipoTransacao": "string", "Contador": 0 } }, "detalhesDesconto": { "descontoPercentual": 0, "descontoPercentualLinxPromo": 0, "descontoPercentualTotal": 0, "valorTotal": 0, "rentabilidadePercentual": 0, "custoUnitario": 0, "impostos": { "Ipi": { "Valor": 0, "Aliquota": 0, "Base": 0 }, "PisCofins": { "Valor": 0, "Aliquota": 0, "Base": 0 }, "IcmsRetido": { "Valor": 0, "Aliquota": 0, "Base": 0 }, "Icms": { "Valor": 0, "Aliquota": 0, "Base": 0 }, "ValorIcmsComoDesconto": 0, "ValorIcmsOperacaoPropria": 0, "ValorImpostoGlobal": 0, "criterioBaseIPI": 0 }, "Mensagem": "string", "FuncaoAprovacao": 0, "UsuarioAprovador": 0, "LinxPromoOpcao": { "Sugestoes": [ { "Sugestao": "string" } ], "Opcoes": [ { "Opcao": 0, "Sequencia": 0, "MapVersion": "string", "QuantidadeSolicitada": 0, "ValUnitario": 0, "IdLog": 0, "Beneficios": [ { "Promocao": "string", "TipoBeneficio": "string", "Mensagem": "string", "Beneficio": "string", "Quantidade": 0, "Percentual": 0, "Valor": 0, "Sequencia": 0 } ] } ], "OpcaoSelecionada": { "Opcao": 0, "Sequencia": 0, "MapVersion": "string", "QuantidadeSolicitada": 0, "ValUnitario": 0, "IdLog": 0, "Beneficios": [ { "Promocao": "string", "TipoBeneficio": "string", "Mensagem": "string", "Beneficio": "string", "Quantidade": 0, "Percentual": 0, "Valor": 0, "Sequencia": 0 } ] }, "OpcaoSelecionadaAtendimento": 0 } }, "exibirDescontoEValor": true, "permiteEditarValorDesconto": true, "exibirOrdemDeCompra": true, "valorizacao": "string", "contato": 9999999999, "PoliticaDePreco": 0, "QuantidadeInteira": true, "ValorUnitarioInicial": 0, "Mecanico": 9999999, "MensagemDialog": "string", "ItemNotaEntrada": { "QuantidadeUtilizada": 0, "EncontrouNotaEntrada": true, "ValorTotalItem": 0, "Empresa": 0, "Revenda": 0, "ItemEstoque": 0, "ItemEstoquePublico": "string", "DataHoraEntradaSaida": "2023-08-09T13:28:21.953Z", "OperacaoEntradaSaida": "string", "TipoOperacao": "string", "DataHoraDocumento": "2023-08-09T13:28:21.953Z", "NumeroNotaFiscal": 0, "SerieNotaFiscal": "string", "TipoTransacao": "string", "Contador": 0, "OrdemItemNf": 0, "CodigoFci": "string", "NfeChaveAcesso": "string", "AliquotaIcms": 0, "AliquotaIcmsRetido": 0, "CodigoTributacaoItem": 0, "CodigoFiscalOperacao": 0, "QuantidadeNota": 0, "QuantidadeSaldo": 0, "Status": "string" }, "QuantidadePrimeiroItemBiTributacao": 0, "AlteracaoQtdBitributacaoComInclusaoNovosItens": true, "DiferencaAlteracaoQtdBitributacao": 0 } |
Response |
Inserir serviço na ordem de serviço
Rota | v2?function=/Oficina/OrdemServico/MntOrdemServico/IncluiServicoOS |
---|---|
Método | POST |
Descrição | Endpoint responsável por inserir um serviço na ordem de serviço. |
Observação | - |
Request | { "Usuario": 99999, "Empresa": 999999, "Revenda": 99, "Contato": 9999999999, "NroSolicitacao": 99999, "NroLancamento": 99999, "NroOs": 9999999, "Kit": 99999, "Servico": 9999999, "Quantidade": 9999999.99, "MaoDeObra": "string", "Descricao": "string", "ValUnitario": 99999999999.99, "ValDesconto": 99999999999.99, "ValDescontoFranquia": 0, "ValDescontoLinxPromo": 0, "PerDescontoLinxPromo": 0, "IdCesta": 0, "Mecanico": 9999999, "DesMecanico": "string", "ValDescontoIrrf": 0, "ValPcc": 0, "ValIssRetido": 0, "ValInssRetido": 0, "LinxPromoOpcao": { "Sugestoes": [ { "Sugestao": "string" } ], "Opcoes": [ { "Opcao": 0, "Sequencia": 0, "MapVersion": "string", "QuantidadeSolicitada": 0, "ValUnitario": 0, "IdLog": 0, "Beneficios": [ { "Promocao": "string", "TipoBeneficio": "string", "Mensagem": "string", "Beneficio": "string", "Quantidade": 0, "Percentual": 0, "Valor": 0, "Sequencia": 0 } ] } ], "OpcaoSelecionada": { "Opcao": 0, "Sequencia": 0, "MapVersion": "string", "QuantidadeSolicitada": 0, "ValUnitario": 0, "IdLog": 0, "Beneficios": [ { "Promocao": "string", "TipoBeneficio": "string", "Mensagem": "string", "Beneficio": "string", "Quantidade": 0, "Percentual": 0, "Valor": 0, "Sequencia": 0 } ] }, "OpcaoSelecionadaAtendimento": 0 } } |
Response |
Inserir solicitação na ordem de serviço
Rota | v2?function=/Oficina/Solicitacao/IncluiSolicitacaoOS |
---|---|
Método | POST |
Descrição | Endpoint responsável por incluir uma solicitação na ordem de serviço |
Observação | Retorna o número da solicitação. |
Request | { "Empresa": 999999, "Revenda": 99, "Contato": 9999999999, "NroSolicitacao": 99999, "NroOrcamento": 9999999999, "DesSolicitacao": "string", "Situacao": 9, "TipoServicoOs": "string", "TipoServico": "str", "Problema": 0, "DtaProvavel": "2023-08-09T13:39:35.552Z", "ProximaPeca": 0, "ProximoServico": 0, "InformadaAtendimento": "string", "DesDiagnostico": "string", "PoliticaPrecoPeca": 0, "ReclamacaoGwm": "st", "CodCccReclamacao": "s", "CategoriaServico": 0, "SecaoOficina": 0, "ItemChecklist": "string", "MotivoCancelamento": 3, "ContadorCupomFiscal": 0, "NumeroCoo": 0, "QuandoOcorrem": "string", "OndeOcorrem": "string", "FreqOcorrem": "string", "HistVeiculo": "string", "TipoSolicitacaoMontadora": "string", "AssistTecnica1": 0, "AssistTecnica2": 0, "AssistTecnica3": 0, "AssistTecnica4": 0, "AssistTecnica5": 0, "ItemEstoqueCausador1": 0, "ItemEstoqueCausador2": 0, "ItemEstoqueCausador3": 0, "ItemEstoqueCausador4": 0, "ItemEstoqueCausador5": 0, "CodFalha": 0, "CausadorProblema": "string", "TipoServicoOsAnterior": "string", "AtualizadoElsaIls": "string", "NumeroCooDav": 0, "ImprimuOs": "string", "DtaInclusao": "2023-08-09T13:39:35.552Z", "DesCancelamento": "string", "IdVwbCorServico": 999999, "CodBarras": "string", "MbbServiceMeasure": "string", "RenaultEdr": "strin", "TipoRevisaoServico": 0, "GarRecallFca": "string", "ConfirmadoCliente": "string", "Pesquisar": "string", "RevisaoExpressa": "string", "ReclameClienteRenault": "string", "DtaExclusao": "2023-08-09T13:39:35.552Z", "StatusReparoPend": "string", "DesSolicitacaoDetalhada": "string", "Utilizado": "string", "SolicAgendado": "string", "TipoBarulho": "string", "TipoPiso": "string", "PsaFfTipo": 0, "PoliticaPrecoServico": 0, "MotivoRetrabalho": 0, "SolicitacaoAprovada": "string", "NovoDefeito": "string", "DesNovoDefeito": "string", "Mecanico": 0, "FordBlocoServTransf": "string", "FordTipoServTransf": "string", "ServiceCodAgenda": "string", "PriceStf": 0, "BloquearTipoSolicitacao": "string" } |
Response |
Lançar CDT / Lançar apontamento de horas trabalhada
Rota | v2?function=/Oficina/LancamentoCDT/LancarCDT |
---|---|
Método | POST |
Descrição | Endpoint responsável por realizar o lançamento de CDT. |
Observação | Caso não retorne nenhuma string o lançamento ocorreu com sucesso. |
Request | { "Empresa": 0, "Revenda": 0, "Lancamentos": [ { "CodigoMecanico": 0, "DataProcessamento": "string", "NroOs": 0, "NroLancamento": 0, "DataInicioCDT": "2022-04-04T20:03:12.921Z", "DataFimCDT": "2022-04-04T20:03:12.921Z", "CodigoUsuario": 0, "ManterAberto": true, //Somente números. "Motivo": "string" } ] } |
Response |
Manter dados do check-in
Rota | v2?function=/Oficina/CheckinOficinaMetodos/ManterCheckinApollo |
---|---|
Método | POST |
Descrição | Endpoint responsável por incluir ou alterar os dados do check-in. |
Observação | Neste endPoint é necessário verificar o código de erro retornado na propriedade Resposta.Erro. Quando retornado diferente de 0 houve erros. |
Request | { "Empresa": 0, "Revenda": 0, "CodigoUsuario": "110", "CodigoAgenda": "string", //Obrigatório no modo I "CodigoConsultor": "632645", //I -> Inserir A -> Alterar "Modo": "I", "Checkin": { "CodigoCheckin": 9999999999, "CodigoTipoVeiculo": 999999999999, "PlacaVeiculo": "string", "Veiculo": "string", "Proprietario": "string", "CodigoConsultor": "string", "NomeConsultor": "string", //0 -> Vazio 1 -> 1/4 2 -> 1/2 3 -> 3/4 4 -> Cheio 5 -> 1/8 6 -> 3/8 7 -> 5/8 8 -> 7/8 "NivelCombustivel": 0, "Quilometragem": 99999999, "NumeroPrisma": 999, "CorPrisma": "string", "DataHora": "string", "Solicitacoes": [ { "CodigoSolicitacao": 0, "DescricaoSolicitacao": "string", "CodigoTipoServico": "string", "ValorTotal": "string", "Excluida": true, "Editavel": true, "Itens": [ { "CodigoItem": "string", "DescricaoItem": "string", //PCA -> Peça SRV -> Serviço "TipoItem": "SRV", //Valor separado por . "ValorUnitario": "0.00", //Valor separado por . "QuantidadeItem": "0.00", "TotalItem": "string", "CodigoPacote": "strin", "NroLancamento": 99999 } ], "CodigoSolicitacaoOrigem": 99999 } ], "Observacao": "string", "CodigosItemChecklist": [ "string" ], "CodigosItemChecklistCategoria": [ { "CodigoCategoria": 0, "Categoria": "string", "Itens": [ { "CodigoItemChecklist": 99999, "Ok": true, "Reparar": true, "Observacao": "string", "DescricaoItem": "string" } ] } ], "Evidencias": [ { "IdItemCheckin": "string", "SequenciaEvidencia": 0, "Observacao": "string", "CodigoParteVeiculo": 0, "CaminhoFoto": "string" } ], "JsonEvidencia": "string", "VeiculoCliente": { "NomeCliente": "string", "CodigoCliente": 0, "Chassi": "string", "AnoFabricacao": 0, "AnoModelo": 0, "DataVenda": "string", "DataUltServico": "string", "TipoRevisao": "string", "DescricaoUltimoServico": "string", "CodigoModelo": "string", "DescricaoModelo": "string", "Quilometragem": 0, "Placa": "string", "CorExterna": "string", "TipoCombustivel": "string" } } } |
Response |
Manter dados do cliente
Rota | v2?function=/Oficina/CheckinOficinaMetodos/ManterDadosCliente |
---|---|
Método | POST |
Descrição | Endpoint responsável por incluir ou alterar os dados do cliente. |
Observação | Neste endPoint é necessário verificar o código de erro retornado na propriedade Resposta.Erro. Quando retornado diferente de 0 houve erros. |
Request | { "Empresa": 0, "Revenda": 0, //I -> Inserir A -> Alterar "Modo": "string", "CodigoUsuario": 0, "Cliente": { "CodigoCliente": 0, "NomeCliente": "string", "DDDTelefone": "string", "Telefone": "string", "DDDCelular": "string", "Celular": "string", "Email": "string", "Endereco": "string", "Complemento": "string", "Cidade": "string", //UF "Estado": "string", "Cep": "string", //dd/MM/yyyy "DataNascimento": "string", "Bairro": "string", //1 -> Telefone 2 -> E-mail 3 -> SMS 4 -> WhatsApp "FormaContato": 0, //CNPJ/CPF "Cgccpf": "string", //F -> Pessoa Física J -> Pessoa Jurídica "Tppessoa": "string", "TipoVia": "string" } } |
Response |
Manter dados do veículo
Rota | v2?function=/Oficina/CheckinOficinaMetodos/ManterDadosVeiculo |
---|---|
Método | POST |
Descrição | Endpoint responsável por incluir ou alterar os dados do veículo. |
Observação | Neste endPoint é necessário verificar o código de erro retornado na propriedade Resposta.Erro. Quando retornado diferente de 0 houve erros. |
Request | { "Empresa": 999999, "Revenda": 99, //I -> Inserir A -> Alterar "Modo": "I", "Veiculo": { "NomeCliente": "string", "CodigoCliente": 99999999, "Chassi": "string", "AnoFabricacao": 9999, "AnoModelo": 9999, "DataVenda": "2023-08-09T13:48:13.017Z", "DataPrimeiraVenda": "2023-08-09T13:48:13.017Z", "DataUltServico": "string", "TipoRevisao": "string", "DescricaoUltServico": "string", "CodigoModelo": "string", "DescricaoModelo": "string", "Quilometragem": 99999999, "Placa": "string", //Código da cor do veículo "CorExterna": "string", //A -> Alcool B -> Bi-Combustível D -> Diesel G -> Gasolina O -> Outros S -> Gás T -> Tri-Combustível "TipoCombustivel": "T" }, "CodigoUsuario": "string" } |
Response |
Busca de orçamentos não autorizados pelo cliente
Rota | Oficina/Orcamento/ConsultaOrcamentosAbertosCliente/{empresa}/{revenda}/{contato}/{idcliente} |
---|---|
Método | GET |
Descrição | Busca os orçamentos abertos que ainda não tiveram aprovação do cliente |
Observação | É obrigatório enviar o idcliente ou contato. Empresa/revenda é obrigatório ao enviar contato. Empresa/revenda não é obrigatório ao informar idcliente, porém, caso seja informado, os orçamentos serão filtrados pela empresa/revenda informado. Parâmetros não informados devem ser enviados valor <= 0. |
Request | - |
Response |
Busca de orçamentos não autorizados pelo cliente
Rota | /Parcerias/ConsultaOrcamentosAbertosCliente/{empresa}/{revenda}/{contato}/{idcliente} |
---|---|
Método | GET |
Descrição | Busca os orçamentos abertos que ainda não tiveram aprovação do cliente |
Observação | O método é o mesmo que o Oficina/Orcamento/ConsultaOrcamentosAbertosCliente, porém retorna menos dados. É obrigatório enviar o idcliente ou contato. Empresa/revenda é obrigatório ao enviar contato. Empresa/revenda não é obrigatório ao informar idcliente, porém, caso seja informado, os orçamentos serão filtrados pela empresa/revenda informado. Parâmetros não informados devem ser enviados valor <= 0. |
Request | - |
Response |
Grava aprovação total do cliente no orçamento
Rota | /Oficina/Orcamento/GravaAprovacaoClienteTotal |
---|---|
Método | POST |
Descrição | Grava aprovação total de peças e serviços do orçamento por parte do cliente. |
Observação | Uma vez que a aprovação/reprovação do cliente for gravada, não será permitido gravar novamente, seja aprovação total, parcial ou reprovação. Caso tudo ocorra normalmente, a resposta será sempre "Aprovação gravada com sucesso." |
Request | { "Empresa": 0, "Revenda": 0, "Contato": 0, "NroOrcamento": 0 } |
Response |
Grava reprovação total do cliente no orçamento
Rota | /Oficina/Orcamento/GravaAprovacaoClienteReprovada |
---|---|
Método | POST |
Descrição | Grava reprovação total de peças e serviços do orçamento por parte do cliente. |
Observação | Uma vez que a aprovação/reprovação do cliente for gravada, não será permitido gravar novamente, seja aprovação total, parcial ou reprovação. Caso tudo ocorra normalmente, a resposta será sempre "Aprovação gravada com sucesso." |
Request | { "Empresa": 0, "Revenda": 0, "Contato": 0, "NroOrcamento": 0 } |
Response |
Grava aprovação parcial do cliente no orçamento
Rota | /Oficina/Orcamento/GravaAprovacaoClienteParcial |
---|---|
Método | POST |
Descrição | Grava aprovação parcial de peças e serviços do orçamento por parte do cliente. |
Observação | Somente deverão ser enviados as peças/serviços que o cliente deseja aprovar. As peças/serviços que não forem enviadas serão gravadas como reprovadas. Caso nenhuma peça/serviço seja enviada, será gravado como Reprovação Total. Caso todas as peças/serviços sejam enviadas, será gravado como Aprovação Total. Uma vez que a aprovação/reprovação do cliente for gravada, não será permitido gravar novamente, seja aprovação total, parcial ou reprovação. Caso tudo ocorra normalmente, a resposta será sempre "Aprovação gravada com sucesso." |
Request | { "Empresa": 0, "Revenda": 0, "Contato": 0, "NroOrcamento": 0, "Pecas": [ { "Referencia": 0, "NroSolicitacao": 0, "NroLancamento": 0 } ], "Servicos": [ { "Referencia": 0, "NroSolicitacao": 0, "NroLancamento": 0 } ] } |
Response |
Veículo
Consulta combustíveis
Rota | v2?function=/Veiculos/Cadastros/ManutencaoDeCombustiveis/ObterLista |
---|---|
Método | GET |
Descrição | Endpoint responsável por retornar uma lista com os combustíveis cadastrados. |
Observação | - |
Request | - |
Response |
Consulta cores
Rota | v2?function=/Veiculo/Cores/{Empresa} |
---|---|
Método | GET |
Descrição | Endpoint responsável por retornar uma lista com as cores de veículo da empresa consultada. |
Observação | - |
Request | - |
Response |
Consulta família de veículo
Rota | v2?function=/Veiculo/Familia/Obter/{Empresa}/{Familia} |
---|---|
Método | GET |
Descrição | Endpoint responsável por retornar a família de veículo da empresa consultada. |
Observação | - |
Request | - |
Response |
Consulta famílias de veículos
Rota | v2?function=/Veiculo/Familia/ObterLista/{Empresa} |
---|---|
Método | GET |
Descrição | Endpoint responsável por retornar uma lista com as famílias de veículo da empresa consultada. |
Observação | - |
Request | - |
Response |
Consulta modelo de veículos
Rota | v2?function=/Veiculo/Modelo/{Empresa}/{Modelo} |
---|---|
Método | GET |
Descrição | Endpoint responsável por retornar o modelo de veículo da empresa consultada. |
Observação | - |
Request | - |
Response |
Consulta modelos de veículos
Rota | v2?function=/Veiculo/Modelo/Lista/{Empresa}/{Modelo?} |
---|---|
Método | GET |
Descrição | Endpoint responsável por retornar uma lista com os modelos de veículos da empresa consultada. |
Observação | Na rota, o Modelo? representa que não é obrigatório enviar o código do modelo para consulta. |
Request | - |
Response |