SCPP Manual Implementacao Calculo Remoto de Precos e Prazos

Download SCPP Manual Implementacao Calculo Remoto de Precos e Prazos

Post on 06-Jul-2015

53 views

Category:

Documents

0 download

TRANSCRIPT

EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT Manual de Implementao de Clculo Remoto de Preos e Prazos de Encomendas

Clculo Remoto de Preos e Prazos de EncomendasO clculo remoto de preos e prazos de encomendas dos Correios destinado aos clientes que possuem contrato de SEDEX, e-SEDEX e PAC, que necessitam calcular, no seu website e de forma personalizada, o preo e o prazo de entrega de uma encomenda. possvel tambm a um cliente que no possui contrato de encomenda com os Correios realizar o clculo, porm neste caso os preos apresentados sero aqueles praticados no balco da agncia. De forma a dar maior flexibilidade ao cliente, os Correios oferecem quatro formas de obter o resultado da consulta: 1 Consulta via Webservices: Esta forma de consulta utiliza a tecnologia Web Services coleo de protocolos e padres (XML, SOAP e WSDL) usados para troca de informaes entre aplicaes Internet. Ela indicada para usurios avanados, que dominam essa tecnologia; 2 Resultado no formato XML: Nesta forma de consulta os parmetros so passados para o calculador de preos e prazos via post e o resultado retornado no formato XML; 3 Resultado na pgina do cliente: Nesta forma de consulta os parmetros so passados para o calculador de preos e prazos via post e o resultado retornado numa pgina HTML especificada pelo requisitante.Ex:

1/15Manual de Implementacao do Calculo Remoto de Precos e Prazos_versao_1.5.2.doc

EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT Manual de Implementao de Clculo Remoto de Preos e Prazos de Encomendas

4 Resultado na pgina dos Correios: Nesta forma de consulta os parmetros so passados para o calculador de preos e prazos via post e o resultado ser mostrado dentro de uma janela pop-up do prprio site dos Correios.(necessrio desabilitar o bloqueador de pop-up do browser)

1.2

Consulta via Webservices: A interface do WebService pode ser consultada em:http://ws.correios.com.br/calculador/CalcPrecoPrazo.asmx

O mtodo relativo a este manual CalcPrecoPrazo Parmetros de entradaCampo nCdEmpresa Tipo String Descrio Seu cdigo administrativo junto ECT. O cdigo est disponvel no corpo do contrato firmado com os Correios. Senha para acesso ao servio, associada ao seu cdigo administrativo. A senha inicial corresponde aos 8 primeiros dgitos do CNPJ informado no contrato. A qualquer momento, possvel alterar a senha no endereo http://www.corporativo.correios.com.br/encomendas/s ervicosonline/recuperaSenha. Cdigo do servio: Cdigo 41106 40010 40045 40126 40215 40290 40096 40436 40444 81019 41068 40568 40606 81868 81833 81850 Servio PAC sem contrato SEDEX sem contrato SEDEX a Cobrar, sem contrato SEDEX a Cobrar, com contrato SEDEX 10, sem contrato SEDEX Hoje, sem contrato SEDEX com contrato SEDEX com contrato SEDEX com contrato e-SEDEX, com contrato PAC com contrato SEDEX com contrato SEDEX com contrato (Grupo 1) e-SEDEX, com contrato (Grupo 2) e-SEDEX, com contrato (Grupo 3) e-SEDEX, com contrato Obrigatrio No, mas o parmetro tem que ser passado mesmo vazio. No, mas o parmetro tem que ser passado mesmo vazio. .

sDsSenha

String

nCdServico

String

Sim. Pode ser mais de um numa consulta separados por vrgula.

sCepOrigem sCepDestino nVlPeso nCdFormato

String String Decimal Int

CEP de Origem sem hfen.Exemplo: 05311900 CEP de Destino sem hfen Peso da encomenda, incluindo sua embalagem. O peso deve ser informado em quilogramas. Formato da encomenda (incluindo embalagem). Valores possveis: 1 ou 2 1 Formato caixa/pacote 2 Formato rolo/prisma Comprimento da encomenda (incluindo embalagem), em centmetros.

Sim Sim Sim Sim

nVlComprimento

Decimal

Sim.

2/15Manual de Implementacao do Calculo Remoto de Precos e Prazos_versao_1.5.2.doc

EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT Manual de Implementao de Clculo Remoto de Preos e Prazos de Encomendas nVlAltura Decimal Altura da encomenda (incluindo embalagem), em centmetros. nVlLargura nVlDiametro sCdMaoPropria Decimal Decimal String Largura da encomenda (incluindo embalagem), em centmetros. Dimetro da encomenda (incluindo embalagem), em centmetros. Indica se a encomenda ser entregue com o servio adicional mo prpria. Valores possveis: S ou N (S Sim, N No) Indica se a encomenda ser entregue com o servio adicional valor declarado. Neste campo deve ser apresentado o valor declarado desejado, em Reais. Indica se a encomenda ser entregue com o servio adicional aviso de recebimento. Valores possveis: S ou N (S Sim, N No)

Sim. Sim. Sim. Sim.

nVlValorDeclarado

Decimal

sCdAvisoRecebimento

String

Sim. Se no optar pelo servio informar zero. Sim. Se no optar pelo servio informar N

Retorno dos dados O retorno dos dados um XML informando a situao da consulta e uma lista (array) com os dados de preo dos servios SEDEX, e-SEDEX e PAC. O e-SEDEX um servio exclusivo para as principais localidades clientes do segmento de Comrcio Eletrnico, portanto, caso o CEP Origem e Destino estejam fora da rea de abrangncia do e-SEDEX, o mesmo no ser informado e uma mensagem relativa indisponibilidade do servio ser apresentada.Parmetro Resultado.Servicos Resultado.Servicos.cServico[x].Codigo Resultado.Servicos.cServico[x].Valor Resultado.Servicos.cServico[x].PrazoEntrega Descrio Array com os preos e prazos dos servios solicitados e disponveis. Cdigo do Servio de Entrega. Preo total da encomenda, em Reais, incluindo os preos dos servios opcionais Prazo estimado em dias para entrega do produto. Se o valor retornado for 0 (zero), indica que o prazo no foi retornado corretamente. Preo do servio adicional Mo Prpria Preo do servio adicional Aviso de Recebimento Preo do servio adicional Valor Declarado Informa se a localidade informada possui entrega domiciliria. Se o prazo no for retornado corretamente, o retorno deste parmetro ser vazio. Informa se a localidade informada possui entrega domiciliria aos sbados. Se o prazo no for retornado corretamente, o retorno deste parmetro ser vazio. + o cdigo 7 (Servio indisponvel, tente mais tarde) Retorna a descrio do erro gerado.

Resultado.Servicos.cServico[x].ValorMaoPropria Resultado.Servicos.cServico[x].ValorAvisoRecebimento Resultado.Servicos.cServico[x].ValorValorDeclarado Resultado.Servicos.cServico[x].EntregaDomiciliar

Resultado.Servicos.cServico[x].EntregaSabado

Resultado.Servicos.cServico[x].Erro Resultado.Servicos.cServico[x].MsgErro

3/15Manual de Implementacao do Calculo Remoto de Precos e Prazos_versao_1.5.2.doc

EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT Manual de Implementao de Clculo Remoto de Preos e Prazos de Encomendas

Interface do WebService Formato de entradaPOST /calculador/CalcPrecoPrazo.asmx HTTP/1.1 Host: localhost Content-Type: text/xml; charset=utf-8 Content-Length: length SOAPAction: "http://tempuri.org/CalcPrecoPrazo" long string string string string string string long int long long long long string long string

Formato do retornoHTTP/1.1 200 OK Content-Type: text/xml; charset=utf-8 Content-Length: length int long long long long int string string int4/15Manual de Implementacao do Calculo Remoto de Precos e Prazos_versao_1.5.2.doc

EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT Manual de Implementao de Clculo Remoto de Preos e Prazos de Encomendas string int long long long long int string string int string

Exemplo do XML de resultado

5/15Manual de Implementacao do Calculo Remoto de Precos e Prazos_versao_1.5.2.doc

EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT Manual de Implementao de Clculo Remoto de Preos e Prazos de Encomendas

1.2 Consulta com resultado no formato XML, na pgina do cliente e na pgina dos Correios: O calculador de preos e prazos dos servios de encomendas dos Correios tambm pode ser acessado pelo endereo:http://ws.correios.com.br/calculador/CalcPrecoPrazo.aspx

Neste caso os resultados podero ser visualizados no formato XML, numa janela popup ou numa pgina disponvel no ambiente do requisitante. Neste ltimo caso o retorno ser enviado via post.

Parmetros de entradaCampo nCdEmpresa Tipo String Descrio Seu cdigo administrativo junto ECT. O cdigo est disponvel no corpo do contrato firmado com os Correios. Senha para acesso ao servio, associada ao seu cdigo administrativo. A senha inicial corresponde aos 8 primeiros dgitos do CNPJ informado no contrato. A qualquer momento, possvel alterar a senha no endereo http://www.corporativo.correios.com.br/encomendas/s ervicosonline/recuperaSenha. Cdigo do servio: Cdigo 41106 40010 40045 40126 40215 40290 40096 40436 40444 81019 41068 40568 40606 81868 81833 81850 Servio PAC sem contrato SEDEX sem contrato SEDEX a Cobrar, sem contrato SEDEX a Cobrar, com contrato SEDEX 10, sem contrato SEDEX Hoje, sem contrato SEDEX com contrato SEDEX com contrato SEDEX com contrato e-SEDEX, com contrato PAC com contrato SEDEX com contrato SEDEX com contrato (Grupo 1) e-SEDEX, com contrato (Grupo 2) e-SEDEX, com contrato (Grupo 3) e-SEDEX, com contrato Obrigatrio No, mas o parmetro tem que ser passado mesmo vazio. No, mas o parmetro tem que ser passado mesmo vazio.

sDsSenha

String

nCdServico

String

Sim. Pode ser mais de um numa consulta separados por vrgula.

sCepOrigem sCepDestino nVlPeso nCdFormato

String String Decimal Int

CEP de Origem sem hfen.Exemplo: 05311900 CEP de Destino Sem hfem Peso da encomenda, incluindo sua embalagem. O peso deve ser informado em quilogramas. Formato da encomenda (incluindo embalagem). Valores possveis: 1 ou 2 1 Formato caixa/pacote 2 Formato rolo/prisma

Sim Sim Sim Sim

6/15Manual de Implementacao do Calculo Remoto de Precos e Prazos_versao_1.5.2.doc

EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT Manual de Implementao de Clculo Remoto de Preos e Prazos de Encomendas nVlComprimento Decimal Comprimento da encomenda (incluindo embalagem), em centmetros. nVlAltura nVlLargura nVlDiametro sCdMaoPropria Decimal Decimal Decimal String Altura da encomenda (incluindo embalagem), em centmetros. Largura da encomenda (incluindo embalagem), em centmetros. Dimetro da encomenda (incluindo embalagem), em centmetros. Indica se a encomenda ser entregue com o servio adicional mo prpria. Valores possveis: S ou N (S Sim, N No) Indica se a encomenda ser entregue com o servio adicional valor declarado. Neste campo deve ser apresentado o valor declarado desejado, em Reais. Indica se a encomenda ser entregue com o servio adicional aviso de recebimento. Valores possveis: S ou N (S Sim, N No) Indica a forma de retorno da consulta. XML Resultado em XML Popup Resultado em uma janela popup Resultado via post em uma pgina do requisitante

Sim. Sim. Sim. Sim. Sim.

nVlValorDeclarado

Decimal

sCdAvisoRecebimento

String

StrRetorno

String

Sim. Se no optar pelo servio informar zero. Sim. Se no optar pelo servio informar N Sim.

Parmetro de retornoCodigo_X Valor_X ValorMaoPropria_X ValorAvisoRecebimento_X ValorValorDeclarado_X PrazoEntrega_X Cdigo do Servio de Entrega. Preo total da encomenda, em Reais, incluindo os preos dos servios opcionais. Preo do servio adicional Mo Prpria. Preo do servio adicional Aviso de Recebimento. Preo do servio adicional Valor Declarado. Prazo estimado em dias para entrega do produto. Se o valor retornado for 0 (zero), indica que o prazo no foi retornado corretamente. Informa se a localidade informada possui entrega domiciliria. Se o prazo no for retornado corretamente, o retorno deste parmetro ser vazio. Informa se a localidade informada possui entrega domiciliria aos sbados. Se o prazo no for retornado corretamente, o retorno deste parmetro ser vazio. Os mesmos do Web Services. Retorna a descrio do erro gerado.

EntregaDomiciliar_X

EntregaSabado_X

Erro_X MsgErro_X

Obs: O X um ndice que varia de 1 at n (nmero de servios enviado no parmetro nCdServico). Por exemplo: se forem enviados dois cdigos de servio (40010,40044), o retorno conter os campos Cdigo_1 (com o valor 40010) e Codigo_2 (com o valor 40044).

7/15Manual de Implementacao do Calculo Remoto de Precos e Prazos_versao_1.5.2.doc

EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT Manual de Implementao de Clculo Remoto de Preos e Prazos de Encomendas

Exemplo de consulta com retorno no formato XMLhttp://ws.correios.com.br/calculador/CalcPrecoPrazo.aspx?nCdEmpresa=&sDsSenha=&sCepOrigem=719393 60&sCepDestino=72151613&nVlPeso=1&nCdFormato=1&nVlComprimento=20&nVlAltura=5&nVlLargura=15 &sCdMaoPropria=s&nVlValorDeclarado=200&sCdAvisoRecebimento=n&nCdServico=41106&nVlDiametro=0 &StrRetorno=xml

Exemplo de retorno no formato XML

8/15Manual de Implementacao do Calculo Remoto de Precos e Prazos_versao_1.5.2.doc

EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT Manual de Implementao de Clculo Remoto de Preos e Prazos de Encomendas

Exemplo de consulta com retorno no formato popuphttp://ws.correios.com.br/calculador/CalcPrecoPrazo.aspx?nCdEmpresa=&sDsSenha=&sCepOrigem=719393 60&sCepDestino=72151613&nVlPeso=1&nCdFormato=1&nVlComprimento=20&nVlAltura=5&nVlLargura=15 &sCdMaoPropria=s&nVlValorDeclarado=200&sCdAvisoRecebimento=n&nCdServico=41106&nVlDiametro=0 &StrRetorno=popup

Exemplo de retorno no formato popup

9/15Manual de Implementacao do Calculo Remoto de Precos e Prazos_versao_1.5.2.doc

EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT Manual de Implementao de Clculo Remoto de Preos e Prazos de Encomendas

Exemplo de consulta com retorno na pgina do requisitantehttp://ws.correios.com.br/calculador/CalcPrecoPrazo.aspx?nCdEmpresa=&sDsSenha=&sCepOrigem=719393 60&sCepDestino=72151613&nVlPeso=1&nCdFormato=1&nVlComprimento=20&nVlAltura=5&nVlLargura=15 &sCdMaoPropria=s&nVlValorDeclarado=200&sCdAvisoRecebimento=n&nCdServico=41106&nVlDiametro=0 &StrRetorno=http://ws.correios.com.br/calculador/popuptarifa.aspx

Exemplo de retorno na pgina do requisitante

10/15Manual de Implementacao do Calculo Remoto de Precos e Prazos_versao_1.5.2.doc

EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT Manual de Implementao de Clculo Remoto de Preos e Prazos de Encomendas

1.3

Cdigos e mensagens de erro

Cdigo de erro Mensagem de erro0 -1 -2 -3 -4 -5 -6 -7 -8 -9 -10 -11 -12 -13 -14 -15 -16 -17 -18 -19 -20 -21 -22 -23 -24 -25 -26 -27 -28 -29 -30 -31 -32 -33 -34 -35 Processamento com sucesso Cdigo de servio invlido CEP de origem invlido CEP de destino invlido Peso excedido O Valor Declarado no deve exceder R$ 10.000,00 Servio indisponvel para o trecho informado O Valor Declarado obrigatrio para este servio Este servio no aceita Mo Prpria Este servio no aceita Aviso de Recebimento Precificao indisponvel para o trecho informado Para definio do preo devero ser informados, tambm, o comprimento, a largura e altura do objeto em centmetros (cm). Comprimento invlido. Largura invlida. Altura invlida. O comprimento no pode ser maior que 90 cm. A largura no pode ser maior que 90 cm. A altura no pode ser maior que 90 cm. A altura no pode ser inferior a 2 cm. A altura no pode ser maior que o comprimento. A largura no pode ser inferior a 5 cm. A largura no pode ser menor que 11cm, quando o comprimento for menor que 25cm. O comprimento no pode ser inferior a 16 cm. A soma resultante do comprimento + largura + altura no deve superar a 160 cm. Comprimento invlido. Dimetro invlido Informe o comprimento. Informe o dimetro. O comprimento no pode ser maior que 90 cm. O dimetro no pode ser maior que 90 cm. O comprimento no pode ser inferior a 18 cm. O dimetro no pode ser inferior a 5 cm. A soma resultante do comprimento + o dobro do dimetro no deve superar a 104 cm. Sistema temporariamente fora do ar. Favor tentar mais tarde. Cdigo Administrativo ou Senha invlidos. Senha incorreta.11/15Manual de Implementacao do Calculo Remoto de Precos e Prazos_versao_1.5.2.doc

EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT Manual de Implementao de Clculo Remoto de Preos e Prazos de Encomendas

-36 -37 -38 -888 006 007 008 009 010 011 7 99

Cliente no possui contrato vigente com os Correios. Cliente no possui servio ativo em seu contrato. Servio indisponvel para este cdigo administrativo. Erro ao calcular a tarifa Localidade de origem no abrange o servio informado Localidade de destino no abrange o servio informado Servio indisponvel para o trecho informado CEP inicial pertencente a rea de Risco CEP final pertencente a rea de Risco CEP inicial e final pertencentes a rea de Risco Servio indisponvel, tente mais tarde Outros erros diversos do .Net

12/15Manual de Implementacao do Calculo Remoto de Precos e Prazos_versao_1.5.2.doc

EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT Manual de Implementao de Clculo Remoto de Preos e Prazos de Encomendas

1.4

Exemplo de aplicao cliente para consulta de preos e prazos via webservices:

Passos para Utilizao: Para testar copie os cdigos fonte de exemplo para um servidor web no wwwroot com os nomes frete.asp e frete2.asp respectivamente.

Cdigos Fontes Frete.asp Formulrio de Chamada Calculo de Frete Codigo: Senha: Servios: Cep Origem: Cep Destino: Peso: Formato: Caixa/pacote Rolo/prisma Comprimento: Altura: Largura: Dimetro: Mo prpria: Sim No 13/15Manual de Implementacao do Calculo Remoto de Precos e Prazos_versao_1.5.2.doc

EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT Manual de Implementao de Clculo Remoto de Preos e Prazos de Encomendas Valor declarado: Aviso de Recebimento: Sim No

Frete2.asp Requisio dos Dados

Em caso de dvidas ou informaes ligue para nossa Central de Atendimento ao Cliente Telefone 3003-088815/15Manual de Implementacao do Calculo Remoto de Precos e Prazos_versao_1.5.2.doc