idpath · stringObligatorioRestricciones
{
"type": "string"
}Parámetros, estructura de datos y respuestas del contrato versionado.
/embarcador/solicitacoes-transporte/{id}/aceitar-oferta-motoristaLas 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.
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).conditions_version explícita (OFFER_CONDITIONS_VERSION_REQUIRED) idéntica a los términos presentados y vigentes (OFFER_CONDITIONS_VERSION_MISMATCH).DriverProviderRepresentation / DriverRepresentationService), vehículo autorizado (DriverVehicleAuthorization), check-in diario en la fecha del servicio (DriverAvailability) y disponibilidad de la vacante (VACANCY_ALREADY_FILLED).operacao — Operación[
{
"oauth2": []
},
{
"chaveApi": []
}
]idpath · stringObligatorio{
"type": "string"
}Obligatorio
application/jsonoffer_idintegerObligatorioID obligatorio de la oferta real (shipper_driver_offers.id) emitida y pendiente para el conductor autenticado.
conditions_versionintegerObligatorioVersión obligatoria de las condiciones presentadas en la oferta y vigentes en la demanda (OFFER_CONDITIONS_VERSION_REQUIRED).
driver_user_idinteger | nullOpcionalID del conductor autenticado (users.id). Debe coincidir con el usuario autenticado y destinatario de la oferta (OFFER_RECIPIENT_MISMATCH).
aggregated_carrier_company_idintegerObligatorioID de la empresa prestadora (companies.id / CNPJ) formalmente representada por el conductor en driver_provider_representations.
driver_representation_idinteger | nullOpcionalID de la representación formal activa (driver_provider_representations.id).
vehicle_idinteger | nullOpcionalID del vehículo autorizado para el conductor en driver_vehicle_authorizations.
vacancy_slot_numberinteger | nullOpcionalNúmero de la vacante operacional (shipper_operational_vacancies.slot_number).
work_unit_keystring | nullOpcionalClave de la tarifa diaria/turno operacional.
200 Respuesta HTTPAceptación explícita del conductor registrada en shipper_driver_offers y shipper_operational_vacancies
application/jsonsuccessbooleanOpcionaldataobjectOpcionalcommercial_resolutionobject | nullOpcional403 Respuesta HTTPEl actor autenticado no corresponde al conductor destinatario (OFFER_RECIPIENT_MISMATCH) o no posee representación formal activa (DRIVER_REPRESENTATION_REQUIRED)
422 Respuesta HTTPOferta 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)
{
"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"
}