Cotação de Frete - TMS Transportador

Esqueleto Oracle

CREATE OR REPLACE PROCEDURE STP_CALCULA_VLRFRETE_TMS ( P_CODPARCORIG NUMBER,
P_CODPARCDEST NUMBER, P_CODCIDORIG NUMBER, P_CODCIDDEST NUMBER, P_VLRMERCADORIA NUMBER, P_PESO    NUMBER,
P_M3	NUMBER,
P_VLRFRETE OUT NUMBER
)
AS BEGIN
P_VLRFRETE := 0;

-- Implementar regra de cálculo da empresa aqui.
-- Exemplo (pseudo): consultar uma tabela própria de frete pela
-- combinação de cidades e aplicar fator por kg + ad valorem.

EXCEPTION
WHEN NO_DATA_FOUND THEN
P_VLRFRETE := 0;
END;
/

Esqueleto SQL Server

CREATE OR ALTER PROCEDURE STP_CALCULA_VLRFRETE_TMS @P_CODPARCORIG	NUMERIC(18, 0),
@P_CODPARCDEST	NUMERIC(18, 0),
@P_CODCIDORIG	NUMERIC(18, 0),
@P_CODCIDDEST	NUMERIC(18, 0),
@P_VLRMERCADORIA NUMERIC(18, 4),
@P_PESO	NUMERIC(18, 4),
@P_M3	NUMERIC(18, 4), @P_VLRFRETE	NUMERIC(18, 4) OUTPUT
AS BEGIN
SET @P_VLRFRETE = 0;

-- Implementar regra de cálculo da empresa aqui.
END GO

Boas práticas de customização

• Trate parâmetros nulos. Origem ou destino podem chegar com apenas o parceiro ou apenas a cidade.

• Sempre retorne um número em P_VLRFRETE . Use como padrão quando nenhuma regra se aplicar.

• Nunca altere a assinatura (ordem, nome, tipo ou quantidade dos parâmetros).

• Não execute COMMIT ou ROLLBACK dentro da procedure — a transação é controlada pela aplicação.

• Não use DBMS_OUTPUT ou prints — a aplicação espera apenas o retorno numérico limpo.

• Trate exceções esperadas (como NO_DATA_FOUND ) e devolva 0 em vez de propagar erro.

Como instalar a procedure customizada

Conecte-se ao banco do cliente com um usuário do schema da Sankhya.

Execute o script (CREATE OR REPLACE no Oracle, CREATE OR ALTER no SQL Server).

Confirme se foi criada: ```sql -- Oracle SELECT TEXT FROM USER_SOURCE WHERE NAME = 'STP_CALCULA_VLRFRETE_TMS' ORDER BY LINE;-- SQL Server SELECT OBJECT_DEFINITION(OBJECT_ID('STP_CALCULA_VLRFRETE_TMS'));

Teste a procedure direto no banco antes de validar pela tela:sql -- Oracle DECLARE V_VLR NUMBER; BEGIN STP_CALCULA_VLRFRETE_TMS(12, 22, 2, 15, 1500, 100, 1, V_VLR); DBMS_OUTPUT.PUT_LINE('Frete: ' || V_VLR); END; / ```

Acesse a tela ''Cotação de Frete'' (Logística » TMS » Rotinas » Cotação Frete) e clique em Calcular com os mesmos parâmetros para conferir o resultado.

Mensagens e erros comuns

Perguntas Frequentes (FAQ)

• Por que o Valor do Frete sempre vem zerado?

A rotina de cálculo (STP_CALCULA_VLRFRETE_TMS) é entregue vazia propositalmente, pois cada cliente deve personalizá-la conforme sua regra de cálculo. Solicite ao consultor responsável pela implantação que realize a customização da procedure de acordo com a tabela de frete da empresa.

• Posso digitar o valor do frete manualmente?

Sim. O campo “Valor do Frete” permite digitação manual. Utilize essa opção para sobrepor o valor calculado em situações específicas ou para gerar o pedido sem executar o cálculo automático.

• O e-mail é enviado na hora?

Não. O sistema adiciona a mensagem à fila de envio (FILA_MSG). O envio é realizado pela rotina padrão de filas da plataforma, conforme a frequência configurada no servidor. Caso o e-mail demore para ser entregue, verifique com a equipe de TI o status da fila e as configurações do servidor SMTP.

• Posso configurar mais de um pedido modelo?

Não. A configuração “Nro Pedido Modelo” permite informar apenas um pedido. Selecione um modelo que represente adequadamente o cenário mais comum de cotações da empresa.

• Como o pedido modelo é usado?

Ao clicar em “Gerar Pedido”, o sistema clona o pedido modelo (cabeçalho e primeiro roteiro) e ajusta automaticamente os seguintes dados:

• Parceiros e cidades de origem e destino;

• Peso e quantidade (m³);

• Valor do frete da empresa.

Os demais campos como TOP, natureza, condições e observações, são mantidos conforme o pedido modelo e podem ser revisados após a geração.

• Posso enviar para mais de um destinatário no e-mail?

Sim. No campo “Destinatário”, informe os e-mails separados por vírgula. O sistema criará uma mensagem na fila para cada destinatário informado.