Docsity
Docsity

Prepare-se para as provas
Prepare-se para as provas

Estude fácil! Tem muito documento disponível na Docsity


Ganhe pontos para baixar
Ganhe pontos para baixar

Ganhe pontos ajudando outros esrudantes ou compre um plano Premium


Guias e Dicas
Guias e Dicas

Calculo Financeiro em Geral, Resumos de Cálculo

calculo de finanças em geral, porcentagens e resumos

Tipologia: Resumos

2025

Compartilhado em 11/06/2025

tiago-freaza
tiago-freaza 🇧🇷

1 documento

1 / 16

Toggle sidebar

Esta página não é visível na pré-visualização

Não perca as partes importantes!

bg1
1/16
DEENC Departamento de Encomendas
Revisão 25/09/2019
Manual técnico de integração
web services ao
Sistema Calculador de Preço e Prazo -
SCPP
Brasília
2019
Versão 2.2 de 25/09/2019
Diretoria de Negócios - DINEG
Superintendência Comercial SUCOM
Departamento de Canais Digitais - DEDIG
pf3
pf4
pf5
pf8
pf9
pfa
pfd
pfe
pff

Pré-visualização parcial do texto

Baixe Calculo Financeiro em Geral e outras Resumos em PDF para Cálculo, somente na Docsity!

1/ DEENC – Departamento de Encomendas

Manual técnico de integração

web services ao

Sistema Calculador de Preço e Prazo -

SCPP

Brasília

Versão 2. 2 de 25/09/

Diretoria de Negócios - DINEG

Superintendência Comercial – SUCOM

Departamento de Canais Digitais - DEDIG

2/ DEENC – Departamento de Encomendas

Calculador de preços e prazos de

encomendas

O calculador de preços e prazos de encomendas dos Correios é destinado aos

clientes que possuem contrato de SEDEX e PAC, que necessitam calcular, no seu

ambiente e de forma personalizada, o preço e o prazo de entrega de uma encomenda.

Para o cálculo acordado em contrato os clientes deverão necessariamente informar em

cada consulta o código administrativo, a senha e o código de um ou mais serviços

inerentes ao seu contrato.

É possível também a um cliente que não possui contrato de encomenda com os

Correios realizar o cálculo, porém, neste caso, os preços apresentados serão aqueles

praticados no balcão da agência.

De forma a dar maior flexibilidade ao cliente, os Correios oferecem quatro formas

de obter o resultado da consulta:

a) Consulta via Webservice: Esta forma de consulta utiliza a tecnologia Web Services –

coleção de protocolos e padrões (XML, SOAP e WSDL) usados para troca de

informações entre aplicações Internet. Ela é indicada para usuários avançados, que

dominam essa tecnologia;

b) Resultado no formato XML: Nesta forma de consulta os parâmetros são passados

para o calculador de preços e prazos via post e o resultado é retornado no formato

XML;

c) Resultado na página do cliente: Nesta forma de consulta os parâmetros são

passados para o calculador de preços e prazos via post e o resultado é retornado numa

página HTML especificada pelo requisitante.

Ex:

4/

DEENC – Departamento de Encomendas

nCdFormato Int Formato da encomenda (incluindo embalagem). Valores possíveis: 1, 2 ou 3 1 – Formato caixa/pacote 2 – Formato rolo/prisma 3 – Envelope

Sim

nVlComprimento Decimal Comprimento da encomenda (incluindo embalagem), em centímetros.

Sim.

nVlAltura Decimal Altura da encomenda (incluindo embalagem), em centímetros. Se o formato for envelope, informar zero (0).

Sim.

nVlLargura Decimal Largura da encomenda (incluindo embalagem), em centímetros.

Sim.

nVlDiametro Decimal Diâmetro da encomenda (incluindo embalagem), em centímetros.

Sim.

sCdMaoPropria String Indica se a encomenda será entregue com o serviço adicional mão própria. Valores possíveis: S ou N (S – Sim, N – Não)

Sim.

nVlValorDeclarado Decimal Indica se a encomenda será entregue com o serviço adicional valor declarado. Neste campo deve ser apresentado o valor declarado desejado, em Reais.

Sim. Se não optar pelo serviço informar zero. sCdAvisoRecebimento String Indica se a encomenda será entregue com o serviço adicional aviso de recebimento. Valores possíveis: S ou N (S – Sim, N – Não)

Sim. Se não optar pelo serviço informar ‘N’

Retorno dos dados

O retorno dos dados é um XML informando a situação da consulta e uma lista ( array ) com

os dados de preço e prazo dos serviços SEDEX e PAC.

5/

DEENC – Departamento de Encomendas

Exemplo do XML de retorno

Parâmetro Descrição

Resultado.Servicos Array com os preços e prazos dos serviços solicitados e disponíveis. Resultado.Servicos.cServico[x].Codigo Código do Serviço de Entrega. Resultado.Servicos.cServico[x].Valor Preço total da encomenda, em Reais, incluindo os preços dos serviços opcionais Resultado.Servicos.cServico[x].PrazoEntrega Prazo estimado em dias para entrega do produto. Se o valor retornado for 0 (zero), indica que o prazo não foi retornado corretamente. Resultado.Servicos.cServico[x].ValorMaoPropria Preço do serviço adicional Mão Própria Resultado.Servicos.cServico[x].ValorAvisoRecebimento Preço do serviço adicional Aviso de Recebimento Resultado.Servicos.cServico[x].ValorValorDeclarado Preço do serviço adicional Valor Declarado Resultado.Servicos.cServico[x].EntregaDomiciliar Informa se a localidade informada possui entrega domiciliária. Se o prazo não for retornado corretamente, o retorno deste parâmetro será vazio. Resultado.Servicos.cServico[x].EntregaSabado Informa se a localidade informada possui entrega domiciliária aos sábados. Se o prazo não for retornado corretamente, o retorno deste parâmetro será vazio. Resultado.Servicos.cServico[x].Erro **<Códigos de Erros retornados pelo calculador>

  • o código 7 (Serviço indisponível, tente mais tarde)** Resultado.Servicos.cServico[x].MsgErro Retorna a descrição do erro gerado.

7/

DEENC – Departamento de Encomendas

nVlValorDeclarado Decimal Indica se a encomenda será entregue com o serviço adicional valor declarado. Neste campo deve ser apresentado o valor declarado desejado, em Reais.

Sim. Se não optar pelo serviço informar zero. sCdAvisoRecebimento String Indica se a encomenda será entregue com o serviço adicional aviso de recebimento. Valores possíveis: S ou N (S – Sim, N – Não)

Sim. Se não optar pelo serviço informar ‘N’

Retorno dos dados

O retorno dos dados é um XML informando a situação da consulta e uma lista ( array ) com

os dados de preço dos serviços SEDEX e PAC.

Parâmetro Descrição

Resultado.Servicos Array com os preços e prazos dos serviços solicitados e disponíveis. Resultado.Servicos.cServico[x].Codigo Código do Serviço de Entrega. Resultado.Servicos.cServico[x].Valor Preço total da encomenda, em Reais, incluindo os preços dos serviços opcionais Resultado.Servicos.cServico[x].ValorMaoPropria Preço do serviço adicional Mão Própria Resultado.Servicos.cServico[x].ValorAvisoRecebimento Preço do serviço adicional Aviso de Recebimento Resultado.Servicos.cServico[x].ValorValorDeclarado Preço do serviço adicional Valor Declarado Resultado.Servicos.cServico[x].Erro **<Códigos de Erros retornados pelo calculador>

  • o código 7 (Serviço indisponível, tente mais tarde)** Resultado.Servicos.cServico[x].MsgErro Retorna a descrição do erro gerado.

Exemplo do XML de retorno

8/

DEENC – Departamento de Encomendas

1.3 Parâmetros de entrada: método CalcPrazo

Campo Tipo Descrição Obrigatório sCepOrigem String CEP de Origem sem hífen.Exemplo: 05311900 Sim

sCepDestino String CEP de Destino sem hífen Sim

nCdServico String Para clientes sem contrato:

Códigos Vigentes: Código Serviço 04014 SEDEX à vista

04510 PAC à vista 04782 SEDEX 12 ( à vista) 04790 SEDEX 10 (à vista)

04804 SEDEX Hoje à vista

Para clientes com contrato: Consultar os códigos no seu contrato.

Sim.

Retorno dos dados

O retorno dos dados é um XML informando a situação da consulta e uma lista ( array ) com

os dados de prazo dos serviços SEDEX e PAC.

Parâmetro Descrição

Resultado.Servicos Array com os preços e prazos dos serviços solicitados e disponíveis. Resultado.Servicos.cServico[x].Codigo Código do Serviço de Entrega. Resultado.Servicos.cServico[x].PrazoEntrega Prazo estimado em dias para entrega do produto. Se o valor retornado for 0 (zero), indica que o prazo não foi retornado corretamente. Resultado.Servicos.cServico[x].EntregaDomiciliar Informa se a localidade informada possui entrega domiciliária. Se o prazo não for retornado corretamente, o retorno deste parâmetro será vazio. Resultado.Servicos.cServico[x].EntregaSabado Informa se a localidade informada possui entrega domiciliária aos sábados. Se o prazo não for retornado corretamente, o retorno deste parâmetro será vazio. Resultado.Servicos.cServico[x].Erro **<Códigos de Erros retornados pelo calculador>

  • o código 7 (Serviço indisponível, tente mais tarde)**

Resultado.Servicos.cServico[x].MsgErro Retorna a descrição do erro gerado.

Exemplo do XML de retorno

10/

DEENC – Departamento de Encomendas

Exemplo de consulta com retorno no formato XML para preço e prazo:

http://ws.correios.com.br/calculador/CalcPrecoPrazo.aspx?nCdEmpresa=08082650&sDsSenha=564321&sCe

pOrigem=70002900&sCepDestino=04547000&nVlPeso=1&nCdFormato=1&nVlComprimento=20&nVlAltura=

0&nVlLargura=20&sCdMaoPropria=n&nVlValorDeclarado=0&sCdAvisoRecebimento=n&nCdServico=04510&

nVlDiametro=0&StrRetorno=xml&nIndicaCalculo=

Exemplo de retorno no formato XML

11/

DEENC – Departamento de Encomendas

  1. Códigos e mensagens de erro:

Código de erro Mensagem de erro

0 Processamento com sucesso

  • 1 Código de serviço inválido
  • 2 CEP de origem inválido
  • 3 CEP de destino inválido
  • 4 Peso excedido
  • 5 O Valor Declarado não deve exceder R$ 10.000,
  • 6 Serviço indisponível para o trecho informado
  • 7 O Valor Declarado é obrigatório para este serviço
  • 8 Este serviço não aceita Mão Própria
  • 9 Este serviço não aceita Aviso de Recebimento
  • 10 Precificação indisponível para o trecho informado
  • 11 Para definição do preço deverão ser informados, também, o comprimento, a

largura e altura do objeto em centímetros (cm).

  • 12 Comprimento inválido.
  • 13 Largura inválida.
  • 14 Altura inválida.
  • 15 O comprimento não pode ser maior que 105 cm.
  • 16 A largura não pode ser maior que 105 cm.
  • 17 A altura não pode ser maior que 105 cm.
  • 18 A altura não pode ser inferior a 2 cm.
  • 20 A largura não pode ser inferior a 11 cm.
  • 22 O comprimento não pode ser inferior a 16 cm.
  • 23 A soma resultante do comprimento + largura + altura não deve superar a 200 cm.
  • 24 Comprimento inválido.
  • 25 Diâmetro inválido
  • 26 Informe o comprimento.
  • 27 Informe o diâmetro.
  • 28 O comprimento não pode ser maior que 105 cm.
  • 29 O diâmetro não pode ser maior que 91 cm.
  • 30 O comprimento não pode ser inferior a 18 cm.
  • 31 O diâmetro não pode ser inferior a 5 cm.
  • 32 A soma resultante do comprimento + o dobro do diâmetro não deve superar a

200 cm.

  • 33 Sistema temporariamente fora do ar. Favor tentar mais tarde.
  • 34 Código Administrativo ou Senha inválidos.

13/

DEENC – Departamento de Encomendas

  1. Exemplo de aplicação cliente para consulta de preços e prazos via webservice:

Passos para Utilização:

Para testar copie os códigos fonte de exemplo para um servidor web no wwwroot com os

nomes frete.asp e frete2.asp respectivamente.

Códigos Fontes

Frete.asp – Formulário de Chamada

Calculo de Frete
Codigo:
Senha:
Serviços:
Cep Origem:
Cep Destino:
Peso:
Formato:
Comprimento:
Altura:
Largura:
Diâmetro:
Mão própria:

Valor declarado:
Aviso de Recebimento:

Frete2.asp – Requisição dos Dados <%@LANGUAGE=VBScript%> <% option explicit 'On Error Resume Next dim oXmlHttp, oXmlDom dim sReturn, sPacoteSoap dim nCodigoRet, sDescricaoRet set oXmlHttp = server.CreateObject("Microsoft.XMLHTTP") const sSoapServer = "http://ws.correios.com.br/calculador/CalcPrecoPrazo.asmx"

'Tratamento de campos obrigatórios dim peso, comprimento, altura, largura, diametro, valordeclarado if request.form("peso") = "" then peso = "0" else peso = request.form("peso") end if

if request.form("comprimento") = "" then comprimento = "0" else comprimento = request.form("comprimento") end if

if request.form("altura") = "" then altura = "0" else altura = request.form("altura") end if

if request.form("largura") = "" then largura = "0" else largura = request.form("largura") end if

if request.form("diametro") = "" then diametro = "0" else diametro = request.form("diametro") end if

if request.form("valordeclarado") = "" then valordeclarado = "0"

16/

DEENC – Departamento de Encomendas

Em caso de dúvidas ou informações ligue para nossa Central de Atendimento ao Cliente –

Telefone 3003-