Confirm Order

Confirms an existing hardware order. The order must be in QUOTED status and belong to the authenticated company.

Authentication

This endpoint requires authentication. See Authentication for details.

Parameters

Field	Type	Required	Description
id	string	Yes	UUID of the order request to be confirmed
companyCode	string	Yes	Company code of the authenticated company

Request

Production URL: https://orchestrator.tecspal.com/
Sandbox URL: https://orchestrator-dev.tecspal.com/
Endpoint: POST /orders/confirm

Example Request

{
  "data": {
    "id": "3178e7e9-0fe9-47ad-b69a-e5604a990822",
    "companyCode": "DM1"
  },
  "request": "orders/confirm",
  "vendor": "tecspal",
  "verb": "POST"
}

Response Schema

Property	Type	Description
statusCode	number	HTTP status code of the response (200 on success)
message	string	Description of the response status (e.g. Request successful)
envelop	array	Array containing the confirmed order minimal data

Envelope Item Properties

Cada item dentro de envelop terá apenas os campos essenciais da order confirmada:

Property	Type	Description
id	string	Unique identifier of the order
status	string	Final status of the order (ACCEPTED)

Example Response

{
  "statusCode": 200,
  "message": "Request successful",
  "envelop": [
    {
      "id": "3178e7e9-0fe9-47ad-b69a-e5604a990822",
      "status": "ACCEPTED"
    }
  ]
}

Error Responses

Bad Request (400)

{
  "error": "Bad Request",
  "message": "id is required",
  "statusCode": 400
}

Invalid Company or Order (400)

{
  "error": "Bad Request",
  "message": "Order request not found",
  "statusCode": 400
}

Invalid Status (400)

{
  "error": "Bad Request",
  "message": "The Order cannot be confirmed",
  "statusCode": 400
}

Unauthorized (401)

{
  "error": "Unauthorized",
  "message": "Unauthorized access",
  "statusCode": 401
}

Notes

• Only orders with status QUOTED can be confirmed via this endpoint.
• Confirming the order updates its status to ACCEPTED.
• The companyCode provided must match the company associated with the order.
• If the order is already in ACCEPTED status, the endpoint will return the same id and status without making changes.