[Melhoria] Vendas: Inclusão de Pedido de Venda – Suporte a Canal de Venda e Vendedor

Agora no Bluesoft ERP, é possível informar canal de venda e vendedor na API de inclusão de pedido de venda.

COMO IRÁ FUNCIONAR A PARTIR DE AGORA?

A inclusão de pedido de venda via API será realizada pelo endpoint:

API > POST /api/venda/pedidovenda

Foram adicionados os seguintes campos ao payload:

Campo	Obrigatoriedade
‘vendedorKey’	Opcional
‘canalVendaKey’	Opcional

Exemplo de payload:

{
  "cpfCnpjCliente": "77777777777",
  "cpfCnpjLoja": "12312312312312",
  "dataEmissao": "01/07/2026",
  "dataPagamento": "01/07/2026",
  "dataVencimento": "01/08/2026",
  "numeroPedido": "11223349",
  "vendedorKey": 9,
  "canalVendaKey": 11,
  "produtos": [
    {
      "plu": 1000,
      "quantidade": 50,
      "valor": 250,
      "desconto": 29.9,
      "observacao": "Teste"
    }
  ]
}

Regras para o campo ‘vendedorKey‘:

1. O campo ‘vendedorKey’ é opcional.
2. Quando informado com um vendedor cadastrado no ERP, o vendedor será vinculado ao pedido.
3. Quando não informado, a API manterá o comportamento atual, inferindo o vendedor a partir da loja.
4. Caso seja informado um ‘vendedorKey’ inexistente, igual a zero ou negativo, a API impedirá a criação do pedido e retornará a mensagem ‘Vendedor não encontrado para o vendedorKey X’.

Regras para o campo ‘canalVendaKey‘:

1. O campo ‘canalVendaKey’ é opcional no contrato da API.
2. A obrigatoriedade do Canal de Venda será determinada exclusivamente pela parametrização do ERP.
3. Quando o parâmetro ‘Obrigatório Canal de Venda’ estiver desabilitado, a API permitirá criar pedidos com ou sem ‘canalVendaKey’.
4. Quando o parâmetro ‘Obrigatório Canal de Venda’ estiver habilitado, a API exigirá que o pedido possua Canal de Venda.
5. Quando a opção ‘Todos os canais’ estiver marcada, a API aceitará qualquer Canal de Venda válido informado pela integração.
6. Quando a opção ‘Todos os canais’ não estiver marcada, a API validará se o Canal de Venda informado pertence aos canais permitidos para o tipo de pedido.
7. Caso o Canal de Venda informado não esteja permitido para o tipo de pedido, a API impedirá a criação do pedido.
8. Caso o campo ‘canalVendaKey’ não seja enviado quando o Canal de Venda for obrigatório, a API impedirá a criação do pedido e retornará a mensagem ‘Canal de Venda é obrigatório para o Tipo de Pedido selecionado’.
9. Caso seja informado um ‘canalVendaKey’ inexistente, igual a zero ou negativo, a API impedirá a criação do pedido e retornará a mensagem ‘Canal de venda não encontrado para o canalVendaKey X’.

A parametrização de Canal de Venda por tipo de pedido pode ser realizada em:

Vendas > Configurações > Parâmetros do Módulo Vendas

Nessa parametrização, é possível definir:

• Se o Canal de Venda será obrigatório;
• Qual será o Canal de Venda padrão;
• Se todos os canais serão aceitos;
• Quais Canais de Venda serão permitidos para o tipo de pedido.

Para conhecer mais sobre como é a utilização dessa ferramenta, clique aqui.

Para saber mais sobre a utilização das APIs do ERP, clique aqui.