Manual de Implementacao Do Web Service SIGEPWEB Logistica Reversa

EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT
SIGEP Web - Manual de Implementao do Web Service
SIGEP WEB
Manual de Implementao de
Web Service Correios
1/74
Sumrio
SIGEP WEB Implementao e acesso ao Web Service....................................... 4
Pr-Requisitos ............................................................................................................. 5
Interface do Web Service SIGEP WEB ....................................................................... 6
Mtodos do Web Service do SIGEP WEB .................................................................. 6
Exemplo de tabelas para armazenamento em banco de dados.................................. 6
Viso Geral do Processo ............................................................................................. 7
Mtodo verificaDisponibilidadeServico() ................................................................... 12
Mtodo buscaCliente() .............................................................................................. 13
Mtodo consultaCEP() .............................................................................................. 14
Mtodo getStatusCartaoPostagem() ......................................................................... 14
Mtodo solicitaEtiquetas() ......................................................................................... 15
Mtodo geraDigitoVerificadorEtiquetas() ................................................................... 17
Mtodo fechaPlpVariosServicos() ............................................................................. 18
Especificao do Leiaute do XML ............................................................................. 23
Mtodo solicitaXmlPLP() ........................................................................................... 29
Web Service de Logstica Reversa ........................................................................ 31

Interface do Web Service de Logstica Reversa ........................................................ 31
Viso Geral do Processo Logstica Reversa .......................................................... 32
Mtodos do Web Service Logstica Reversa ............................................................. 35
Confeco de Etiquetas e Relatrios para Impresso .............................................. 47
Lista de Postagem (Voucher): ................................................................................... 47
Chancelas: ................................................................................................................ 48
Aviso de Recebimento (AR): ..................................................................................... 48
01 - Rtulo de Postagem (Etiqueta): ......................................................................... 50
02 - Algoritimo Gerao do dgito verificador ............................................................ 51
03 Layout 2D Data Matrix .................................................................................... 51
04 - Leiaute do arquivo XSD WS Sigep.................................................................. 54
05 - Cdigo da Diretoria Regional (tag <numero_diretoria>) .................................... 61
06 - Cdigo do Servio Adicional ............................................................................. 62
07 - Algoritmo e-ticket (Autorizao de Postagem) .................................................. 62
08 Rastreamento Correios ..................................................................................... 63
2/74
09 Cdigo Forma de Pagamento (tag <forma_pagamento>) ................................. 63

10 - Cdigo Pas Bandeira ........................................................................................ 64
11 - Cdigo do Tipo de Exportador ........................................................................... 64
12 - Cdigo da Natureza da Operao ...................................................................... 64
13 - Cdigo do Porte da Empresa ............................................................................ 64
14 - Cdigo da Unidade de Comercializao ............................................................ 64
15 - Cdigo da Moeda de Negociao ...................................................................... 65
16 - Tabela de Mensagem de Erro Logstica Reversa .............................................. 65
17 - Tabela de Produtos ............................................................................................ 67
18 - Leiaute de chancelas ......................................................................................... 69
18.1 - Chancela PAC ................................................................................................. 69
18.2 - Chancela SEDEX ............................................................................................ 70
18.3 - Chancela SEDEX 10 ....................................................................................... 71
18.4 - Chancela SEDEX Hoje.................................................................................... 72
18.5 - Chancela e-SEDEX ......................................................................................... 73
18.6 - Chancela Carta ............................................................................................... 74
3/74
SIGEP WEB Implementao e acesso ao Web Service

Os Correios disponibilizam gratuitamente, para clientes com contrato, um conjunto
de operaes acessveis via Web Service que possibilitam a integrao do Gerenciador
de Postagem dos Correios SIGEP WEB com sistemas proprietrios de cliente,
automatizando de forma personalizada o processo de organizao das postagens da sua
empresa ou rgo.
Esse servio de TI engloba um conjunto de mtodos que permitem automatizar a

prestao de servios qualificados como: SEDEX, Encomenda PAC, e-SEDEX entre
outros.
Na integrao utilizado os padres SOAP (Simple Object Access Protocol) e XML

(eXtended Markup Language), usados para troca de informaes entre sistemas
heterognios. Com a integrao dos sistemas, o processo obtem agilidade e eficincia na
comunicao entre cadeias de produo e ou logstica, pois passa a ser dinmica e
principalmente segura, levando em considerao que no haver interveno humana.
Os principais benefcios alcanados com esta integrao so listados a seguir:

Organizao e registro dos objetos em uma nica interface integrada aos
Correios;
Pesquisa de servios disponveis no carto de postagem;
Verificao do status do contrato e carto de postagem;
Antecipao do nmero de registro dos objetos antes mesmo da carga ser
encaminhada;
Maior celeridade no tratamento de objetos confiados aos Correios;
Gerao de Pr Lista de Postagem (PLP) que ficar aguardando a carga de
encomendas ser entregue na unidade de captao dos Correios;
Gesto unificada no sistema proprietrio do cliente de todos os processos
destinados a postagem: rastreamento ativo, consulta de CEP da base oficial,
pesquisa de abrangncia dos servios, prvia de faturamento em D+1 por
objeto postado, entre outras funcionalidades.
Alm disso, h outros servios tambm disponibilizados pelos Correios, que
podero ser agregados ao sistema do cliente:
4/74
Web Service de Clculo de Preos e Prazos de Encomendas

Proporciona a simulao de preo e prazo de entrega de mltiplos servios.
Os detalhes bem como o manual de implementao, podem ser obtidos no
endereo:http://www.correios.com.br/para-sua-empresa/servicos-para-o-seucontrato/precos-e-prazos/calculador-remoto-de-precos-e-prazos
WSDL: http://ws.correios.com.br/calculador/CalcPrecoPrazo.asmx?WSDL
Web Service de Rastreamento de Objetos
Os clientes podem efetuar consulta de rastreamento com at 5 mil objetos
por chamada. Um exemplo de utilizao do Web Service est no Anexo 08,
neste documento.
WSDL: http://webservice.correios.com.br/service/rastro/Rastro.wsdl
Pr-Requisitos
Para ter acesso a este servio, o cliente necessitar:
Possuir contrato com os Correios;
Solicitar ao representante comercial da ECT permisso de acesso para

utilizao do Web Service atravs de login e senha;
Implementar em seu sistema proprietrio as funcionalidades necessrias

para integrao com os mtodos descritos neste documento a exemplo
da seqncia lgica aqui descrita.
5/74
Interface do Web Service SIGEP WEB

A interface poder ser consultada e configurada no ambiente de desenvolvimento
(sistema proprietrio) no seguinte endereo:
Desenvolvimento:
https://apphom.correios.com.br/SigepMasterJPA/AtendeClienteService/AtendeCliente?wsdl
Para o acesso ao ambiente de desenvolvimento, podero ser utilizados os seguintes

dados para autenticao e testes de implementao:
Usurio
Senha
Cdigo Administrativo
Contrato
Cdigo Servio
Carto
sigep
n5f9t8
08082650
9912208555
...
0057018901
Obs: Para desenvolvimento, os cdigos de servios podem ser obtidos atravs do mtodo
buscaCliente(), exemplificado em tpico especfico neste manual.
Produo:
https://apps.correios.com.br/SigepMasterJPA/AtendeClienteService/AtendeCliente?wsdl
Obs: Para produo, devero ser utilizados os parmetros do contrato com os Correios.
Mtodos do Web Service do SIGEP WEB
Os mtodos e elementos necessrios para utilizao do Web Service sero

descritos e exemplificados logo abaixo.
Antes, porm, segue sugesto de esquema de tabelas que o cliente poder criar
para armazenar os dados a serem enviados e depois recebidos do Sistema de
Gerenciamento de Postagens dos Correios SIGEP WEB. Isso facilitar a gesto da
informao dos pedidos e servios de Correios utilizados.
Exemplo de tabelas para armazenamento em banco de dados

6/74
Exemplo de dados do modelo proposto:

Tb_Pedido
idPedido
notaFiscal
1
123456789
Tb_Pedido_Servico
idPedido
idServicosECT
codigoObjetoECT
109819
DL611459289BR
109819
DL611459292BR
Tb_Servicos_ECT
idServicosECT
codigoServicoECT
descricaoServicoECT
104625
40096
SEDEX - Contrato
109819
41068
PAC
Tb_Servicos_Cliente
idServicosECT
idCliente
109819
Tb_Cliente
idCliente
1
2
cartaoPostagem
0066000000
0066000001
contrato
991220000
991220000
cnpj
70111999000101
70111999000101
Viso Geral do Processo

7/74
Na viso aqui proposta, o processo de integrao envolve Correios e Cliente em

cinco etapas:
1. Inicializao: Nesta etapa o cliente consulta os Correios para verificar/validar a

situao do contrato/carto, seus servios disponveis e para reservar faixas de
nmeros de registro das encomendas, que sero consumidas pelo cliente ao longo
de um perodo pr-definido, gerenciando localmente os nmeros vlidos. O sistema
do cliente poder controlar o estoque desta numerao de forma automatizada.
Estes nmeros de registro identificam os objetos que sero postados nos Correios
e so chave para o rastreamento;
2. Atendimento Pedido: Contempla os passos mnimos para preparao fsica das
encomendas por parte do cliente. Permite a validao de preo, prazo,
disponibilidade do servio para o CEP destino, alm de selecionar a melhor forma
de entrega de acordo com a necessidade. O rtulo a ser impresso deve seguir o
padro proposto neste documento Anexo 01;
3. Pr-postagem: Fechamento da Pr-lista de Postagem PLP, dos pedidos
anteriormente atendidos. Estes pedidos sero consolidados diariamente em uma
nica lista a ser enviada de forma eletrnica aos Correios. O retorno ser um
nmero que identificar a PLP. Este nmero a chave para o recebimento das
encomendas nos Correios a ser disposto no voucher. O controle de expedio ser
atravs do voucher a ser gerado pelo sistema proprietrio modelo constante
neste documento;
4. Postagem: Apresenta os passos para a postagem das encomendas nos Correios;
5. Acompanhamento da Entrega: Nesta etapa, demonstra o gerenciamento das
encomendas encaminhadas/postadas nos Correios. Alm de obter o rastreamento
da encomenda no fluxo postal at o momento da sua entrega, ser tambm
possvel obter os dados atualizados da aferio/captao do atendimento e o valor
precificado no sistema de atendimento dos Correios, para cada encomenda.
8/74
9/74
10/74
11/74
Mtodo verificaDisponibilidadeServico()
Este mtodo ser responsvel por verificar a disponibilidade de servios em
especifico que no possuem abrangncia nacional (SEDEX 10, SEDEX 12, e-SEDEX).
Assinatura do mtodo:
verificaDisponibilidadeServico(codAdministrativo, numeroServico, cepOrigem, cepDestino, usuario,
senha)
Campo
Tipo
Descrio
Obrigatrio
codAdministrativo
String(8)
Sim
numeroServico
String
cepOrigem
String (8)
Cdigo Administrativo do contrato do Cliente com

a ECT.
Cdigos dos servios contratados, podendo ser
separados por vrgulas., Ex:
40215,81019...
CEP de Origem sem hfen.Exemplo: 70002900
cepDestino
String (8)
CEP de Destino sem hfen
Sim
usuario
String
Sim
senha
String
Usurio autenticador. (Fornecido pelo

Representante Comercial dos Correios)
Senha de autenticao. (Fornecida pelo
Sim
Sim
Sim
Retorno do mtodo:
Campo
return
Tipo
Boolean (true / false)
Exemplo:
Consulta:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:cli="http://cliente.bean.master.sigep.bsb.correios.com.br/">
<soapenv:Header/>
<soapenv:Body>
<cli:verificaDisponibilidadeServico>
<codAdministrativo>00000000</codAdministrativo>
<numeroServico>40215</numeroServico>
<cepOrigem>70002900</cepOrigem>
<cepDestino>81350120</cepDestino>
<usuario>*******</usuario>
<senha>*******</senha>
</cli:verificaDisponibilidadeServico>
</soapenv:Body>
</soapenv:Envelope>
Retorno:
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Body>
<ns2:verificaDisponibilidadeServicoResponse
xmlns:ns2="http://cliente.bean.master.sigep.bsb.correios.com.br/">
<return>true</return>
</ns2:verificaDisponibilidadeServicoResponse>
</S:Body>
</S:Envelope>
12/74
Mtodo buscaCliente()
Este mtodo retorna os servios disponveis no contrato para um determinado
carto de postagem. Este mtodo pode ser utilizado periodicamente para atualizar a
tabela Tb_Servicos_ECT acima descrita.
buscaCliente (idContrato, idCartaoPostagem, usuario, senha)
Campo
Tipo
Descrio
Obrigatrio
idContrato
String(10)
Nmero do contrato
Sim
idCartaoPostagem
String (10)
Carto de postagem vinculado ao contrato
Sim
usuario
String
Sim
senha
String

Sim
Exemplo:
Consulta:
<soapenv:Header/>
<soapenv:Body>
<cli:buscaCliente>
<idContrato>0000000000</idContrato>
<idCartaoPostagem>0000000000</idCartaoPostagem>
</cli:buscaCliente>
</soapenv:Body>
</soapenv:Envelope>
Retorno:
<S:Body>
<ns2:buscaClienteResponse xmlns:ns2="http://cliente.bean.master.sigep.bsb.correios.com.br/">
<return>
<cnpj>********</cnpj>
<contratos>
<cartoesPostagem>
<codigoAdministrativo>********</codigoAdministrativo>
<numero>********</numero>
<servicos>

<codigo>40096</codigo>
<descricao>SEDEX - CONTRATO</descricao>

<id>104625</id>
...
</cartoesPostagem>
<codigoDiretoria>10</codigoDiretoria>
</contratos>
</return>
</ns2:buscaClienteResponse>
</S:Body>
</S:Envelope>
13/74
Mtodo consultaCEP()
Este mtodo retorna o endereo atualizado da base dos Correios.
consultaCEP(cep)
Campo
Tipo
Descrio
Obrigatrio
Cep
String(8)
Nmero do cep sem hfen.
Sim
Exemplo:
Consulta:
<soapenv:Header/>
<soapenv:Body>
<cli:consultaCEP>
<cep>70002900</cep>
</cli:consultaCEP>
</soapenv:Body>
</soapenv:Envelope>
Retorno:
<S:Body>
<ns2:consultaCEPResponse xmlns:ns2="http://cliente.bean.master.sigep.bsb.correios.com.br/">
<return>
<bairro>Asa Norte</bairro>
<cep>70002900</cep>
<cidade>Braslia</cidade>
<complemento/>
<complemento2/>
<end>SBN Quadra 1 Bloco A</end>
<id>0</id>
<uf>DF</uf>
</return>
</ns2:consultaCEPResponse>
</S:Body>
</S:Envelope>
Mtodo getStatusCartaoPostagem()
Este mtodo retorna o status do carto de postagem. recomendada a pesquisa
peridica para evitar tentativa de postagens com carto cancelando, ocasionando a no
aceitao nos Correios ou atrasando o seu encaminhamento.
getStatusCartaoPostagem (numeroCartaoPostagem, usuario, senha)
14/74

Campo
Tipo
Descrio
Obrigatrio
numeroCartaoPostagem
String (10)
Carto de Postagem vinculado ao contrato
Sim
usuario
String
Sim
senha
String

Sim
Retorno do mtodo:
Campo
return
Tipo
Normal / Cancelado
Exemplo:
Consulta:
<soapenv:Header/>
<soapenv:Body>
<cli:getStatusCartaoPostagem>
<numeroCartaoPostagem>0000000000</numeroCartaoPostagem>
</cli:getStatusCartaoPostagem>
</soapenv:Body>
</soapenv:Envelope>
Retorno:
<S:Body>
<ns2:getStatusCartaoPostagemResponse
<return>Normal</return>
</ns2:getStatusCartaoPostagemResponse>
</S:Body>
</S:Envelope>
Mtodo solicitaEtiquetas()
Este mtodo retorna numerao de registro(s) dos Correios para futura postagem
de objeto(s). O nmero de registro o identificador do objeto no fluxo postal da ECT,
sendo utilizado como chave para rastreamento.
Com o atendimento da solicitao, o nmero de registro fica reservada para o
CNPJ informado. Quando da preparao do objeto para postagem, cada nmero poder
ser usado para gerao do rtulo de postagem no padro descrito no Anexo 01.
O mtodo contempla o pedido de um ou mais nmeros, por exemplo:
Situao 1: Aps a finalizao de um processo (Ex: Compra de um produto na loja
online), obter um nmero do registro da encomenda a ser postada.
Situao 2: Aguardar a finalizao de uma lista com n objetos a ser postada,
15/74
solicitando em seguida, uma faixa de numerao.

Situao 3: Solicitar uma quantidade maior de etiquetas e gerenci-la localmente
de acordo com os servios utilizados, com rotina de controle do estoque das etiquetas,
consumindo a numerao deste estoque. Recomendamos solicitar uma faixa de etiquetas
conforme previso de postagem do dia por servio (PAC, SEDEX, etc). Dessa forma
quando se esgotar o estoque de etiquetas para o servio, efetuar nova solicitao. Esse
processo evita a dependncia de solicitao on-line de etiquetas, permitindo um controle
local no sistema cliente.
Para cada tipo de servio dever ser solicitada uma faixa de numerao.
Este mtodo pode ser utilizado sob demanda, quantas vezes o cliente necessitar.
Importante: O nmero retornado no contm o dgito verificador. Para obteno
desse dgito, consuma o mtodo geraDigitoVerificadorEtiquetas ou implemente sua
prpria gerao do dgito verificador, conforme especificao e exemplo constantes do
Anexo 02.
solicitaEtiquetas(tipoDestinatario, identificador, idServico,
qtdEtiquetas, usuario,
senha)
Campo
Tipo
Descrio
Obrigatrio
tipoDestinatario
String (1)
Identificao com a letra C, de cliente.
Sim
identificador
String (14)
CNPJ da empresa. Ex: 00000000000000
Sim
idServico
Long (6)
Id do servio, porder ser obtido no mtodo buscaCliente().
Sim
qtdEtiquetas
Int
Sim
usuario
String
senha
String
Quantidade de etiquetas a serem solicitadas. Permite

solicitar 1 ou n etiquetas.
Usurio autenticador. (Fornecido pelo Representante
Comercial dos Correios)
Senha de autenticao. (Fornecida pelo Representante
Sim
Sim
Retorno do mtodo:
Campo
Tipo
return
String (Faixa de Numerao de Etiquetas)
Exemplo:
Consulta:
16/74

<soapenv:Header/>
<soapenv:Body>
<cli:solicitaEtiquetas>
<tipoDestinatario>C</tipoDestinatario>
<identificador>*******</identificador>
<idServico>104625</idServico>
<qtdEtiquetas>1</qtdEtiquetas>
</cli:solicitaEtiquetas>
</soapenv:Body>
</soapenv:Envelope>
Retorno:
<S:Body>
<ns2:solicitaEtiquetasResponse
<return>DL76023727 BR,DL76023727 BR</return>
</ns2:solicitaEtiquetasResponse>
</S:Body>
</S:Envelope>
Mtodo geraDigitoVerificadorEtiquetas()
Este mtodo retorna o dgito verificador de uma etiqueta ou um array.
geraDigitoVerificadorEtiquetas(etiquetas, usuario, senha)
Campo
Tipo
Descrio
Obrigatrio
Etiquetas
String(13)
Sim
usuario
String
senha
String
Dever ser uma String contendo o espao vazio

que ser gravado o digito verificador.
Ex: DL61145929 BR
Poder ser enviado individualmente ou um array.
Usurio
autenticador.
(Fornecido
pelo
Sim
Sim
Retorno do mtodo:
Campo
return
Tipo
Int(digitoVerificador), Sendo um array o retorno ser indexado na sequncia
enviada.
Exemplo:
Consulta:
<soapenv:Header/>
<soapenv:Body>
<cli:geraDigitoVerificadorEtiquetas>
<etiquetas>DL74668653 BR</etiquetas>
<etiquetas>DL76023727 BR</etiquetas>
17/74

</cli:geraDigitoVerificadorEtiquetas>
</soapenv:Body>
</soapenv:Envelope>
Retorno:
<S:Body>
<ns2:geraDigitoVerificadorEtiquetasResponse
<return>6</return>
<return>2</return>
</ns2:geraDigitoVerificadorEtiquetasResponse>
</S:Body>
</S:Envelope>
Mtodo fechaPlpVariosServicos()
Este mtodo responsvel por enviar as informaes dos objetos que sero
postados nos Correios. O controle do encaminhamento dos objetos fsicos ser por meio
de uma Pr-Llista de Postagem (Cdigo PLP). Permite o envio de vrios objetos de
diferentes servios, pois o campo listaEtiquetas um array dos objetos constantes no
XML. A seqncia dos objetos contidos no array listaEtiquetas dever ser a mesma do
XML, que tambm enviado por parmetro no momento de acionar o mtodo. Os objetos
informados no array listaEtiquetas no devem conter o dgito verificador. J no XML
obrigatrio informar o dgito verificador da etiqueta.
Os
nmeros
de
objeto
devero
ser obtidos
previamente pelo mtodo
solicitaEtiquetas(). Preferencialmente, essa PLP poder ser enviada na finalizao do

processo de postagem do dia, contemplando todos os objetos a serem expedidos em uma
nica lista. No entanto, possvel que seja fechada mais de uma PLP por dia, caso haja
esta necessidade dentro do processo do cliente. A seguir, informaremos o detalhamento
do mtodo.
fechaPlpVariosServicos(xml, idPlpCliente, cartaoPostagem, listaEtiquetas, usuario,
senha)
Campo
Tipo
Descrio
Obrigatrio
xml
String
Sim
idPlpCliente
Long
PLP (pr-lista de postagem) em formato XML conforme

exemplo abaixo (Exemplo de XML de PLP).
Cdigo identificador para uso de controle do cliente da
PLP enviada aos Correios.
Sim
18/74

cartaoPostagem
String (10)
listaEtiquetas
List<String>
usuario
String
senha
String
Cdigo que autoriza a postagem dos servios no

contrato.
Lista de objetos enviados via parmetro sem o digito
verificador, por exemplo:
List<String> listaEtiquetas = new ArrayList<String>();
listaEtiquetas.add("DL12345677BR");
listaEtiquetas.add("DF12345678BR");
Sim

Sim
Sim
Sim
Retorno do mtodo:
Campo
return
Tipo
Long (idPlpCliente)
Exemplo:
Consulta:
<soapenv:Header/>
<soapenv:Body>
<cli:fechaPlpVariosServicos>
<xml></xml> 
<idPlpCliente>123</idPlpCliente>
<cartaoPostagem>******</cartaoPostagem>
<listaEtiquetas>DL76023727BR</listaEtiquetas>
<listaEtiquetas>PH76023727BR</listaEtiquetas>
<usuario>******</usuario>
<senha>******</senha>
</cli:fechaPlpVariosServicos>
</soapenv:Body>
</soapenv:Envelope>
Retorno:
<S:Body>
<ns2:fechaPlpResponse xmlns:ns2="http://cliente.bean.master.sigep.bsb.correios.com.br/">
<return>1545168</return>
</ns2:fechaPlpResponse>
</S:Body>
</S:Envelope>
Exemplo do XML da PLP

<?xml version="1.0" encoding="ISO-8859-1" ?>
<correioslog>
<tipo_arquivo>Postagem</tipo_arquivo>
<versao_arquivo>2.3</versao_arquivo>
<plp>
<id_plp />
<valor_global />
<mcu_unidade_postagem />
<nome_unidade_postagem />
<cartao_postagem>********</cartao_postagem>
19/74

</plp>
<remetente>
<numero_contrato>********</numero_contrato>
<numero_diretoria>36</numero_diretoria>
<codigo_administrativo>********</codigo_administrativo>
<nome_remetente> <![CDATA[Empresa Ltda]]></nome_remetente>
<logradouro_remetente><![CDATA[Avenida Central]]></logradouro_remetente>
<numero_remetente>2370</numero_remetente>
<complemento_remetente><![CDATA[sala 1205,12 andar]]></complemento_remetente>
<bairro_remetente> <![CDATA[Centro]]></bairro_remetente>
<cep_remetente><![CDATA[70002900]]></cep_remetente>
<cidade_remetente><![CDATA[Braslia]]></cidade_remetente>
<uf_remetente>PR</uf_remetente>
<telefone_remetente><![CDATA[6112345008]]></telefone_remetente>
<fax_remetente><![CDATA[]]></fax_remetente>
<email_remetente> <![CDATA[cli@mail.com.br]]> </email_remetente>
</remetente>
<forma_pagamento />

<objeto_postal>
<numero_etiqueta>PH185560916BR</numero_etiqueta>
<codigo_objeto_cliente />
<codigo_servico_postagem>41068</codigo_servico_postagem>
<cubagem>0,0000</cubagem>
<peso>200</peso>
<rt1 />
<rt2 />
<destinatario>
<nome_destinatario><![CDATA[Destino Ltda]]></nome_destinatario>
<telefone_destinatario><![CDATA[6212349644]]> </telefone_destinatario>
<celular_destinatario><![CDATA[]]></celular_destinatario>
<email_destinatario><![CDATA[]]></email_destinatario>
<logradouro_destinatario><![CDATA[Avenida Central]]></logradouro_destinatario>
<complemento_destinatario> <![CDATA[Qd: 102 A Lt: 04]]></complemento_destinatario>
<numero_end_destinatario>1065</numero_end_destinatario>
</destinatario>
<nacional>
<bairro_destinatario><![CDATA[Setor Industrial]]></bairro_destinatario>
<cidade_destinatario><![CDATA[Goinia]]></cidade_destinatario>
<uf_destinatario>GO</uf_destinatario>
<cep_destinatario> <![CDATA[74000100]]></cep_destinatario>
<codigo_usuario_postal />
<centro_custo_cliente />
<numero_nota_fiscal>102030</numero_nota_fiscal>
<serie_nota_fiscal />
<valor_nota_fiscal />
<natureza_nota_fiscal />
<descricao_objeto> <![CDATA[]]></descricao_objeto>
<valor_a_cobrar>0,0</valor_a_cobrar>
</nacional>
<servico_adicional>

<codigo_servico_adicional>025</codigo_servico_adicional>
<valor_declarado>99,00</valor_declarado>
</servico_adicional>
<dimensao_objeto>
<tipo_objeto>002</tipo_objeto>
<dimensao_altura>20</dimensao_altura>
<dimensao_largura>30</dimensao_largura>
<dimensao_comprimento>38</dimensao_comprimento>
<dimensao_diametro>0</dimensao_diametro>
</dimensao_objeto>
<data_postagem_sara />
<status_processamento>0</status_processamento>
<numero_comprovante_postagem />
<valor_cobrado />
</objeto_postal>
</correioslog>
Exemplo de codificao do mtodo fechaPlpVariosServicos() PHP

Transcrevemos abaixo um mtodo simples de utilizao do mtodo fechar PLP
20/74
vrios servios. Poder ser adaptado em qualquer plataforma, seguindo esse exemplo do
ambiente de desenvolvimento.
<?php
$clientSoap = new SoapClient( "https://apphom.correios.com.br/SigepMasterJPA/AtendeClienteService/AtendeCliente?wsdl" );
$xml = "<?xml version=\"1.0\" encoding=\"ISO-88591\"?><correioslog><tipo_arquivo>Postagem</tipo_arquivo><versao_arquivo>2.3</versao_arquivo><plp><id_plp /><valor_global
/><mcu_unidade_postagem/><nome_unidade_postagem/><cartao_postagem>0057018901</cartao_postagem></plp><remetente><nu
mero_contrato>9912208555</numero_contrato><numero_diretoria>10</numero_diretoria><codigo_administrativo>08082650</codigo_
administrativo><nome_remetente><![CDATA[Empresa Teste]]></nome_remetente><logradouro_remetente><![CDATA[Avenida
Central]]></logradouro_remetente><numero_remetente>2370</numero_remetente><complemento_remetente><![CDATA[Sala 1205,
12andar]]></complemento_remetente><bairro_remetente><![CDATA[Centro]]></bairro_remetente><cep_remetente>80002900</cep_r
emetente><cidade_remetente><![CDATA[Curitiba]]></cidade_remetente><uf_remetente>PR</uf_remetente><telefone_remetente><![C
DATA[4130795008]]></telefone_remetente><fax_remetente><![CDATA[4191239321]]></fax_remetente><email_remetente><![CDATA[
cli@mail.com.br]]></email_remetente></remetente><forma_pagamento
/><objeto_postal><numero_etiqueta>SO000641962BR</numero_etiqueta><codigo_objeto_cliente/><codigo_servico_postagem>41068
</codigo_servico_postagem><cubagem>0,0000</cubagem><peso>2500</peso><rt1/><rt2/><destinatario><nome_destinatario><![CD
ATA[Cliente2]]></nome_destinatario><telefone_destinatario><![CDATA[6232339644]]></telefone_destinatario><celular_destinatario><!
[CDATA[6291239321]]></celular_destinatario><email_destinatario><![CDATA[cli2@mail.com.br]]></email_destinatario><logradouro_d
estinatario><![CDATA[Avenida Central2]]></logradouro_destinatario><complemento_destinatario><![CDATA[Qd: 102 A Lt:
04]]></complemento_destinatario><numero_end_destinatario>865</numero_end_destinatario></destinatario><nacional><bairro_desti
natario><![CDATA[Setor
Industrial]]></bairro_destinatario><cidade_destinatario><![CDATA[Goinia]]></cidade_destinatario><uf_destinatario>GO</uf_destinatar
io><cep_destinatario><![CDATA[74503100]]></cep_destinatario><codigo_usuario_postal/><centro_custo_cliente/><numero_nota_fisca
l>112233</numero_nota_fiscal><serie_nota_fiscal/><valor_nota_fiscal/><natureza_nota_fiscal/><descricao_objeto><![CDATA[]]></des
cricao_objeto><valor_a_cobrar>0,0</valor_a_cobrar></nacional><servico_adicional><codigo_servico_adicional>025</codigo_servico_
adicional><codigo_servico_adicional>001</codigo_servico_adicional><codigo_servico_adicional>019</codigo_servico_adicional><valo
r_declarado>3500,00</valor_declarado></servico_adicional><dimensao_objeto><tipo_objeto>002</tipo_objeto><dimensao_altura>50
</dimensao_altura><dimensao_largura>30</dimensao_largura><dimensao_comprimento>60</dimensao_comprimento><dimensao_di
ametro>0</dimensao_diametro></dimensao_objeto><data_postagem_sara/><status_processamento>0</status_processamento><num
ero_comprovante_postagem/><valor_cobrado/></objeto_postal><objeto_postal><numero_etiqueta>SL999221795BR</numero_etiquet
a><codigo_objeto_cliente/><codigo_servico_postagem>40096</codigo_servico_postagem><cubagem>0,0000</cubagem><peso>800
</peso><rt1/><rt2/><destinatario><nome_destinatario><![CDATA[Cliente3]]></nome_destinatario><telefone_destinatario><![CDATA[62
32339644]]></telefone_destinatario><celular_destinatario><![CDATA[6291239333]]></celular_destinatario><email_destinatario><![CD
ATA[cli3@mail.com.br]]></email_destinatario><logradouro_destinatario><![CDATA[Avenida
Central3]]></logradouro_destinatario><complemento_destinatario><![CDATA[Qd: 102 A Lt:
04]]></complemento_destinatario><numero_end_destinatario>285</numero_end_destinatario></destinatario><nacional><bairro_desti
natario><![CDATA[Central]]></bairro_destinatario><cidade_destinatario><![CDATA[Goinia]]></cidade_destinatario><uf_destinatario>
GO</uf_destinatario><cep_destinatario><![CDATA[74503100]]></cep_destinatario><codigo_usuario_postal/><centro_custo_cliente/><
numero_nota_fiscal>224455</numero_nota_fiscal><serie_nota_fiscal/><valor_nota_fiscal/><natureza_nota_fiscal/><descricao_objeto>
<![CDATA[]]></descricao_objeto><valor_a_cobrar>0,0</valor_a_cobrar></nacional><servico_adicional><codigo_servico_adicional>02
5</codigo_servico_adicional><codigo_servico_adicional>001</codigo_servico_adicional><codigo_servico_adicional>019</codigo_serv
ico_adicional><valor_declarado>1000,00</valor_declarado></servico_adicional><dimensao_objeto><tipo_objeto>002</tipo_objeto><di
mensao_altura>40</dimensao_altura><dimensao_largura>50</dimensao_largura><dimensao_comprimento>30</dimensao_comprime
nto><dimensao_diametro>0</dimensao_diametro></dimensao_objeto><data_postagem_sara/><status_processamento>0</status_pro
cessamento><numero_comprovante_postagem/><valor_cobrado/></objeto_postal></correioslog>";
$idPlpCliente = "1L";
$cartaoPostagem = "0057018901";
/* Retirar o digto verificador dos objetos do array e seguir a mesma sequncia do XML */
$listaEtiquetas = array('SO00064196BR', 'SL99922179BR');
$params = array('xml' => $xml, 'idPlpCliente' => $idPlpCliente, 'cartaoPostagem' => $cartaoPostagem, 'listaEtiquetas' =>
$listaEtiquetas, 'usuario' => 'sigep' , 'senha' => 'n5f9t8');
$result = $clientSoap->fechaPlpVariosServicos($params);
print_r($result);
?>
Consideraes importantes para a construo do XML:

1. O XSD que efetua a validao deste XML, poder ser consultado no Anexo
04 deste documento e dever, necessariamente, validar o XML, antes de
fechar a PLP .
2. Utilizar o <![CDATA[ ]]> nos campos texto, para evitar problemas com
caracteres especiais que poderiam corromper o xml (&, %, etc).
21/74
3. Ao incluir o arquivo XML no mtodo (fechaPlp ou fechaPlpVariosServicos),

excluir os terminadores de linha, para que o arquivo seja transportado de
forma linear.
4. Para enviar o XML no mtodo fechaPlpVariosServicos ou fechaPlp, retirar o
dgito verificador do cdigo da etiqueta na assinatura do mtodo.
5. Os dados de contrato, cdigo administrativo e carto de postagem, devem
estar previamente cadastrados e dentro da vigncia. possvel consultar o
status
do
carto
de
postagem
atravs
do
mtodo
getStatusCartoPostagem() e obter todos os servios disponveis no

carto atravs do mtodo buscaCliente(). Essa consulta importante para
evitar erros ao enviar uma lista de postagem num carto com data de
vencimento j expirada.
6. O servio postado deve estar associado ao carto de postagem, informao
obtida atravs do mtodo buscaCliente().
7. O nmero da etiqueta obrigatrio. Apenas objetos registrados podem ser
postados. Desta forma, o cdigo adicional de nmero 025, referente ao
servio
adicional
Registro,
deve
sempre
ser
declarado
na
tag
<codigo_servico_adicional> para cada objeto postado.

8. As etiquetas utilizadas no arquivo devem pertencer ao cliente e a sigla deve
estar associada ao servio a ser postado, informao obtida atravs do
mtodo solicitaEtiquetas(). Ou seja, se no XML a etiqueta informada for do
servio SEDEX, o cdigo do servio deve ser tambm relacionado a este
mesmo servio SEDEX. Esse relacionamento de servio/cdigo poder ser
consultado atravs do mtodo buscaCliente().
9. Todas as TAGS devem ser declaradas no XML, mesmo as no obrigatrias.
Caso no tenham contedo, devem ser declaradas vazias.
10. A homologao da comunicao entre sistema proprietrio e Correios
ocorrer da seguinte forma: Atravs de um nmero de PLP retornado pelo
mtodo fechaPLP dever ser enviado ao representante comercial. O teste
ser efetuado captando esta PLP na unidade de atendimento/operacional
dos Correios, se no houver nenhum erro no sistema de atendimento dos
Correios, a comunicao/homologao estar vlida. Recomendamos antes
de chamar o mtodo fechaPLP, validar o XML no XSD constante do Anexo
04 deste documento.
22/74
11. Haver necessidade da homologao dos rtulos de postagem, ser

efetuado leitura das mquinas dos Correios na unidade de atendimento ou
operacional. Para o teste do rtulo ser necessria a impresso fsica do
cliente e encaminhando ao representante comercial que ir homologar junto
a unidade de atendimento dos Correios. O padro a ser utilizado consta
neste documento no anexo 01.
12. O rtulo dos Correios contempla a etiqueta 2D (DataMatrix). O layout do 2D
consta do Anexo 03.
Especificao do Leiaute do XML

O leiaute dividido nas seguintes tags:
<?xml version="1.0" encoding="ISO-8859-1" ?>
Encoding padro dos Correios para o xml.
<correioslog>
a tag principal. Identifica o arquivo como pertencente ao sistema CorreiosLOG.
<tipo_arquivo>
Identifica qual o tipo do arquivo dentro do sistema CorreiosLOG. Permite a
distino entre os diversos tipos de arquivos que o sistema CorreiosLOG processa. Para
este leiaute, dever ser preenchido: Postagem
Observao: campo obrigatrio
<versao_arquivo>
Identifica a verso do leiaute do arquivo XML. A verso deste leiaute a: 2.3
Observao: campo obrigatrio
Tag <plp>
Tags
Descrio
Tipo de dados
Observaes
<id_plp>
Identifica o registro da PLP Pr Lista de
Numrico(10)
Preenchimento
Postagem que ser retornada atravs do
no
obrigatrio.
mtodo fechaPLP e sendo chave para o

atendimento nos Correios dos objetos a serem
postados.
23/74

Dever obrigatoriamente ser enviada vazia,
por exemplo: <id_plp />
<valor_global>
Valor em reais do total da tarificao dos
Numrico(10,2)
objetos da PLP, que ser retornada atravs do
Preenchimento
no
obrigatrio.
mtodo solicitaXmlPlp quando postada.

<mcu_unidade_postagem>
Identifica
unidade
de
postagem
dos
Caractere(12)
Correios.
<nome_unidade_postagem>
Nome da unidade de postagem dos Correios.
Preenchimento
no
obrigatrio.
Caractere(30)
Preenchimento
no
obrigatrio.
<cartao_postagem>
Numero do carto do cliente associado PLP.
Caractere(10)
Ex: 0087654321 (sempre com 10 caracteres
Preenchimento
Obrigatrio
inserir zeros esquerda).
Tag <remetente>
Identifica o remetente da postagem. Esta Tag dever aparecer somente uma vez
no arquivo. Os dados necessrios para o remetente so:
Tags
Descrio
Tipo de dados
Observaes
<numero_contrato>
Nmero do contrato do cliente
Caractere(10)
Preenchimento
Obrigatrio.
No
pode
existir
caractere - entre os
nmeros.
<numero_diretoria>
Nmero da Diretoria Regional do contrato do
Numerico(2)
cliente, conforme Anexo 05.

<codigo_administrativo>
Cdigo administrativo do cliente
Preenchimento
Obrigatrio.
Caractere(8)
Preenchimento
Obrigatrio
No
pode
existir
nmeros.
<nome_remetente>
Nome do remetente
Caractere(50)
Preenchimento
Obrigatrio
<logradouro_remetente>
Logradouro do remetente.
Caractere(40)
Recomendado utilizar o mtodo buscaCEP()
<numero_remetente>
Parte do endereo
Preenchimento
Obrigatrio
Caractere(5)
Preenchimento
Obrigatrio
<complemento_remetente>
Complemento do endereo
Caractere(20)
Preenchimento
no
obrigatrio.
<bairro_remetente>
Bairro do remetente
Caractere(20)
Preenchimento
Obrigatrio
<cep_remetente>
CEP do remetente
Numrico(8)
Preenchimento
Obrigatrio
99999999
No
pode
existir
24/74

nmeros.
<cidade_remetente>
Cidade do remetente
Caractere(30)
<uf_remetente>
Unidade de Federao
Caractere(2)
<telefone_remetente>
Telefone do remetente
Numrico (12)
Preenchimento
Obrigatrio
Preenchimento
Obrigatrio
Preenchimento
no
obrigatrio.
99999999999
No
pode
existir
nmeros
<fax_remetente>
Fax do remetente
Numrico (12)
Preenchimento
no
obrigatrio.
99999999999
No
pode
existir
nmeros
<email_remetente>
Email do remetente
Caractere (50)
Preenchimento
no
obrigatrio.
Tag <forma_pagamento>
Valor numrico indicando a forma de pagamento utilizada pelo cliente para realizar
a postagem.
Observao: campo no obrigatrio.
Para postagens a faturar enviar a tag vazia, por exemplo: <forma_pagamento />
Tag <objeto_postal >

Tag delimitadora do objeto que ser postado. Esta tag contm as caractersticas do
objeto postado. Para postagens de n objetos, esta tag dever ser repetida conforme a
quantidade de objetos desejados.
Tags
Descrio
Tipo de dados
Observaes
<numero_etiqueta>
Nmero do Objeto na ECT. Importante:
Caractere(13)
Preenchimento
aqui dever constar: nmero do objeto +

digito
verificador.
Obrigatrio
Exemplo:
DF12345678 9 BR
<codigo_objeto_cliente>
Cdigo de controle do objeto no cliente
Caractere(20)
Preenchimento
no obrigatrio.
<codigo_servico_postagem>
Cdigo do servio da postagem, por
Caractere(5)
exemplo: 40215, 40096, etc.
Preenchimento
obrigatrio
<cubagem>
Cubagem do Objeto
Numrico(9,2)
<peso>
Peso do objeto (em gramas)
Numrico(5)
Preenchimento
no obrigatrio.
Preenchimento
25/74

Obrigatrio.
<rt1>
Reservado para observao do cliente
Caractere(255)
<rt2>
Reservado para observao do cliente
Caractere(255)
+ <destinatario>
Dados do destinatrio
Preenchimento
no obrigatrio.
Preenchimento
no obrigatrio.
Preenchimento
Obrigatrio
+ <nacional>
Dados relevantes a postagem nacional
Preenchimento
Obrigatrio
+ <servico_adicional>
+ <dimensao_objeto>
Identifica os servios adicionais do
Preenchimento
objeto postado
Obrigatrio
Contm as dimenses do objeto (altura,
Preenchimento
largura, comprimento e dimetro) e o tipo
Obrigatrio.
do objeto (embalagem)
<data_postagem_sara>
Contm
data
de
efetivao
da
Preenchimento
postagem.
<status_processamento>
no obrigatrio.
Contm o STATUS do processamento

do
objeto,
dever
ser
enviado
Caractere(1)
Preenchimento
Obrigatrio.
informao com valor igual a 0.

<numero_comprovante_postagem>
Contm o numero de comprovante de
Numrico(10)
Preenchimento
postagem.
<valor_cobrado>
Valor que foi tarifado no Sistema de
no obrigatrio.
Numrico(10,2)
Preenchimento
Atendimento da Agncia dos Correios.
no obrigatrio.
Tag <destinatario>
Esta tag contm os dados do destino da encomenda.

Tags
Descrio
Tipo de dados
Observaes
<nome_destinatario>
Nome do destinatrio
Caractere(50)
Preenchimento
Obrigatrio.
<telefone_destinatario >
Telefone do Destinatrio
Numrico (12)
Preenchimento
no
obrigatrio.
99999999999
No
pode
existir
nmeros
<celular_destinatario>
Celular do Destinatrio
Numrico (12)
Preenchimento
no
obrigatrio.
99999999999
No
pode
existir
nmeros
<email_destinatario>
Email do Destinatrio
Caractere(50)
Preenchimento
no
obrigatrio.
26/74

<logradouro_destinatario>
Logradouro do destinatrio. Recomendado
Caractere(50)
Preenchimento
utilizar o mtodo buscaCEP()
<complemento_destinatario>
Obrigatrio.
Caractere(30)
Preenchimento
no
obrigatrio.
<numero_end_destinatario>
Parte do endereo
Caractere(5)
Preenchimento
Obrigatrio.
Tag <nacional>
A tag <nacional> dever estar dentro da tag <objeto_postal> e conter os atributos
especficos de uma postagem de objetos nacionais.
Tags
Descrio
Tipo de dados
Observaes
<bairro_destinatario>
Bairro do destinatrio
Caractere(30)
Preenchimento Obrigatrio.
<cidade_destinatario>
Cidade do destinatrio
Caractere(30)
<uf_destinatario>
Sigla da UF do destinatrio
Caractere(2)
Preenchimento Obrigatrio
<cep_destinatario>
CEP do destinatrio
Numrico(8)
Preenchimento
Obrigatrio 99999999
No pode existir o caractere -
entre os nmeros.
<codigo_usuario_postal>
Cdigo do usurio postal
Caractere(20)
Preenchimento no obrigatrio.
<centro_custo_cliente>
Centro de custo do cliente
Caractere(20)
<numero_nota_fiscal>
Nmero da nota fiscal. Se torna
Numrico(7)
Preenchimento Obrigatrio para
obrigatrio
se
servio
for
encomenda PAC.
Encomenda PAC 41068

<serie_nota_fiscal>
Srie
da
nota
obrigatrio
se
fiscal.
o
Se
servio
torna
Caractere(20)
for
Preenchimento Obrigatrio para

encomenda PAC.
Encomenda PAC 41068

<valor_nota_fiscal>
Valor da nota fiscal
Numrico(9,2)
<natureza_nota_fiscal>
Natureza da nota fiscal
Caractere(0)
Dever
ser
enviada
sem
preenchimento nenhum.
<descricao_objeto>
Descrio do objeto
Caractere(20)
<valor a cobrar >
Valor a cobrar do destinatrio
Numrico(9,2)
Obrigatrio para o servio na

modalidade a cobrar.
Tag <servico_adicional>
27/74
A tag <servico_adicional> dever estar dentro da tag <objeto_postal> e conter os

seguintes atributos do objeto:
Tags
Descrio
Tipo de dados
Observaes
<codigo_servico_adicional>
Cdigo do servio adicional
Caractere (3)
O servio adicional
025,
referente ao registro, deve

sempre ser informado.
Casos os servios postados
pelo cliente possuam outros
servios
devem
adicionais,
estes
tambm
ser
informados conforme Anexo

06.
<valor_declarado>
Valor do seguro adicional declarado pelo Numrico (9,2)
Se
cdigo
do
servio
cliente.
adicional for igual a 019 o

campo obrigatrio
Tag <dimenso_objeto>
A tag <dimensao_objeto> dever estar dentro da tag <objeto_postal> e conter os

seguintes atributos:
Tags
<tipo_objeto>
Descrio
Contm o cdigo do tipo de objeto
Tipo de dados
Caractere (3)
Observao
Para 001 No prencher as tags de
que foi postado (embalagem)

001 - Envelope
dimenses.
002 - Pacote / Caixa
Para 002 Preencher as tags: altura,
003 - Rolo / Cilindro
largura e comprimento.
Para 003 Preencher as tags: comprimento
e dimetro.
<dimensao_altura>
Altura do objeto (em cm)
Inteiro (5)
Para:
<tipo_objeto> = 001, preencher com 0
<tipo_objeto> = 002, obrigatrio
<dimensao_largura>
Largura do objeto (em cm)
Inteiro (5)
Para:
28/74

<dimensao_comprimento>
Comprimento do objeto (em cm)
Inteiro (5)
Para:
<dimensao_diametro>
Dimetro do objeto (em cm)
Inteiro (5)
Para:
Mtodo solicitaXmlPLP()
Este mtodo retorna o mesmo xml da PLP que foi anteriormente enviada pelo
cliente no fechamento da PLP, sendo atualizado no ato da postagem dos objetos nos
Correios, com informaes aferidas nas seguintes tags:
Tags
Descrio
Tipo de dados
<valor_global>
Valor da tarifao total da PLP.
Numrico(10,2)
<mcu_unidade_postagem>
Cdigo da unidade de postagem
Caractere(12)
Observao
dos Correios
<nome_unidade_postagem>
Nome da unidade de postagem
Caractere(30)
dos Correios.
<cubagem>
Cubagem do Objeto
Numrico(9,2)
<peso>
Peso do objeto (em gramas)
Numrico(5)
<dimensao_altura>
Altura do objeto (em cm)
Inteiro (5)
<dimensao_largura>
Largura do objeto (em cm)
Inteiro (5)
<dimensao_comprimento>
Comprimento do objeto (em cm)
Inteiro (5)
<dimensao_diametro>
Dimetro do objeto (em cm)
Inteiro (5)
<data_postagem_sara>
Contm a data de efetivao da

postagem.
<status_processamento>
Contm o STATUS do
Caractere(1)
processamento do objeto, quando

postado igual a 1.
<numero_comprovante_postagem>
Contm o numero de comprovante
Numrico(10)
de postagem do sistema de
Atendimento dos Correios.
<valor_cobrado>
Valor que foi precificado no
Numrico(10,2)
Sistema de Atendimento da
Unidade dos Correios para o
objeto.
solicitaXmlPlp (idPlpMaster, usuario, senha)
Campo
Tipo
Descrio
Obrigatrio
29/74

idPlpMaster
Inteiro
Nmero da PLP (pr-lista de postagem).
Sim
usuario
String
Sim
senha
String

Sim
Retorno do mtodo:
Campo
return
Tipo
Xml
Exemplo:
Consulta:
<soapenv:Header/>
<soapenv:Body>
<cli: solicitaXmlPlp>
<idPlpMaster>1234567</idPlpMaster>
<usuario>******</usuario>
<senha>******</senha>
</cli: solicitaXmlPlp>
</soapenv:Body>
</soapenv:Envelope>
30/74
Web Service de Logstica Reversa

Esse Web Service especifico para Logstica Reversa que possui mtodos
necessrios para integrao entre o sistema proprietrio e os Correios.
Interface do Web Service de Logstica Reversa

A interface do Web Service de Logstica Reversa poder ser consultada e
configurada nos seguintes endereos:
Desenvolvimento:
http://webservicescolhomologacao.correios.com.br/ScolWeb/WebServiceScol?wsdl
Para o acesso ao ambiente de desenvolvimento, podero ser utilizados os

seguintes dados para autenticao e testes de implementao:
Usurio
Senha
Cd Administrativo
Contrato
Cd Serv
Carto
60618043
8o8otn
08082650
9912208555
41076
0057018901
Produo:
http://webservicescol.correios.com.br/ScolWeb/WebServiceScol?wsdl
necessrio, para acesso ao ambiente em produo, solicitar login e senha,

enviando os seguintes dados abaixo para o gestor do seu contrato com os Correios. O email informado ser definido como login de acesso ao ambiente, ao que recomendamos
que seja um e-mail corporativo.
Nmero Contrato
Carto de Postagem
Cdigo Administrativo
Razo Social
E-mail
Obs: O ambiente estar sujeito a evolues. Os clientes integrados sero avisados por email com antecedncia de no mnimo 30 dias, atravs do mtodo sobreWebService().
J estaro disponveis no ambiente de desenvolvimento, as manutenes com data
programada para entrar em produo.
31/74
Viso Geral do Processo Logstica Reversa

Na viso aqui proposta, o processo de integrao envolve Correios, Cliente e
Consumidor em trs etapas:
1. Inicializao: Nesta etapa o cliente consulta os Correios para verificar se h novas

informaes sobre o servio ou ambiente do Web Service, sendo mais um canal de
comunicao de forma automatizada, podendo ser parametrizado como um pralerta no sistema proprietrio. Por meio deste canal sero postadas informaes
sobre versionamento da aplicao, novas funcionalidades ou manutenes
programadas;
2. Postagem do Pedido: Contempla a interao do consumidor com o cliente que
solicita uma autorizao de postagem/coleta. O sistema proprietrio ir processar a
solicitao do consumidor junto aos Correios, que retornar uma autorizao de
postagem/coleta a este consumidor via email e/ou SMS. Neste momento, o
consumidor estar apto para encaminhar sua encomenda de acordo com o servio
autorizado pelo nosso cliente com contrato;
3. Acompanhamento
do
Pedido:
Nesta
etapa
ser
possvel
ao
cliente
acompanhar/gerenciar as autorizaes de postagem/coleta disponibilizadas ao seu

consumidor. Quando o consumidor efetuar a postagem/coleta, o sistema
proprietrio do cliente poder obter a informao do nmero da etiqueta de registro
e efetuar o rastreamento da encomenda no fluxo postal at o momento de sua
entrega.
32/74
33/74
34/74
Mtodos do Web Service Logstica Reversa

Mtodo solicitarRange()
Este mtodo retorna uma faixa de numerao de autorizao de postagem (eticket) a ser gerenciada no sistema proprietrio para o servio de logstica reversa. Para
cada nmero se faz necessrio calcular o dgito verificador, podendo ser consumido o
mtodo calcularDigitoVerificador() ou ainda a sua implementao local, conforme exemplo
do Anexo 07. Recomendado utilizar este mtodo apenas de forma contigencial.
Exemplo:
Consulta:
xmlns:web="http://webservice.scol.correios.com.br/">
<soapenv:Header/>
<soapenv:Body>
<web:solicitarRange>
<usuario>60618043</usuario>
<senha>8o8otn</senha>
<codAdministrativo> 08082650</codAdministrativo>
<contrato>9912208555</contrato>
<!-AP = Autorizao Postagem
LR = Logistica Reversa
LE - Logistica Reversa PAC
LS - Logistiva Reversa Sedex
LV - Logistiva Reversa e-Sedex
-->
<tipo>AP</tipo>

<servico></servico>
<quantidade>1</quantidade>
</web:solicitarRange>
</soapenv:Body>
</soapenv:Envelope>
Retorno:
<S:Body>
<ns2:solicitarRangeResponse xmlns:ns2="http://webservice.scol.correios.com.br/">
<return>
<cod_erro>0</cod_erro>
<data>01/05/2013</data>
<faixa_final>17084003</faixa_final>
<faixa_inicial>17084003</faixa_inicial>
<hora>15:57</hora>
</return>
</ns2:solicitarRangeResponse>
</S:Body>
</S:Envelope>
35/74
Mtodo calcularDigitoVerificador()
Este mtodo calcula o dgito verificador da numerao da faixa retornada do
mtodo solicitarRange(). Com o dgito verificador calculado, o nmero (Autorizao de
Postagem / e-ticket) est apto a ser disponibilizado ao cliente para efetuar a postagem
em uma unidade/agncia dos Correios. Recomendado antes da disponibilizao ao
cliente efetuar o processamento atravs do mtodo solicitarPostagemReversa().
Exemplo:
Consulta:
<soapenv:Header/>
<soapenv:Body>
<web:calcularDigitoVerificador>
<numero>15733879</numero>
</web:calcularDigitoVerificador>
</soapenv:Body>
</soapenv:Envelope>
Retorno:
<S:Body>
<ns2:calcularDigitoVerificadorResponse xmlns:ns2="http://webservice.scol.correios.com.br/">
<return>
<data>01/05/2013</data>
<digito>6</digito>
<hora>16:07</hora>
</return>
</ns2:calcularDigitoVerificadorResponse>
</S:Body>
</S:Envelope>
Mtodo solicitarPostagemReversa()
Este mtodo processa o pedido de autorizao de postagem ou coleta de forma
online nos Correios. Poder ser efetuado at 50 solicitaes simultneas em uma nica
chamada, sendo uma lista de coletas_solicitadas.
Obs: Para o tipo C = Coleta, no poder ser utilizado a nmerao obtida pelo
mtodo solicitarRange(), dever ser consumido o mtodo solicitarPostagemReversa(),
sem informar a tag nmero. O servio de coleta domiciliria requer validao da rea de
36/74
abrangncia conforme o parmetro CEP.
Exemplo:
Consulta:
<soapenv:Header/>
<soapenv:Body>
<web:solicitarPostagemReversa>
<contrato> 9912208555</contrato>
<codigo_servico>41076</codigo_servico>
<cartao> 0057018901</cartao>
<destinatario>
<bairro>Centro</bairro>
<cep>70002900</cep>
<complemento>Residencial Central</complemento>
<ddd>61</ddd>
<email>cli@email.com.br</email>
<logradouro>Qd 301</logradouro>
<nome>Fulano</nome>
<numero>10</numero>
<referencia></referencia>
<telefone>6133331234</telefone>
<uf>DF</uf>
</destinatario>
<coletas_solicitadas>
<!-2:Solicitao de Checklist Celular
4: Solicitao de Checklist Eletrnico
-->
<cklist>2</cklist>
<descricao></descricao>
<id_cliente>102030</id_cliente>
<produto>

<codigo></codigo>
<qtd></qtd>
<tipo></tipo>
</produto>
<remetente>
<cep>80002900</cep>
<cidade>Curitiba</cidade>
<complemento>Bloco II</complemento>
<ddd>41</ddd>

<email>cli@email.com.br</email>
<logradouro>Rua Joo Negro</logradouro>
<nome>Ciclano</nome>
<referencia></referencia>
<uf>PR</uf>
<celular></celular>
<ddd_celular></ddd_celular>
<sms>N</sms>
<identificacao></identificacao>
</remetente>
<!-C - Coleta
A - Autorizao Postagem
CA Caso no exista coleta, a solicitao poder ser uma Autorizao de Postagem
-->
<tipo>A</tipo>
37/74

<!Valor declarado do objeto -->
<valor_declarado>1000.00</valor_declarado>
<ag>5</ag>
<ar>1</ar>
<cartao></cartao>
<!-Nmero da Autorizao de Postagem.
Usado quando o cliente j possui uma faixa
numrica reservada desse tipo de solicitao.
-->
<numero></numero>
<obj_col>
<desc></desc>
<entrega></entrega>
<id>12344321</id>

<item>1</item>
<num></num>
</obj_col>
<servico_adicional></servico_adicional>
</coletas_solicitadas>
</web:solicitarPostagemReversa>
</soapenv:Body>
</soapenv:Envelope>
Retorno:
<S:Body>
<ns2:solicitarPostagemReversaResponse xmlns:ns2="http://webservice.scol.correios.com.br/">
<return>
<data_processamento>01/05/2013</data_processamento>
<hora_processamento>16:42</hora_processamento>
<msg_erro/>
<resultado_solicitacao>
<codigo_erro>0</codigo_erro>
<data_solicitacao>01/05/2013</data_solicitacao>
<descricao_erro/>
<hora_solicitacao>16:42</hora_solicitacao>
<id_obj>12344321</id_obj>
<numero_coleta>170840044</numero_coleta>
<numero_etiqueta/>
<prazo>06/05/2013</prazo>
<status_objeto>01</status_objeto>
<tipo>A</tipo>
</resultado_solicitacao>
</return>
</ns2:solicitarPostagemReversaResponse>
</S:Body>
</S:Envelope>
Mtodo cancelarPedido()
Com este mtodo ser possvel efetuar o cancelamento / desistncia de um pedido
de autorizao de postagem e solicitao de coleta disponibilizado ao cliente. O
cancelamento do pedido somente ser possvel se a tag de retorno descricao_status
(mtodo acompanharPedido()) estiver como A Coletar para o servio de coleta ou
Aguardando Objeto na Agncia para pedidos de Autorizao de Postagem, neste caso
ainda no houve nenhum evento de atendimento desta solicitao.
38/74
Exemplo:
Consulta:
<soapenv:Header/>
<soapenv:Body>
<web:cancelarPedido>
<numeroPedido>170840044</numeroPedido>
<tipo>A</tipo>
</web:cancelarPedido>
</soapenv:Body>
</soapenv:Envelope>
Retorno:
<S:Body>
<ns2:cancelarPedidoResponse xmlns:ns2="http://webservice.scol.correios.com.br/">
<return>
<codigo_administrativo>5122864</codigo_administrativo>
<objeto_postal>
<datahora_cancelamento>01/05/2013 16:49</datahora_cancelamento>
<numero_pedido>170840044</numero_pedido>
<status_pedido>Desistncia do Cliente ECT</status_pedido>
</objeto_postal>
</return>
</ns2:cancelarPedidoResponse>
</S:Body>
</S:Envelope>
Mtodo acompanharPedido()
Com esta funcionalidade poder acompanhar o pedido de autorizao de
postagem, quando houver a postagem em uma unidade dos Correios o mtodo retorna o
nmero da etiqueta de registro atravs da tag <numero_etiqueta>. Atravs desse nmero
ser possvel acompanhar o rastreamento do objeto, exemplificado no Anexo 08.
Exemplo:
Consulta:
<soapenv:Header/>
<soapenv:Body>
<web:acompanharPedido>

<tipoBusca>H</tipoBusca>

<tipoSolicitacao>C</tipoSolicitacao>
<numeroPedido>010092315</numeroPedido>
</web:acompanharPedido>
</soapenv:Body>
</soapenv:Envelope>
39/74
Retorno:
<S:Body>
<ns2:acompanharPedidoResponse xmlns:ns2="http://webservice.scol.correios.com.br/">
<return>
<codigo_administrativo>5122864</codigo_administrativo>
<coleta>
<controle_cliente>102030</controle_cliente>
<historico>
<data_atualizacao>08-03-2013</data_atualizacao>
<descricao_status>Aguardando Objeto de Entrega</descricao_status>
<hora_atualizacao>14:43:35</hora_atualizacao>
<observacao/>
<status>0</status>
</historico>
<numero_pedido>10092315</numero_pedido>
<objeto>
<controle_objeto_cliente/>
<data_ultima_atualizacao>08-03-2013</data_ultima_atualizacao>
<descricao_status>A Coletar</descricao_status>
<hora_ultima_atualizacao>14:43:35</hora_ultima_atualizacao>
<numero_etiqueta>LE201904855BR</numero_etiqueta>
<ultimo_status>1</ultimo_status>
</objeto>
</coleta>
<tipo_solicitacao>C</tipo_solicitacao>
</return>
</ns2:acompanharPedidoResponse>
</S:Body>
</S:Envelope>
Descrio das tags de Logstica Reversa

Descrio das Tags do Cabealho
40/74

Nome da Tag
Descrio / Observaes
Tipo Dados
Obrigatrio
Fixo
Sim
Data
(DD/MM/YYY
Y)
Data
(DD/MM/YYY
Y)
No
<codigo_administrativo>
Identifica a verso do arquivo XML.

Para esta verso dever ser preenchido: 4.0
Data para agendar o processamento do arquivo.
Se informada o sistema processa o arquivo
apenas na data indicada.
Data de agendamento de coleta de todos os
pedidos do arquivo. O sistema aceita apenas
datas com mais de cinco dias corridos a partir da
data de processamento do arquivo. Caso
contrrio o processamento do arquivo inteiro ser
cancelado.
Cdigo Administrativo do cliente.
Numrico (8)
Sim
<contrato>
Nmero do contrato do cliente.
Numrico (10)
Sim
<codigo_servico>
Numrico(5)
Sim
Numrico(10)
No
Sub-Tags
Sim
+ <nome>
Cdigo do servio que ser utilizado. O cdigo

ser fornecido pela ECT.
Nmero do carto de postagem do cliente que
ser usado para a cobrana das taxas do servio
realizado.
Sub-tags que armazenam dados do
destinatrio.
Nome do Cliente ou Razo Social
Caractere(60)
Sim
+ <logradouro>
Logradouro do cliente
Caractere(72)
Sim
+ <numero>
Caractere(8)
Sim
+ <complemento>
Nmero do endereo do cliente. Caso no

possua preencher com S/N
Complemento do endereo do cliente
Caractere(30)
No
+ <bairro>
Bairro
Caractere(50)
No
+ <referencia>
Uma referncia do local de entrega
Caractere(60)
No
+ <cidade>
Cidade
Caractere(36)
Sim
+ <uf>
Sigla do Estado.
Caractere(2)
Sim
+ <cep>
Caractere(8)
Sim
+ <ddd>
CEP sempre com oito posies.

Exemplo: 01000999
Cdigo de rea do telefone.
Caractere(3)
No
+ <telefone>
Telefone do cliente
Caractere(12)
No
+ <email>
Este campo no obrigatrio, mas importante

para que o cliente receba informaes sobre
seus pedidos.
Caractere(72)
No
<versao_arquivo>
<data_processamento>
<agendamento>
<carto>
Tag <destinatario>
No
41/74
Tag onde so colocados os blocos de tags que armazenam os dados das
solicitaes.
Cada solicitao de coleta ou autorizao de postagem est contida nesta tag.
Descrio das Tags dos Dados da Solicitao.

Sub-tags de <coleta>
<tipo>
Descrio / Observaes
Indica se a solicitao de coleta domiciliria
ou uma autorizao de postagem.
Tipo Dados
Obrigatrio
Caractere(2)
Sim
Numrico (9)
No
Caractere (30)
No
Data
DD/MM/YYYY
No
CA = Coleta domiciliar. Caso no exista coleta

domiciliar na localidade o sistema transforma
automaticamente o pedido em uma autorizao
de postagem.
C = Coleta domiciliria. Caso no exista a
coleta no local indicado, o sistema ignora a
solicitao
A = Autorizao de Postagem
<numero>
<id_cliente>
<ag>
<carto>
Caso nenhum valor seja passado nessa tag, o

sistema entende que uma solicitao de
coleta domiciliria.
Nmero da Autorizao de Postagem. Usado
quando o cliente j possui uma faixa numrica
desse tipo de solicitao. Esse nmero ser
encaminhado no arquivo de retorno.
Campo para preenchimento livre. um valor
para identificao da solicitao junto ao cliente.
Este valor enviado no arquivo de retorno
gerado aps o processamento.
Coleta domiciliar: Data para agendamento da
coleta. Se informado o pedido fica retido no
sistema e a primeira tentativa de coleta feita
apenas na data informada.
O sistema aceita apenas datas com mais de
cinco dias corridos a partir da data de
processamento do pedido.
Autorizao de Postagem: Indica a quantidade
de dias de validade da autorizao.
A validade deve ser de no mnimo 5 e no
mximo 60 dias. Se no for informada, a
validade da autorizao ser de 10 (dez) dias
corridos a partir da data do processamento do
pedido.
Nmero do carto de postagem para ser usado
no faturamento dos valores do servio realizado.
Caso seja informado para essa solicitao, a tag
<cartao> do cabealho ser ignorada.
Numrico(2)
Entre 5 e 60
dias.
Numrico(10)
No
42/74

<valor_declarado>
<servico_adicional>
<descricao>
<ar>
<cklist>
Tag <remetente>
+ <nome>
+ <logradouro>
+ <numero>
+ <complemento>
+ <bairro>
+ <cidade>
+ <uf>
+ <cep>
+ <referencia>
+ <ddd>
+ <telefone>
+ <email>
+ <celular>
+ <ddd_celular>
+ <sms>
+ <identificao>
Tag <obj_col>
+ <obj>
+ + <item>
+ + <id>
+ + <desc>
Somatrio de todos os valores declarados dos

objetos da coleta. Exemplo: 1020.70
Cdigos de servios adicionais separados por
vrgula.
Descrio / instrues para coleta.
Indica se para solicitar Aviso de
Recebimento para as encomendas
cadastradas. Usado apenas para pedidos de
Autorizao de Postagem.
Indica que sero impressas vias de checklist.
Apenas clientes previamente habilitados
podem utilizar essa opo. Cdigo fornecido
pela ECT.
Sub-tags que armazenam dados do
remetente da coleta ou autorizao de
postagem.
Nome do remetente
Logradouro do remetente
Nmero do endereo do remetente. Caso no
possua, preencher com S/N
Bairro do remetente
Cidade do remetente
UF do remetente
Cep do remetente sempre com 8 posies.
Exemplo 01200999.
Uma referncia do endereo do remetente
Cdigo do DDD do remetente
Nmero do telefone do remetente. Este campo
no obrigatrio mas importante para que a
ECT entre em contato com o remetente em
casos de insucesso na coleta.
E-mail do remetente. Caso seja preenchido o
remetente receber um e-mail informando
sobre a coleta ou a autorizao de postagem.
Nmero do telefone celular do rementente
Cdigo do DDD do celular do remetente
Caso deseja receber SMS dos status do
objeto (S = Sim, N = No)
Nmero do CNPJ ou CPF do remetente.
Contm os blocos de tags que cadastram
os objetos que sero coletados (coleta
domiciliar) ou postados (autorizao de
postagem).
Vide observaes no item 4.b.
Cada objeto cadastrado caracterizado por um
bloco que se inicia nesta tag. Vide leiaute no
item 2 - Demonstrao das tags do arquivo
XML. Caso esta tag no seja encontrada o
sistema assume que existe apenas um objeto a
ser coletado ou postado.
Tag obrigatria. Apenas confirma o cadastro do
objeto dentro da solicitao.
Campo para preenchimento livre. um valor
para identificao do objeto junto ao cliente.
Este valor enviado no arquivo de retorno
gerado aps o processamento. Exemplo:
Nmero da nota fiscal.
Descrio do objeto que ser coletado
Numrico(9.2)
No
Caractere(20)
No
Caractere(255)
Booleano
Colocar 1 ou 0
No
No
Valor fixo
No
Sim
Caractere(60)
Caractere(72)
Caractere(8)
Sim
Sim
Sim
Caractere(30)
Caractere(80)
Caractere(40)
Caractere(2)
Caractere(8)
No
No
Sim
Sim
Sim
Caractere(60)
Caractere(3)
Caractere(18)
No
No
No
Caractere(72)
No
Caractere(9)
Caractere(3)
Caractere(1)
No
No
No
Caractere(14)
-
No
Sim
Sub-tags
Sim
Valor fixo
1
Caractere(30)
Sim
No
Caractere(255)
No
43/74

+ + <entrega>
+ + <num>
Tag <produto>
+ <desc>
+ + <codigo>
+ + <tipo>
+ + <qtd>
Nmero do objeto para os pedidos de coleta

simultnea. O contrato deve aceitar pedidos de
coleta simultnea.
Nmero do objeto quando existe uma faixa
numrica reservada para o cliente. Esta opo
ainda no utilizada.
Contm os blocos de tags que so utilizadas
para solicitao de produtos junto com a
coleta. O contrato do cliente deve ser
habilitado previamente para usar essa tag.
Caractere(13)
No
Caractere(13)
No
No
Cada tipo de produto a ser solicitado

caracterizado por um bloco que se inicia nesta
tag. Vide leiaute no item 2 - Demonstrao das
tags do arquivo XML. obrigatrio caso o
produto seja solicitado para esta coleta.
Cdigo do produto. Fornecido pela ECT
Cdigo do tipo de produto. Fornecido pela ECT
Quantidade de produtos do tipo fornecido.
Sub-tags
Numrico
Numrico
Numrico
Observaes Importantes
a) Valor Declarado: Caso seja informado, assegura ao cliente o ressarcimento do
valor declarado da mercadoria mais os preos postais pagos, nos casos de
extravio ou danos encomenda, mediante o pagamento de taxa de Seguro
Complementar (Ad Valorem) sobre o valor que exceder o valor do seguro
automtico.
Tags:
<valor_declarado>: Valor declarado do objeto da solicitao.
b) Cadastro dos Objetos (tag <obj_col>): muito importante que os objetos que
sero coletados ou postados sejam bem discriminados.
Caso a tag <id> no seja utilizada, o sistema obtm o valor da tag <id_cliente>.
Havendo divergncia entre a quantidade de objetos informada na solicitao e a

quantidade real no local da coleta ou postagem, a ECT ir tratar o pedido da
seguinte forma:
I) Quantidade de objetos cadastrados MAIOR que a quantidade real:

So coletados todos os objetos e cancelados os demais no sistema.
44/74
II) Quantidade de objetos cadastrados MENOR que a quantidade real:

coletada a quantidade de objetos informada, deixando no local da coleta
os demais.
Mtodo solicitarPostagemSimultanea()
Este mtodo responsvel pela postagem do objeto de ida e pela autorizao de
postagem/coleta do objeto de retorno, ocorrendo a troca simultnea dos objetos.
Esta modalidade de servio permite o envio de um objeto novo para substituir, por
exemplo, um defeituoso.
Ser necessrio na chamada enviar uma etiqueta vlida obtida atravs do Web
Service do SIGEP WEB no mtodo solicitaEtiquetas() e j calculado o digito verificador
atravs do mtodo geraDigitoVerificadorEtiquetas(). Ser necessrio fechar a PLP deste
objeto reverso atravs do mtodo fechaPLP() no ambiente SIGEP WEB da postagem de
ida. Na Tag <obj> ser informado a etiqueta como este exemplo, sendo o registro
(etiqueta) o mesmo correspondente ao servio que est sendo utilizado:
<obj>DL123456789BR</obj>
A postagem de ida ocorrer por meio de uma PLP Pr lista de postagem, e o
retorno do mtodo informar o nmero da autorizao de postagem ou coleta atravs da
tag <numero_coleta> podendo solicitar das seguintes maneiras na tag <tipo>:
C = Coleta Domiciliar A troca do objeto ser efetuada no endereo do

consumidor (remetente do objeto de retorno), para isso ser iniciado uma
entrega x coleta no endereo do mesmo. A tag <numero_coleta> contem o
nmero de coleta que poder ser acompanhada atravs do mtodo
acompanharPedido(). A tag <numero_etiqueta> poder ser acompanhada
atravs do mtodo rastreamento dos Correios quando for efetuado o evento
coleta.
A = Autorizao de Postagem na Agncia A troca do objeto ser efetuada

em uma Agncia Prpria dos Correios mais prxima do endereo do
destinatrio da encomenda de ida (remetente da encomenda de retorno). A
tag <numero_coleta> contem o nmero da autorizao de postagem, e
poder ser acompanhada pelo mtodo acompanharPedido(). Quando o
evento postagem ocorrer, poder ser consultado o status e a etiqueta
atravs do mtodo acompanharPedido(). Para a postagem de ida, poder
45/74
obter a o nmero da etiqueta atravs do Web Service do SIGEP WEB com

base no servio utilizado.
Obs: Antes de postar o objeto de ida, necessrio consumir o mtodo

solicitarPostagemSimultanea().
Exemplo:
Consulta:
<soapenv:Header/>
<soapenv:Body>
<web:solicitarPostagemSimultanea>

<contrato>9912208555</contrato>
<codigo_servico>41076</codigo_servico>
<cartao>0057018901</cartao>
<destinatario>
<cep>71901010</cep>
<complemento>AP 100</complemento>
<ddd>61</ddd>
<email></email>
<logradouro>Quadra 301</logradouro>
<nome>Fulano</nome>
<numero>9</numero>
<referencia>Residencial XXX</referencia>
<uf>DF</uf>
</destinatario>
<!-2:Solicitao de Checklist Celular
4: Solicitao de Checklist Eletrnico
-->
<cklist>2</cklist>
<descricao></descricao>
<produto>
<codigo></codigo>
<qtd></qtd>
<tipo></tipo>
</produto>
<remetente>
<cep>80002900</cep>
<cidade>Curitiba</cidade>
<complemento>Bl II</complemento>
<ddd>41</ddd>
<email>ciclano@email.com</email>
<logradouro>Rua Joo Negro</logradouro>
<nome>Ciclano</nome>
<referencia>Ed Sede</referencia>
<uf>PR</uf>
<celular></celular>
<sms></sms>
<identificacao></identificacao>
</remetente>
46/74

<!-C - Coleta Domiciliar
A - Autorizao Postagem
CA Caso no tenha coleta, o sistema gera uma Autorizao de Postagem
-->
<tipo>C</tipo>

<valor_declarado>1000.00</valor_declarado>

<obj>DL619955496BR</obj>
<obs></obs>
</coletas_solicitadas>
</web:solicitarPostagemSimultanea>
</soapenv:Body>
</soapenv:Envelope>
Retorno:
<S:Body>
<ns2:solicitarPostagemSimultaneaResponse xmlns:ns2="http://webservice.scol.correios.com.br/">
<return>
<data_processamento>31/05/2013</data_processamento>
<hora_processamento>08:54</hora_processamento>
<msg_erro/>
<resultado_solicitacao>
<codigo_erro>0</codigo_erro>
<data_solicitacao>31/05/2013</data_solicitacao>
<descricao_erro/>
<hora_solicitacao>08:54</hora_solicitacao>
<id_obj/>
<numero_coleta>010092664</numero_coleta>
<numero_etiqueta>LE201914606BR</numero_etiqueta>
<prazo>03/06/2013</prazo>
<status_objeto>01</status_objeto>
<tipo>C</tipo>
</resultado_solicitacao>
</return>
</ns2:solicitarPostagemSimultaneaResponse>
</S:Body>
</S:Envelope>
Confeco de Etiquetas e Relatrios para Impresso

Ser necessrio implementar a impresso de alguns relatrios conforme segue
abaixo:
Lista de Postagem (Voucher):

Relatrio que agrupa o quantitativo dos objetos da PLP (que encapsula o xml de
objetos) transmitida aos Correios, devendo uma via acompanhar a carga fsica.
Exemplo de voucher padro dos Correios:

47/74
Chancelas:
So elementos grficos dos rtulos de postagem que identificam o tipo de servio
que est sendo utilizado na encomenda e contm o nome do servio e a marca Correios.
So de uso obrigatrio a serem implementadas nos rtulos de postagem. Podero ser
obtidas por meio do Consultor Comercial informando os servios que sero utilizados.
Alguns dos modelos esto no Anexo 18.
Aviso de Recebimento (AR):

Servio adicional que lhe permite ter em mo o comprovante escrito com a
assinatura de destinatrio.
Exemplo:
48/74
49/74
Anexos
01 - Rtulo de Postagem (Etiqueta):

a etiqueta que contm todas as informaes do objeto, remetente e destinatrio e
que dever ser afixada no prprio objeto. Esse padro se faz necessrio para a triagem
automatizada nos Correios. A documentao de referncia poder ser consultada atravs
do Guia Tcnico para Impresso de Etiquetas.
http://www.correios.com.br/para-sua-empresa/servicos-para-o-seucontrato/enderecamento/arquivos/Guiadeenderecamentodeencomendas.pdf
Modelo Padro:
50/74
02 - Algoritimo Gerao do dgito verificador

Exemplo de Algoritmo em Java:
/* Exemplo de clculo do digito verificador em Java Ex: numeroEtiqueta = "DL07798661BR" */
public static String geraEtiquetaComDigitoVerificador(String numeroEtiqueta) {
String prefixo = numeroEtiqueta.substring(0, 2);
String numero = numeroEtiqueta.substring(2, 10);
String sufixo = numeroEtiqueta.substring(10).trim();
String retorno = numero;
String dv;
Integer[] multiplicadores = {8, 6, 4, 2, 3, 5, 9, 7};
Integer soma = 0;
// Preenche nmero com 0
if(numeroEtiqueta.length()
retorno = "Error";
}else if(numero.length() <
String zeros = "";
int diferenca = 8 -
esquerda
< 12){
8 && numeroEtiqueta.length() == 12){
numero.length();
for(int i=0; i<diferenca; i++){

zeros += "0";
}
retorno = zeros + numero;
}else{
retorno = numero.substring(0, 8);
}
for(int i=0; i<8; i++){
soma += new Integer(retorno.substring(i, (i+1))) * multiplicadores[i];
}
Integer resto = soma % 11;
if(resto == 0){
dv = "5";
}else if(resto == 1){
dv = "0";
}else{
dv = new Integer(11 - resto).toString();
}
retorno += dv;
retorno = prefixo + retorno + sufixo;
return retorno;
}
03 Layout 2D Data Matrix
Tamanho: 32 x 32
ITEM
CEP destino
CARACTERES
8
Complemento do CEP
CEP Origem
Complemento do CEP
5
51/74
Validador do CEP Destino
IDV
Etiqueta
13
Servios Adicionais (25, 01, 02, 19, 49, 57)
12
Carto de Postagem
10
Cdigo do Servio
Informao de Agrupamento
Nmero do Logradouro
Complemento do Logradouro
20
Valor Declarado
DDD + Telefone Destinatrio
12
Latitude
10
Longitude
10
Pipe |
Reserva para cliente
30
Complemento do CEP:
Nmero do logradouro.
Ex1: 00100
Ex2: 01200
Ex3: 00000 (Quando a informao for S/N, BR 101, KM 5)
Validador do CEP Destino:
Soma dos 8 dgitos do CEP de destino:
Subtrai-se o resultado da soma do mltiplo de 10, imediatamente superior ao resultado.
Ex: CEP: 71010050 7+1+0+1+0+0+5+0 = 14
Subtrai-se 14 e 20.
O validador do CEP do exemplo 6.
IDV Identificador de Dados Variveis:
Identificador do servio que est sendo utilizado.
IDV
51
Identificao da Aplicao
Encomenda
Uso do Campo Varivel

Registro com servio adicional
81
Malotes
Registro com servio adicional
Servios Adicionais (AR, MP, DD, VD): Quando no possui o servio adicional dever
ser preenchido com 00.
Ex1: 250102194957
Ex2: 250102190000
Ex3: 250000000000 -- Quando no possuir nenhum servio adicional
52/74
Cd. Servio Adicional

01
02
19
25
37
49
57
67
69
Descrio
Aviso de Recebimento
Mo Prpria Nacional
Valor Declarado Nacional (Encomendas)
Registro Nacional
Aviso de Recebimento Digital
Devoluo de Nota Fiscal - SEDEX
Taxa de Entrega de Encomenda Despadronizada
Logstica Reversa Simultnea Domiciliria
Logstica Reversa Simultnea em Agncia
Informao de Agrupamento: (Nmero identificador do agrupamento da PLP)

Ex1. PLP: 101515 (Nesta PLP temos sete objetos, sendo: Trs objetos do agrupamento
com identificador 01, Dois objetos sem agrupamentos e dois objetos do agrupamento com
identificador 02).
Etiqueta PH297898690BR Agrupamento 01
Etiqueta PH297898712BR
Etiqueta PH297898726BR
OBS.: A postagem agrupada dever ocorrer quando existir mais de um volume para o
mesmo destinatrio / logradouro no servio de PAC e a numerao dos objetos
agrupados ter etiquetas seqncias.
Nmero do Logradouro: Nmero do endereo.
Complemento do Endereo: Informao adicional do endereo
Ex1: Casa 100 Bl 2
Ex2: Ap 1000
Ex3: BL II AP 1000
Valor Declarado: Nmero inteiro.
Ex: 00100
Ex: 01000
Ex: 10000
DDD + Telefone Destinatrio: Nmero do telefone do destinatrio
Ex1: 011999253224 Para o estado de SP so 9 posies no campo telefone + DDD
Ex2: 006199253224 Para os demais estados conforme exemplo 2
Ex3: 000000000000 Quando no existe a informao
Latitude: Informao da latitude, ser fornecido pelos Correios via Web Service.
Ex: -15.836518
Obs.: Caso no possui a informao preencher com -00.000000
53/74
Longitude: Informao da longitude, ser fornecido pelos Correios via Web Service.
Ex: -48.033981
Obs.: Caso no possui a informao preencher com -00.000000
04 - Leiaute do arquivo XSD WS Sigep

A seguir demonstramos o leiaute do schema XSD utilizado para validao do XML
que enviado nos mtodos fechaPlp() ou fechaPlpVariosServicos(). Essa validao do
xml poder ser efetuada localmente, j validando o arquivo xml antes mesmo de ser
enviado via parmetro.
<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
<xs:element name="versao_arquivo">
<xs:simpleType>
<xs:restriction base="xs:decimal">
<xs:enumeration value="2.3"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="valor_nota_fiscal" type="xs:string"/>
<xs:element name="valor_global" type="xs:string"/>
<xs:element name="valor_declarado">
<xs:simpleType>
<xs:restriction base="xs:string"/>
</xs:simpleType>
</xs:element>
<xs:element name="valor_cobrado" type="xs:string"/>
<xs:element name="valor_a_cobrar">
<xs:simpleType>
</xs:simpleType>
</xs:element>
<xs:element name="uf_remetente">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:maxLength value="2"/>
<xs:enumeration value="AC"/>
<xs:enumeration value="AL"/>
<xs:enumeration value="AP"/>
<xs:enumeration value="AM"/>
<xs:enumeration value="BA"/>
<xs:enumeration value="CE"/>
<xs:enumeration value="DF"/>
<xs:enumeration value="ES"/>
<xs:enumeration value="GO"/>
<xs:enumeration value="MA"/>
<xs:enumeration value="MT"/>
<xs:enumeration value="MS"/>
<xs:enumeration value="MG"/>
<xs:enumeration value="PA"/>
<xs:enumeration value="PB"/>
<xs:enumeration value="PR"/>
<xs:enumeration value="PE"/>
<xs:enumeration value="PI"/>
<xs:enumeration value="RJ"/>
<xs:enumeration value="RN"/>
<xs:enumeration value="RS"/>
<xs:enumeration value="RO"/>
<xs:enumeration value="RR"/>
<xs:enumeration value="SC"/>
<xs:enumeration value="SP"/>
<xs:enumeration value="SE"/>
<xs:enumeration value="TO"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="uf_destinatario">
<xs:simpleType>
54/74

<xs:enumeration value="AC"/>
<xs:enumeration value="AL"/>
<xs:enumeration value="AP"/>
<xs:enumeration value="AM"/>
<xs:enumeration value="BA"/>
<xs:enumeration value="CE"/>
<xs:enumeration value="DF"/>
<xs:enumeration value="ES"/>
<xs:enumeration value="GO"/>
<xs:enumeration value="MA"/>
<xs:enumeration value="MT"/>
<xs:enumeration value="MS"/>
<xs:enumeration value="MG"/>
<xs:enumeration value="PA"/>
<xs:enumeration value="PB"/>
<xs:enumeration value="PR"/>
<xs:enumeration value="PE"/>
<xs:enumeration value="PI"/>
<xs:enumeration value="RJ"/>
<xs:enumeration value="RN"/>
<xs:enumeration value="RS"/>
<xs:enumeration value="RO"/>
<xs:enumeration value="RR"/>
<xs:enumeration value="SC"/>
<xs:enumeration value="SP"/>
<xs:enumeration value="SE"/>
<xs:enumeration value="TO"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="tipo_arquivo">
<xs:simpleType>
<xs:enumeration value="Postagem"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="telefone_remetente">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="telefone_destinatario">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="status_processamento">
<xs:simpleType>
<xs:restriction base="xs:byte">
<xs:enumeration value="0"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="servico_adicional">
<xs:complexType>
<xs:sequence>
<xs:element ref="codigo_servico_adicional" maxOccurs="4"/>
<xs:element ref="valor_declarado"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="serie_nota_fiscal">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
55/74

<xs:element name="rt2">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="rt1">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="remetente">
<xs:complexType>
<xs:sequence>
<xs:element ref="numero_contrato"/>
<xs:element ref="numero_diretoria"/>
<xs:element ref="codigo_administrativo"/>
<xs:element ref="nome_remetente"/>
<xs:element ref="logradouro_remetente"/>
<xs:element ref="numero_remetente"/>
<xs:element ref="complemento_remetente"/>
<xs:element ref="bairro_remetente"/>
<xs:element ref="cep_remetente"/>
<xs:element ref="cidade_remetente"/>
<xs:element ref="uf_remetente"/>
<xs:element ref="telefone_remetente"/>
<xs:element ref="fax_remetente"/>
<xs:element ref="email_remetente"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="plp">
<xs:complexType>
<xs:sequence>
<xs:element ref="id_plp"/>
<xs:element ref="valor_global"/>
<xs:element ref="mcu_unidade_postagem"/>
<xs:element ref="nome_unidade_postagem"/>
<xs:element ref="cartao_postagem"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="peso">
<xs:simpleType>
<xs:restriction base="xs:integer">
<xs:maxInclusive value="30000"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="objeto_postal">
<xs:complexType>
<xs:sequence>
<xs:element ref="numero_etiqueta"/>
<xs:element ref="codigo_objeto_cliente"/>
<xs:element ref="codigo_servico_postagem"/>
<xs:element ref="cubagem"/>
<xs:element ref="peso"/>
<xs:element ref="rt1"/>
<xs:element ref="rt2"/>
<xs:element ref="destinatario"/>
<xs:element ref="nacional"/>
<xs:element ref="servico_adicional"/>
<xs:element ref="dimensao_objeto"/>
<xs:element ref="data_postagem_sara"/>
<xs:element ref="status_processamento"/>
<xs:element ref="numero_comprovante_postagem"/>
<xs:element ref="valor_cobrado"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="numero_remetente">
<xs:simpleType>
56/74

</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="numero_nota_fiscal">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="numero_etiqueta">
<xs:simpleType>
<xs:minLength value="13"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="numero_end_destinatario">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="numero_diretoria">
<xs:simpleType>
<xs:restriction base="xs:byte">
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="numero_contrato">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="numero_comprovante_postagem" type="xs:string"/>
<xs:element name="nome_unidade_postagem">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="nome_remetente">
57/74

<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="nome_destinatario">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="natureza_nota_fiscal">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="nacional">
<xs:complexType>
<xs:sequence>
<xs:element ref="bairro_destinatario"/>
<xs:element ref="cidade_destinatario"/>
<xs:element ref="uf_destinatario"/>
<xs:element ref="cep_destinatario"/>
<xs:element ref="codigo_usuario_postal"/>
<xs:element ref="centro_custo_cliente"/>
<xs:element ref="numero_nota_fiscal"/>
<xs:element ref="serie_nota_fiscal"/>
<xs:element ref="valor_nota_fiscal"/>
<xs:element ref="natureza_nota_fiscal"/>
<xs:element ref="descricao_objeto"/>
<xs:element ref="valor_a_cobrar"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="mcu_unidade_postagem">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="logradouro_remetente">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="logradouro_destinatario">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="id_plp">
<xs:simpleType>
</xs:simpleType>
</xs:element>
<xs:element name="forma_pagamento">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="fax_remetente">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
58/74

<xs:element name="email_remetente">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="email_destinatario">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="dimensao_objeto">
<xs:complexType>
<xs:sequence>
<xs:element name="tipo_objeto">
<xs:simpleType>
<xs:restriction base="xs:short">
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element ref="dimensao_altura"/>
<xs:element ref="dimensao_largura"/>
<xs:element ref="dimensao_comprimento"/>
<xs:element ref="dimensao_diametro"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="dimensao_altura">
<xs:simpleType>
<xs:restriction base="xs:int">
<xs:minInclusive value="2"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="dimensao_largura">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="dimensao_comprimento">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="dimensao_diametro">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="destinatario">
<xs:complexType>
<xs:sequence>
<xs:element
<xs:element
<xs:element
<xs:element
ref="nome_destinatario"/>
ref="telefone_destinatario"/>
ref="celular_destinatario"/>
ref="email_destinatario"/>
59/74

<xs:element ref="logradouro_destinatario"/>
<xs:element ref="complemento_destinatario"/>
<xs:element ref="numero_end_destinatario"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="descricao_objeto">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="data_postagem_sara">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="cubagem">
<xs:simpleType>
</xs:simpleType>
</xs:element>
<xs:element name="correioslog">
<xs:complexType>
<xs:sequence>
<xs:element ref="tipo_arquivo"/>
<xs:element ref="versao_arquivo"/>
<xs:element ref="plp" maxOccurs="1"/>
<xs:element ref="remetente"/>
<xs:element ref="forma_pagamento"/>
<xs:element ref="objeto_postal" maxOccurs="1000"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="complemento_remetente">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="complemento_destinatario">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="codigo_usuario_postal">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="codigo_servico_postagem">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="codigo_servico_adicional" type="xs:short"/>
<xs:element name="codigo_objeto_cliente">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="codigo_administrativo">
<xs:simpleType>
60/74

</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="cidade_remetente">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="cidade_destinatario">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="cep_remetente">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="cep_destinatario">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="centro_custo_cliente">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="celular_destinatario">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="cartao_postagem">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="bairro_remetente">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="bairro_destinatario">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
</xs:schema>
05 - Cdigo da Diretoria Regional (tag <numero_diretoria>)
61/74
Cdigo
Descrio
Sigla
00001
AC ADMINISTRAAO CENTRAL
AC
00003
DR ACRE
ACR
00004
DR ALAGOAS
AL
00006
DR AMAZONAS
AM
00005
DR AMAP
AP
00008
DR BAHIA
BA
00010
DR BRASLIA
BSB
00012
DR CEAR
CE
00014
DR - ESPIRITO SANTO
ES
00016
DR GOIS
GO
00018
DR MARANHO
MA
00020
DR - MINAS GERAIS
MG
00022
DR - MATO GROSSO DO SUL
MS
00024
DR - MATO GROSSO
MT
00028
DR PAR
PA
00030
DR PARABA
PB
00032
DR PERNAMBUCO
PE
00034
DR PIAU
PI
00036
DR PARAN
PR
00050
DR - RIO DE JANEIRO
RJ
00060
DR - RIO GRANDE DO NORTE
RN
00026
DR RONDONIA
RO
00065
DR RORAIMA
RR
00064
DR - RIO GRANDE DO SUL
RS
00068
DR - SANTA CATARINA
SC
00070
DR SERGIPE
SE
00074
DR - SO PAULO INTERIOR
SPI
00072
DR - SO PAULO
SPM
00075
DR- TOCANTINS
TO
06 - Cdigo do Servio Adicional
Cdigo
Descrio Do Servio Adicional

001
Aviso de Recebimento
002
Mo Prpria
019
Valor Declarado (Ad Valorem)
025
Registro
07 - Algoritmo e-ticket (Autorizao de Postagem)
62/74
Exemplo de Algoritmo em Java:

public class DvVerificador {
public static void main(String[] args) {
System.out.println(geraEtiquetaComDigitoVerificador("15653850"));
}
// Exemplo e-ticket 15653829 (dv=7)
public static String geraEtiquetaComDigitoVerificador(String numeroEtiqueta) {
Integer[] multiplicadores = {8, 6, 4, 2, 3, 5, 9, 7};
Integer soma = 0;
String dv;
if (numeroEtiqueta.length() != 8) {
numeroEtiqueta = "Error";
} else {
for (int i = 0; i < 8; i++) {
soma += new Integer(numeroEtiqueta.substring(i, (i + 1))) * multiplicadores[i];
}
Integer resto = soma % 11;
if (resto == 0) {
dv = "5";
} else if (resto == 1) {
dv = "0";
} else {
dv = new Integer(11 - resto).toString();
}
numeroEtiqueta += dv;
}
return numeroEtiqueta;
}
}
08 Rastreamento Correios
Rastreamento Mtodo eventos()
xmlns:res="http://resource.webservice.correios.com.br/">
<soapenv:Header/>
<soapenv:Body>
<res:buscaEventosLista>
<usuario>ECT</usuario>
<senha>SRO</senha>
<tipo>L</tipo>
<resultado>T</resultado>
<lingua>101</lingua>
<objetos>TE123456785AA</objetos> /* Exemplo com dois objetos */
<objetos>TE123456785AB</objetos>
</res:buscaEventosLista>
</soapenv:Body>
</soapenv:Envelope>
09 Cdigo Forma de Pagamento (tag <forma_pagamento>)
Codigo
Forma_Pagamento
Vale Postal
Reembolso Postal
Contrato de Cmbio
63/74

4
Carto de Crdito
Outros
10 - Cdigo Pas Bandeira
Codigo_pais_bandeira
Descricao_pais
Codigo_pais_ECT
1058
Brasil
BR
11 - Cdigo do Tipo de Exportador
Cdigo
1
Exportador
Pessoa Jurdica
11
Pessoa Fsica
12
Pessoa Fsica domiciliada no exterior sem CPF
13
Pessoa Fsica residente no pas sem CPF
12 - Cdigo da Natureza da Operao
Cdigo
Natureza_Operao
Pessoa fsica com cobertura cambial
Pessoa fsica sem cobertura cambial
Pessoa jurdica com cobertura cambial
Pessoa fsica sem cobertura cambial
30
Doao em carter de ajuda humanitria
31
Bagagem desacompanhada
41
Bens de carter cultural- Exportao temporria
42
Exportao temporria de material para emprego militar
43
Feiras e exposies
44
Conserto, reparo ou restaurao
45
Outras exportaes temporrias
61
Bens submetidos a regime de admisso temporria
71
Erro de expedio
72
No atendimento de exigncia de controle extrafiscal
73
Indeferimento de regime aduaneiro especial
74
Outros motivos: Portaria MF 306/95
13 - Cdigo do Porte da Empresa
Cdigo
Porte_Empresa
Micro Empresa
Pequena Empresa
Outros
14 - Cdigo da Unidade de Comercializao

64/74
Cdigo
Unidade_Comercializao
Centmetro
Grama
Milmetro
Minuto
No Significativo
Pagina
Palavra
10
Quantidade
Quilograma
R$-Valor
15 - Cdigo da Moeda de Negociao
Cdigo
Moeda
Real
16 - Tabela de Mensagem de Erro Logstica Reversa
65/74

Cdigo
Descrio do Erro
NO PERMITIDO AGENDAR PROCESSAMENTO DE ARQUIVO VIA WEBSERVICE
10
O ARQUIVO J FOI PROCESSADO
103
ARQUIVO COM ERRO DE ESTRUTURA
104
DADOS DE VALIDAO DA COLETA INCOMPLETOS
105
CLIENTE NO CONFIGURADO PARA USAR O SISTEMA
107
VERSO INVLIDA DO ARQUIVO XML
108
VALOR DECLARADO NO PODE SER SUPERIOR A R$ 10.000,00
109
DADOS DO CONTRATO INVLIDOS
111
COLETA DOMICILIAR NO DISPONVEL PARA O SERVIO SEDEX 10
1111
COLETA DOMICILIAR NO DISPONVEL PARA ESSA LOCALIDADE
112
SERVIO NO ATENDE O CEP DE DESTINO
113
CEP DO DESTINATRIO INEXISTENTE
114
CEP DE DESTINO COM FORMATO INVLIDO
115
CEP DE ORIGEM COM FORMATO INVLIDO
117
CEP DO REMETENTE INEXISTENTE
120
SERVIO ESPECIAL (e-SEDEX) NO ABRANGE O CEP DE ORIGEM INFORMADO
122
DADOS DE DESTINATRIO INCOMPLETO
125
DADOS DE REMETENTE INCOMPLETOS
134
DATA DE AGENDAMENTO INVLIDA. VERIFICAR TAG -AGENDAMENTO
136
NMERO DE ENTREGA INVLIDO
1366
SERVIO DE SIMULTNEA EM AGNCIA NO ATENDIDO NA REGIO DO CEP DO REMETENTE
138
O ARQUIVO NO CONTM PEDIDOS DE COLETA. VERIFICAR TAG -coletas_solicitadas
140
CARTO INVLIDO PARA O CONTRATO INFORMADO
142
VALOR INVLIDO PARA O TIPO DE SOLICITAO.VERIFICAR TAG -AG
195
NMERO DE E-TICKET J UTILIZADO
1955
NMERO DE OBJETO J UTILIZADO NESSE ARQUIVO
198
NMERO DE OBJETO INVLIDO OU DGITO VERIFICADOR INCORRETO
1988
FAIXA NUMRICA NO RESERVADA PARA ESSE CLIENTE
19888
NMERO DE OBJETO J UTILIZADO
198888
TIPO DE ETIQUETA INVLIDO
199
O SERVIO ADICIONAL 'AVISO DE RECEBIMENTO' SOMENTE EST DISPONVEL PARA OS PEDIDOS DE

AUTORIZAO DE POSTAGEM
200
CDIGO DE CHECKLIST INVLIDO
201
CDIGO DO PRODUTO INVLIDO
202
SERVIO ESPECIAL SEDEX 10 NO ATENDIDO POR LOGSTICA REVERSA DOMICILIRIA
203
VALOR TAG -AR- INVLIDO
66/74

Cdigo
Descrio do Erro
204
TAGS -ENTREGA- INCONSISTENTES
206
VALOR DECLARADO INVLIDO
206
TAG -ENVIO.OBJ- INVLIDA.
207
DATA DE PROCESSAMENTO INVLIDA. VERIFICAR TAG -DATA_PROCESSAMENTO-
208
ARQUIVO VAZIO.
209
ARQUIVO COM MAIS DE 300 COLETA
210
SERVIO INDISPONVEL NO MOMENTO
211
VALOR DECLARADO NO PODE SER INFERIOR A R$ 11,00
212
ID DE POSTAGEM INVLIDO
213
VALOR INVLIDO PARA A TAG - QTD_CAIXA -
214
TAG - numero - DEVE SER UTILIZADO SOMENTE NO SERVIO DE AUTORIZAO DE POSTAGEM
215
TAG - identificacao - CPF OU CNPJ INVLIDO.
216
UF INVLIDA.
217
TAG - numero INVLIDA
218
TAG - cartao INVLIDA
219
TAG - PRODUTO.CODIGO INVLIDA
220
TAG - PRODUTO.TIPO INVLIDA
221
TAG - PRODUTO.QTD INVLIDA
222
O CEP INFORMADO NO PERTENCE A FAIXA DE ABRANGNCIA DO SERVIO E-SEDEX GRUPO I
223
O CEP INFORMADO NO PERTENCE A FAIXA DE ABRANGNCIA DO SERVIO E-SEDEX GRUPO II
224
TIPO DA SOLICITAO INVLIDA
225
SERVIO INVLIDO
226
QUANTIDADE INVLIDA
227
O NMERO DEVE POSSUIR 8 DGITOS
-1
Cdigo do identificador de acesso ao web service no autorizado.
-3
Tipo de solicitao invlida.
-4
Tipo de busca invlido.
-5
Nmero do pedido invlido ou no localizado na base de dados para o tipo de solicitao informado.
-7
Dados obrigatrios no informados.
-8
No existe informao para o solicitado.
-9
Pedido no pode ser cancelado, pois encontra-se no status
-10
O limite de pedidos deve ser no mximo de 30.
-11
Servio indisponvel no momento.
17 - Tabela de Produtos
Cdigo
Tipo
Descrio da Embalagem
116600403
Caixa de Encomenda "B" (16x11x6 cm)
116600055
Caixa Encomenda 01 (18x13,5x9 cm)
116600063
Caixa Encomenda 02 (27x18x9 cm)
116600071
Caixa Encomenda 03 (27x22,5x13,5 cm)
116600080
116600160
116600179
67/74

116600187
765000660
Envelope Bolha Grande (20x28 cm)
765000652
Envelope Bolha Mdio (21x18 cm)
765000644
Envelope SEDEX Plstico Grande (40x28 cm)
765000636
Envelope SEDEX Plstico Mdio (35,3x25 cm)
68/74
18 - Leiaute de chancelas
18.1 - Chancela PAC
Padronizao visual dos smbolos de Contratos Chancelas - ENTREGA NO URGENTE

Instrues para arte-finalizao -
Servio: ENCOMENDA PAC

1. Para diagramar a Chancela siga as instrues abaixo:
2. Para arte-finalizao em negativo seguir a mesma

diagramao como no exemplo abaixo:
Negativo:
PAC
0000/2002-DR/XX/YY
Siglas ou nomes por extenso dos servios .

Estaro sempre dispostas no parte superior dos smbolos.A
diagramao pr-definida.
PAC
Cliente
(Dimenses 25 x 35mm)
N do contrato; ano de assinatura; DR/origem/postagem

Fonte: Arial normal (caixa alta), corpo 7pt, espaamentos
entre-letra e entre-linha=100%
Obs: Quando a DR de origem e postagem for a mesma,
utilizar a sigla somente uma vez.
Cliente
Fonte: Arial negrito (caixa alta e baixa), corpo 9 a 11pt,
espaamentos entre-letra e entre-linha=100%
Obs: Utilizar duas linhas (centralizadas) quando necessrio.
Identificao dos Correios .
Estaro sempre dispostas no parte inferior dos smbolos.
A diagramao pr-definida.
Ateno:
No permitida alteraes na forma da chancela,
assim como nas especificaes acima.
0000/2002-DR/XX/YY
Cliente
3. Utilizar a chancela reduzida somente quando

necessrio.
Reduo (15X20mm):
Ateno:
PAC
0 0 0 0 /2 0 0 2 - DR/XX/YY
Cliente
N do contrato; ano de
assinatura; DR/origem/postagem
Fonte: Arial normal (caixa alta),
corpo 4pt, espaamentos entreletra e entre-linha=100%
Obs: Quando a DR de origem e
postagem for a mesma, utilizar a
sigla somente uma vez.
Cliente
Fonte: Arial normal (caixa alta e
baixa), corpo 5pt, espaamentos
Obs: Utilizar duas linhas
(centralizadas) quando necessrio.
69/74
18.2 - Chancela SEDEX
Padronizao visual dos smbolos de Contratos Chancelas

Servio Expresso: SEDEX


Negativo:
0000/2002-DR/XX/YY

Cliente
(Eixo maior 35mm)

(Eixo menor 23mm)
0000/2002-DR/XX/YY

Cliente
Cliente

necessrio.
Reduo (eixo maior 20mm; eixo menor 13,2mm):
Ateno:
0 0 0 0 /2 0 0 2 - DR/XX/YY
Ateno:
Cliente
Cliente
70/74
18.3 - Chancela SEDEX 10

Servio Expresso: SEDEX 10


Negativo:
0000/2002-DR/XX/YY
Cliente
(Eixo maior 35mm)

(Eixo menor 23mm)

0000/2002-DR/XX/YY

Cliente
Ateno:
Cliente

necessrio.
Ateno:
0000/2002-DR/XX/YY
Cliente
Cliente
71/74
18.4 - Chancela SEDEX Hoje

Servio Expresso: SEDEX Hoje


Negativo:
0000/2002-DR/XX/YY
Cliente
(Eixo maior 35mm)

(Eixo menor 23mm)

0000/2002-DR/XX/YY

Cliente
Cliente

necessrio.
Ateno:
0000/2002-DR/XX/YY
Ateno:
Cliente
Cliente
72/74
18.5 - Chancela e-SEDEX

Servio Expresso: e-SEDEX


Negativo:
0000/2002-DR/XX/YY
Cliente
(Eixo maior 35mm)

(Eixo menor 23mm)

0000/2002-DR/XX/YY

Cliente
Cliente

necessrio.
Ateno:
0000/2002-DR/XX/YY
Ateno:
Cliente
Cliente
73/74
18.6 - Chancela Carta
Padronizao visual dos smbolos de Contratos Chancelas - ENTREGA URGENTE

Servio: CARTA
1. Para diagramar a Chancela, siga as instrues abaixo:
2. Para arte-finalizao em negativo, siga a mesma

diagramao do item 1, conforme exemplo abaixo:
Negativo:

Estaro sempre dispostas no parte superior dos smbolos.
0000/2002-DR/XX/YY
Cliente
(dimetro 35mm)

0000/2002-DR/XX/YY
Cliente
Cliente
Estar sempre disposta na parte inferior dos smbolos.

necessrio.
Reduo (dimetro 20mm):
Ateno:
0 0 0 0 /2 0 0 2 - D R /XX/YY
Cliente
No permitido alteraes na forma da chancela, assim

como nas especificaes deste documento, salvo o
disposto abaixo.
A critrio do Cliente e para que a chancela fique
proporcional ao tamanho do objeto, suas dimenses
podero variar no intervalo entre os valores mximos e
mnimos mencionados neste documento.
Ateno:
N do contrato; ano de assinatura;
DR/origem/postagem
Fonte: Arial normal (caixa alta), corpo
4pt, espaamentos entre-letra e
entre-linha=100%
Cliente
Fonte: Arial negrito (caixa alta e
74/74

Manual de Implementacao Do Web Service SIGEPWEB Logistica Reversa

Caricato da

Informazioni sul documento

Copyright

Formati disponibili

Condividi questo documento

Condividi o incorpora il documento

Opzioni di condivisione

Hai trovato utile questo documento?

Questo contenuto è inappropriato?

Copyright:

Formati disponibili

Manual de Implementacao Do Web Service SIGEPWEB Logistica Reversa

Caricato da

Copyright:

Formati disponibili

EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT

SIGEP Web - Manual de Implementao do Web Service

EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT

SIGEP Web - Manual de Implementao do Web Service

Web Service de Logstica Reversa ........................................................................ 31

EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT

SIGEP Web - Manual de Implementao do Web Service

09 Cdigo Forma de Pagamento (tag <forma_pagamento>) ................................. 63

EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT

SIGEP Web - Manual de Implementao do Web Service

SIGEP WEB Implementao e acesso ao Web Service

Esse servio de TI engloba um conjunto de mtodos que permitem automatizar a

Na integrao utilizado os padres SOAP (Simple Object Access Protocol) e XML

Os principais benefcios alcanados com esta integrao so listados a seguir:

EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT

SIGEP Web - Manual de Implementao do Web Service

Web Service de Clculo de Preos e Prazos de Encomendas

Para ter acesso a este servio, o cliente necessitar:

Possuir contrato com os Correios;

Solicitar ao representante comercial da ECT permisso de acesso para

Implementar em seu sistema proprietrio as funcionalidades necessrias

EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT

SIGEP Web - Manual de Implementao do Web Service

Interface do Web Service SIGEP WEB

Para o acesso ao ambiente de desenvolvimento, podero ser utilizados os seguintes

Mtodos do Web Service do SIGEP WEB

Os mtodos e elementos necessrios para utilizao do Web Service sero

Exemplo de tabelas para armazenamento em banco de dados

EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT

SIGEP Web - Manual de Implementao do Web Service

Exemplo de dados do modelo proposto:

Viso Geral do Processo

EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT

SIGEP Web - Manual de Implementao do Web Service

Na viso aqui proposta, o processo de integrao envolve Correios e Cliente em

1. Inicializao: Nesta etapa o cliente consulta os Correios para verificar/validar a

EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT

SIGEP Web - Manual de Implementao do Web Service

EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT

SIGEP Web - Manual de Implementao do Web Service

EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT

SIGEP Web - Manual de Implementao do Web Service

EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT

SIGEP Web - Manual de Implementao do Web Service

Cdigo Administrativo do contrato do Cliente com

CEP de Destino sem hfen

Usurio autenticador. (Fornecido pelo

EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT

SIGEP Web - Manual de Implementao do Web Service

Carto de postagem vinculado ao contrato

Usurio autenticador. (Fornecido pelo

EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT

SIGEP Web - Manual de Implementao do Web Service

Nmero do cep sem hfen.

EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT

SIGEP Web - Manual de Implementao do Web Service

Carto de Postagem vinculado ao contrato

Usurio autenticador. (Fornecido pelo

EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT

SIGEP Web - Manual de Implementao do Web Service

solicitando em seguida, uma faixa de numerao.

Identificao com a letra C, de cliente.

CNPJ da empresa. Ex: 00000000000000

Id do servio, porder ser obtido no mtodo buscaCliente().