idpath · stringObrigatórioRestrições
{
"type": "string"
}Parâmetros, estrutura de dados e respostas do contrato versionado.
/embarcador/solicitacoes-transporte/{id}/confirmar-atendimentoDescrições técnicas preservadas do contrato versionado. Exemplos de dados foram omitidos da cópia pública.
Separa o compromisso comercial de atendimento assumido pelo Gestor de Transporte (commitment_scope: manager_commitment, atualizando attendance_status para manager_committed) da alocação/confirmação de executor individual (commitment_scope: executor_allocation, atualizando attendance_status para partially_confirmed ou confirmed conforme o preenchimento de vagas).
manager_commitment): registra que o Gestor de Transporte assumiu o compromisso de atender a demanda contratada, sem fingir que um motorista específico já aceitou a oferta. Se um CNPJ prestador (aggregated_carrier_company_id) for informado sem driver_user_id, é validado e registrado como prestador indicado/vinculado, mantendo o estado em manager_committed.executor_allocation): exige aggregated_carrier_company_id elegível + driver_user_id homologado no gestor + evidência canônica de aceite explícito da oferta pelo motorista autorizado (POST /embarcador/solicitacoes-transporte/{id}/aceitar-oferta-motorista) compatível com a versão de condições vigentes (conditions_version).422 MANAGER_CANNOT_ACCEPT_FOR_DRIVER).driver_availabilities) apenas declara disponibilidade para aquela data operacional (service_date); não equivale a aceite de oferta (422 DAILY_CHECKIN_DOES_NOT_EQUAL_ACCEPTANCE) e não se propaga automaticamente para outro dia (422 DAILY_CHECKIN_DATE_MISMATCH).aggregated_carrier_company_id / CNPJ), motorista (driver_user_id / CPF), veículo (vehicle_id / vehicle_plate / vehicle_type) e representação autorizada, limitando a quantidade de executores confirmados ao teto de vagas da programação (422 VACANCY_LIMIT_EXCEEDED).operacao — Operação[
{
"oauth2": []
},
{
"chaveApi": []
}
]idpath · stringObrigatório{
"type": "string"
}Obrigatório
application/jsoncommitment_scopestring | nullOpcionalEscopo da ação (manager_commitment para compromisso comercial do gestor; executor_allocation para confirmar motorista com aceite explícito).
"manager_commitment" · "executor_allocation" · nullaggregated_carrier_company_idinteger | nullOpcionalID da empresa prestadora (Transportador Agregado / CNPJ) elegível vinculada ao Gestor de Transporte responsável. Obrigatório em executor_allocation.
driver_user_idinteger | nullOpcionalID do motorista autorizado (users.id) que aceitou explicitamente a oferta. Obrigatório para confirmar executor (confirmed / partially_confirmed).
vehicle_idinteger | nullOpcionalvehicle_platestring | nullOpcionalvehicle_typestring | nullOpcionalwork_unit_keystring | nullOpcionalIdentificador da unidade de trabalho (diária/turno) para evitar geração de diária duplicada quando novas entregas são incorporadas ao mesmo turno aceito.
200 Resposta HTTPCompromisso do gestor registrado (manager_committed) ou executor confirmado (partially_confirmed / confirmed)
application/jsonsuccessbooleanOpcionaldataobjectOpcionalcommercial_resolutionobject | nullOpcional403 Resposta HTTPTentativa de autorização por slug/marca White Label ou ator sem vínculo autorizado
422 Resposta HTTPSolicitação não contratada, tentativa do gestor de aceitar pelo motorista (MANAGER_CANNOT_ACCEPT_FOR_DRIVER), check-in diário sem aceite de oferta (DAILY_CHECKIN_DOES_NOT_EQUAL_ACCEPTANCE), check-in de outro dia (DAILY_CHECKIN_DATE_MISMATCH), ausência de aceite canônico (DRIVER_OFFER_ACCEPTANCE_REQUIRED) ou limite de vagas excedido (VACANCY_LIMIT_EXCEEDED)
{
"tags": [
"Solicitações e Contratação de Transporte (Embarcador)"
],
"summary": "Registrar compromisso comercial do gestor ou confirmar alocação de executor com aceite individual",
"description": "Separa o **compromisso comercial de atendimento assumido pelo Gestor de Transporte** (`commitment_scope: manager_commitment`, atualizando `attendance_status` para `manager_committed`) da **alocação/confirmação de executor individual** (`commitment_scope: executor_allocation`, atualizando `attendance_status` para `partially_confirmed` ou `confirmed` conforme o preenchimento de vagas).\n\n- **Compromisso comercial do gestor (`manager_commitment`)**: registra que o Gestor de Transporte assumiu o compromisso de atender a demanda contratada, sem fingir que um motorista específico já aceitou a oferta. Se um CNPJ prestador (`aggregated_carrier_company_id`) for informado sem `driver_user_id`, é validado e registrado como prestador indicado/vinculado, mantendo o estado em `manager_committed`.\n- **Alocação/confirmação de executor (`executor_allocation`)**: exige `aggregated_carrier_company_id` elegível + `driver_user_id` homologado no gestor + **evidência canônica de aceite explícito da oferta pelo motorista autorizado** (`POST /embarcador/solicitacoes-transporte/{id}/aceitar-oferta-motorista`) compatível com a versão de condições vigentes (`conditions_version`).\n- **Credencial do gestor ou da API não aceita pelo agregado** (`422 MANAGER_CANNOT_ACCEPT_FOR_DRIVER`).\n- **Check-in diário (`driver_availabilities`) apenas declara disponibilidade** para aquela data operacional (`service_date`); não equivale a aceite de oferta (`422 DAILY_CHECKIN_DOES_NOT_EQUAL_ACCEPTANCE`) e não se propaga automaticamente para outro dia (`422 DAILY_CHECKIN_DATE_MISMATCH`).\n- **Múltiplos motoristas do mesmo CNPJ prestador**: preserva a distinção entre empresa prestadora contratada (`aggregated_carrier_company_id` / CNPJ), motorista (`driver_user_id` / CPF), veículo (`vehicle_id` / `vehicle_plate` / `vehicle_type`) e representação autorizada, limitando a quantidade de executores confirmados ao teto de vagas da programação (`422 VACANCY_LIMIT_EXCEEDED`).\n",
"operationId": "confirmarAtendimentoSolicitacaoTransporte",
"parameters": [
{
"name": "id",
"in": "path",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"commitment_scope": {
"type": [
"string",
"null"
],
"enum": [
"manager_commitment",
"executor_allocation",
null
],
"description": "Escopo da ação (`manager_commitment` para compromisso comercial do gestor; `executor_allocation` para confirmar motorista com aceite explícito)."
},
"aggregated_carrier_company_id": {
"type": [
"integer",
"null"
],
"description": "ID da empresa prestadora (Transportador Agregado / CNPJ) elegível vinculada ao Gestor de Transporte responsável. Obrigatório em `executor_allocation`."
},
"driver_user_id": {
"type": [
"integer",
"null"
],
"description": "ID do motorista autorizado (`users.id`) que aceitou explicitamente a oferta. Obrigatório para confirmar executor (`confirmed` / `partially_confirmed`)."
},
"vehicle_id": {
"type": [
"integer",
"null"
]
},
"vehicle_plate": {
"type": [
"string",
"null"
]
},
"vehicle_type": {
"type": [
"string",
"null"
]
},
"work_unit_key": {
"type": [
"string",
"null"
],
"description": "Identificador da unidade de trabalho (diária/turno) para evitar geração de diária duplicada quando novas entregas são incorporadas ao mesmo turno aceito."
}
}
}
}
}
},
"responses": {
"200": {
"description": "Compromisso do gestor registrado (`manager_committed`) ou executor confirmado (`partially_confirmed` / `confirmed`)",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SolicitacaoTransporteResponse"
}
}
}
},
"403": {
"description": "Tentativa de autorização por slug/marca White Label ou ator sem vínculo autorizado",
"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": "Solicitação não contratada, tentativa do gestor de aceitar pelo motorista (`MANAGER_CANNOT_ACCEPT_FOR_DRIVER`), check-in diário sem aceite de oferta (`DAILY_CHECKIN_DOES_NOT_EQUAL_ACCEPTANCE`), check-in de outro dia (`DAILY_CHECKIN_DATE_MISMATCH`), ausência de aceite canônico (`DRIVER_OFFER_ACCEPTANCE_REQUIRED`) ou limite de vagas excedido (`VACANCY_LIMIT_EXCEEDED`)",
"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}/confirmar-atendimento"
}