> ## Documentation Index
> Fetch the complete documentation index at: https://docs.machine.global/llms.txt
> Use this file to discover all available pages before exploring further.

# Obter solicitações

> Ao acionar, são retornadas todas as solicitações da central conforme os parâmetros informados.



## OpenAPI

````yaml pages/v1/openapi-corridas.json GET /solicitacao
openapi: 3.1.0
info:
  title: API de Integração
  description: API de Integração v1
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api-vendas.taximachine.com.br/api/integracao
  - url: https://api.taximachine.com.br/api/integracao
security:
  - basicAuth: []
    ApiKeyAuth: []
paths:
  /solicitacao:
    get:
      summary: Obter solicitações
      description: >-
        Ao acionar, são retornadas todas as solicitações da central conforme os
        parâmetros informados.
      parameters:
        - name: id_mch
          in: query
          description: >-
            ID da solicitação. Caso seja informado os outros parâmetros serão
            ignorados.
          schema:
            type: integer
        - name: status_solicitacao
          in: query
          description: >-
            Status da solicitação. Caso não seja informado, todos serão
            considerados. Valores possíveis: Distribuindo (D), Aguardando aceite
            (G), Pendente (P), Não atendida (N), Aceita (A), Arredores local
            (A), Cheguei ao local (C), Entrada do passageiro (E), Partida
            prolongada (O), Alteração de trajeto (T), Em espera (S), Em
            andamento (E), Parada confirmada (R), Finalizada (F), Cancelada (C),
            Aguardando pagamento (R).
          schema:
            type: string
            enum:
              - D
              - G
              - P
              - 'N'
              - A
              - C
              - E
              - O
              - T
              - S
              - R
              - F
        - name: condutor_id
          in: query
          description: >-
            ID do taxista que aceitou a solicitação. Caso não seja informado,
            todos serão considerados.
          schema:
            type: integer
        - name: cliente_id
          in: query
          description: >-
            ID do cliente que aceitou a solicitação. Caso não seja informado,
            todos serão considerados.
          schema:
            type: integer
        - name: tipo_pagamento
          in: query
          description: >-
            Tipo de pagamento selecionado pelo cliente. Caso não seja informado,
            todos serão considerado. Valores aceitos: Dinheiro (D), Débito
            (máquina) (B), Crédito máquina (C), eTicket (T), Voucher (V), Pix
            (X), Picpay (P), Whatsapp (H), Cartão via app (A), Faturado (F), Pix
            via app (I), Carteira de créditos (R).
          schema:
            type: string
            enum:
              - D
              - B
              - C
              - T
              - V
              - X
              - P
              - H
              - A
              - F
              - I
              - R
        - name: data_hora_solicitacao_min
          in: query
          description: >-
            Data/hora miníma da abertura da solicitação, intervalo máximo de 31
            dias em relação ao data_hora_max.
          schema:
            type: string
            format: date-time
        - name: data_hora_solicitacao_max
          in: query
          description: >-
            Data/hora máxima da abertura da solicitação, intervalo máximo de 31
            dias em relação ao data_hora_min.
          schema:
            type: string
            format: date-time
        - name: empresa_id
          in: query
          description: ID da empresa que aceitou a corrida.
          schema:
            type: integer
        - name: obter_filiais
          in: query
          description: >-
            Permite obter as corridas das filiais, apenas caso o usuário
            autenticado seja da matriz (1 para verdade 0 para falso).
          schema:
            type: integer
            enum:
              - 0
              - 1
        - name: limite
          in: query
          description: >-
            Quantidade de solicitações retornadas. O limite padrão é 20 e o
            máximo é 100.
          schema:
            type: integer
            default: 20
            maximum: 100
        - name: pagina
          in: query
          description: Qual início da contagem para o limite. O padrão é 1.
          schema:
            type: integer
            default: 1
      responses:
        '200':
          description: Sucesso
          content:
            application/json:
              schema:
                type: object
              example:
                success: true
                response:
                  - id: '100018001'
                    data_hora_solicitacao: '2024-05-02 08:53:42'
                    data_hora_chegada_local: null
                    status_solicitacao: 'N'
                    cliente_id: '83605'
                    nome_passageiro: Rogério Barreto
                    empresa_id: null
                    bandeira_chamada_id: '8'
                    data_hora_aceite: null
                    data_hora_finalizacao: null
                    data_hora_cancelamento: null
                    data_hora_pendencia: '2024-05-02 08:53:49'
                    distancia_coleta_km: null
                    valor_corrida: '7.00'
                    condutor_especificado: false
                    com_retorno: false
                    condutor_id: ''
                    nome_condutor: ''
                    telefone_condutor: ''
                    veiculo: ''
                    placa_veiculo: ''
                    cor_veiculo: null
                    duracao_corrida: '0'
                    distancia_percorrida_km: '0'
                    taxas_cancelamento: null
                    paradas: []
                  - id: '100018035'
                    data_hora_solicitacao: '2024-05-03 09:36:44'
                    data_hora_chegada_local: null
                    status_solicitacao: 'N'
                    cliente_id: '83316'
                    nome_passageiro: Maria Andreia
                    bandeira_chamada_id: '8'
                    data_hora_aceite: null
                    data_hora_finalizacao: null
                    data_hora_cancelamento: null
                    data_hora_pendencia: '2024-05-03 09:36:45'
                    distancia_coleta_km: null
                    valor_corrida: '10.50'
                    condutor_especificado: false
                    com_retorno: false
                    condutor_id: ''
                    nome_condutor: ''
                    telefone_condutor: ''
                    veiculo: ''
                    placa_veiculo: ''
                    cor_veiculo: null
                    duracao_corrida: '0'
                    distancia_percorrida_km: '0'
                    taxas_cancelamento: null
                    partida:
                      endereco: Rua Altaneira
                      complemento: null
                      referencia: null
                      bairro: Campo Grande
                      cidade: Rio de Janeiro
                      estado: RJ
                      lat: '-22.8743056'
                      lng: '-43.5626744'
                    paradas:
                      - id: '320'
                        endereco: Praia do Arpoador
                        complemento: ''
                        bairro: Arpoador
                        cidade: Rio de Janeiro
                        uf: RJ
                        lat: '-22.988420900610592'
                        lng: '-43.1934916318077'
                        ordem: 0
                        numero_pedido: '2'
                    link_acompanhamento_solicitacao: >-
                      https://link-acompanhamento-exemplo/solicitacao/acompanhar/OTU2MzE0ODIyOTM1MQ==
components:
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
    ApiKeyAuth:
      type: apiKey
      in: header
      name: api-key
      description: Obrigatório. Sua chave API.

````