Changelog

Acompanhe todas as alterações na documentação da API de corridas da Machine.

VERSÃ0 1.6 - 16/01/2025

1. Alterado comportamento dos saques no endpoint /sacarCreditosCondutor. Agora é permitido realizar saques que excedem o saldo disponível na carteira.

VERSÃ0 1.5 - 08/01/2025

1. Adição de endpoints: 

   1. Adicionado inclusão de dados dos usuários administradores de empresas no endpoint /empresa. Agora, os campos nome e e-mail dos administradores estarão disponíveis.

      1. No entanto, caso o usuário autenticado na API seja uma empresa e não possua permissão para gerenciar usuários, esses dados não serão exibidos.
         

   2. Adicionado novo endpoint /atualizarCondutores, que permite a atualização em massa de condutores.

      1. Nesse primeiro momento, ao informar os condutores, somente será possível atualizar as áreas de bloqueio dos condutores. Além disso, foi adicionado o endpoint /listarAreas, que permite consultar as áreas disponíveis para a central.
         

   3. Adicionado o CPF na resposta do endpoint /cliente.

VERSÃ0 1.5 - 19/09/2024

1. Adição de endpoints:

   1. Adicionado "dados extras" no retorno do endpoint /empresa

      1. Somente pode ser visualizado pela central
         

   2. Adicionado informações da partida no retorno do endpoint /solicitacao

      1. endereço

      2. complemento

      3. referência

      4. bairro

      5. cidade

      6. estado

      7. latitude

      8. longitude
         

   3. Adicionado o "id" da parada e "link de rastreio do pedido" para o campo "paradas" do endpoint /solicitacao

VERSÃO 1.4 - 04/09/2024

1. Adição de endoints:

   1. Adicionado endpoint /listarWebhook para disponibilizar dados sobre os webhooks cadastrados.

   2. Adicionado endpoint /atualizarWebhook para atualizar a URL de algum webhook.

   3. Adicionado endpoint /deletarWebhook para excluir um webhook do sistema.

Observação:

Central pode visualizar dados dos webhooks de suas empresas, bem como atualizá-los ou deletá-los.

VERSÃO 1.3 - 28/08/2024

1. Alteração nos retornos das requisições

   
   

   1. Adicionado condutor_id no retorno do endpoint /posicaoCondutor

VERSÃO 1.2 - 17/07/2024

1. Adição de endpoints
   

   1. Adicionado endpoint /cadastrarEmpresa para realizar o cadastro de empresas

   2. Adicionando o endpoint /atualizarEmpresas para realizar a atualização em massa de empresas
      

2. Alteração no retorno das requisições
   

   1. Adicionado as informações da empresa no endpoint /consultarProgramada

VERSÃO 1.1 - 10/07/2024

Foram feitas refatorações visando melhorias e padronização na comunicação da Machine com seus clientes, além da correção de alguns bugs. Reforçamos que, após a descontinuação das informações antigas, se não houver atualização para a nova nomenclatura, o seu sistema poderá apresentar falhas.

🔍 As centrais terão até 30 dias para se regularizarem de acordo com os novos padrões.

1.  Endpoints que utilizam a nomenclatura Taxista será alterada para Condutor
   

   1. /atualizarTaxista alterado para /atualizarCondutor

   2. /taxista alterado para /condutor

   3. /documentoTaxista alterado para /documentoCondutor

   4. /obterDocumentosCadastroTaxista alterado para

   5. /obterDocumentosCadastroCondutor

   6. /obterDocumentosTaxista alterado para /obterDocumentosCondutor

   7. /posicaoMotorista alterado para /posicaoCondutor
      

2. As nomenclaturas de corrida foram alteradas para solicitacao

   1. /estimarCorrida alterado para /estimarSolicitacao

   2. /estimarCorrida2 alterado para /estimarSolicitacaoMulticategorias

   3. /abrirCorrida alterado para /abrirSolicitacao
      

3. Alterações nos parâmetros das requisições

   1. Nas endpoints /empresa, /funcionario e /centroDeCusto foram acrescidas paginação, seguindo o formato de padrão com os parâmetros limite e pagina.

   2. Na endpoint /categoria foram removidos os trechos '_partida' de todos os parâmetros Exemplo anterior: /categoria? lat_partida=-23.550520&lng_partida=-46.633308&cidade_partida=São%20Paulo&endereco_partida=Avenida%20Paulista&bairro_partida=Bela%20Vista&estado_partida=SP Exemplo atual: /categoria?lat=-23.550520&lng=-46.633308&cidade=São%20Paulo&endereco=Avenida%20Paulista&bairro=Bela%20Vista&estado=SP
      

   3. Na endpoint /solicitacao o parâmetro taxista_id passou a se chamar condutor_id e o parâmetro id passou a ser id_mch

   4. Na endpoint /atualizarTaxista (refatorada para /atualizarCondutor), o parâmetro status_taxista passou a ser status_condutor

   5. Na endpoint /taxista (refatorada para /condutor), o parâmetro status_taxista passou a ser status_condutor
      

4. Alterações nos retornos das requisições

   1. No retorno da endpoint /solicitacao foram acrescidos os retornos: condutor_id, nome_condutor e telefone_condutor. Serão deprecados os retornos: taxista_id, nome_taxista e telefone_taxista

   2. Na endpoint /posicaoCondutor foram acrescidos os retornos: lat_condutor e lng_condutor, serão deprecados os retornos lat_taxi e lng_taxi

   3. Na endpoint /recibo foram acrescidos os retornos condutor e dados_solicitacao, com as mesmas informações de motorista e corrida, esses últimos, serão deprecados.

   4. Na endpoint /consultarCorridas foi acrescido o retorno condutor com os mesmos dados de motorista. Esse último, será deprecado.
      

5. Refatorações no retorno do webhook

   1. No webhook de posição foi acrescentado os dados lat_cond, lng_cond e condutor_id. Os dados lat_taxi, lng_taxi e taxista_id serão deprecados.

   2. No webhook de status da solicitação foi acrescido o dados condutor com as mesmas informações de motorista. Esse último, será deprecado