Empresa Brasileira de Correios e Telégrafos
Informações adicionais sobre layout do arquivo de postagem formato xml
1- O contrato, código administrativo e cartão de postagem devem estar previamente
cadastrado e dentro da vigência
2- O número da etiqueta é obrigatório. Apenas objetos registrados podem ser postados.
Desta forma, o adicional “25” referente ao registro deve sempre ser declarado na tag
<codigo_servico_adicional> para cada objeto postado
3 - As etiquetas utilizadas no arquivo devem pertencer ao cliente e a sigla deve estar
associada ao serviço a ser postado
4 - O serviço postado deve estar associado ao cartão de postagem
5 - A tag <internacional> só deve ser declarada em postagens de objetos internacionais, caso
contrário deve ser suprimida.
6 - AS demais tag’s não obrigatórias, caso não tenham conteúdo, devem ser declaradas
vazias.
7 - Atualmente, apenas objetos nacionais podem ser postados via arquivo de postagem.
8 - Antes de iniciar as postagens via arquivo de postagem nas agências, o cliente deve enviar
um arquivo de teste para o contato comercial.
9- Qualquer dúvida sobre o layout do arquivo de postagem entrar em contato com a
representante comercial
Empresa Brasileira de Correios e Telégrafos
CorreiosLOG – Layout formato XML para Postagem Eletrônica no SARA
O layout é dividido nas seguintes tags:
<correioslog> – É a tag principal. Identifica o arquivo como pertencente ao sistema CorreiosLOG.
Tag <tipo_arquivo>
<tipo_arquivo> - Identifica qual o tipo do arquivo dentro do sistema CorreiosLOG. Permite a distinção
entre os diversos tipos de arquivos que o sistema CorreiosLOG processa.
Para este layout deverá ser preenchido: Postagem
Observação: campo obrigatório
Tag <versao_arquivo>
<versao_arquivo> - Identifica a versão do layout do arquivo XML.
A versão deste layout é a 2.3
Observação: campo obrigatório
Tag <remetente>
<remetente> - Identifica o remetente da postagem. Esta Tag deverá aparecer somente uma vez no
arquivo. Os dados necessários para o remetente são:
Tags
Descrição
Tipo de dados
Observações
<numero_contrato>
Número do contrato do
cliente
Caractere(020)
Obrigatório
Não pode existir o
caractere “-“ entre
os números.
<codigo_administrativo>
Código administrativo do
cliente
Caractere(009)
Obrigatório
Não pode existir o
caractere “-“ entre
os números.
<nome_remetente>
Nome do remetente
Caractere(050)
Não obrigatório
(Será obrigatório
apenas para o
serviço 40126)
<logradouro_remetente>
Logradouro do remetente
Caractere(040)
Não obrigatório
Empresa Brasileira de Correios e Telégrafos
apenas para o
serviço 40126)
<numero_remetente>
Parte do endereço
Caractere(06)
Não obrigatório
(Será obrigatório
apenas para o
serviço 40126)
<complemento_remetente>
Complemento do endereço
Caractere(020)
Não obrigatório
(Será obrigatório
apenas para o
serviço 40126)
<bairro_remetente>
Bairro do remetente
Caractere(020)
Não obrigatório
(Será obrigatório
apenas para o
serviço 40126)
<cep_remetente>
CEP do remetente
Numérico(8)
Obrigatório
99999999
Não pode existir o
caractere “-“ entre
os números.
<cidade_remetente>
Cidade do remetente
Caractere(030)
Não obrigatório
(Será obrigatório
apenas para o
serviço 40126)
<uf_remetente>
Unidade de Federação
Caractere(002)
Obrigatório
<telefone_remetente>
Telefone do remetente
Numérico (012)
Não obrigatório
99999999999
Não pode existir o
caractere “-“ entre
os números
<fax_remetente>
Fax do remetente
Numérico (012)
Não obrigatório
99999999999
Não pode existir o
caractere “-“ entre
os números
<email_remetente>
Email do remetente
Caractere (050)
Não obrigatório
Empresa Brasileira de Correios e Telégrafos
Tag <forma_pagamento>
<forma_pagamento> - Valor numérico indicando a forma de pagamento utilizada pelo cliente para realizar
a postagem.
Observação: campo não obrigatório.
Tabela em anexo.
Tag <objeto_postal>
<objeto_postal> - Tag delimitadora do objeto que será postado. Esta tag contém as características do
objeto postado.
Tags
Descrição
Tipo de dados
Observações
<numero_etiqueta>
Número do Objeto na ECT
Caractere(013)
Obrigatório
<codigo_objeto_cliente>
Código do objeto no cliente
Caractere(020)
Não obrigatório
<codigo_servico_postagem>
Código do serviço da postagem Caractere(005)
Obrigatório
<cubagem>
Cubagem do Objeto
Numérico(9,4)
Não obrigatório
<peso>
Peso do objeto (em gramas)
Numérico(5)
Não obrigatório
<rt1>
Reservado para observação
Caractere(255)
Não obrigatório
<rt2>
Reservado para observação
Caractere(255)
Não obrigatório
+ <destinatario>
Dados do destinatário
Obrigatório
+ <nacional>
Dados relevantes a postagem
nacional
Obrigatório para
objeto nacional
+ <internacional>
Dados relevantes a postagem
internacional
Obrigatório para
objeto
internacional. Para
os objetos
nacionais, esta tag
deverá ser
suprimida
+ <servico_adicional>
Identifica os serviços adicionais
do objeto postado
Obrigatório
+<dimensao_objeto>
Contém as dimensões do
objeto (altura,
largura,comprimento e
diâmetro) e o tipo do objeto
(embalagem)
Obrigatório para
os serviços que
exigem
dimensões.
Atualmente 41068,
41017)
Empresa Brasileira de Correios e Telégrafos
Tag <destinatario>
<destinatario> - Esta tag contém os dados do destino da encomenda.
Tags
Descrição
Tipo de dados
Observações
<nome_destinatario>
Nome do destinatário
Caractere(050)
Não obrigatório
(Será obrigatório
apenas para o
serviço 40126)
<telefone_destinatario >
Telefone do Destinatário
Numérico (012)
Não obrigatório
99999999999
Não pode existir o
caractere “-“ entre
os números
<celular_destinatario>
Celular do Destinatário
Numérico (012)
Não obrigatório
99999999999
Não pode existir o
caractere “-“ entre
os números
<email_destinatario>
Email do Destinatário
Caractere(050)
Não obrigatório
<logradouro_destinatario>
Logradouro do destinatário
Caractere(050)
Não obrigatório
(Será obrigatório
apenas para o
serviço 40126)
<complemento_destinatario>
Complemento do endereço
Caractere(030)
Não obrigatório
(Será obrigatório
apenas para o
serviço 40126)
<numero_end_destinatario>
Parte do endereço
Caractere(06)
Não obrigatório
(Será obrigatório
apenas para o
serviço 40126)
Tag <nacional>
<nacional> – A tag <nacional> deverá estar dentro da tag <objeto_postal> e conterá os atributos
específicos de uma postagem de objetos nacionais.
Tags
Descrição
Tipo de dados
Observações
Empresa Brasileira de Correios e Telégrafos
(Será obrigatório apenas
para o serviço 40126)
<cidade_destinatario>
Cidade do destinatário
Caractere(030)
Não obrigatório
(Será obrigatório apenas
para o serviço 40126)
<uf_destinatario>
Sigla da UF do destinatário
Caractere(002)
Obrigatório
<cep_destinatario>
CEP do destinatário
Numérico(8)
Obrigatório 99999999
Não pode existir o
caractere “-“ entre os
números.
<codigo_usuario_postal> Código do usuário postal
Caractere(020)
Não obrigatório
<centro_custo_cliente>
Centro de custo do cliente
Caractere(020)
Não obrigatório
<numero_nota_fiscal>
Número da nota fiscal
Numérico(9)
Opcional. Não será mais
necessário um arquivo por
número de nota fiscal.
<serie_nota_fiscal>
Série da nota fiscal
Caractere(020)
Não obrigatório
<valor_nota_fiscal>
Valor da nota fiscal
Numérico(9,2)
Não obrigatório
<natureza_nota_fiscal>
Natureza da nota fiscal
Caractere(020)
Não obrigatório
<descricao_objeto>
Descrição do objeto
Caractere(020)
Não obrigatório
<valor a cobrar >
Valor a cobrar do destinatário Numérico(9,2)
Obrigatório para os
serviços 40126
Tag <internacional>
<internacional> – A tag <internacional> deverá estar dentro da tag <objeto_postal> e conterá os atributos
específicos de uma postagem de objetos internacionais. Esta tag somente deve estar presente para objeto
internacional.
Tags
Descrição
Tipo de dados
Observações
<city_destinatario>
Cidade do destinatário
Caractere(030) Obrigatório
<post_code_destinatario>
CEP do destinatário
Caractere(015) Não obrigatório
<nome_pais_destinatario>
País do destinatário
Caractere(030) Não obrigatório
<codigo_pais_bandeira_destino>
Código do país bandeira
do destino da postagem
Numérico(4)
Obrigatório
TABELA EM ANEXO
<prazo_exportacao_temporaria>
Prazo de exportação
temporária
Numérico(3)
Não obrigatório
<codigo_tipo_exportador>
Código do tipo de
exportador
Numérico(2)
Não obrigatório
TABELA EM ANEXO
<codigo_natureza_operacao>
Código da natureza da
operação
Numérico(2)
Não obrigatório
TABELA EM ANEXO
<codigo_porte_empresa>
Código do porte da
empresa
Numérico(2)
Não obrigatório
TABELA EM ANEXO
<caso_nao_entrega>
Armazena o que deve ser
Numérico(1)
Obrigatório
Empresa Brasileira de Correios e Telégrafos
feito, em caso de não
entrega do objeto.
0: Devolver ao remetente
1: Tratar como abandonado
<emitir_numero_dse>
Indica se a DSE será
emitida ou não pela ECT
Numérico(1)
Não obrigatório
0: Emissão pela ECT
1: DSE informada pelo
cliente
<numero_dse>
Número da DSE
Caractere (011) Não obrigatório
+ <item_alfandega>
Informações para
alfândega
Tag <item_alfandega>
<item_alfandega> Esta tag deverá estar dentro da tag <internacional> e conterá os atributos específicos
para Alfândega.
Tags
Descrição
Tipo de dados
Observações
<codigo_ncm>
Código do item, segundo
NCM
Caractere(20)
Não obrigatório
<quantidade_item>
Quantidade de itens
Numérico(5)
Não obrigatório
<descricao_item>
Descrição do item
Caractere(020)
Não obrigatório
<codigo_unidade_comercializac
ao>
Refere-se a unidade de
medida
Numérico(5)
Obrigatório
<peso_liquido_item>
Peso liquido do item (em
gramas)
Numérico(5)
Não obrigatório
<peso_bruto_item>
Peso bruto do item (em
gramas)
Numérico(5)
Não obrigatório
<valor_item_real>
Valor do item em Real
Numérico(9,2)
Não obrigatório
<valor_item_dolar>
Valor do item em Dólar
Numérico(9,2)
Não obrigatório
<codigo_moeda_negociacao>
Código da moeda de
negociação
Numérico(5)
Não obrigatório
TABELA EM ANEXO
Tag <servico_adicional>
<servico_adicional> – A tag <servico_adicional> deverá estar dentro da tag <objeto_postal> e conterá os
seguintes atributos:
Tags
Descrição
Tipo de dados
Observações
<codigo_servico_adicional>
Código do serviço adicional
Caractere (002)
Obrigatório.
O adicional “25”
referente ao registro
,deve sempre ser
declarado.
Casos os serviços
postados pelo cliente
possuam outros
Empresa Brasileira de Correios e Telégrafos
serviços adicionais,
estes devem ser
declarados .
TABELA EM ANEXO
<valor_declarado>
Valor declarado do serviço
adicional
Numérico (9,2)
Se o código do serviço
adicional for igual a 19 o
campo é obrigatório,
caso contrário esta Tag
deverá ser suprimida
<data_agendamento>
Data do agendamento,
quando o serviço adicional for
e-Sedex
Date
Se o código do serviço
adicional for igual a 36 o
campo é obrigatório,
caso contrário esta tag
deverá ser suprimida.
Tag <dimensao_objeto>
<dimensao_objeto>
- A tag <dimensao_objeto> deverá estar dentro da tag <objeto_postal> e conterá os
seguintes atributos:
tags
descrição
Tipo de dados
observação
<tipo_objeto>
Contém o código do
tipo de objeto que foi
postado (embalagem)
Numérico(3)
Obrigatório
1 – Envelope
2 – Pacote
3 – Rolo
<dimensao_altura>
Altura do objeto (em
cm/mm)
Numérico (5,1)
Não obrigatório
<dimensao_largura>
Largura do objeto (em
cm/mm)
Numérico (5,1)
Não obrigatório
<dimensao_comprimento>
Comprimento do objeto
(em cm/mm)
Numérico (5,1)
Não obrigatório
<dimensao_diametro>
Diâmetro do objeto (em
cm/mm)
Empresa Brasileira de Correios e Telégrafos
ANEXO
Formas de Pagamento
Codigo
Forma_Pagamento
1
Vale Postal
2
Reembolso Postal
3
Contrato de Câmbio
4
Cartão de Crédito
5
Outros
Código País Bandeira
Codigo_pais_bandeira Descricao_pais Codigo_pais_ECT
132 AFEGANISTAO AF 175 ALBANIA AL 230 ALEMANHA DE 310 BURKINA FASO BF 370 ANDORRA AD 400 ANGOLA AO 418 ANGUILLA AI 434 ANTIGUA E BARBUDA AG 477 ANTILHAS HOLANDESAS AN 531 ARABIA SAUDITA SA 590 ARGELIA DZ 639 ARGENTINA AR 647 ARMENIA AM
655 ARUBA (TER DA HOLANDA) AW
698 AUSTRALIA AU 728 AUSTRIA AT 736 AZERBAIJAO AZ 779 BAHAMAS BS 809 BAHREIN BH 817 BANGLADESH BD 833 BARBADOS BB 850 BELARUS BY 876 BELGICA BE 884 BELIZE BZ 906 BERMUDAS BM 930 MIANMAR MM 973 BOLIVIA BO
Empresa Brasileira de Correios e Telégrafos
Codigo_pais_bandeira Descricao_pais Codigo_pais_ECT
981 BOSNIA-HERZEGOVINA BA 1015 BOTSUANA BW 1058 Brasil BR 1082 BRUNEI BN 1112 BULGARIA BG 1155 BURUNDI BI 1198 BUTAO BT 1279 CABO VERDE CV 1376 CAYMAN KY 1414 CAMBODJA KH 1457 CAMAROES CM 1490 CANADA CA
1511 ILHAS CANARIAS E TENERIFE CT
1538 CAZAQUISTAO KZ 1546 CATAR QA 1589 CHILE CL 1600 CHINA CN 1619 TAIWAN TW 1635 CHIPRE CY 1651 COCOS,ILHAS NULL 1694 COLOMBIA CO 1732 COMORES KM
1775 REP. DEMOC. DO CONGO CD
1830 ILHAS COOK CK 1872 COREIA DO NORTE KP 1902 COREIA DO SUL KR 1937 COSTA DO MARFIM CI 1953 CROACIA HR 1961 COSTA RICA CR 1988 KUWAIT KW 1996 CUBA CU 2291 BENIN BJ 2321 DINAMARCA DK 2356 DOMINICA DM 2399 EQUADOR EC 2402 EGITO EG
2445 EMIRADOS ARABES UNIDOS AE
2453 ESPANHA ES 2461 ESLOVENIA SI 2470 ESLOVAQUIA SK 2496 ESTADOS UNIDOS US 2518 ESTONIA EE 2534 ETIOPIA ET 2550 MALVINAS FK 2593 FAROE FO 2674 FILIPINAS PH 2712 FINLANDIA FI 2755 FRANÇA FR 2810 GABAO GA
Empresa Brasileira de Correios e Telégrafos
Codigo_pais_bandeira Descricao_pais Codigo_pais_ECT
2852 GAMBIA GM
2895 GANA GH
2917 GEORGIA GE
2933 GIBRALTAR (TER BRITANICO) GI
2976 GRANADA GD
3018 GRECIA GR
3050 GROENLANDIA(TERR DA DINAMARCA GL
3093 GUADALUPE (TERRIT FRANCES) GP
3131 GUAM (TERR AMERICANO) GU
3174 GUATEMALA GT 3255 GUIANA FRANCESA GF 3298 GUINE GN 3310 GUINE EQUATORIAL GQ 3344 GUINE-BISSAU GW 3379 GUIANA GY 3417 HAITI HT 3450 HONDURAS HN 3514 HONG KONG HK 3557 HUNGRIA HU 3573 IEMEN YE
3595 MAN, ILHA DE NULL
3611 INDIA IN 3654 INDONESIA ID 3697 IRAQUE IQ 3727 IRA IR 3751 IRLANDA IE 3794 ISLANDIA IS 3832 ISRAEL IL 3867 ITALIA IT 3883 IUGOSLAVIA YU 3913 JAMAICA JM 3999 JAPAO JP 4030 JORDANIA JO 4111 KIRIBATI KI 4200 LAOS LA 4260 LESOTO LS 4278 LETONIA LV 4316 LIBANO LB 4340 LIBERIA LR 4383 LIBIA LY 4405 LIECHTENSTEIN LI 4421 LITUANIA LT 4456 LUXEMBURGO LU 4472 MACAU MO 4499 MACEDONIA MK 4502 MADAGASCAR MG 4525 ACORES E MADEIRA AC 4553 MALASIA MY 4588 MALAVI MW
Empresa Brasileira de Correios e Telégrafos
Codigo_pais_bandeira Descricao_pais Codigo_pais_ECT
4618 MALDIVAS MV 4642 MALI ML 4677 MALTA MT 4740 MARROCOS MA 4766 ILHAS MARSHALL MH 4774 MARTINICA MQ 4855 MAURICIO MU 4901 MIDWAY MI 4936 MEXICO MX 4944 MOLDAVIA MD 4952 MONACO MC 4979 MONGOLIA MN 4995 MICRONESIA FM 5010 MONTSERRAT MS 5053 MOCAMBIQUE MZ 5070 NAMIBIA NA 5088 NAURU NR 5118 ILHAS CHRISTMAS CX 5177 NEPAL NP 5215 NICARAGUA NI 5258 NIGER NE 5282 NIGERIA NG 5355 NORFOLK NF 5380 NORUEGA NO 5428 NOVA CALEDONIA NC 5452 PAPUA-NOVA GUINE PG 5487 NOVA ZELANDIA NZ 5517 VANUATU VU 5568 OMA OM 5738 PAISES BAIXOS NL 5754 PALAU PW 5762 PAQUISTAO PK 5800 PANAMA PA 5860 PARAGUAI PY 5894 PERU PE 5932 PITCAIRN PN 5991 POLINESIA FRANCESA PF 6033 POLONIA PL 6076 PORTUGAL PT 6114 PORTO RICO PR 6238 QUENIA KE 6254 QUIRGUISTAO KG 6289 REINO UNIDO GB
6408 CENTRO AFRICANA (REPUBLICA) CF
6475 REPUBLICA DOMINICANA DO
6602 REUNIAO RE
6653 ZIMBABUE ZW
6700 ROMENIA RO
Empresa Brasileira de Correios e Telégrafos
Codigo_pais_bandeira Descricao_pais Codigo_pais_ECT
6769 RUSSIA RU 6777 SALOMAO SB 6858 SAARA OCIDENTAL MA 6874 EL SALVADOR SV 6904 SAMOA WS 6912 SAMOA AMERICANA AS
6955 SAO CRISTOVAO E NEVIS KN
6971 SAN MARINO SM
7005 SAINT PIERRE E MIQUELON PM
7056 SAO VICENTE E GRANADINAS VC
7102 SANTA HELENA SH
7153 SANTA LUCIA LC
7200 SAO TOME E PRINCIPE ST
7285 SENEGAL SN 7315 SEYCHELLES SC 7358 SERRA LEOA SL 7412 CINGAPURA SG 7447 SIRIA SY 7480 SOMALIA SO 7501 SRI-LANKA LK 7544 SUAZILANDIA SZ 7560 AFRICA DO SUL ZA 7595 SUDAO SD 7641 SUECIA SE 7676 SUICA CH 7706 SURINAME SR 7722 TADJIQUISTAO TJ 7765 TAILANDIA TH 7838 DJIBUTI DJ 7889 CHADE TD 7919 TCHECA CZ 7951 TIMOR ORIENTAL TP 8001 TOGO TG 8109 TONGA TO 8150 TRINIDAD E TOBAGO TT 8206 TUNISIA TN 8230 TURCKS E CAICOS TC 8249 TURCOMENISTAO TM 8273 TURQUIA TR 8281 TUVALU TV 8311 UCRANIA UA 8338 UGANDA UG 8451 URUGUAI UY 8478 UZBEQUISTAO UZ 8486 VATICANO VA 8508 VENEZUELA VE 8583 VIETNA VN 8702 FIJI FJ
Empresa Brasileira de Correios e Telégrafos
Código do Tipo de Exportador
Código Exportador
1 Pessoa Jurídica 11 Pessoa Física
12 Pessoa Física domiciliada no exterior sem CPF 13 Pessoa Física residente no país sem CPF
Empresa Brasileira de Correios e Telégrafos
Código da Natureza da Operação
Código Natureza_Operação
1 Pessoa física com cobertura cambial 2 Pessoa física sem cobertura cambial 3 Pessoa jurídica com cobertura cambial 4 Pessoa física sem cobertura cambial 30 Doação em caráter de ajuda humanitária 31 Bagagem desacompanhada
41 Bens de caráter cultural- Exportação temporária 42 Exportação temporária de material para emprego
militar
43 Feiras e exposições
44 Conserto, reparo ou restauração 45 Outras exportações temporárias
61 Bens submetidos a regime de admissão temporária 71 Erro de expedição
72 Não atendimento de exigência de controle extrafiscal 73 Indeferimento de regime aduaneiro especial
74 Outros motivos: Portaria MF 306/95
Código do Porte da Empresa
Código Porte_Empresa
1 Micro Empresa 2 Pequena Empresa
3 Outros
Código da Unidade de Comercialização
Código Unidade_Comercialização 8 Centímetro 2 Grama 9 Milímetro 5 Minuto 6 Não Significativo 4 Pagina 3 Palavra 10 Quantidade
Empresa Brasileira de Correios e Telégrafos
1 Quilograma
7 R$-Valor
Código da Moeda de Negociação
Código Moeda
0 Real 1 Dolar Ameri Tur 3 Franco Fran Tur 5 Franco Belg Tur 6 Afegane/Afeganist 7 Franco Suic Tur 9 Escudo Port Tur 10 Birr/Etiopia 11 Coroa Norue Tur 13 Coroa Dinam Tur 14 Bath/Tailandia 15 Dts - Upu 16 Euro 20 Balboa/Panama 25 Bolivar/Venzuela 30 Boliviano/Bolivia 35 Cedi/Gana 40 Colon/Costa Rica 45 Colon/El Salvador 51 Cordoba Ouro 57 Coroa/Estonia 58 Coroa Eslovaca 60 Coroa Islnd/Islan 70 Coroa Sueca/Sueci 75 Coroa Tcheca 90 Dalasi/Gambia 95 Dinar Argelino 100 Dinar/Kwait 105 Dinar/Bahrein 115 Dinar/Iraque 125 Dinar/Jordania 130 Dinar/Libia 132 Dinar/Macedonia 134 Dinar/Sudao 135 Dinar/Tunisia 138 Direito Especial 139 Dirham/Marrocos 145 Dirham/Emir.Arabe