← InicioFleetPay / API

Registrar aceptación explícita de la oferta de transporte por el conductor autorizado

Parámetros, estructura de datos y respuestas del contrato versionado.

POST/embarcador/solicitacoes-transporte/{id}/aceitar-oferta-motorista
aceitarOfertaMotoristaSolicitacaoTransporteBase de Pruebas: https://api.fleetpay.site/v1

Las descripciones técnicas se traducen del contrato versionado. Se conservan los identificadores y el JSON originales; se omiten los ejemplos de datos.

Registra la aceptación explícita de la oferta real (ShipperDriverOffer emitida y pendiente en la ronda activa) por el conductor destinatario autorizado (driver_user_id), delegando en la autoridad central DriverOfferRoundDistributionService::acceptOfferByDriver.

  • Exige offer_id obligatorio (OFFER_ID_REQUIRED) de una oferta real existente (OFFER_NOT_FOUND), ya enviada (OFFER_NOT_DISPATCHED), no retirada (OFFER_WITHDRAWN), vigente (OFFER_EXPIRED) y dirigida al conductor autenticado (OFFER_RECIPIENT_MISMATCH).
  • Exige conditions_version explícita (OFFER_CONDITIONS_VERSION_REQUIRED) idéntica a los términos presentados y vigentes (OFFER_CONDITIONS_VERSION_MISMATCH).
  • Valida representación formal activa (DriverProviderRepresentation / DriverRepresentationService), vehículo autorizado (DriverVehicleAuthorization), check-in diario en la fecha del servicio (DriverAvailability) y disponibilidad de la vacante (VACANCY_ALREADY_FILLED).

Autenticación

Permiso Requerido
operacao — Operación
Módulo
Contratación Directa (Embarcador)
Perfiles Aplicables
Embarcador · Gestor de Transporte · Agregado Empresarial
Mecanismos
OAuth2 client_credentials (POST /oauth/token) o API Key vía Authorization: Bearer / X-Api-Key
[
  {
    "oauth2": []
  },
  {
    "chaveApi": []
  }
]
La disponibilidad depende del entorno, los permisos habilitados y el proveedor. Esta referencia no ejecuta solicitudes ni recibe credenciales.

Parámetros

idpath · stringObligatorio
Restricciones
{
  "type": "string"
}

Cuerpo de la Solicitud

Obligatorio

application/json

offer_idintegerObligatorio

ID obligatorio de la oferta real (shipper_driver_offers.id) emitida y pendiente para el conductor autenticado.

conditions_versionintegerObligatorio

Versión obligatoria de las condiciones presentadas en la oferta y vigentes en la demanda (OFFER_CONDITIONS_VERSION_REQUIRED).

driver_user_idinteger | nullOpcional

ID del conductor autenticado (users.id). Debe coincidir con el usuario autenticado y destinatario de la oferta (OFFER_RECIPIENT_MISMATCH).

aggregated_carrier_company_idintegerObligatorio

ID de la empresa prestadora (companies.id / CNPJ) formalmente representada por el conductor en driver_provider_representations.

driver_representation_idinteger | nullOpcional

ID de la representación formal activa (driver_provider_representations.id).

vehicle_idinteger | nullOpcional

ID del vehículo autorizado para el conductor en driver_vehicle_authorizations.

vacancy_slot_numberinteger | nullOpcional

Número de la vacante operacional (shipper_operational_vacancies.slot_number).

work_unit_keystring | nullOpcional

Clave de la tarifa diaria/turno operacional.

Respuestas

200 Respuesta HTTP

Aceptación explícita del conductor registrada en shipper_driver_offers y shipper_operational_vacancies

application/json

successbooleanOpcional
commercial_resolutionobject | nullOpcional
403 Respuesta HTTP

El actor autenticado no corresponde al conductor destinatario (OFFER_RECIPIENT_MISMATCH) o no posee representación formal activa (DRIVER_REPRESENTATION_REQUIRED)

application/json

errorobjectOpcional
404 Respuesta HTTP

Solicitud no encontrada

application/json

errorobjectOpcional
422 Respuesta HTTP

Oferta ausente (OFFER_ID_REQUIRED), inexistente (OFFER_NOT_FOUND), no enviada (OFFER_NOT_DISPATCHED), retirada (OFFER_WITHDRAWN), expirada (OFFER_EXPIRED), versión omitida (OFFER_CONDITIONS_VERSION_REQUIRED) o divergente (OFFER_CONDITIONS_VERSION_MISMATCH), vacante cubierta (VACANCY_ALREADY_FILLED) o check-in ausente/de otra fecha (DAILY_CHECKIN_DATE_MISMATCH)

application/json

errorobjectOpcional
Definición Completa de la Operación
{
  "tags": [
    "Solicitações e Contratação de Transporte (Embarcador)"
  ],
  "summary": "Registrar aceite explícito da oferta de transporte pelo motorista autorizado",
  "description": "Registra o aceite explícito da oferta real (`ShipperDriverOffer` emitida e pendente na rodada ativa) pelo motorista destinatário autorizado (`driver_user_id`), delegando à autoridade central `DriverOfferRoundDistributionService::acceptOfferByDriver`.\n- Exige `offer_id` obrigatório (`OFFER_ID_REQUIRED`) referenciando uma oferta real existente (`OFFER_NOT_FOUND`), já enviada (`OFFER_NOT_DISPATCHED`), não retirada (`OFFER_WITHDRAWN`), dentro do prazo (`OFFER_EXPIRED`) e destinada ao motorista autenticado (`OFFER_RECIPIENT_MISMATCH`).\n- Exige `conditions_version` explícita (`OFFER_CONDITIONS_VERSION_REQUIRED`) idêntica aos termos apresentados na oferta e vigentes na demanda (`OFFER_CONDITIONS_VERSION_MISMATCH`).\n- Valida representação formal ativa (`DriverProviderRepresentation` / `DriverRepresentationService`), veículo autorizado (`DriverVehicleAuthorization`), check-in diário na data do serviço (`DriverAvailability`) e disponibilidade da vaga (`VACANCY_ALREADY_FILLED`).\n",
  "operationId": "aceitarOfertaMotoristaSolicitacaoTransporte",
  "parameters": [
    {
      "name": "id",
      "in": "path",
      "required": true,
      "schema": {
        "type": "string"
      }
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/AceitarOfertaMotoristaRequest"
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "Aceite explícito do motorista registrado em `shipper_driver_offers` e `shipper_operational_vacancies`",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/SolicitacaoTransporteResponse"
          }
        }
      }
    },
    "403": {
      "description": "Ator autenticado não corresponde ao motorista destinatário (`OFFER_RECIPIENT_MISMATCH`) ou não possui representação formal ativa (`DRIVER_REPRESENTATION_REQUIRED`)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Erro"
          }
        }
      }
    },
    "404": {
      "description": "Solicitação não encontrada",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Erro"
          }
        }
      }
    },
    "422": {
      "description": "Oferta ausente (`OFFER_ID_REQUIRED`), inexistente (`OFFER_NOT_FOUND`), não enviada (`OFFER_NOT_DISPATCHED`), retirada (`OFFER_WITHDRAWN`), expirada (`OFFER_EXPIRED`), versão de condições omitida (`OFFER_CONDITIONS_VERSION_REQUIRED`) ou divergente (`OFFER_CONDITIONS_VERSION_MISMATCH`), vaga já preenchida (`VACANCY_ALREADY_FILLED`) ou check-in diário ausente/de outra data (`DAILY_CHECKIN_DATE_MISMATCH`)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Erro"
          }
        }
      }
    }
  },
  "x-fleetpay-scope": "operacao",
  "x-fleetpay-module": "contratacao-direta",
  "x-fleetpay-profiles": [
    "embarcador",
    "gestor",
    "agregado_empresarial"
  ],
  "method": "POST",
  "path": "/embarcador/solicitacoes-transporte/{id}/aceitar-oferta-motorista"
}