← HomeFleetPay / API

Record manager commercial commitment or confirm executor allocation with individual acceptance

Parameters, data structure and responses from the versioned contract.

POST/embarcador/solicitacoes-transporte/{id}/confirmar-atendimento
confirmarAtendimentoSolicitacaoTransporteSandbox Base: https://api.fleetpay.site/v1

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

Separates the commercial fulfillment commitment assumed by the Transport Manager (commitment_scope: manager_commitment, updating attendance_status to manager_committed) from individual executor allocation/confirmation (commitment_scope: executor_allocation, updating attendance_status to partially_confirmed or confirmed based on filled slots).

  • Manager commercial commitment (manager_commitment): records that the Transport Manager committed to fulfilling contracted demand without faking driver acceptance. If a provider CNPJ (aggregated_carrier_company_id) is supplied without driver_user_id, it is validated and recorded as indicated/linked provider while staying manager_committed.
  • Executor allocation/confirmation (executor_allocation): requires an eligible aggregated_carrier_company_id + vetted driver_user_id under the manager + canonical evidence of explicit offer acceptance by the authorized driver (POST /embarcador/solicitacoes-transporte/{id}/aceitar-oferta-motorista) matching current conditions (conditions_version).
  • Manager or API credentials cannot accept on the driver's behalf (422 MANAGER_CANNOT_ACCEPT_FOR_DRIVER).
  • Daily check-in (driver_availabilities) only declares availability for that service date (service_date); it does not equal offer acceptance (422 DAILY_CHECKIN_DOES_NOT_EQUAL_ACCEPTANCE) and does not carry over across dates (422 DAILY_CHECKIN_DATE_MISMATCH).
  • Multiple drivers under the same provider CNPJ: keeps provider company (aggregated_carrier_company_id / CNPJ), driver (driver_user_id / CPF), vehicle (vehicle_id / vehicle_plate / vehicle_type) and authorized representation distinct, capping confirmed executors at the schedule's vacancy ceiling (422 VACANCY_LIMIT_EXCEEDED).

Authentication

Required Scope
operacao — Operations
Module
Direct Contracting (Shipper)
Target Profiles
Shipper · Transport Manager · Dedicated Fleet Contractor
Schemes
OAuth2 client_credentials (POST /oauth/token) or API Key via Authorization: Bearer / X-Api-Key
[
  {
    "oauth2": []
  },
  {
    "chaveApi": []
  }
]
Availability depends on the environment, enabled scopes and provider. This reference does not execute requests or collect credentials.

Parameters

idpath · stringRequired
Constraints
{
  "type": "string"
}

Request Body

Required

application/json

commitment_scopestring | nullOptional

Action scope (manager_commitment for manager commercial commitment; executor_allocation to confirm a driver with explicit acceptance).

"manager_commitment" · "executor_allocation" · null
aggregated_carrier_company_idinteger | nullOptional

Eligible provider company ID (Aggregated Carrier / CNPJ) linked to the responsible Transport Manager. Required in executor_allocation.

driver_user_idinteger | nullOptional

ID of the authorized driver (users.id) who explicitly accepted the offer. Required to confirm executor (confirmed / partially_confirmed).

vehicle_idinteger | nullOptional
vehicle_platestring | nullOptional
vehicle_typestring | nullOptional
work_unit_keystring | nullOptional

Work unit identifier (shift/day-rate) to avoid generating duplicate daily rates when new deliveries are incorporated into the same accepted shift.

Responses

200 HTTP Response

Manager commitment recorded (manager_committed) or executor confirmed (partially_confirmed / confirmed)

application/json

successbooleanOptional
commercial_resolutionobject | nullOptional
403 HTTP Response

Attempt to authorize by White Label slug/brand or actor without authorized link

application/json

errorobjectOptional
404 HTTP Response

Request not found

application/json

errorobjectOptional
422 HTTP Response

Uncontracted request, manager attempt to accept on driver's behalf (MANAGER_CANNOT_ACCEPT_FOR_DRIVER), daily check-in without offer acceptance (DAILY_CHECKIN_DOES_NOT_EQUAL_ACCEPTANCE), check-in from another date (DAILY_CHECKIN_DATE_MISMATCH), missing canonical acceptance (DRIVER_OFFER_ACCEPTANCE_REQUIRED) or vacancy limit exceeded (VACANCY_LIMIT_EXCEEDED)

application/json

errorobjectOptional
Complete Operation Definition
{
  "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"
}