Criar Pedido
Primeiro passo do fluxo. Cria um pedido vazio e retorna o orderId, que será usado para adicionar depósitos e confirmar o pedido.
POST /benefits/v1/orders
Requisição:
| Campo | Obrigatório | Descrição |
|---|---|---|
companyId | Sim | ID da empresa para a qual o pedido será criado |
Resposta (201):
| Campo | Descrição |
|---|---|
id | Guarde este valor — é o orderId necessário para as próximas etapas |
status | Sempre requested ao criar — pedido aguardando depósitos |
companyId | ID da empresa vinculada ao pedido |
totalAmount | Valor total em centavos (começa em 0) |
totalFee | Total de taxas em centavos (começa em 0) |
createdAt | Data e hora de criação |
Erros comuns
| Código | Causa |
|---|---|
400 | companyId inválido |
403 | Sem permissão para esta empresa |
Próximo passo: Adicionar Depósitos →