API de Integração V1

Integre seu sistema com a plataforma Machine de maneira simples, segura e eficaz. Este guia contém tudo o que você precisa para começar sua jornada conosco.

Quem Somos

A Machine é um produto Gaudium, projetado para fornecer tecnologia que permite a operação eficiente e segura das centrais de mobilidade urbana e entregas. Fornecemos as ferramentas para que condutores realizem serviços com excelência.

Evolução Constante

Nossa plataforma está em constante evolução. Recomendamos acompanhar nossos informes e o changelog para se manter atualizado sobre as novas funcionalidades e melhorias na integração.

Tipos de Solicitações e Pagamento

As solicitações podem ser feitas de imediato ou programadas para o futuro, cada uma identificada por números diferentes. Após o disparo de uma solicitação programada, uma nova solicitação é criada no sistema.

Formas de Pagamento Suportadas

Todas as solicitações estão associadas a uma forma de pagamento. As opções incluem:

As solicitações podem ter vários objetivos, dependendo do modelo de negócio e do tipo de cliente:

Passageiro

Levar uma pessoa para o destino solicitado.

Empresa

Transportar o funcionário de uma organização.

Estabelecimento

Levar o hóspede de um hotel para o destino.

Agentes das Solicitações e Estimativas

Os principais agentes das solicitações são os condutores (motoristas, mototaxistas e taxistas). Para otimizar seu negócio, é possível criar categorias e associar os condutores a elas, como uma categoria específica para carregar compras.Antes da solicitação, o cliente pode obter uma estimativa de custo, que é sempre feita por categoria. Cada categoria tem suas tarifas definidas pela central.

Ciclo de Vida das Solicitações

As solicitações passam por várias etapas e subetapas. Os registros de solicitação não alteram o status da solicitação. Segue a estrutura correta do ciclo:

Solicitações Programadas

Solicitações aceitas e canceladas por um condutor antes do início podem ser redistribuídas, ocasionando a repetição de alguns status. Solicitações programadas seguem um ciclo específico de estados:

Primeiros passos

Explore a tab “Referência” para obter mais informações sobre como se conectar à API e testar os endpoints.

Pronto! Agora você está preparado para explorar a nossa integração para que, juntos, possamos crescer ainda mais.