Manual de Implementacao Do Web Service SIGEPWEB e 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 fechaPlp() .............................................................................................................17
Mtodo fechaPlpVariosServicos()......................................................................................19
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
2/74
08 Rastreamento Correios..............................................................................................63
09 Cdigo Forma de Pagamento (tag <forma_pagamento>) .........................................63
10 - Cdigo Pas Bandeira.................................................................................................63
11 - Cdigo do Tipo de Exportador....................................................................................63
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:
Web Service de Clculo de Preos e Prazos de Encomendas proporciona
a simulao de preo e prazo de entrega de mltiplos servios. Os detalhes
4/74
bem como o manual de implementao, podem ser obtidos no endereo

www.correios.com.br/webservices.
WSDL: http://ws.correios.com.br/calculador/CalcPrecoPrazo.asmx?WSDL
Sistema de Rastreamento de Objetos via XML os clientes podem obter
detalhes (rastros) dos objetos postados, atravs da tecnologia XML
(eXtensible Markup Language).
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
...
0067594867
Obs: Para desenvolvimento, os cdigos de servios podem ser obtidos atravs do mtodo
buscaCliente(), exemplificado em tpico especfico neste manual.
Produo:
http://sigep.correios.com.br/sigep/update/AtendeClienteService.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
idPedido
Tb_Pedido_Servico
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
Boolean (true / false)
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 o 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.

Para cada tipo de servio dever ser solicitada uma faixa de numerao.
Este mtodo pode ser utilizado sob demanda, quantas vezes o cliente precisar.
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 obtido no mtodo buscaCliente().
Sim
qtdEtiquetas
Int
Sim
usuario
String
senha
String
Quantidade de etiquetas a serem solicitadas limitadas em

1000 objetos por PLP.
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:
<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>
16/74
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>
</cli:geraDigitoVerificadorEtiquetas>
</soapenv:Body>
</soapenv:Envelope>
Retorno:
<S:Body>
<ns2:geraDigitoVerificadorEtiquetasResponse
<return>6</return>
<return>2</return>
</ns2:geraDigitoVerificadorEtiquetasResponse>
</S:Body>
</S:Envelope>
Mtodo fechaPlp()
Este mtodo, assim como o mtodo fechaPlpVariosServicos(), responsvel por
enviar a lista contendo os objetos que sero postados nos Correios, chamada de PrLista de Postagem PLP. Entretanto, ao contrrio do fechaPlpVariosServicos(), o mtodo
17/74
fechaPlp() s permite o envio de uma lista com objetos que utilizem o mesmo servio (ou
s SEDEX, ou s PAC, etc).
Os cdigos de objetos dentro da lista devero estar sequenciados dentro de um
range de nmeros de objeto previamente obtido pelo mtodo solicitaEtiquetas().
Preferencialmente, essa PLP dever ser enviada na finalizao do processo de postagem
do dia, contemplando todos os objetos a serem expedidos. No entanto, possvel que
seja fechada mais de uma PLP por dia, caso haja esta necessidade no processo do
cliente.
fechaPlp(xml, idPlpCliente, cartaoPostagem, faixaEtiquetas, usuario, senha)
Campo
Tipo
Descrio
Obrigatrio
xml
String
Sim
idPlpCliente
Long
cartaoPostagem
String (10)
faixaEtiquetas
String
usuario
String
senha
String
PLP (pr-lista de postagem) em formato XML

conforme exemplo abaixo (Exemplo de XML de
PLP).
Cdigo identificador para uso de controle do
cliente.
Cdigo que autoriza a postagem dos servios no
contrato.
Informar o range de etiquetas (nmero inicial e
nmero final) de postagem dos objetos contidos
no XML. Este mtodo permite envio de PLP
contemplando somente um nico tipo de servio
(ou Sedex, ou PAC, etc), em que tenha sido
associada uma faixa sequenciada de nmeros
de objeto. Na assinatura do mtodo dever
constar apenas a faixa sem o digito verificador,
no xml dever constar o nmero + o digto.
Exemplo constante na assinatura do mtodo:
"DL12345678BR,DL12345679BR"
Usurio
autenticador.
(Fornecido
pelo
Sim
Sim
Sim
Sim
Sim
Retorno do mtodo:
Campo
return
Tipo
Long (idPlp)
Exemplo:
Consulta:
<soapenv:Header/>
<soapenv:Body>
<cli:fechaPlp>
<xml></xml>
<idPlpCliente>123</idPlpCliente>
<cartaoPostagem>*******</cartaoPostagem>
<faixaEtiquetas>DL76023727BR,DL76023727BR</faixaEtiquetas>
</cli:fechaPlp>
</soapenv:Body>
</soapenv:Envelope>
18/74
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>
Mtodo fechaPlpVariosServicos()
Este mtodo tambm responsvel por enviar a lista contendo os objetos que
sero postados nos Correios. Esta lista chamada de Pr Llista de Postagem PLP.
Entretanto, ao contrrio do fechaPlp(), o mtodo fechaPlpVariosServicos() permite o envio
de uma lista com vrios objetos de servios distintos e sem obrigatoriedade de serem
sequenciados, pois o campo listaEtiquetas um array dos objetos constantes do XML.
Os
nmeros
de
objeto devero
ser obtidos
previamente pelo mtodo
solicitaEtiquetas(). Preferencialmente, essa PLP dever ser enviada na finalizao do

processo de postagem do dia, contemplando todos os objetos a serem expedidos. 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
cartaoPostagem
String (10)
listaEtiquetas
List<String>
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.
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");
usuario
String
Sim
senha
String

Sim
Sim
Sim
Sim
Retorno do mtodo:
Campo
return
Tipo
Long (idPlpCliente)
19/74
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 de XML de 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>
</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>
20/74

<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>
21/74
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).
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
22/74
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.
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>
23/74
Tags
Descrio
Tipo de dados
Observaes
<id_plp>
Identifica o registro da PLP Pr
Numrico(10)
Preenchimento
Lista de Postagem
retornada
atravs
que ser
do
no
obrigatrio.
mtodo
fechaPLP e sendo chave para o

atendimento nos Correios dos
objetos a serem postados.
Dever
obrigatoriamente
enviada
vazia,
por
ser
exemplo:
<id_plp />
<valor_global>
Valor
em
reais
do
total
da
Numrico(10,2)
tarificao dos objetos da PLP,
Preenchimento
no
obrigatrio.
que ser retornada atravs do

mtodo
solicitaXmlPlp
quando
postada.
<mcu_unidade_postagem>
Identifica a unidade de postagem
Caractere(12)
dos Correios.
Nome da unidade de postagem
<cartao_postagem>
Numero do carto do cliente
Caractere(30)
Preenchimento
Caractere(10)
Preenchimento
dos Correios.
no
obrigatrio.
associado
0087654321
(sempre
no
obrigatrio.
<nome_unidade_postagem>
caracteres
Preenchimento
PLP.
inserir
Ex:
com
10
zeros
Obrigatrio
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
cliente,
Numerico(2)
conforme
Preenchimento
Obrigatrio.
Anexo 05.
<codigo_administrativo>
Cdigo administrativo do cliente
Caractere(8)
Preenchimento
Obrigatrio
No
pode
existir
nmeros.
<nome_remetente>
Nome do remetente
Caractere(50)
Preenchimento
Obrigatrio
24/74

<logradouro_remetente>
Logradouro do remetente.
Caractere(40)
Recomendado utilizar o mtodo
Preenchimento
Obrigatrio
buscaCEP()
<numero_remetente>
Parte do endereo
Caractere(5)
Preenchimento
Obrigatrio
<complemento_remetente>
Complemento do endereo
Caractere(20)
<bairro_remetente>
Bairro do remetente
Caractere(20)
Preenchimento
no
obrigatrio.
Preenchimento
Obrigatrio
<cep_remetente>
CEP do remetente
Numrico(8)
Preenchimento
Obrigatrio
99999999
No
pode
existir
nmeros.
<cidade_remetente>
Cidade do remetente
Caractere(30)
Preenchimento
Obrigatrio
<uf_remetente>
Unidade de Federao
Caractere(2)
Preenchimento
Obrigatrio
<telefone_remetente>
Telefone do remetente
Numrico (12)
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
25/74
quantidade de objetos desejados.

Tags
Descrio
Tipo de dados
Observaes
<numero_etiqueta>
Nmero do Objeto na ECT.
Caractere(13)
Preenchimento
aqui
Importante:
dever
Obrigatrio
constar: nmero do objeto +

digito
verificador.
Exemplo:
DF12345678 9 BR
<codigo_objeto_cliente>
Cdigo de controle do objeto no
Caractere(20)
cliente
<codigo_servico_postagem>
no obrigatrio.
Cdigo do servio da postagem,
Caractere(5)
por exemplo: 40215, 40096, etc.

<cubagem>
Preenchimento
Cubagem do Objeto
Preenchimento
obrigatrio
Numrico(9,2)
Preenchimento
no obrigatrio.
<peso>
Peso do objeto (em gramas)
Numrico(5)
Preenchimento
Obrigatrio.
<rt1>
Reservado para observao do
Caractere(255)
cliente
<rt2>
no obrigatrio.
Reservado para observao do
Caractere(255)
cliente
+ <destinatario>
Preenchimento
Preenchimento
no obrigatrio.
Dados do destinatrio
Preenchimento
Obrigatrio
+ <nacional>
Dados relevantes a postagem
Preenchimento
nacional
Obrigatrio
+ <servico_adicional>
Identifica os servios adicionais
Preenchimento
do objeto postado
Obrigatrio
+ <dimensao_objeto>
Contm as dimenses do objeto
Preenchimento
(altura, largura, comprimento e
Obrigatrio.
dimetro) e o tipo do objeto

(embalagem)
<data_postagem_sara>
Contm a data de efetivao da
Preenchimento
postagem.
<status_processamento>
Contm
no obrigatrio.
o
processamento
STATUS
do
do
Caractere(1)
objeto,
Preenchimento
Obrigatrio.
dever ser enviado a informao

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

Tags
Descrio
Tipo de dados
<nome_destinatario>
Nome do destinatrio
Caractere(50)
Observaes
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.
<logradouro_destinatario>
Logradouro
do
destinatrio.
Caractere(50)
Recomendado utilizar o mtodo
Preenchimento
Obrigatrio.
buscaCEP()
<complemento_destinatario>
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 -
27/74

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
torna
servio
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>
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,
tambm
estes
ser
informados conforme Anexo

06.
<valor_declarado>
Valor
do
seguro
adicional Numrico (9,2)
declarado pelo cliente.
Se
cdigo
do
servio
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
Descrio
Tipo de dados
Observao
28/74

<tipo_objeto>
Contm o cdigo do tipo de objeto
Caractere (3)
que foi postado (embalagem)
Para 001 No prencher as tags de
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:
<dimensao_comprimento>
Comprimento do objeto (em cm)
Inteiro (5)
Para:
<dimensao_diametro>
Dimetro do objeto (em cm)
Inteiro (5)
Para:
* Referncia:
http://www.correios.com.br/produtosaz/produto.cfm?id=8560360B-5056-9163-895DA62922306ECA
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.
29/74

<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
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
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.
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
5122864
1000010572
41076
0057702519
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.
Exemplo:
Consulta:
xmlns:web="http://webservice.scol.correios.com.br/">
<soapenv:Header/>
<soapenv:Body>
<web:solicitarRange>
<usuario>60618043</usuario>
<senha>8o8otn</senha>
<contrato>1000010572</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>
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
35/74
Postagem / e-ticket) est apto a ser disponibilizado ao cliente para efetuar a postagem
em uma unidade/agncia dos Correios, na sequencia poder ser enviado para
processamento nos Correios 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 um pedido de autorizao de postagem ou coleta para
quem j possui um nmero de autorizao de postagem (e-ticket) solicitado atravs do
mtodo solicitarRange() e calculado pelo mtodo calcularDigitoVerificador().
Este mtodo ainda solicita um pedido de autorizao de postagem ou coleta
quando no informado o nmero.
Recomendamos utilizar sempre os mtodos
solicitarRange() e calcularDigitoVerificador(), para reduzir o volume de acessos aos

servidores dos Correios. Como exemplo, a cada 2 horas pode-se programar o
processamento dos pedidos de autorizao de postagem atravs do mtodo
solicitarPostagemReversa() levando em considerao a disponibilidade da informao
para postagem imediata.
Uma alternativa ao uso do mtodo calcularDigitoVerificador() a implementao
36/74
local de seu algoritmo, conforme exemplo do Anexo 07.
Obs1: Para os servios que no possuem abrangncia em todos os municpios do

Brasil, como ocorre com o e-SEDEX e com o SEDEX 10, recomendamos o consumo
prvio do mtodo verificaDisponibilidadeServico() do SIGEP WEB, evitando assim que
seja efetuada postagem para destino fora da abrangncia do servio.
Obs2:
Para
tipo
(Coleta)
dever
ser
consumido
mtodo
solicitarPostagemReversa via web service, sem informar a tag nmero (Range Local). O
servio de coleta domiciliria requer validao da rea de abrangncia por CEP destino.
Exemplo:
Consulta:
<soapenv:Header/>
<soapenv:Body>
<web:solicitarPostagemReversa>
<codigo_servico>41076</codigo_servico>
<cartao>0057702519</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>61 3333-1234</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>
<telefone>41 3232-1234</telefone>
37/74

<uf>PR</uf>
<celular></celular>
<ddd_celular></ddd_celular>
<sms></sms>
<identificacao></identificacao>
</remetente>
<!-C - Coleta
A - Autorizao Postagem
-->
<tipo>A</tipo>

<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
38/74
estiver como A Coletar ou Aguardando Objeto na Agncia para pedidos de Autorizao

de Postagem, neste caso ainda no houve nenhum evento de atendimento desta
solicitao.
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 via post no Sistema de Rastreamento
de Objetos dos Correios SRO, exemplificado no Anexo 08.
Exemplo:
Consulta:
<soapenv:Header/>
<soapenv:Body>
<web:acompanharPedido>
39/74


<tipoBusca>H</tipoBusca>

<tipoSolicitacao>C</tipoSolicitacao>
<numeroPedido>010092315</numeroPedido>
</web:acompanharPedido>
</soapenv:Body>
</soapenv:Envelope>
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
<reg>
Esse valor ser fixo e definido pela ECT
Fixo
Sim
<versao_arquivo>
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
<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 tem incio 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>
Tag <obj_col>
+ <obj>
+ + <item>
+ + <id>
+ + <desc>
+ + <entrega>
+ + <num>
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.
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
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
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
Sim
Sub-tags
Sim
Valor fixo
1
Caractere(30)
Sim
No
Caractere(255)
Caractere(13)
No
No
Caractere(13)
No
43/74
Tag <produto>
+ <desc>
+ + <codigo>
+ + <tipo>
+ + <qtd>
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.
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.
No
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>: Quando essa tag preenchida o valor declarado informado
dividido entre todos os objetos da solicitao.
Caso a tag <vr_dec> do bloco de declarao do objeto seja preenchido, o valor
informado passa a ser o valor declarado do objeto.
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:
44/74
So coletados todos os objetos e cancelados os demais no sistema.

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
45/74
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,
necessrio solicitar ao representante comercial dos Correios um range de
etiquetas 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>

<codigo_servico>41076</codigo_servico>
<cartao>57702519</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>
<telefone>6112341369</telefone>
<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>
46/74

<referencia>Ed Sede</referencia>
<telefone>4112342158</telefone>
<uf>PR</uf>
<celular></celular>
<ddd_celular></ddd_celular>
<sms></sms>
<identificacao></identificacao>
</remetente>
<!-C - Coleta Domiciliar
A - Autorizao 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
47/74
objetos) transmitida aos Correios, devendo uma via acompanhar a carga fsica.
Exemplo de voucher padro dos Correios:
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. O padro do leiaute a ser desenvolvido pode ser obtido nesse
link: http://www.correios.com.br/voce/enderecamento/enderecamentoEncomendas.cfm.
48/74
Exemplo:
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
na
ECT.
documentao
de
referncia
pode
ser
obtida
http://www.correios.com.br/voce/enderecamento/enderecamentoEncomendas.cfm,
baixando o Guia Tcnico para Impresso de Etiquetas.
http://www.correios.com.br/voce/enderecamento/Arquivos/guia_tecnico_encomendas.pdf
Exemplo:
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
CARACTERES
CEP destino
Complemento do CEP
CEP Origem
Complemento do CEP
Validador do CEP Destino
1
51/74
IDV
Etiqueta
13
Servios Adicionais (25, 01, 02, 19, 49, 57)
12
Carto de Postagem
Cdigo do Servio
10
5
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:
Ponto de entrega conforme DNE Diretrio Nacional de Endereo, ser fornecido pelos
Correios via Web Service.
Obs.: Caso no possui o ponto de entrega preencher com 00000.
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
Cd. Servio Adicional
01
02
19
Descrio
Aviso de Recebimento
Mo Prpria Nacional
Valor Declarado Nacional (Encomendas)
52/74
25
37
49
57
67
69
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
Longitude: Informao da longitude, ser fornecido pelos Correios via Web Service.
Ex: -48.033981
Obs.: Caso no possui a informao preencher com -00.000000
53/74
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>
<xs:enumeration value="AC"/>
54/74

<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>
<xs:element name="rt2">
<xs:simpleType>
55/74

</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>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="numero_nota_fiscal">
56/74

<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">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
57/74

<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>
<xs:element name="email_remetente">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
</xs:element>
58/74

<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 ref="nome_destinatario"/>
<xs:element ref="telefone_destinatario"/>
<xs:element ref="celular_destinatario"/>
<xs:element ref="email_destinatario"/>
<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>
59/74

</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>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="cidade_remetente">
<xs:simpleType>
</xs:restriction>
</xs:simpleType>
60/74

</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>)

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
61/74

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)

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;
62/74

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
Exemplo de Rastreamento via post:
<form name="frm1" method="post" action="http://websro.correios.com.br/sro_bin/sroii_xml.eventos">
<input type="text" name="Usuario" value="ECT"><br>
<input type="text" name="Senha" value="SRO"><br>
<input type="text" name="Tipo" value="L"><br>
<input type="text" name="Resultado" value="T"><br>
<input size="60" width="60" type="text" name="Objetos" value="SI550395415BR"><br>
<input type="submit" value="OK">
</form>
09 Cdigo Forma de Pagamento (tag <forma_pagamento>)

Codigo
Forma_Pagamento
Vale Postal
Reembolso Postal
Contrato de Cmbio
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
63/74

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

Cdigo
Unidade_Comercializao
Centmetro
Grama
Milmetro
Minuto
No Significativo
Pagina
Palavra
10
Quantidade
Quilograma
64/74

7
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:
PAC
0000/2002-DR/XX/YY
2. Para arte-finalizao em negativo seguir a mesma

diagramao como no exemplo abaixo:
Negativo:
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/X X/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
Ateno:
Cliente

necessrio.
Ateno:
0000/2002-DR/XX/YY
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
Ateno:
Cliente

necessrio.
Ateno:
0000/2002-DR/XX/YY
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:

Estaro sempre dispostas no parte superior dos smbolos.
0000/2002-DR/XX/YY
Cliente
(dimetro 35mm)
2. Para arte-finalizao em negativo, siga a mesma

diagramao do item 1, conforme exemplo abaixo:
Negativo:

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
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.
Cliente
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 e Logistica Reversa

Enviado por

Dados do documento

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Manual de Implementacao Do Web Service SIGEPWEB e Logistica Reversa

Enviado por

Direitos autorais:

Formatos disponíveis

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

SIGEP WEB Implementao e acesso ao Web Service

EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT

SIGEP Web - Manual de Implementao do Web Service

bem como o manual de implementao, podem ser obtidos no endereo

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

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

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 obtido no mtodo buscaCliente().

Quantidade de etiquetas a serem solicitadas limitadas em

String (Faixa de Numerao de Etiquetas)

EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT

SIGEP Web - Manual de Implementao do Web Service

Dever ser uma String contendo o espao vazio

EMPRESA BRASILEIRA DE CORREIOS E TELGRAFOS ECT

SIGEP Web - Manual de Implementao do Web Service

PLP (pr-lista de postagem) em formato XML