Cria pedido

POST 
/orders

Cria um pedido da empresa autenticada — endpoint compartilhado por todas as telas que criam pedidos (Pedidos, PDV/Store Front, Ordem de serviço, devolução/Reversa, importação). A tela de Ordem de serviço usa este mesmo endpoint enviando o tipo de pedido marcado como ordem de serviço; o subconjunto de campos enviado por cada tela varia.

Etapas internas (handler OrderPost, Node → worker orderpost.php, PHP):

1. O handler Node repassa o corpo recebido ao worker (POST /order/orderpost.php?an=<conta>), com a conta resolvida a partir do prefix do token.
2. O worker valida a conta, resolve a empresa e (quando ShareDataWithRelatedCompanies=1) o grupo de empresas relacionadas, valida tipo de pedido, vendedor, centro de distribuição, integração, cliente e endereços, monta itens/pagamentos/dados fiscais e grava o pedido.
3. Quando o tipo de pedido emite NFCe (PDV), o pedido já nasce como StoreFrontOrder=1.
4. Com o IDOrder retornado pelo worker, o handler Node lê a ficha completa do pedido recém-criado e a devolve, acrescentando Danfe65Base64Encode (PDF da DANFE NFCe em base64, quando houver).

Campos obrigatórios dependem do tipo de pedido e das parametrizações da empresa: há fallbacks para tipo de pedido padrão, centro de distribuição padrão e vendedor automático (AutomaticSetSalesmanNewOrder). O required abaixo reflete o conjunto exigido pelo fluxo de criação padrão do frontend.

Request

Responses

200

Pedido criado. Retorna um array com a ficha completa do pedido recém-criado (mesma estrutura do registro de pedido), acrescido de Danfe65Base64Encode (PDF da DANFE NFCe em base64, null quando não aplicável).

400

Dados inválidos ou cadastro ausente. Mensagens emitidas (sem o prefixo): Precisa enviar a conta para criar o pedido, Empresa não encontrada, Tipo pedido informado não cadastrado ou empresa não possui tipo pedido padrão, Status pedido não cadastrado ou inválido ao criar pedido, Vendedor não existe, Centro de distribuição não existe, Empresa não possui centro de distribuição padrão, Integração não cadastrada, Obrigatório informar a integração, Empresa faturadora não encontrada, Consumidor não cadastrado, Endereço não cadastrado, Endereço entrega não cadastrado, Transportadora não cadastrada ou inativa, SKU(s) não cadastrados: …, Itens são tipo produto e não pode ser adicionado ao pedido, Armazém(s) não cadastrado: …, Tipo documento padrão não cadastrado, Plano de contas padrão não cadastrado, Não tem motivo de devolução cadastrado, Não tem categoria de devolução cadastrada, Pedido com emissão de NFCe, mas não tem tipo de pedido para NFCe, Tipo pedido emite NFCe e nota fiscal é devolução. Não é permitido emitir NFCe de devolução, Valor do vale compras é acima do disponível para a loja: …, Problema adicionar pagamento: …, Erro ao criar pedido.