WebService Total Express

Verso 2.4 - Dezembro/ 2015

Total Express - Tex Courier Ltda

edi@totalexpress.com.br
www.totalexpress.com.br
Sumrio

............................................................................................................................................................. 1
1. Introduo ........................................................................................................................................... 3
1.1. O que um WebService? ............................................................................................................. 3
1.2 Disponibilidade .............................................................................................................................. 3
1.3 Responsabilidades do usurio ....................................................................................................... 3
2. Como utilizar o servio ........................................................................................................................ 4
3. Dados tcnicos .................................................................................................................................... 4
3.1. Segurana na transmisso ............................................................................................................ 4
4. Recursos do Webservice ..................................................................................................................... 4
5. Mtodo RegistraColeta ....................................................................................................................... 5
5.1 Descrio da estrutura RegistraColetaRequest ......................................................................... 6
5.1 Descrio da estrutura RegistraColetaResponse .................................................................... 11
6. Mtodo ObterTracking ...................................................................................................................... 12
6.1 Descrio da estrutura ObterTrackingRequest ....................................................................... 13
6.2 Descrio da estrutura ObterTrackingResponse ..................................................................... 13
Anexo 1 Status das Encomendas ........................................................................................................ 15
Anexo 2 Modelo do mtodo RegistraColetaRequest ......................................................................... 18
Anexo 3 Configurao Extra ............................................................................................................... 19
Anexo 4 Tracking ................................................................................................................................. 20

2
WebService Total Express
1. Introduo
O WebService TOTAL EXPRESS foi criado para facilitar a troca de informaes com seus clientes de
forma prtica e segura.

1.1. O que um WebService?

Trata-se de uma soluo utilizada na integrao de sistemas que se d pela comunicao entre
diferentes aplicaes, atravs da adoo de padres especficos moldados de acordo com a
necessidade do usurio.

Em nosso caso, de um lado temos os servidores da TOTAL EXPRESS que disponibilizam o servio de
WebService, no papel de Service Provider, e do outro temos os clientes da empresa requisitando
servios digitais, ou seja, enviando e recebendo informaes. O WebService da TOTAL EXPRESS utiliza
o protocolo de troca de dados SOAP.

1.2 Disponibilidade
O WebService est disponvel o tempo todo (24 horas por dia, 7 dias por semana), exceto em
momentos em que ocorram situaes de manuteno ou falha tcnica.

Nesses casos, a TOTAL EXPRESS se compromete a notificar os usurios do WebService com a mxima
antecedncia possvel, mas se reserva ao direito de realizar manutenes emergenciais sem que haja
tal comunicao. A TOTAL EXPRESS se reserva ao direito de alterar o IP dos servidores sempre que
necessrio, e sempre instrui seus clientes a utilizar a URL de acesso em suas configuraes.

Por se tratar de um servio sncrono, em cada transmisso o sistema cliente poder saber se houve
alguma falha, sem que seja necessrio entrar em contato com a equipe tcnica da TOTAL EXPRESS.

1.3 Responsabilidades do usurio

O usurio do servio dever estar ciente e concordar com suas responsabilidades:

Respeitar as normas de segurana colocadas pela TOTAL EXPRESS. IMPORTANTE!

Garantir a integridade das informaes enviadas;
Realizar o uso consciente, evitando sobrecarga de processamento;
Construir uma ferramenta eficaz de envio, capaz de confirmar a transmisso atravs da
resposta obtida. Havendo erros, caber ao cliente identific-los e trat-los;
O envio das coletas deve ser feito sempre em lote, representando um processo de expedio
para a Total Express. proibido o envio pedido a pedido, pois pode causar impacto no
processo operacional e no processamento do servio eletrnico;

O USO INDEVIDO PODE ACARRETAR SUSPENSO DO SERVIO SEM PRVIO AVISO!

3
2. Como utilizar o servio
Para se tornar um utilizador do WebService, o cliente dever preparar o ambiente tcnico conforme
descrito nesse manual, e entrar em contato com o departamento de tecnologia da TOTAL EXPRESS,
solicitando preparao do ambiente de testes. Nesse momento o cliente dever informar os
endereos de IP de onde as transmisses sero originadas.

A equipe tcnica da TOTAL EXPRESS fornecer ao cliente as seguintes informaes: endereo de

transmisso (inclusive endereo do arquivo WSDL), usurio e senha.

Aps a concluso dos testes, a equipe tcnica da TOTAL EXPRESS liberar acesso ao ambiente
produtivo. Salientamos que o ambiente de testes apenas realiza a validao dos dados sem grav-los
em nossa base.

3. Dados tcnicos
Protocolo de transmisso: SOAP 1.1
Mais informaes: http://www.w3.org/TR/soap11/

Codificao do contedo: UTF-8

Mais informaes: http://tools.ietf.org/html/rfc5198

Tipo de servio: Sncrono (tempo real): o processamento da solicitao de servio

concludo na mesma conexo, com a devoluo de uma mensagem com
o resultado do processamento solicitado. Essa mensagem poder ser de
sucesso ou de erro.

Tamanho mximo da 500 Kb. Transmisses maiores sero descartadas.

transmisso:

3.1. Segurana na transmisso

Para assegurar a autenticidade da transmisso, o WebService TOTAL EXPRESS trabalha com
protocolo HTTPS. Se o cliente no possuir SSL, o webservice aceitar conexes apenas a partir de
endereos IP previamente cadastrados (mximo de 5 endereos) e tambm autenticao do usurio,
via HTTP. Subentende-se, portanto, que o cliente dever possuir ao menos um endereo IP fixo. Se o
cliente possuir SSL, o webservice aceitar conexes apenas com autenticao de usurio, sem a
necessidade do IP.

4. Recursos do Webservice
RegistraColeta Permite ao cliente transmitir informaes das encomendas, que so os dados
das encomendas a serem entregues.
ObterTracking Permite ao cliente resgatar informaes de tracking (retorno) das
encomendas.

4
5. Mtodo RegistraColeta
Permite ao cliente transmitir informaes de remessas. Cada transmisso nesse mtodo pode conter
um ou mais volumes (encomendas). A chamada desse mtodo deve ser feita enviando uma estrutura
complexa RegistraColetaRequest. Os dados retornados viro no formato de uma estrutura
complexa RegistraColetaResponse.

As informaes transmitidas ficam a disposio do cliente por 10 dias, aguardando o volume fsico
aps este prazo os dados so apagados do sistema necessitando uma nova transmisso das
informaes.

5
5.1 Descrio da estrutura RegistraColetaRequest
# Nome Descrio Preenchimento Tipo Tam. Observaes
tns:RegistraColetaRequest
1 CodRemessa Cdigo de identificao da remessa pelo cliente Opcional xsd:string 20
2 Encomendas Lote de encomendas Mandatrio tns:Encomendas 1
tns:Encomendas
3 Encomenda Dados da encomenda Mandatrio tns:Encomenda
tns:Encomenda
1 = Servio Expresso / 2 = Servio Especial / 3 = Standard com
Transferncia Rodoviria / 4 = Entrega Fcil / 5 = Premium / 6 =
4 TipoServico Servio Contratado Mandatrio xsd:nonNegativeInteger 1 Standard
Em caso do TipoServico = 4, dever ser informado o CNPJ do
5 TipoServicoTipo Servio Contratado Opcional xsd:string 14 Estabelecimento de retirada da encomenda
6 TipoEntrega Tipo de Entrega Mandatrio xsd:nonNegativeInteger 1 0 = Entrega Normal (padro) / 1 = GoBack / 2 = RMA
7 Peso Peso da encomenda Opcional xsd:decimal 3,2 Numrico, com 2 casas decimais. Ex: 12.34
8 Volumes Quantidade de volumes Mandatrio xsd:nonNegativeInteger 2 Quantidade de volumes fsicos (caixas)
Preencher com CIF, pois a Total Express no trabalha com a
9 CondFrete Condio de frete Mandatrio xsd:string 3
modalidade FOB
10 Pedido Cdigo do pedido Mandatrio xsd:string 20
11 IdCliente Cdigo fornecido pelo cliente Opcional xsd:string 20 Cdigo fornecido pelo cliente para identificar a encomenda
Informar a descrio do produto predominante. Item exigido para
12 Natureza Natureza da Mercadoria Mandatrio xsd:string 25 emisso do CTe (vide campo 279 do Manual de Integrao
Contribuinte - Verso 1.0.4a de - 12/08/11)
13 TipoVolumes Tipo de Volumes Opcional xsd:string 3 Ex: CX (Caixas)
14 IsencaoIcms Indica mercadoria isenta de ICMS Mandatrio xsd:nonNegativeInteger 1 0 = no / 1 = sim
informaes de coleta/troca (RMA/GoBack)
15 InfoColeta Descrio do material a ser coletado Condicional xsd:string 255 Obrigatrio quando o tipo de Entrega (campo 5) for 1 ou 2.
dados do destinatrio
16 DestNome Nome do destinatrio Mandatrio xsd:string 40
17 DestCpfCnpj CPF ou CNPJ do destinatrio Mandatrio xsd:string 14 Informar apenas os nmeros, inclusive zeros esquerda, se houver.
Obrigatrio quando o destinatrio for contribuinte.
18 DestIe Inscrio Estadual Condicional xsd:String 14
Informar apenas os nmeros, inclusive zeros esquerda, se houver.
19 DestEnd Endereo de entrega Mandatrio xsd:string 80
20 DestEndNum Nmero do Endereo de entrega Mandatrio xsd:string 10

6
21 DestCompl Complemento do endereo de entrega Condicional xsd:string 60 Obrigatrio caso o endereo exija complemento
# Nome Descrio Preenchimento Tipo Tam. Observaes
dados do destinatrio (cont.)
22 DestPontoRef Ponto de referncia para entrega Opcional xsd:string 255 Muito til para localizao de endereos
23 DestBairro Bairro Mandatrio xsd:string 40
24 DestCidade Cidade Mandatrio xsd:string 40
25 DestEstado Estado Mandatrio xsd:string 2
26 DestPais Pas Opcional xsd:string 20 Pas de destino. Padro: Brasil
27 DestCep Cep Mandatrio xsd:NonNegativeInteger 8
28 DestEmail Email Opcional xsd:string 60
29 DestDdd DDD Opcional xsd:NonNegativeInteger 3 O DDD pode ser informado nesse campo ou nos campos abaixo.
O nmero poder ser informado sem o DDD (nesse caso o DDD
30 DestTelefone1 Telefone Opcional xsd:NonNegativeInteger dever ser informado no campo 28), ou o nmero completo com o
12 DDD. Informar apenas nmeros
O nmero poder ser informado sem o DDD (nesse caso o DDD
31 DestTelefone2 Telefone2 Opcional xsd:NonNegativeInteger dever ser informado no campo 28), ou o nmero completo com o
12 DDD. Informar apenas nmeros
O nmero poder ser informado sem o DDD (nesse caso o DDD
32 DestTelefone3 Telefone3 Opcional xsd:NonNegativeInteger dever ser informado no campo 28), ou o nmero completo com o
12 DDD. Informar apenas nmeros
dados adicionais do pedido
Descrio da campanha. O acompanhamento de campanhas um
33 Campanha Nome da Campanha Opcional xsd:string 10 produto adicional que deve ser contratado.
34 Cod Dados do COD, se houver Opcional tns:Cod 1
O agendamento de entregas um produto adicional que deve ser
35 Agendamento Dados do COD, se houver Opcional tns:Agendamento 1
contratado.
36 DocFiscalNFe Coleo de elementos para Nota Fiscal Eletrnica Condicional tns: DocFiscalNFe 1 Obrigatrio se empresa emitir Nota Fiscal Eletrnica
Coleo de elementos para Nota Fiscal
DocFiscalNF
37 convencional (papel) Condicional tns: DocFiscalNF 1 Obrigatrio se empresa emitir Nota Fiscal convencional (papel)
Coleo de elementos para outros documentos
DocFiscalO
38 fiscais Condicional tns: DocFiscalO 1 Obrigatrio se empresa emitir outros documentos fiscais
Informo do CNPJ do Embarcador da Informar CNPJ do Embarcador da encomenda, caso seja diferente do
CNPJ
39 Encomenda Opcional xsd:string 14 CNPJ do Remetente.
tns:Cod Estrutura Complexa COD
40 FormaPagto Forma de pagamento do COD Condicional xsd:String 2 Obrigatrio quando houver COD. Utilizar CH = cheque
41 Parcelas Nmero de parcelas Condicional xsd:Decimal 2 Obrigatrio quando houver COD

7
42 Valor Valor total a ser coletado Condicional xsd:Decimal 5,2 Obrigatrio quando houver COD. Soma do valor das parcelas
tns:Agendamento - Estrutura Complexa Agendamento
# Nome Descrio Preenchimento Tipo Tam. Observaes
43 AgData Data da entrega Agendada Condicional xsd:Date Somente deve ser preenchido caso o servio tenha sido contratado
tns:Agendamento - Estrutura Complexa Agendamento (cont)
44 AgPeriodo1 Perodo da entrega Condicional xsd:String 1 Obrigatrio se for entrega agendada. M = manh, T=tarde, N=noite
45 AgPeriodo2 Segundo perodo de entrega Opcional xsd:String 1 T=tarde, N=noite
tns:DocFiscalNFe coleo de notas fiscais eletrnicas
46 DocFiscalNFe Coleo de notas fiscais eletrnicas Mandatrio tns:NFe 1
tns: NFe - dados da nota fiscal eletrnica
47 NfeNumero Nmero da Nota Fiscal Mandatrio xsd:NonNegativeInteger 9
48 NfeSerie Serie da nota fiscal Mandatrio xsd:NonNegativeInteger 3
49 NfeData Data de emisso da Nota Fiscal Mandatrio xsd:Date
50 NfeValTotal Valor total da Nota Fiscal Mandatrio xsd:Decimal 15,2
51 NfeValProd Valor total dos produtos Mandatrio xsd:Decimal 15,2 Esse valor ser utilizado no clculo do seguro da encomenda.
52 NfeCfop CFOP predominante Opcional xsd:NonNegativeInteger 4
53 NfeChave Chave de acesso Mandatrio xsd:String 44
tns:DocFiscalNF coleo de notas fiscais convencional
54 DocFiscalNF Coleo de notas fiscais convencionais (papel) Mandatrio tns:NF 1
tns:NF nota fiscal convencional
55 NfNumero Nmero da Nota Fiscal Mandatrio xsd:NonNegativeInteger 9
56 NfSerie Serie da nota fiscal Mandatrio xsd:string 3
57 NfData Data de emisso da Nota Fiscal Mandatrio xsd:date 10
58 NfValTotal Valor total da Nota Fiscal Mandatrio xsd:decimal 15,2
59 NfValBc Valor da Base de Clculo do ICMS Mandatrio xsd:decimal 15,2
60 NfValIcms Valor total do ICMS Mandatrio xsd:decimal 15,2
61 NfValBcSt Valor da Base de Clculo do ICMS ST Mandatrio xsd:decimal 15,2 Se no houver substituio tributria, preencher com 0
62 NfValIcmsSt Valor total do ICMS ST Mandatrio xsd:decimal 15,2 Se no houver substituio tributria, preencher com 0
63 NfValProd Valor total dos produtos Mandatrio xsd:decimal 15,2 Esse valor ser utilizado no clculo do seguro da encomenda.
64 NfCfop CFOP predominante Mandatrio xsd:NonNegativeInteger 4
tns:DocFiscalNFo coleo de documentos fiscais de outros tipos
8
65 DocFiscalO Coleo de outros tipos de documentos fiscais Mandatrio tns: DocFiscalOutroTipo 1

9
# Nome Descrio Preenchimento Tipo Tam. Observaes
tns: DocFiscalOutroTipo coleo de documentos fiscais de outros tipos
66 NfoTipo Tipo de Documento Mandatrio xsd:string 2 Tipo do documento fiscal:00-Declarao ou 99-Outros
67 NfoDescricao Descrio do Documento Condicional xsd:string 60 Obrigatrio caso tipo 99-Outros
68 NfoNumero Nmero do Documento Mandatrio xsd:NonNegativeInteger 9
69 NfoData Data de Emisso Mandatrio xsd:string 10
70 NfoValTotal Valor total do Documento Mandatrio xsd:decimal 15,2
71 NfoValProd Valor total da Mercadoria Mandatrio xsd:decimal 15,2 Esse valor ser utilizado no clculo do seguro da encomenda.
72 NfoCfop CFOP predominante Opcional xsd:NonNegativeInteger 4

10
5.1 Descrio da estrutura RegistraColetaResponse
# Nome Descrio Preenchimento Tipo Tam. Observaes
tns:RegistraColetaRequest
Cdigo informado pelo cliente para identificar a
1 CodRomaneio Condicional xsd:string 20 Normalmente utilizado quando houver um processo de expedio.
transmisso
2 ItensProcessados Total de itens processados Mandatrio xsd:NonNegativeInteger 3
3 ItensRejeitados Total de itens rejeitados Mandatrio xsd:NonNegativeInteger 3
Obrigatrio caso ocorra algum erro pontual (campo 3
4 ErrosIndividuais Descrio dos erros encontrados, se houver Condicional tns:ErrosIndividuais 1 ItensRejeitados maior que 0)
0 Cliente no autorizado a realizar o procedimento
1 Processado com sucesso
Obs: Processamento realizado com sucesso.
2 Sistema indisponvel no momento
Obs: O cliente dever realizar a transmisso novamente mais tarde.
3 Erro na validao XSD
5 CodigoProc Cdigo do Processamento Obrigatrio xsd:NonNegativeInteger 1 Obs: O cliente dever verificar a estrutura do contedo enviado.
4 Erro sistmico por parte da TOTAL EXPRESS
Obs: O cliente dever realizar a transmisso novamente mais tarde.
5 Erro com os dados enviados (campos mandatrios no
preenchidos, etc.) em pelo menos um dos volumes enviados.
Obs: Nesse caso ser enviada a matriz ErrosIndividuais de
elementos do tipo CriticaVolume para cada item invlido.
Obrigatrio caso pelo menos um volume seja processado. Em
6 NumProtocolo Nmero do protocolo de recebimento. Condicional xsd:string 1
ambiente de homologao ser retornado sempre 1 (um).
tns:ErrosIndividuais - Matriz com os erros individuais observados no processamento
Matriz de elementos CriticaVolume, que traz o
7 CriticaVolume Obrigatrio tns:CriticaVolume 1 Serve como base para o tratamento dos erros encontrados.
resultado do processamento individual dos volumes.
tns:CriticaVolume Descrio do erro
8 Pedido Cdigo do pedido. Mandatrio xsd:string 1
9 IdCliente Cdigo da encomenda Condicional xsd:string 1 Obrigatrio se houver
1 Tipo de Servio no contratado;
2 Erro com os dados enviados (campos mandatrios no
preenchidos, etc.);
10 CodigoErro Mandatrio xsd:NonNegativeInteger 1 Obs: O cliente dever verificar o contedo enviado, na ausncia de
dados e/ou preenchimento incorreto dos campos;
3 Volume Duplicado;
4 Erro sistmico por parte da Total Express ao processar volume.
11 DescricaoErro Descrio do erro gerado Mandatrio xsd:string 1

11
6. Mtodo ObterTracking
Cada vez que uma encomenda movimentada, o sistema ICS gera um novo status que nos permite
precisar, em tempo real, qual a situao do volume.

De tempos em tempos (customizado por cliente, com o intervalo mnimo de uma hora), o sistema ICS
agrupa os novos status que surgiram, e disponibiliza essas informaes num arquivo que pode ser
baixado pelo ICS, ou por WebService, atravs do mtodo ObterTracking.

A chamada desse mtodo deve ser feita enviando uma estrutura complexa ObterTrackingRequest.
Os dados retornados viro no formato de uma estrutura complexa ObterTrackingResponse.

12
6.1 Descrio da estrutura ObterTrackingRequest
# Nome Descrio Preenchimento Tipo Tam. Observaes
tns:ObterTrackingRequest
Caso no informado, os sero transmitidos apenas os lotes ainda no
1 DataConsulta Data para consulta pontual Opcional xsd:date enviados.

6.2 Descrio da estrutura ObterTrackingResponse

# Nome Descrio Preenchimento Tipo Tam. Observaes
tns:ObterTrackingResponse
0 Cliente no autorizado a realizar o procedimento
1 Processado com sucesso
Obs: Processamento realizado com sucesso.
2 Sistema indisponvel no momento
1 CodigoProc Cdigo nico do lote de retorno Mandatrio xsd:nonNegativeInteger 10 Obs: O cliente dever realizar a transmisso novamente mais tarde.
3 Erro na validao XSD
Obs: O cliente dever verificar a estrutura do contedo enviado.
4 Erro sistmico por parte da TOTAL EXPRESS
Obs: O cliente dever realizar a transmisso novamente mais tarde.
2 ArrayLoteRetorno Coleo de lotes de retorno Opcional tns:ArrayLoteRetorno Se no houver itens no transmitidos, o campo no ser enviado.
tns:ArrayLoteRetorno coleo de lotes de retorno
3 LoteRetorno Itens de retorno Mandatrio tns: LoteRetorno
tns:LoteRetorno coleo de lotes de retorno
4 CodRetorno Cdigo de identificao do lote de retorno Mandatrio xsd:nonNegativeInteger 10
5 DataGeracao Data de gerao do lote de retorno Mandatrio xsd:dateTime
Matriz de elementos EncomendaRetorno,
tns:
6 ArrayEncomendaRetorno que traz os status individuais obtidos no Opcional 1 Se no houver itens no transmitidos, o campo no ser enviado.
ArrayEncomendaRetorno
perodo
tns:ArrayEncomendaRetorno lote de retorno
7 EncomendaRetorno Itens de retorno Mandatrio tns: EncomendaRetorno
tns:EncomendaRetorno dados da encomenda
Cdigo interno da Total Express que permite
xsd:nonNegativeInteger
8 AWB identificar o volume Mandatrio 12
9 Pedido Nmero do pedido informado na transmisso Mandatrio xsd:string 20
10 NotaFiscal Nmero do documento fiscal informado Mandatrio xsd:NonNegativeInteger 9

13
11 NotaFiscalSerie Srie do documento fiscal informado Mandatrio xsd:string 3
# Nome Descrio Preenchimento Tipo Tam. Observaes
tns:EncomendaRetorno dados da encomenda (cont.)
Cdigo informado pelo cliente para identificar
12 IdCliente o item (encomenda) Condicional xsd:string 20 Obrigatrio, se houver
Ser enviado caso a encomenda tenha sido redespachada pelos
13 CodigoObjeto Cdigo do objeto nos Correios Condicional xsd:string 13
Correios.
14 ArrayStatusTotal Coleo de status Total do perodo Condicional tns: ArrayStatusTotal 1 Se no houver itens no transmitidos, o campo no ser enviado.
15 ArrayStatusEct Coleo de status ECT do perodo Condicional tns: ArrayStatusEct 1 Se no houver itens no transmitidos, o campo no ser enviado.
tns: ArrayStatusTotal coleo de status de retorno
16 StatusTotal Itens de retorno Mandatrio tns: StatusTotal
tns: StatusTotal status do transporte feito pela Total Express
Cdigo do Status retornado. O Anexo 1
xsd:nonNegativeInteger
17 CodStatus contm a relao dos status disponveis Mandatrio
18 DescStatus Descrio do Status Mandatrio xsd:string
19 DataStatus Data da ocorrncia Mandatrio xsd:dateTime
tns:ArrayStatusEct coleo de status de retorno
20 StatusEct Itens de retorno Mandatrio tns: StatusEct
tns:StatusEct status do transporte feito pelos Correios
21 EctTipo Tipo do evento dos Correios Mandatrio xsd:string 3
22 EctStatus Status do evento de retorno Mandatrio xsd:string 3
23 EctData Data do evento Mandatrio xsd:date
24 EctHora Hora do evento Mandatrio xsd:time
25 EctDescricao Descrio do evento Opcional xsd:string 100
26 EctComentario Um comentrio adicional sobre o evento Opcional xsd:string
27 EctLocal Local onde ocorreu o evento Opcional xsd:string 50
28 EctCodigo CEP da unidade ECT Opcional xsd:string 20
29 EctCidade Cidade onde ocorreu o evento Opcional xsd:string 100
30 EctUf UF onde ocorreu o evento Opcional xsd:string 2

14
Anexo 1 Status das Encomendas
Atualizao: 02/2017.

A Total Express se reserva ao direito de alterar a listagem a qualquer momento sem prvio aviso.

cdigo descrio
0 ARQUIVO RECEBIDO
1 ENTREGA REALIZADA
6 ENDERECO DESTINATARIO NAO LOCALIZADO
8 DUAS OU MAIS VEZES AUSENTE/FECHADO
9 RECUSADA - MERCADORIA EM DESACORDO
10 SINISTRO LIQUIDADO
11 RECUSADA - AVARIA DA MERCADORIA / EMBALAGEM
12 SERVIO NO ATENDIDO
13 LOCALIDADE FORA DO PERIMETRO URBANO
14 MERCADORIA AVARIADA
15 EMBALAGEM EM ANALISE
16 RECUSADA - PEDIDO / COLETA EM DUPLICIDADE
18 EXTRAVIO / HUB
19 EXTRAVIO POR DIVERGNCIA DE COLETA
20 ESPERA SUPERIOR A 20 MINUTOS
21 CLIENTE AUSENTE/ ESTABELECIMENTO FECHADO
22 MERCADORIA ENVIADA PARA SALVADOS
23 EXTRAVIO DE MERCADORIA EM TRANSITO
24 ACAREAO SEM SUCESSO MERCADORIA EXTRAVIADA
25 DEVOLUO EM ANDAMENTO AO CD
26 DEVOLUO RECEBIDA NO CD
27 ROUBO DE CARGA
29 CLIENTE RETIRA NA TRANSPORTADORA
30 EXTRAVIO / AGENTE
31 EXTRAVIO / COURIER OU MOTORISTA
32 EXTRAVIO / TRANSFERNCIA AEREA
33 EXTRAVIO / TRANSFERNCIA RODOVIARIA
34 DEVOLVIDO PELOS CORREIOS
35 EXTRAVIO / ROUBO - TRANSPORTADORAS
36 EXTRAVIO / ROUBO - ECT
37 FORA DE ROTA
38 REDESPACHADO CORREIO
39 DESTINATARIO MUDOU-SE
40 CANCELADO PELO DESTINATARIO
41 DESTINATARIO DESCONHECIDO
42 DESTINATARIO DEMITIDO

15
43 DESTINATARIO FALECEU
44 FALTA BLOCO DO EDIFICIO / SALA
45 FALTA NOME DE CONTATO / DEPARTAMENTO / RAMAL
46 FALTA NUMERO APT/CASA
47 NUMERO INDICADO NO LOCALIZADO
48 INTEMPERIES
49 AREA RESTRITA DE ACESSO
50 VEICULO ENTREGADOR AVARIADO
51 NO VISITADO
52 RECUSADO POR TERCEIROS
53 CONFLITO CEP/LOCALIDADE
55 RECUSA - FALTA DE COMPRA
56 CANCELADO PELO REMETENTE
57 PRODUTO NAO DISPONIVEL PARA COLETA
58 COLETA REVERSA NO SOLICITADA
59 RECEBEDOR SEM IDENTIFICACAO
60 RMA EXECUTADO
61 DEVOLVIDA AO REMETENTE
62 RMA RECEBIDO NO CD
63 ORDEM DE COLETA CANCELADA
64 DINHEIRO OU CHEQUE NAO DISPONIVEL
65 VALOR DE COD DIVERGENTE
68 COLETA RECEBIDA NO CD
69 COLETA RECEBIDA COM NC NO CD DE
70 AVISO ENTREGA/EXECUO SERVIO
71 DEVOLUO EM ANDAMENTO PARA O REMETENTE
72 DEVOLUO REJEITADA PELO REMETENTE
73 AGUARDANDO AUTORIZAO PARA DEVOLUO
74 PERDA DE EMBARQUE POR HORRIO DE CORTE
80 EM AGENDAMENTO
83 COLETA REALIZADA
84 COLETA REALIZADA C/ NO CONFORMIDADE
90 ENCOMENDA DESCARTADA
91 ENTREGA PROGRAMADA
92 PROBLEMAS FISCAIS
93 PROBLEMAS OPERACIONAIS
94 EXTRAVIO PARCIAL
95 FALTA DE COMPLEMENTO FISICO
98 AGUARDANDO CUBAGEM
101 RECEBIDA E PROCESSADA NO CD
102 TRANSFERENCIA PARA:
103 RECEBIDO CD DE:
104 PROCESSO DE ENTREGA

16
106 REDESPACHO TRANSPORTADORA
107 REDESPACHO POR CONTA DO CLIENTE

17
Anexo 2 Modelo do mtodo RegistraColetaRequest

##### REQUEST #####

<?xml version="1.0" encoding="UTF-8"?>

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="urn:RegistraColeta" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:ns2="http://edi.totalexpress.com.br/soap/webservice_v24.total"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-
ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">

<SOAP-ENV:Body><ns1:RegistraColeta><RegistraColetaRequest xsi:type="ns2:RegistraColetaRequest">

<CodRemessa xsi:type="xsd:string"></CodRemessa>
<Encomendas SOAP-ENC:arrayType="ns2:Encomenda[1]" xsi:type="ns2:Encomendas">
<item xsi:type="ns2:Encomenda">
<TipoServico xsi:type="xsd:nonNegativeInteger">0</TipoServico>
<TipoEntrega xsi:type="xsd:nonNegativeInteger">0</TipoEntrega>
<Volumes xsi:type="xsd:nonNegativeInteger">0</Volumes>
<CondFrete xsi:type="xsd:string">0</CondFrete>
<Pedido xsi:type="xsd:string">0</Pedido>
<IdCliente xsi:type="xsd:string">0</IdCliente>
<Natureza xsi:type="xsd:string">0</Natureza>
<IsencaoIcms xsi:type="xsd:nonNegativeInteger">0</IsencaoIcms>
<DestNome xsi:type="xsd:string">0</DestNome>
<DestCpfCnpj xsi:type="xsd:string">0</DestCpfCnpj>
<DestEnd xsi:type="xsd:string">0</DestEnd>
<DestEndNum xsi:type="xsd:string">0</DestEndNum>
<DestCompl xsi:type="xsd:string">0</DestCompl>
<DestBairro xsi:type="xsd:string">0</DestBairro>
<DestCidade xsi:type="xsd:string">0</DestCidade>
<DestEstado xsi:type="xsd:string">0</DestEstado>
<DestCep xsi:type="xsd:nonNegativeInteger">0</DestCep>
<DestEmail xsi:type="xsd:string">0</DestEmail>
<DestDdd xsi:type="xsd:nonNegativeInteger">0</DestDdd>
<DestTelefone1 xsi:type="xsd:nonNegativeInteger">0</DestTelefone1>
<DocFiscalNFe SOAP-ENC:arrayType="ns2:NFe[1]" xsi:type="ns2:DocFiscalNFe"><item xsi:type="ns2:NFe">
<NfeNumero xsi:type="xsd:nonNegativeInteger">0</NfeNumero>
<NfeSerie xsi:type="xsd:nonNegativeInteger">0</NfeSerie>
<NfeData xsi:type="xsd:date">0</NfeData>
<NfeValTotal xsi:type="xsd:decimal">0</NfeValTotal>
<NfeValProd xsi:type="xsd:decimal">0</NfeValProd>
<NfeCfop xsi:type="xsd:nonNegativeInteger">0</NfeCfop>
<NfeChave xsi:type="xsd:string"> 0 </NfeChave>
</item></DocFiscalNFe></item>
</Encomendas></RegistraColetaRequest></ns1:RegistraColeta></SOAP-ENV:Body></SOAP-ENV:Envelope>

18
Anexo 3 Configurao Extra

Configurao do Time: Quando h uma quantidade muito grande de dados para ser
consumido e a requisio para sem ser concluda o problema pode ser o Time. Este
parmetro pode ser configurado pelo comando abaixo:

TAG <con:setting id="HttpSettings@socket_timeout">120000</con:setting>

Ou pelo SoapUI:

19
Anexo 4 Tracking

Exemplo da estrutura ObterTrackingRequest

Caso no informado o parmetro data, sero transmitidos apenas os lotes ainda no consumidos. Com o parmetro data
sero retornados todos os lotes da data pesquisada.

<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:ObterTracking">

<soapenv:Header/>

<soapenv:Body>

<urn:ObterTracking soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">

<ObterTrackingRequest xsi:type="web:ObterTrackingRequest"
xmlns:web="http://edi.totalexpress.com.br/soap/webservice_v24.total">

<!--Optional:-->

<DataConsulta xsi:type="xsd:date">2015-07-15</DataConsulta>

</ObterTrackingRequest>

</urn:ObterTracking>

</soapenv:Body>

</soapenv:Envelope>

Link de Tracking

http://tracking.totalexpress.com.br/tracking/0

Ou

http://tracking.totalexpress.com.br/poupup_track.php?reid=0000&pedido=000000&nfiscal=000000

Reid= o cdigo de sua empresa na Total Express

pedido=deve ser preenchido com o nmero de pedido do cliente que vem na integrao

nfiscal= deve ser preenchido com o nmero da nota fiscal do cliente

20