EcomDocs
POSTPedido manual

Criar pedido manual

Cria um pedido avulso para cliente existente, novo ou anônimo, com itens e valores. Requer permissão vendas.

POST/manual-orders
AutenticaçãoPainel adminvendas.

Cookie de sessão do painel (ecom_token) + permissão RBAC.

Corpo da requisição

  • clienteobjectopcional

    Dados do cliente (ou customerId).

  • itensarrayobrigatório

    Itens do pedido manual.

  • observacaostringopcional

    Observação.

Cabeçalhos

  • Cookiestringobrigatório

    Cookie de sessão do painel: ecom_token=<jwt> (obtido em POST /auth/login).

Requisição

curl -X POST "https://api.ecomplataforma.com.br/manual-orders" \
  -b cookies.txt -H "Content-Type: application/json" \
  -d '{"cliente":{"nome":"João"},"itens":[{"descricao":"Conserto","precoCents":5000}]}'

Resposta201

200 OK
{ "success": true, "data": { "id": "m_10", "status": "aberto" } }

Respostas de erro

401Não autenticado
401 Não autenticado
{
  "success": false,
  "error": "Sessão ausente ou expirada."
}
403Sem permissão
403 Sem permissão
{
  "success": false,
  "error": "Você não tem permissão para acessar este recurso."
}
422Falha de validação
422 Falha de validação
{
  "success": false,
  "error": "O campo 'email' é obrigatório."
}
AnteriorListar pedidos manuaisPróximoAtualizar pedido manual