← HomeFleetPay / Schema

AceitarOfertaMotoristaRequest

Structure preserved from the versioned API contract.

Technical descriptions are translated from the versioned contract. Original identifiers and JSON are preserved; data examples are omitted.

offer_idintegerRequired

Mandatory ID of the real offer (shipper_driver_offers.id) issued and pending for the authenticated driver.

conditions_versionintegerRequired

Mandatory version of the terms presented in the offer and active in the demand (OFFER_CONDITIONS_VERSION_REQUIRED).

driver_user_idinteger | nullOptional

Authenticated driver ID (users.id). Must match the authenticated user and offer recipient (OFFER_RECIPIENT_MISMATCH).

aggregated_carrier_company_idintegerRequired

ID of the provider company (companies.id / CNPJ) formally represented by the driver in driver_provider_representations.

driver_representation_idinteger | nullOptional

ID of the active formal representation (driver_provider_representations.id).

vehicle_idinteger | nullOptional

ID of the authorized vehicle for the driver in driver_vehicle_authorizations.

vacancy_slot_numberinteger | nullOptional

Operational vacancy number (shipper_operational_vacancies.slot_number).

work_unit_keystring | nullOptional

Operational day-rate/shift key.

Original JSON Definition (Portuguese Descriptions)
{
  "type": "object",
  "required": [
    "offer_id",
    "conditions_version",
    "aggregated_carrier_company_id"
  ],
  "properties": {
    "offer_id": {
      "type": "integer",
      "description": "ID obrigatório da oferta real (`shipper_driver_offers.id`) emitida e pendente para o motorista autenticado."
    },
    "conditions_version": {
      "type": "integer",
      "description": "Versão obrigatória das condições apresentadas na oferta e vigentes na demanda (`OFFER_CONDITIONS_VERSION_REQUIRED`)."
    },
    "driver_user_id": {
      "type": [
        "integer",
        "null"
      ],
      "description": "ID do motorista autenticado (`users.id`). Deve coincidir com o usuário autenticado e destinatário da oferta (`OFFER_RECIPIENT_MISMATCH`)."
    },
    "aggregated_carrier_company_id": {
      "type": "integer",
      "description": "ID da empresa prestadora (`companies.id` / CNPJ) formalmente representada pelo motorista em `driver_provider_representations`."
    },
    "driver_representation_id": {
      "type": [
        "integer",
        "null"
      ],
      "description": "ID da representação formal ativa (`driver_provider_representations.id`)."
    },
    "vehicle_id": {
      "type": [
        "integer",
        "null"
      ],
      "description": "ID do veículo autorizado para o motorista em `driver_vehicle_authorizations`."
    },
    "vacancy_slot_number": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Número da vaga operacional (`shipper_operational_vacancies.slot_number`)."
    },
    "work_unit_key": {
      "type": [
        "string",
        "null"
      ],
      "description": "Chave da diária/turno operacional."
    }
  }
}