​Adicionar Colaboradores ao Pedido

Este endpoint permite adicionar colaboradores a um pedido em aberto, com base no identificador do pedido (orderId).

• orderId: string (ID do pedido) *

• employees: array (Lista de colaboradores a serem adicionados) *

  • id: string (ID do colaborador) *
  • value: integer (Valor em centavos) *

[*] Campos obrigatórios

URL: /corporate-card/v1/orders/{orderId}/employees
Método: POST
Descrição: Adiciona colaboradores a um pedido em aberto.

Headers:

• Content-Type: 'application/json'
• x-flash-auth: <chave_de_api>

Corpo da Requisição:

{
  "employees": [
    { "id": "SQQSL61JHsp2o4bnMvOBc", "value": 100 },
    { "id": "E-VGnsNJgUeSjEYeZR6eL", "value": 200 }
  ]
}
json

Colaboradores não adicionados:

Um colaborador inelegível não interrompe a requisição. Ele é ignorado, os demais são adicionados normalmente, e ele volta em failedEmployees com o motivo:

• INACTIVE: o colaborador está inativo.
• NOT_FOUND: o colaborador não foi encontrado.

Quando nenhum dos colaboradores enviados é elegível, nada é adicionado ao pedido e a requisição falha com 400.

Resposta 200 – Exemplo:

{
  "id": "QkQlrP6oqIoNYvLya0spD",
  "companyId": "TN4zKN59LSd_MV9lBp3hn",
  "status": "OPEN",
  "employees": [{ "id": "SQQSL61JHsp2o4bnMvOBc", "value": 100 }],
  "totalAmount": 100,
  "failedEmployees": [
    { "id": "E-VGnsNJgUeSjEYeZR6eL", "reason": "INACTIVE" }
  ],
  "createdAt": "2026-01-08T01:16:29.701Z",
  "updatedAt": "2026-01-08T01:16:29.701Z"
}
json

Resposta 400 – Exemplo (nenhum colaborador elegível):

{
  "statusCode": 400,
  "message": "BadRequestException",
  "issues": "Failed to add employees. The following IDs are not valid for this request (non-existent or inactive): [SQQSL61JHsp2o4bnMvOBc, E-VGnsNJgUeSjEYeZR6eL]",
  "timestamp": "2026-01-08T01:16:29.701Z"
}
json