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

Embed Size (px)

TRANSCRIPT

<p>EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT Manual de Implementao de Clculo Remoto de Preos e Prazos de Encomendas</p> <p>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: </p> <p>1/15Manual de Implementacao do Calculo Remoto de Precos e Prazos_versao_1.5.2.doc</p> <p>EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT Manual de Implementao de Clculo Remoto de Preos e Prazos de Encomendas</p> <p>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)</p> <p>1.2</p> <p>Consulta via Webservices: A interface do WebService pode ser consultada em:http://ws.correios.com.br/calculador/CalcPrecoPrazo.asmx</p> <p>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. .</p> <p>sDsSenha</p> <p>String</p> <p>nCdServico</p> <p>String</p> <p>Sim. Pode ser mais de um numa consulta separados por vrgula.</p> <p>sCepOrigem sCepDestino nVlPeso nCdFormato</p> <p>String String Decimal Int</p> <p>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.</p> <p>Sim Sim Sim Sim</p> <p>nVlComprimento</p> <p>Decimal</p> <p>Sim.</p> <p>2/15Manual de Implementacao do Calculo Remoto de Precos e Prazos_versao_1.5.2.doc</p> <p>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)</p> <p>Sim. Sim. Sim. Sim.</p> <p>nVlValorDeclarado</p> <p>Decimal</p> <p>sCdAvisoRecebimento</p> <p>String</p> <p>Sim. Se no optar pelo servio informar zero. Sim. Se no optar pelo servio informar N</p> <p>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.</p> <p>Resultado.Servicos.cServico[x].ValorMaoPropria Resultado.Servicos.cServico[x].ValorAvisoRecebimento Resultado.Servicos.cServico[x].ValorValorDeclarado Resultado.Servicos.cServico[x].EntregaDomiciliar</p> <p>Resultado.Servicos.cServico[x].EntregaSabado</p> <p>Resultado.Servicos.cServico[x].Erro Resultado.Servicos.cServico[x].MsgErro</p> <p>3/15Manual de Implementacao do Calculo Remoto de Precos e Prazos_versao_1.5.2.doc</p> <p>EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT Manual de Implementao de Clculo Remoto de Preos e Prazos de Encomendas</p> <p>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 </p> <p>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</p> <p>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 </p> <p>Exemplo do XML de resultado</p> <p>5/15Manual de Implementacao do Calculo Remoto de Precos e Prazos_versao_1.5.2.doc</p> <p>EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT Manual de Implementao de Clculo Remoto de Preos e Prazos de Encomendas</p> <p>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</p> <p>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.</p> <p>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.</p> <p>sDsSenha</p> <p>String</p> <p>nCdServico</p> <p>String</p> <p>Sim. Pode ser mais de um numa consulta separados por vrgula.</p> <p>sCepOrigem sCepDestino nVlPeso nCdFormato</p> <p>String String Decimal Int</p> <p>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</p> <p>Sim Sim Sim Sim</p> <p>6/15Manual de Implementacao do Calculo Remoto de Precos e Prazos_versao_1.5.2.doc</p> <p>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</p> <p>Sim. Sim. Sim. Sim. Sim.</p> <p>nVlValorDeclarado</p> <p>Decimal</p> <p>sCdAvisoRecebimento</p> <p>String</p> <p>StrRetorno</p> <p>String</p> <p>Sim. Se no optar pelo servio informar zero. Sim. Se no optar pelo servio informar N Sim.</p> <p>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.</p> <p>EntregaDomiciliar_X</p> <p>EntregaSabado_X</p> <p>Erro_X MsgErro_X</p> <p>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).</p> <p>7/15Manual de Implementacao do Calculo Remoto de Precos e Prazos_versao_1.5.2.doc</p> <p>EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT Manual de Implementao de Clculo Remoto de Preos e Prazos de Encomendas</p> <p>Exemplo de consulta com retorno no formato XMLhttp://ws.correios.com.br/calculador/CalcPrecoPrazo.aspx?nCdEmpresa=&amp;sDsSenha=&amp;sCepOrigem=719393 60&amp;sCepDestino=72151613&amp;nVlPeso=1&amp;nCdFormato=1&amp;nVlComprimento=20&amp;nVlAltura=5&amp;nVlLargura=15 &amp;sCdMaoPropria=s&amp;nVlValorDeclarado=200&amp;sCdAvisoRecebimento=n&amp;nCdServico=41106&amp;nVlDiametro=0 &amp;StrRetorno=xml</p> <p>Exemplo de retorno no formato XML</p> <p>8/15Manual de Implementacao do Calculo Remoto de Precos e Prazos_versao_1.5.2.doc</p> <p>EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT Manual de Implementao de Clculo Remoto de Preos e Prazos de Encomendas</p> <p>Exemplo de consulta com retorno no formato popuphttp://ws.correios.com.br/calculador/CalcPrecoPrazo.aspx?nCdEmpresa=&amp;sDsSenha=&amp;sCepOrigem=719393 60&amp;sCepDestino=72151613&amp;nVlPeso=1&amp;nCdFormato=1&amp;nVlComprimento=20&amp;nVlAltura=5&amp;nVlLargura=15 &amp;sCdMaoPropria=s&amp;nVlValorDeclarado=200&amp;sCdAvisoRecebimento=n&amp;nCdServico=41106&amp;nVlDiametro=0 &amp;StrRetorno=popup</p> <p>Exemplo de retorno no formato popup</p> <p>9/15Manual de Implementacao do Calculo Remoto de Precos e Prazos_versao_1.5.2.doc</p> <p>EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT Manual de Implementao de Clculo Remoto de Preos e Prazos de Encomendas</p> <p>Exemplo de consulta com retorno na pgina do requisitantehttp://ws.correios.com.br/calculador/CalcPrecoPrazo.aspx?nCdEmpresa=&amp;sDsSenha=&amp;sCepOrigem=719393 60&amp;sCepDestino=72151613&amp;nVlPeso=1&amp;nCdFormato=1&amp;nVlComprimento=20&amp;nVlAltura=5&amp;nVlLargura=15 &amp;sCdMaoPropria=s&amp;nVlValorDeclarado=200&amp;sCdAvisoRecebimento=n&amp;nCdServico=41106&amp;nVlDiametro=0 &amp;StrRetorno=http://ws.correios.com.br/calculador/popuptarifa.aspx</p> <p>Exemplo de retorno na pgina do requisitante</p> <p>10/15Manual de Implementacao do Calculo Remoto de Precos e Prazos_versao_1.5.2.doc</p> <p>EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT Manual de Implementao de Clculo Remoto de Preos e Prazos de Encomendas</p> <p>1.3</p> <p>Cdigos e mensagens de erro</p> <p>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....</p>