Pedidos

Este artigo documenta o processo de pedidos de venda.

Listar pedidos

Lista de forma paginada os pedidos de venda

Exemplo de resposta

{
    "content": [
        {
            "id": 5804,
            "data": "2023-12-14",
            "prazoEntrega": "2023-12-14",
            "representante": {
                "id": 1,
                "nome": "RENOVADORA DE PNEUS LTDA",
                "email": "rpmpneus@smo.com.br",
                "condicoesAutorizadas": ""
            },
            "cliente": {
                "id": 31511,
                "razaoSocial": "JUNIOR ALVES DE FARIAS"
            },
            "condicaoPagamento": {
                "id": 1,
                "nome": "A Vista"
            },
            "situacao": "RASCUNHO",
            "valorLiquido": 0.0
        }
    ],
    "page": {
        "size": 10,
        "number": 0,
        "totalElements": 1,
        "totalPages": 1
    }
}

Consultar pedido

Consulta um pedido pelo id do pedido

Exemplo de resposta

{
    "id": 1,
    "numeroInterno": 12,
    "data": "2022-12-01",
    "prazoEntrega": "2022-12-01",
    "dataExpedicao": "2022-12-01",
    "representante": {
        "id": 23,
        "nome": "Venda direta",
        "email": "representante@teste.com.br"
    },
    "tabelaPrecos": {
        "id": 23,
        "nome": "Tabela sul"
    },
    "condicaoPagamento": {
        "id": 23,
        "nome": "A vista",
        "parcelas": 0,
        "descontoMaximo": 5
    },
    "cliente": {
        "id": 23091,
        "razaoSocial": "TESTE FORM 1",
        "cnpj": "77.777.777/7777-77",
        "email": "teste@teste.com",
        "telefone": "+55 (49) 36640-000",
        "municipio": "CUNHA PORA",
        "estado": "SC",
        "impostoIsento": "IPI"
    },
      "transportadora": {
        "id": 1366,
        "nome": "GAT TRANSPORTES EIRELI - ME"
    },
    "transportadoraRedespacho": {
        "id": 1366,
        "nome": "GAT TRANSPORTES EIRELI - ME"
    },
    "situacao": "LIBERADO",
    "tipoVenda": {
        "id": 23,
        "nome": "a vista"
    },
    "pedidoMotivoNaoConformidade": {
        "id": 23,
        "nome": "Quebrado"
    },
    "filial": {
        "id": 1,
        "nome": "Filial 1"
    },
    "freteTipo": "DESTINATARIO",
    "observacao": "teste",
    "observacaoCondicaoPagamento": "nada",
    "valorProdutos": 45.56,
    "valorLiquido": 45.86,
    "comissao": 12.56,
    "comissaoValor": 55.99,
    "desconto1": 56.99,
    "desconto2": 89.66,
    "desconto3": 45.88,
    "desconto4": 99.55,
    "tipoConsumidor": "CONSUMO",
    "ipiBase": 45.89,
    "ipiValor": 89.99,
    "stBase": 12,
    "stIcms": 32.99,
    "adicionalVenda": 59.88,
    "percentualFreteCliente": 12,
    "valorFreteCliente": 2,
    "descontoEspecial": {
        "id": 23,
        "desconto": 98.98
    },
    "parcelas": 8,
    "dataBaseParcelas": "2022-12-01",
    "valorEntrada": 1000.66,
    "dataEntrada": "2022-12-01",
    "formaPagamento": "DEPOSITO",
    "observacaoNotaFiscal1": "",
    "observacaoNotaFiscal2": "",
    "observacaoNotaFiscal3": "",
    "observacaoNotaFiscal4": "",
    "observacaoNotaFiscal5": "",
    "numeroRepresentante": 23,
    "aceitaEnvioParcial": "NAO",
    "respeitaPrazoEntrega": "NAO",
    "bndsNumero": "",
    "bndsSeguranca": "",
    "instalacao": "SIM",
    "bndsValidade": "2022-12-01",
    "bndsParcelas": 0,
    "entradaSaida": "ENTRADA",
    "pedidoOrcamento": "PEDIDO",
    "pedidoEspecial": "SIM",
    "metodoPesquisa": {
        "id": 23,
        "descricao": "feira"
    },
    "financiamentoBanco": "",
    "financiamentoGerente": "",
    "financiamentoModalidade": "",
    "parcelasRepresentante": 0,
    "numeroNotaFiscal": 456987,
    "entregaTecnica": "NAO",
    "percentualAcrescimo": 10,
    "itens": [
        {
            "item": 23,
            "produto": {
                "id": 78,
                "referencia": "78",
                "descricao": "banana"
            },
            "quantidade": 56,
            "desconto": 56.99,
            "comissao": 89.88,
            "tabela": 89.99,
            "unitario": 88.88,
            "total": 69.99,
            "ipiAliquota": 56.77,
            "ipiBase": 56.77,
            "ipiValor": 78.44,
            "ipiOutras": 89,
            "ipiCst": "50",
            "stIndicacao": "SIM",
            "stBase": 78.32,
            "stIcms": 89.78,
            "stMva": 10,
            "stIcmsUf": 32.99,
            "stRbc": 10,
            "cfop": "jhdsgbhsdb",
            "descritivo": "",
            "valorJuros": 89.98,
            "identificadorSuperior": 2,
            "identificadorPai": 1,
            "acessorioSuperior": 3,
            "classificacaoItemPrincipal": 1,
            "produtoSubstituto": 23,
            "multiplosProdutos": "NAO",
            "valorFrete": 23.65,
            "percentualFrete": 78.22,
            "dimensoes": [
                {
                    "altura": 0.0,
                    "comprimento": 0.0,
                    "largura": 0.0,
                    "quantidade": 0.0,
                    "tipoCorte": "BLOCO",
                    "observacao": "observacao de teste teste",
                    "percentualPerda": 5.5
                }
            ]
            "acessorios": [
                {
                    "subAcessorios": []
                }
            ],
            "produtosSubstitutos": [
                {
                    "id": 47,
                    "produtoFicha": {
                        "codigo": 3,
                        "descricao": "PRODUTO DA FICHA 1"
                    },
                    "produtoSubstituto": {
                        "codigo": 4693,
                        "descricao": "PRODUTO EXEMPLO SUBSTITUTO 1"
                    }
                }
            ]
        }
    ]
}

Inserir pedido

Insere um pedido novo na base de dados.

Exemplo de conteúdo da requisição

{
    "prazoEntrega": "2022-12-01",
    "representante": {
        "id": 23
    },
    "tabelaPrecos": {
        "id": 23
    },
    "condicaoPagamento": {
        "id": 23
    },
    "cliente": {
        "id": 23
    },
    "transportadora": { 
        "id": 5499
    }, 
    "transportadoraRedespacho": { 
        "id": 2513
    }
    "tipoVenda": {
        "id": 23
    },
    "filial": {
        "id": 1
    },
    "freteTipo": "DESTINATARIO",
    "observacao": "teste",
    "percentualFreteCliente": 12,
    "valorFreteCliente": 2,
    "valorJuros": 43.55,
    "formaPagamento": "DEPOSITO",
    "observacaoNotaFiscal1": "",
    "observacaoNotaFiscal2": "",
    "observacaoNotaFiscal3": "",
    "observacaoNotaFiscal4": "",
    "observacaoNotaFiscal5": "",
    "numeroRepresentante": 23,
    "pedidoOrcamento": "PEDIDO",
    "tipoConsumidor": "CONSUMO",
    "metodoPesquisa": {
        "id": 23
    },
    "usuarioId": 1,
    "itens": [
        {
            "item": 1,
            "produto": {
                "id": 78
            },
            "quantidade": 56,
            "desconto": 56.99,
            "comissao": 89.88,
            "tabela": 89.99,
            "unitario": 88.88,
            "total": 69.99,
            "ipiAliquota": 56.77,
            "ipiBase": 56.77,
            "ipiValor": 78.44,
            "valorFrete": 23.65,
            "stIcms": 89.78,
            "percentualFrete": 78.22,
            "cfop": "5.101.01",
            "descritivo": "Um texto qualquer..."
            "ipiCst": "50",
            "stIndicacao": "SIM",
            "stIcmsUf": 0,
            "stMva": 0,
            "stRbc": 0,
            "dimensoes": [
              {
                "altura": 0.0,
                "comprimento": 0.0,
                "largura": 0.0,
                "quantidade": 0.0,
                "tipoCorte": "BLOCO",
                "observacao":"observacao de teste teste",
                "percentualPerda": 5.5
              }
            ]
            "acessorios": [
                {
                    "subAcessorios": []
                }
            ],
            "produtosSubstitutos": [
                {
                    "produtoFicha": {
                        "codigo": 3
                    },
                    "produtoSubstituto": {
                        "codigo": 4693
                    },
                    "usuarioId": 2
                }
            ]
        }
    ]
}

Resposta

A API retornará o código do novo pedido cadastrado.

Exemplo de resposta

{
  "id": 123456
}

Editar pedido

Atualiza um pedido na base de dados.

Exemplo de conteúdo da requisição

{
    "prazoEntrega": "2022-12-01",
    "representante": {
        "id": 23
    },
    "tabelaPrecos": {
        "id": 23
    },
    "condicaoPagamento": {
        "id": 23
    },
    "cliente": {
        "id": 23
    },
    "transportadora": { 
        "id": 5499 
    }, 
    "transportadoraRedespacho": { 
        "id": 2513 
    }
    "tipoVenda": {
        "id": 23
    },
    "filial": {
        "id": 1
    },
    "freteTipo": "DESTINATARIO",
    "observacao": "teste",
    "percentualFreteCliente": 12,
    "valorFreteCliente": 2,
    "valorJuros": 43.55,
    "formaPagamento": "DEPOSITO",
    "observacaoNotaFiscal1": "",
    "observacaoNotaFiscal2": "",
    "observacaoNotaFiscal3": "",
    "observacaoNotaFiscal4": "",
    "observacaoNotaFiscal5": "",
    "numeroRepresentante": 23,
    "pedidoOrcamento": "PEDIDO",
    "tipoConsumidor": "CONSUMO",
    "metodoPesquisa": {
        "id": 23
    },
    "situacao": "LIBERADO",
    "usuarioId": 1,
    "itens": [
        {
            "item": 1,
            "produto": {
                "id": 78
            },
            "quantidade": 56,
            "desconto": 56.99,
            "comissao": 89.88,
            "tabela": 89.99,
            "unitario": 88.88,
            "total": 69.99,
            "ipiAliquota": 56.77,
            "ipiBase": 56.77,
            "ipiValor": 78.44,
            "valorFrete": 23.65,
            "stIcms": 89.78,
            "percentualFrete": 78.22,
            "cfop": "5.101.01",
            "descritivo": "Um texto qualquer....",
            "ipiCst": "50",
            "stIndicacao": "SIM",
            "stIcmsUf": 0,
            "stMva": 0,
            "stRbc": 0,
            "dimensoes": [
                {
                    "altura": 2.0,
                    "comprimento": 2.0,
                    "largura": 1.0,
                    "quantidade": 5.0,
                    "tipoCorte": "BLOCO",
                    "observacao": "ALTERADPOOO",
                    "percentualPerda": 2.5
                }
            ]
            "acessorios": [
                {
                    "subAcessorios": []
                }
            ],
            "produtosSubstitutos": [
                {
                    "produtoFicha": {
                        "codigo": 3
                    },
                    "produtoSubstituto": {
                        "codigo": 4693
                    },
                    "usuarioId": 2
                }
            ]
        }
    ]
}

Deletar pedido

Excluir um pedido de venda

Consultar tabela de preço

Consulta a tabela de preço filtrando por representante e município ou representante e estado

Exemplo de resposta

{
  "id": 94
}

Consultar impresso do pedido

Consultar impresso do pedido pelo id do pedido

impresso_pedido_venda.pdf

Consultar último preço praticado do cliente e produto

Consulta o último preço praticado filtrando por cliente e produto

Exemplo de resposta

{
    "id": 5916,
    "numeroInterno": 40720,
    "data": "2022-03-11",
    "dataExpedicao": "2022-04-05",
    "unitario": 287.831525
}

Enviar Mensagem

Enviar uma mensagem via e-mail e/ou WhatsApp do pedido

Exemplo de conteúdo da requisição

{
    "recipient": "destinatario@microsys.inf.br",
    "title": "Pedido de venda",
    "whatsApp": "5549988382422",
    "body": "Pedido de venda. Pedido número 999 de Microsys Sistemas"
}