Manual At&m - Integração WS2.0 - 2.0
Manual At&m - Integração WS2.0 - 2.0
Manual At&m - Integração WS2.0 - 2.0
Versão 2.0
www.atmtec.com.br
Integração Webservice 2.0
Índice
1.0 Introdução........................................................................................................................................3
2.0 Apresentação ..................................................................................................................................3
3.0 Conceituação de processo de negócios .........................................................................................4
4.0 Objetivo ...........................................................................................................................................6
5.0 Agentes básicos do processo .........................................................................................................6
6.0 Requisitos dos agentes básicos ......................................................................................................6
7.0 Fatores críticos de sucesso ............................................................................................................6
8.0 Indicadores do processo .................................................................................................................7
9.0 Macro fluxo da integração webservice ............................................................................................7
10.0 Descrição das opções do webservice ...........................................................................................7
11.0 Webservice - averbaCTe – CT-e ..................................................................................................9
12.0 Webservice – CT-e cancelados ................................................................................................. 17
13.0 Webservice - outros documentos (layout AT&M) ...................................................................... 19
14.0 Webservice - outros documentos cancelados ........................................................................... 32
15.0 Webservice - coberturas adicionais – CT-e e outros documentos ............................................ 35
16.0 Webservice - tag nAver .............................................................................................................. 58
17.0 CT-e 3.0 ..................................................................................................................................... 60
18.0 Webservice - averbaNFe – NF-e ............................................................................................... 63
19.0 Webservice – NF-e cancelados ................................................................................................. 71
20.0 Webservice - coberturas adicionais – NF-e ............................................................................... 73
21.0 Webservice - declaraMDFe – MDF-e......................................................................................... 90
22.0 Webservice – MDF-e encerrado ................................................................................................ 94
23.0 Webservice – MDF-e cancelado ................................................................................................ 96
24.0 Webservice – MDF-e inclusão de condutor ............................................................................... 98
25.0 Perguntas frequentes ................................................................................................................. 99
26.0 Considerações finais ................................................................................................................ 102
27.0 Notações .................................................................................................................................. 103
28.0 Ajuda ........................................................................................................................................ 109
1.0 INTRODUÇÃO
2.0 APRESENTAÇÃO
4.0 OBJETIVO
• Acesso ao WebServer.
O processo para averbar e/ou declarar via web service deve seguir o
procedimento abaixo:
Atenção: Apenas se o retorno de erro for 000, 002, 907, 910, brancos,
congestionamento de rede, lentidão na internet ou timeout, deve aguardar
alguns minutos e submeter novamente de modo automático o documento, não
sendo necessário nenhuma ação por parte da transportadora.
Dica: Caso o documento a ser averbado não possua a placa do veículo, poderá
“reter” a averbação até o momento de a placa ser designada e então adicionar a
placa do veículo na tag padrão para esta informação e processar a averbação.
AT&M – Soluções em EDI – (19) 3885-2000 ou (11) 2283-2868 Página 8 de 109
Integração Webservice 2.0
Webservice
URL: webserver.averba.com.br/20
Nome: averbaCTe
Input ou entrada:
Usuário: xsd.string
Senha: xsd.string
Codatm: xsd.string
xmlCTe: xsd.string (XML do CT-e protocolado na secretaria da
fazenda)
Output ou retorno:
<Response>
<Numero></Numero>
<Serie></Serie>
<Filial></Filial>
<CNPJCli></CNPJCli>
<TpDoc></TpDoc>
<InfAdic></InfAdic>
<Averbado>
<dhAverbacao></dhAverbacao>
<Protocolo></Protocolo>
<DadosSeguro>
<NumeroAverbacao></NumeroAverbacao>
<CNPJSeguradora></CNPJSeguradora>
<NomeSeguradora></NomeSeguradora>
<NumApolice></NumApolice>
AT&M – Soluções em EDI – (19) 3885-2000 ou (11) 2283-2868 Página 9 de 109
Integração Webservice 2.0
<TpMov></TpMov>
<TpDDR></TpDDR>
<ValorAverbado></ValorAverbado>
<RamoAverbado></RamoAverbado>
</DadosSeguro>
</Averbado>
<Infos>
<Info>
<Codigo></Codigo>
<Descricao></Descricao>
</Info>
</Infos>
</Response>
Esta averbação pode não ser considerada pela seguradora, por se tratar de
TESTE, causando danos ao segurado em casos de sinistros.
<Response>
<Numero></Numero>
<Serie></Serie>
<Filial></Filial>
<CNPJCli></CNPJCli>
<TpDoc>6</TpDoc>
<InfAdic></InfAdic>
<Averbado>
<dhAverbacao></dhAverbacao>
<Protocolo>TESTE</Protocolo>
<DadosSeguro>
<NumeroAverbacao></NumeroAverbacao>
<CNPJSeguradora></CNPJSeguradora>
<NomeSeguradora></NomeSeguradora>
<NumApolice></NumApolice>
<TpMov></TpMov>
<TpDDR></TpDDR>
<ValorAverbado></ValorAverbado>
<RamoAverbado></RamoAverbado>
</DadosSeguro>
</Averbado>
<Infos>
<Info>
<Codigo></Codigo>
<Descricao></Descricao>
</Info>
</Infos>
</Response>
<Response>
<Numero></Numero>
<Serie></Serie>
<Filial></Filial>
<CNPJCli></CNPJCli>
<TpDoc></TpDoc>
<InfAdic></InfAdic>
<Erros>
<Erro>
<Codigo> </Codigo>
<Descricao></Descricao>
<ValorEsperado></ValorEsperado>
<ValorInformado></ValorInformado>
</Erro>
</Erros>
</Response>
<Response>
<Numero></Numero>
<Serie></Serie>
<Filial></Filial>
<CNPJCli></CNPJCli>
<TpDoc></TpDoc>
<InfAdic></InfAdic>
<Averbado>
<dhAverbacao></dhAverbacao>
<Protocolo></Protocolo>
<DadosSeguro>
<NumeroAverbacao></NumeroAverbacao>
<CNPJSeguradora></CNPJSeguradora>
<NomeSeguradora></NomeSeguradora>
<NumApolice></NumApolice>
<TpMov></TpMov>
<TpDDR></TpDDR>
<ValorAverbado></ValorAverbado>
<RamoAverbado></RamoAverbado>
</DadosSeguro>
</Averbado>
<Infos>
<Info>
<Codigo>001</Codigo>
<Descricao>Documento já Cadastrado</Descricao>
</Info>
</Infos>
</Response>
Webservice
URL: webserver.averba.com.br/20
Nome: averbaCTe
Input ou entrada:
Usuário: xsd.string
Senha: xsd.string
Codatm: xsd.string
xmlCTe: xsd.string (XML do Cancelamento do CT-e protocolado no
SEFAZ)
Output ou retorno:
<Response>
<Numero></Numero>
<Serie></Serie>
<Filial></Filial>
<CNPJCli></CNPJCli>
<Averbado>
<dhAverbacao></dhAverbacao>
<Protocolo></Protocolo>
</Averbado>
</Response>
• 99 para CTRC
• 98 para NFSe
• 97 para Ordem de Coleta
• 96 para MIC
• 95 para Controle de Embarque
• 94 Minuta
• 93 CRT
• 92-RPS
• 91-Romaneio
Webservice
WSDL: webserver.averba.com.br/20
Nome: averbaCTe
Input ou entrada:
Usuário: xsd.string
Senha: xsd.string
Codatm: xsd.string
xmlCTe: xsd.string (XML ajustado para averbação de outros
documentos)
<cteProc>
<CTe>
<infCte>
<ide>
<mod></mod>
<serie></serie>
<nCT></nCT>
<dhEmi></dhEmi>
<tpAmb></tpAmb>
<tpCTe></tpCTe>
<modal></modal>
<tpServ></tpServ>
<cMunIni></cMunIni>
<UFIni></UFIni>
<cMunFim></cMunFim>
<UFFim></UFFim>
<toma03>
<toma></toma>
</toma03>
</ide>
<compl>
<xObs></xObs>
<ObsCont>
<xCampo></xCampo>
<xTexto></xTexto>
</ObsCont>
</compl>
<emit>
<CNPJ></CNPJ>
<enderEmit>
<cMun></cMun>
<UF></UF>
</enderEmit>
</emit>
<rem>
<CNPJ></CNPJ>
<enderReme>
<cMun></cMun>
<UF></UF>
<cPais></cPais>
</enderReme>
</rem>
<dest>
<CNPJ></CNPJ>
<enderDest>
<cMun></cMun>
<UF></UF>
<cPais></cPais>
</enderDest>
</dest>
<infCTeNorm>
<infCarga>
<vCarga></vCarga>
</infCarga>
<seg>
<respSeg></respSeg>
<vCarga></vCarga>
</seg>
</infCTeNorm>
</infCte>
</CTe>
</cteProc>
Output ou retorno:
<Response>
<Numero></Numero>
<Serie></Serie>
<Filial></Filial>
<CNPJCli></CNPJCli>
<TpDoc></TpDoc>
<InfAdic></InfAdic>
<Averbado>
<dhAverbacao></dhAverbacao>
<Protocolo></Protocolo>
<DadosSeguro>
<NumeroAverbacao></NumeroAverbacao>
<CNPJSeguradora></CNPJSeguradora>
<NomeSeguradora></NomeSeguradora>
<NumApolice></NumApolice>
<TpMov></TpMov>
<TpDDR></TpDDR>
<ValorAverbado></ValorAverbado>
<RamoAverbado></RamoAverbado>
</DadosSeguro>
</Averbado>
<Infos>
<Info>
<Codigo></Codigo>
<Descricao></Descricao>
</Info>
</Infos>
</Response>
<Response>
<Numero></Numero>
AT&M – Soluções em EDI – (19) 3885-2000 ou (11) 2283-2868 Página 26 de 109
Integração Webservice 2.0
<Serie></Serie>
<Filial></Filial>
<CNPJCli></CNPJCli>
<TpDoc>6</TpDoc>
<InfAdic></InfAdic>
<Averbado>
<dhAverbacao></dhAverbacao>
<Protocolo>TESTE</Protocolo>
<DadosSeguro>
<NumeroAverbacao></NumeroAverbacao>
<CNPJSeguradora></CNPJSeguradora>
<NomeSeguradora></NomeSeguradora>
<NumApolice></NumApolice>
<TpMov></TpMov>
<TpDDR></TpDDR>
<ValorAverbado></ValorAverbado>
<RamoAverbado></RamoAverbado>
</DadosSeguro>
</Averbado>
<Infos>
<Info>
<Codigo></Codigo>
<Descricao></Descricao>
</Info>
</Infos>
</Response>
<Response>
<Numero></Numero>
<Serie></Serie>
<Filial></Filial>
<CNPJCli></CNPJCli>
<TpDoc></TpDoc>
<InfAdic></InfAdic>
<Erros>
<Erro>
<Codigo></Codigo>
<Descricao></Descricao>
<ValorEsperado></ValorEsperado>
<ValorInformado></ValorInformado>
</Erro>
</Erros>
</Response>
<Response>
<Numero></Numero>
<Serie></Serie>
<Filial></Filial>
<CNPJCli></CNPJCli>
<TpDoc></TpDoc>
<InfAdic></InfAdic>
<Averbado>
<dhAverbacao></dhAverbacao>
<Protocolo></Protocolo>
<DadosSeguro>
<NumeroAverbacao></NumeroAverbacao>
<CNPJSeguradora></CNPJSeguradora>
<NomeSeguradora></NomeSeguradora>
<NumApolice></NumApolice>
<TpMov></TpMov>
<TpDDR></TpDDR>
<ValorAverbado></ValorAverbado>
<RamoAverbado></RamoAverbado>
</DadosSeguro>
</Averbado>
<Infos>
<Info>
<Codigo>001</Codigo>
<Descricao>Documento já Cadastrado</Descricao>
</Info>
</Infos>
</Response>
Exemplo:
Exemplo:
Output ou retorno:
<Response>
<Numero></Numero>
<Serie></Serie>
<Filial></Filial>
<CNPJCli></CNPJCli>
<Averbado>
<dhAverbacao></dhAverbacao>
<Protocolo></Protocolo>
</Averbado>
</Response>
A AT&M possui uma solução para informar estas coberturas, mantendo assim o
processo automatizado, sendo necessário apenas alguns ajustes.
<xTexto>S</xTexto>
</ObsCont>
</compl>
Alternativa de sintaxe:
<compl>
<ObsCont xCampo =“OCD”>
<xTexto>S</xTexto>
</ObsCont>
</compl>
• IC - Içamento de Carga
<compl>
<ObsCont>
<xCampo>IC</xCampo>
<xTexto>S</xTexto>
</ObsCont>
</compl>
Alternativa de sintaxe:
<compl>
<ObsCont xCampo =“IC”>
<xTexto>S</xTexto>
</ObsCont>
</compl>
• RI - Remoção de Carga
Exemplo de utilização:
<compl>
<ObsCont>
<xCampo>RI</xCampo>
<xTexto>S</xTexto>
</ObsCont>
</compl>
Alternativa de sintaxe:
<compl>
<ObsCont xCampo =“RI”>
<xTexto>S</xTexto>
</ObsCont>
</compl>
• Meios Próprios
Se o transporte for feito por meios próprios da carga deverá informar “S”, senão,
não utilizar a tag para valores adicionais, pois o sistema assumirá o “N”, como
default.
OBS: Meios próprios é quando a carga se locomove, como por exemplo alguns
veículos que ainda estão em processo de montagem. Para transportá-los as
vezes não se usa outro caminhão, mas são transportados por meios próprios, ou
seja, ainda são considerados como carga, mas são automotor e podem se
locomover.
Exemplo de utilização:
<compl>
<ObsCont>
<xCampo>MeiosProprios</xCampo>
<xTexto>S</xTexto>
</ObsCont>
</compl>
Alternativa de sintaxe:
<compl>
<ObsCont xCampo =“MeiosProprios”>
<xTexto>S</xTexto>
</ObsCont>
</compl>
• Rastreado
Exemplo de utilização:
<compl>
<ObsCont>
<xCampo>RASTREADO</xCampo>
<xTexto>S</xTexto>
</ObsCont>
</compl>
Alternativa de sintaxe:
<compl>
<ObsCont xCampo =“RASTREADO”>
<xTexto>S</xTexto>
</ObsCont>
</compl>
• Taxa de RCFDC
Exemplo de utilização:
<compl>
<ObsCont>
<xCampo>RCFDC</xCampo>
<xTexto>S</xTexto>
</ObsCont>
</compl>
Alternativa de sintaxe:
<compl>
<ObsCont xCampo =“RCFDC”>
<xTexto>S</xTexto>
</ObsCont>
</compl>
• Estado de Fronteira
Exemplo de utilização:
<compl>
<ObsCont>
<xCampo>UFFRONTEIRA</xCampo>
<xTexto>RS</xTexto>
</ObsCont>
</compl>
Alternativa de sintaxe:
<compl>
<ObsCont xCampo =“UFFRONTEIRA”>
<xTexto>RS</xTexto>
</ObsCont>
</compl>
Exemplo de utilização:
<compl>
<ObsCont>
<xCampo>MERCESPECIFICA</xCampo>
<xTexto>S</xTexto>
</ObsCont>
</compl>
Alternativa de sintaxe:
<compl>
<ObsCont xCampo =“MERCESPECIFICA”>
<xTexto>S</xTexto>
</ObsCont>
</compl>
• Data de Embarque
Exemplo de utilização:
<compl>
<ObsCont>
<xCampo>DHEMB</xCampo>
<xTexto>2017-01-01T01:01:01</xTexto>
</ObsCont>
</compl>
Alternativa de sintaxe:
<compl>
<ObsCont xCampo =“DHEMB”>
<xTexto>2016-01-01T01:01:01</xTexto>
</ObsCont>
</compl>
AT&M – Soluções em EDI – (19) 3885-2000 ou (11) 2283-2868 Página 41 de 109
Integração Webservice 2.0
• Escolta
Exemplo de utilização:
<compl>
<ObsCont>
<xCampo>ESCOLTA</xCampo>
<xTexto>S</xTexto>
</ObsCont>
</compl>
Alternativa de sintaxe:
<compl>
<ObsCont xCampo =“ESCOLTA”>
<xTexto>S</xTexto>
</ObsCont>
</compl>
• RG do Motorista
Exemplo de utilização:
<compl>
<ObsCont>
AT&M – Soluções em EDI – (19) 3885-2000 ou (11) 2283-2868 Página 42 de 109
Integração Webservice 2.0
<xCampo>RGMOTORISTA</xCampo>
<xTexto>11111111111</xTexto>
</ObsCont>
</compl>
Alternativa de sintaxe:
<compl>
<ObsCont xCampo =“RGMOTORISTA”>
<xTexto>11111111111</xTexto>
</ObsCont>
</compl>
Exemplo de utilização:
<compl>
<ObsCont>
<xCampo>CODMOTORISTA</xCampo>
<xTexto>11111111111</xTexto>
</ObsCont>
</compl>
Alternativa de sintaxe:
<compl>
<ObsCont xCampo =“CODMOTORISTA”>
<xTexto>11111111111</xTexto>
AT&M – Soluções em EDI – (19) 3885-2000 ou (11) 2283-2868 Página 43 de 109
Integração Webservice 2.0
</ObsCont>
</compl>
Exemplo de utilização:
<compl>
<ObsCont>
<xCampo>RESPSEG</xCampo>
<xTexto>XXX.XXX.XXX/XXXX-XX</xTexto>
</ObsCont>
</compl>
Alternativa de sintaxe:
<compl>
<ObsCont xCampo =“RESPSEG”>
<xTexto>XXX.XXX.XXX/XXXX-XX</xTexto>
</ObsCont>
</compl>
• Código de Operação
Exemplo de utilização:
<compl>
<ObsCont>
<xCampo>CODOPEREMB</xCampo>
<xTexto>P11999999</xTexto>
</ObsCont>
</compl>
Alternativa de sintaxe:
<compl>
<ObsCont xCampo =“CODOPEREMB”>
<xTexto>P11999999</xTexto>
</ObsCont>
</compl>
• CPF do Motorista
Exemplo de utilização:
<compl>
<ObsCont>
<xCampo>CPFMOTORISTA</xCampo>
<xTexto>111.111.111-11</xTexto>
</ObsCont>
</compl>
Alternativa de sintaxe:
<compl>
<ObsCont xCampo =“CPFMOTORISTA”>
<xTexto>111.111.111-11</xTexto>
</ObsCont>
</compl>
• Placa
Exemplo de utilização:
<compl>
<ObsCont>
<xCampo>PLACA</xCampo>
<xTexto>ZZZ-1111</xTexto>
</ObsCont>
</compl>
Alternativa de sintaxe:
<compl>
<ObsCont xCampo =“PLACA”>
<xTexto>ZZZ-1111</xTexto>
</ObsCont>
</compl>
• Transporte Próprio
Exemplo de utilização:
<compl>
<ObsCont>
<xCampo>TranspProprio</xCampo>
<xTexto>S</xTexto>
AT&M – Soluções em EDI – (19) 3885-2000 ou (11) 2283-2868 Página 47 de 109
Integração Webservice 2.0
</ObsCont>
</compl>
Alternativa de sintaxe:
<compl>
<ObsCont xCampo =“TranspProprio”>
<xTexto>S</xTexto>
</ObsCont>
</compl>
• Percurso Complementar
• Tipo de Transporte:
1-Rodoviário, 2-Marítimo, 3-Fluvial, 4-Ferroviário, 5-Aéreo.
• UF de Origem
• UF de Destino
Exemplo de utilização:
<compl>
<ObsCont>
<xCampo>PercCompl‹/xCampo>
<xTexto>1;SP;SP‹/xTexto>
</ObsCont>
</compl>
Alternativa de sintaxe:
<compl>
<ObsCont xCampo =“PercCompl”>
<xTexto>1;SP;SP</xTexto>
</ObsCont>
</compl>
• Ramo
• RCTRC
Exemplo de utilização:
<compl>
<ObsCont>
<xCampo>RAMO</xCampo>
<xTexto>RCTRC</xTexto>
</ObsCont>
</compl>
Alternativa de sintaxe:
<compl>
<ObsCont xCampo =“RAMO”>
<xTexto>RCTRC</xTexto>
</ObsCont>
</compl>
• RCTAC
Exemplo de utilização:
<compl>
<ObsCont>
<xCampo>RAMO</xCampo>
<xTexto>RCTAC</xTexto>
</ObsCont>
</compl>
Alternativa de sintaxe:
<compl>
<ObsCont xCampo =“RAMO”>
<xTexto>RCTAC</xTexto>
</ObsCont>
</compl>
AT&M – Soluções em EDI – (19) 3885-2000 ou (11) 2283-2868 Página 50 de 109
Integração Webservice 2.0
• RCTAMB
Exemplo de utilização:
<compl>
<ObsCont>
<xCampo>RAMO</xCampo>
<xTexto>RCTAMB</xTexto>
</ObsCont>
</compl>
Alternativa de sintaxe:
<compl>
<ObsCont xCampo =“RAMO”>
<xTexto>RCTAMB</xTexto>
</ObsCont>
</compl>
• TRAMB
Exemplo de utilização:
<compl>
<ObsCont>
<xCampo>RAMO</xCampo>
AT&M – Soluções em EDI – (19) 3885-2000 ou (11) 2283-2868 Página 51 de 109
Integração Webservice 2.0
<xTexto>TRAMB</xTexto>
</ObsCont>
</compl>
Alternativa de sintaxe:
<compl>
<ObsCont xCampo =“RAMO”>
<xTexto>TRAMB</xTexto>
</ObsCont>
</compl>
• Valor de Container
Exemplo de utilização:
<compl>
<ObsCont>
<xCampo>ValorContainer</xCampo>
<xTexto>10000.00</xTexto>
</ObsCont>
</compl>
Alternativa de sintaxe:
<compl>
<ObsCont xCampo =“ValorContainer”>
<xTexto>10000.00</xTexto>
</ObsCont>
</compl>
• Valor de Acessório
Exemplo de utilização:
<compl>
<ObsCont>
<xCampo>ValorAcessorio</xCampo>
<xTexto>10000.00</xTexto>
</ObsCont>
</compl>
Alternativa de sintaxe:
<compl>
<ObsCont xCampo =“ValorAcessorio”>
<xTexto>10000.00</xTexto>
</ObsCont>
</compl>
• Valor de Avarias
Exemplo de utilização:
<compl>
<ObsCont>
<xCampo>ValorAvarias</xCampo>
<xTexto>10000.00</xTexto>
</ObsCont>
</compl>
Alternativa de sintaxe:
<compl>
<ObsCont xCampo =“ValorAvarias”>
<xTexto>10000.00</xTexto>
</ObsCont>
</compl>
• Impostos Suspensos
Exemplo de utilização:
<compl>
<ObsCont>
<xCampo>$BEN</xCampo>
<xTexto>10000.00</xTexto>
</ObsCont>
</compl>
Alternativa de sintaxe:
<compl>
<ObsCont xCampo =“$BEN”>
<xTexto>10000.00</xTexto>
</ObsCont>
</compl>
Exemplo de utilização:
<compl>
<ObsCont>
<xCampo>CODLIM</xCampo>
<xTexto>ABC123</xTexto>
</ObsCont>
</compl>
Alternativa de sintaxe:
<compl>
<ObsCont xCampo =“CODLIM”>
AT&M – Soluções em EDI – (19) 3885-2000 ou (11) 2283-2868 Página 55 de 109
Integração Webservice 2.0
<xTexto>ABC123</xTexto>
</ObsCont>
</compl>
• Filial
Exemplo de utilização:
<compl>
<ObsCont>
<xCampo>FILIAL</xCampo>
<xTexto>12345</xTexto>
</ObsCont>
</compl>
Alternativa de sintaxe:
<compl>
<ObsCont xCampo =“FILIAL”>
<xTexto>12345</xTexto>
</ObsCont>
</compl>
• INFRET
Exemplo de utilização:
<compl>
<ObsCont>
<xCampo>INFRET</xCampo>
<xTexto>ABC123</xTexto>
</ObsCont>
</compl>
Alternativa de sintaxe:
<compl>
<ObsCont xCampo =“INFRET”>
<xTexto>ABC123</xTexto>
</ObsCont>
</compl>
<compl>
<ObsCont>
<xCampo>OCD</xCampo>
<xTexto>S</xTexto>
</ObsCont>
<ObsCont>
<xCampo>MeiosProprios</xCampo>
<xTexto>S</xTexto>
</ObsCont>
AT&M – Soluções em EDI – (19) 3885-2000 ou (11) 2283-2868 Página 57 de 109
Integração Webservice 2.0
</compl>
Alternativa de sintaxe:
<compl>
<ObsCont xCampo =“OCD”>
<xTexto>S</xTexto>
</ObsCont>
<ObsCont xCampo =“MeiosProprios”>
<xTexto>S</xTexto>
</ObsCont>
</compl>
• RCTRC
<seg>
<nAver>RCTRC===============</nAver>
</seg>
• RCTAC
<seg>
<nAver>AEREO===============</nAver>
</seg>
• RCTAMB
<seg>
<nAver>RCTAMB==============</nAver>
</seg>
• TRAMB
<seg>
<nAver>TRAMB===============</nAver>
</seg>
OBS: Esta tag será removida na versão do CT-e na versão 3.0, desta forma,
utilizar a tag adicional “RAMO”, descrito neste manual (WEBSERVICE -
COBERTURAS ADICIONAIS - CTE E OUTROS DOCUMENTOS > Ramo).
OBS: A tag “nAver” pode ser substituída pela tag “nApol” na versão 2.0 do CT-e,
desta forma, todas as explicações acima se aplicam para a tag “nApol”.
Neste tópico será abordado as alterações da versão do CT-e 2.0 para 3.0.
O sistema da AT&M continuará a processar as duas versões.
• <nApol>
Na AT&M esta tag também pode ser utilizada para indicar o ramo a ser
averbado. Desta forma, utilizar a tag adicional “RAMO”, descrito neste manual
(WEBSERVICE - COBERTURAS ADICIONAIS - CTE E OUTROS
DOCUMENTOS > Ramo).
• <nAver>
Na AT&M esta tag também pode ser utilizada para indicar o ramo a ser
averbado. Desta forma, utilizar a tag adicional “RAMO”, descrito neste man ual
(WEBSERVICE - COBERTURAS ADICIONAIS - CTE E OUTROS
DOCUMENTOS > Ramo).
• <respSeg>
• <vCargaAverb>
A versão 2.0 abrange esta tag como <vCarga>, que está abaixo da tag
<seg>.
Na versão 3.0 esta tag é alterada para <vCargaAverb>, que está abaixo da
tag <infCTeNorm>.
• <placa>
A versão 2.0 abrange esta tag como <placa>, que está abaixo da tag
<veic>.
Na versão 3.0 esta tag foi removida.
• <CPF>
A versão 2.0 abrange esta tag como <CPF>, que está abaixo da tag
<moto>.
Na versão 3.0 esta tag foi removida.
• <tpProp>
A versão 2.0 abrange esta tag como <tpProp>, que está abaixo da tag
<veic>.
Na versão 3.0 esta tag foi removida.
WebService
URL: webserver.averba.com.br/20
Nome: averbaNFe
Input ou entrada:
Usuário: xsd.string
Senha: xsd.string
Codatm: xsd.string
xmlNFe: xsd.string (XML da NF-e protocolado na secretária da
fazenda)
Output ou retorno:
<Response>
<Numero></Numero>
<Serie></Serie>
<Filial></Filial>
<CNPJCli></CNPJCli>
<TpDoc></TpDoc>
<InfAdic></InfAdic>
<Averbado>
<dhAverbacao></dhAverbacao>
<Protocolo></Protocolo>
<DadosSeguro>
<NumeroAverbacao></NumeroAverbacao>
<CNPJSeguradora></CNPJSeguradora>
<NomeSeguradora></NomeSeguradora>
<NumApolice></NumApolice>
<TpMov></TpMov>
AT&M – Soluções em EDI – (19) 3885-2000 ou (11) 2283-2868 Página 63 de 109
Integração Webservice 2.0
<TpDDR></TpDDR>
<ValorAverbado></ValorAverbado>
<RamoAverbado></RamoAverbado>
</DadosSeguro>
</Averbado>
<Infos>
<Info>
<Codigo></Codigo>
<Descricao></Descricao>
</Info>
</Infos>
</Response>
<Response>
<Numero></Numero>
<Serie></Serie>
<Filial></Filial>
<CNPJCli></CNPJCli>
<TpDoc>6</TpDoc>
<InfAdic></InfAdic>
<Averbado>
<dhAverbacao></dhAverbacao>
<Protocolo>TESTE</Protocolo>
<DadosSeguro>
<NumeroAverbacao></NumeroAverbacao>
<CNPJSeguradora></CNPJSeguradora>
<NomeSeguradora></NomeSeguradora>
<NumApolice></NumApolice>
<TpMov></TpMov>
<TpDDR></TpDDR>
<ValorAverbado></ValorAverbado>
<RamoAverbado></RamoAverbado>
</DadosSeguro>
</Averbado>
<Infos>
<Info>
<Codigo></Codigo>
<Descricao></Descricao>
</Info>
</Infos>
</Response>
<Response>
<Numero></Numero>
<Serie></Serie>
<Filial></Filial>
<CNPJCli></CNPJCli>
<TpDoc></TpDoc>
<InfAdic></InfAdic>
<Erros>
<Erro>
<Codigo> </Codigo>
<Descricao></Descricao>
<ValorEsperado></ValorEsperado>
<ValorInformado></ValorInformado>
</Erro>
</Erros>
</Response>
<Response>
<Numero></Numero>
<Serie></Serie>
<Filial></Filial>
<CNPJCli></CNPJCli>
<TpDoc></TpDoc>
<InfAdic></InfAdic>
<Averbado>
<dhAverbacao></dhAverbacao>
<Protocolo></Protocolo>
<DadosSeguro>
<NumeroAverbacao></NumeroAverbacao>
<CNPJSeguradora></CNPJSeguradora>
<NomeSeguradora></NomeSeguradora>
<NumApolice></NumApolice>
<TpMov></TpMov>
<TpDDR></TpDDR>
<ValorAverbado></ValorAverbado>
<RamoAverbado></RamoAverbado>
</DadosSeguro>
</Averbado>
<Infos>
<Info>
<Codigo>001</Codigo>
<Descricao>Documento já Cadastrado</Descricao>
</Info>
</Infos>
</Response>
Webservice
WSDL: webserver.averba.com.br/20
Nome: averbaNFe
Input ou entrada:
Usuário: xsd.string
Senha: xsd.string
Codatm: xsd.string
xmlNFe: xsd.string (XML do Cancelamento da NF-e protocolado no
Sefaz)
Output ou retorno:
<Response>
<Numero></Numero>
<Serie></Serie>
<Filial></Filial>
<CNPJCli></CNPJCli>
<Averbado>
<dhAverbacao></dhAverbacao>
<Protocolo></Protocolo>
</Averbado>
</Response>
A AT&M possui uma solução para informar estas coberturas, mantendo assim o
processo automatizado, sendo necessário apenas alguns ajustes.
Exemplo de utilização:
<infAdic>
<obsCont>
<xCampo>OCD</xCampo>
<xTexto>S</xTexto>
</obsCont>
</infAdic>
Alternativa de sintaxe:
<infAdic>
<obsCont xCampo =“OCD”>
<xTexto>S</xTexto>
</obsCont>
</infAdic>
• IC - Içamento de Carga
Exemplo de utilização:
<infAdic>
<obsCont>
<xCampo>IC</xCampo>
<xTexto>S</xTexto>
</obsCont>
</infAdic>
Alternativa de sintaxe:
<infAdic>
<obsCont xCampo =“IC”>
AT&M – Soluções em EDI – (19) 3885-2000 ou (11) 2283-2868 Página 74 de 109
Integração Webservice 2.0
<xTexto>S</xTexto>
</obsCont>
</infAdic>
• RI - Remoção de Carga
Exemplo de utilização:
<infAdic>
<obsCont>
<xCampo>RI</xCampo>
<xTexto>S</xTexto>
</obsCont>
</infAdic>
Alternativa de sintaxe:
<infAdic>
<obsCont xCampo =“RI”>
<xTexto>S</xTexto>
</obsCont>
</infAdic>
• Meios Próprios
Se o transporte for feito por meios próprios da carga deverá informar “S”,
senão, não utilizar a tag para valores adicionais, pois o sistema assumirá o “N”,
como default.
OBS: Meios próprios é quando a carga se locomove, como por exemplo alguns
veículos que ainda estão em processo de montagem. Para transportá-los as
AT&M – Soluções em EDI – (19) 3885-2000 ou (11) 2283-2868 Página 75 de 109
Integração Webservice 2.0
vezes não se usa outro caminhão, mas são transportados por meios próprios, ou
seja, ainda são considerados como carga, mas são automotor e podem se
locomover.
Exemplo de utilização:
<infAdic>
<obsCont>
<xCampo>MeiosProprios</xCampo>
<xTexto>S</xTexto>
</obsCont>
</infAdic>
Alternativa de sintaxe:
<infAdic>
<obsCont xCampo =“MeiosProprios”>
<xTexto>S</xTexto>
</obsCont>
</infAdic>
• Rastreado
Se o segurado possui rastreio da mercadoria deverá informar “S”, senão,
não utilizar a tag para valores adicionais, pois o sistema assumirá o “N”, como
default.
Exemplo de utilização:
<infAdic>
<obsCont>
<xCampo>RASTREADO</xCampo>
<xTexto>S</xTexto>
</obsCont>
</infAdic>
AT&M – Soluções em EDI – (19) 3885-2000 ou (11) 2283-2868 Página 76 de 109
Integração Webservice 2.0
Alternativa de sintaxe:
<infAdic>
<obsCont xCampo =“RASTREADO”>
<xTexto>S</xTexto>
</obsCont>
</infAdic>
• Taxa de RCFDC
Exemplo de utilização:
<infAdic>
<obsCont>
<xCampo>RCFDC</xCampo>
<xTexto>S</xTexto>
</obsCont>
</infAdic>
Alternativa de sintaxe:
<infAdic>
<obsCont xCampo =“RCFDC”>
<xTexto>S</xTexto>
</obsCont>
</infAdic>
• Mercadoria Nova
Exemplo de utilização:
<infAdic>
<obsCont>
<xCampo>MERCNOVA</xCampo>
<xTexto>N</xTexto>
</obsCont>
</infAdic>
Alternativa de sintaxe:
<infAdic>
<obsCont xCampo =“MERCNOVA”>
<xTexto>N</xTexto>
</obsCont>
</infAdic>
Exemplo de utilização:
<infAdic>
<obsCont>
<xCampo>MERCESPECIFICA</xCampo>
<xTexto>S</xTexto>
</obsCont>
AT&M – Soluções em EDI – (19) 3885-2000 ou (11) 2283-2868 Página 78 de 109
Integração Webservice 2.0
</infAdic>
Alternativa de sintaxe:
<infAdic>
<obsCont xCampo =“MERCESPECIFICA”>
<xTexto>S</xTexto>
</obsCont>
</infAdic>
• Data de Embarque
Exemplo de utilização:
<infAdic>
<obsCont>
<xCampo>DHEMB</xCampo>
<xTexto>2016-01-01T01:01:01</xTexto>
</obsCont>
</infAdic>
Alternativa de sintaxe:
<infAdic>
<obsCont xCampo =“DHEMB”>
<xTexto>2016-01-01T01:01:01</xTexto>
</obsCont>
</infAdic>
• Escolta
Exemplo de utilização:
<infAdic>
<obsCont>
<xCampo>ESCOLTA</xCampo>
<xTexto>S</xTexto>
</obsCont>
</infAdic>
Alternativa de sintaxe:
<infAdic>
<obsCont xCampo =“ESCOLTA”>
<xTexto>S</xTexto>
</obsCont>
</infAdic>
• RG do Motorista
Exemplo de utilização:
<infAdic>
<obsCont>
<xCampo>RGMOTORISTA</xCampo>
<xTexto>11111111111</xTexto>
</obsCont>
</infAdic>
Alternativa de sintaxe:
<infAdic>
<obsCont xCampo =“RGMOTORISTA”>
<xTexto>11111111111</xTexto>
</obsCont>
</infAdic>
Exemplo de utilização:
<infAdic>
<obsCont>
<xCampo>CODMOTORISTA</xCampo>
<xTexto>11111111111</xTexto>
</obsCont>
</infAdic>
Alternativa de sintaxe:
<infAdic>
<obsCont xCampo =“CODMOTORISTA”>
<xTexto>11111111111</xTexto>
AT&M – Soluções em EDI – (19) 3885-2000 ou (11) 2283-2868 Página 81 de 109
Integração Webservice 2.0
</obsCont>
</infAdic>
• CPF do Motorista
Exemplo de utilização:
<infAdic>
<obsCont>
<xCampo>CPFMOTORISTA</xCampo>
<xTexto>111.111.111-11</xTexto>
</obsCont>
</infAdic>
Alternativa de sintaxe:
<infAdic>
<obsCont xCampo =“CPFMOTORISTA”>
<xTexto>111.111.111-11</xTexto>
</obsCont>
</infAdic>
• Placa
Exemplo de utilização:
<infAdic>
<obsCont>
<xCampo>PLACA</xCampo>
<xTexto>ZZZ-1111</xTexto>
</obsCont>
</infAdic>
Alternativa de sintaxe:
<infAdic>
<obsCont xCampo =“PLACA”>
<xTexto>ZZZ-1111</xTexto>
</obsCont>
</infAdic>
• Transporte Próprio
Exemplo de utilização:
<infAdic>
<obsCont>
<xCampo>TranspProprio</xCampo>
<xTexto>S</xTexto>
</obsCont>
</infAdic>
Alternativa de sintaxe:
<infAdic>
<obsCont xCampo =“TranspProprio”>
<xTexto>S</xTexto>
</obsCont>
</infAdic>
• Percurso Complementar
• Tipo de Transporte:
1-Rodoviário, 2-Marítimo, 3-Fluvial, 4-Ferroviário, 5-Aéreo.
• UF de Origem
• UF de Destino
OBS: As informações acima devem ser separadas pelo caractere;
<infAdic>
<obsCont>
<xCampo>PercCompl‹/xCampo>
<xTexto>1;SP;SP‹/xTexto>
</obsCont>
</infAdic>
Alternativa de sintaxe:
<infAdic>
<obsCont xCampo =“PercCompl”>
<xTexto>1;SP;SP</xTexto>
</obsCont>
</infAdic>
• Valor de Container
Exemplo de utilização:
<infAdic>
<obsCont>
<xCampo>ValorContainer</xCampo>
<xTexto>10000.00</xTexto>
</obsCont>
</infAdic>
Alternativa de sintaxe:
<infAdic>
<obsCont xCampo =“ValorContainer”>
<xTexto>10000.00</xTexto>
</obsCont>
</infAdic>
• Valor de Acessório
Exemplo de utilização:
<infAdic>
<obsCont>
<xCampo>ValorAcessorio</xCampo>
<xTexto>10000.00</xTexto>
</obsCont>
</infAdic>
Alternativa de sintaxe:
<infAdic>
<obsCont xCampo =“ValorAcessorio”>
<xTexto>10000.00</xTexto>
</obsCont>
</infAdic>
• Valor de Avarias
Exemplo de utilização:
<infAdic>
<obsCont>
<xCampo>ValorAvarias</xCampo>
<xTexto>10000.00</xTexto>
AT&M – Soluções em EDI – (19) 3885-2000 ou (11) 2283-2868 Página 86 de 109
Integração Webservice 2.0
</obsCont>
</infAdic>
Alternativa de sintaxe:
<infAdic>
<obsCont xCampo =“ValorAvarias”>
<xTexto>10000.00</xTexto>
</obsCont>
</infAdic>
• Valor de Despesas
Exemplo de utilização:
<infAdic>
<obsCont>
<xCampo>ValorDespesas</xCampo>
<xTexto>10000.00</xTexto>
</obsCont>
</infAdic>
Alternativa de sintaxe:
<infAdic>
</obsCont>
</infAdic>
Exemplo de utilização:
<compl>
<obsCont>
<xCampo>CODLIM</xCampo>
<xTexto>ABC123</xTexto>
</obsCont>
</compl>
Alternativa de sintaxe:
<compl>
<obsCont xCampo =“CODLIM”>
<xTexto>ABC123</xTexto>
</obsCont>
</compl>
• INFRET
Exemplo de utilização:
<compl>
<obsCont>
<xCampo>INFRET</xCampo>
<xTexto>ABC123</xTexto>
</obsCont>
</compl>
Alternativa de sintaxe:
<compl>
<obsCont xCampo =“INFRET”>
<xTexto>ABC123</xTexto>
</obsCont>
</compl>
Segue exemplos:
<infAdic>
<obsCont>
<xCampo>OCD</xCampo>
<xTexto>S</xTexto>
</obsCont>
<obsCont>
<xCampo>IC</xCampo>
<xTexto>S</xTexto>
</obsCont>
</infAdic>
Alternativa de sintaxe:
<infAdic>
<obsCont xCampo =“OCD”>
<xTexto>S</xTexto>
</obsCont>
<obsCont xCampo =“IC”>
<xTexto>S</xTexto>
</obsCont>
</infAdic>
WebService
URL: webserver.averba.com.br/20
Nome: declaraMDFe
Input ou entrada:
usuário: xsd.string
senha: xsd.string
codatm: xsd.string
xmlMDFe: xsd.string (XML do MDF-e protocolado na secretaria da
fazenda)
Output ou retorno:
<Response>
<Numero></Numero>
<Serie></Serie>
<Filial></Filial>
<Declarado>
<dhChancela></dhChancela>
<Protocolo></Protocolo>
</Declarado>
<Infos>
<Info>
<Codigo></Codigo>
<Descricao></Descricao>
</Info>
</Infos>
</Response>
<Response>
<Numero></Numero>
<Serie></Serie>
<Filial></Filial>
<Declarado>
<dhChancela></dhChancela>
<Protocolo>TESTE</Protocolo>
</Declarado>
<Infos>
<Info>
<Codigo></Codigo>
<Descricao></Descricao>
</Info>
</Infos>
</Response>
<Response>
<Numero></Numero>
<Serie></Serie>
<Filial></Filial>
<Declarado>
<dhChancela></dhChancela>
<Protocolo></Protocolo>
</Declarado>
<Infos>
<Info>
<Codigo>001</Codigo>
<Descricao>Documento ja Cadastrado</Descricao>
</Info>
</Infos>
</Response>
WebService
WSDL: webserver.averba.com.br/20
Nome: declaraMDFe
Input ou entrada:
Usuário: xsd.string
Senha: xsd.string
Codatm: xsd.string
xmlMDFe: xsd.string (XML do encerramento do MDF-e protocolado
no Sefaz)
Output ou retorno:
<Response>
<Numero></Numero>
<Serie></Serie>
<Filial></Filial>
<Declarado>
<dhChancela></dhChancela>
<Protocolo></Protocolo>
</Declarado>
<Infos>
<Info>
<Codigo></Codigo>
<Descricao></Descricao>
</Info>
</Infos>
</Response>
WebService
WSDL: webserver.averba.com.br/20
Nome: declaraMDFe
Input ou entrada:
Usuário: xsd.string
Senha: xsd.string
Codatm: xsd.string
xmlMDFe: xsd.string (XML do cancelamento do MDF-e protocolado
no Sefaz)
Output ou retorno:
<Response>
<Numero></Numero>
<Serie></Serie>
<Filial></Filial>
<Declarado>
<dhChancela></dhChancela>
<Protocolo></Protocolo>
</Declarado>
<Infos>
<Info>
<Codigo></Codigo>
<Descricao></Descricao>
</Info>
</Infos>
</Response>
Webservice
WSDL: webserver.averba.com.br/20
Nome: declaraMDFe
Input ou entrada:
Usuário: xsd.string
Senha: xsd.string
Codatm: xsd.string
xmlMDFe: xsd.string (XML de inclusão do condutor do MDF-e
protocolado no Sefaz)
Output ou retorno:
<Response>
<Numero></Numero>
<Serie></Serie>
<Filial></Filial>
<Declarado>
<dhChancela></dhChancela>
<Protocolo></Protocolo>
</Declarado>
<Infos>
AT&M – Soluções em EDI – (19) 3885-2000 ou (11) 2283-2868 Página 98 de 109
Integração Webservice 2.0
<Info>
<Codigo></Codigo>
<Descricao></Descricao>
</Info>
</Infos>
</Response>
Na NF-e, o valor para averbação é lido da tag <vProd> que está sob a tag
<total>.
AT&M – Soluções em EDI – (19) 3885-2000 ou (11) 2283-2868 Página 100 de 109
Integração Webservice 2.0
AT&M – Soluções em EDI – (19) 3885-2000 ou (11) 2283-2868 Página 101 de 109
Integração Webservice 2.0
AT&M – Soluções em EDI – (19) 3885-2000 ou (11) 2283-2868 Página 102 de 109
Integração Webservice 2.0
27.0 NOTAÇÕES
• Instrução Legal:
CIRCULAR SUSEP No 344, de 21 de junho de 2007.
Dispõe sobre os controles internos específicos para a prevenção contra
fraudes.
O SUPERINTENDENTE DA SUPERINTENDÊNCIA DE SEGUROS
PRIVADOS – SUSEP, na forma do art. 10, inciso XII, da Deliberação SUSEP N.
113, de 17 de abril de 2006, e tendo em vista o que consta do Processo SUSEP
no 15414.004150/2006-00, R E S O L V E:
Art. 1o Dispor sobre os controles internos específicos para a prevenção
contra fraudes.
Art. 2o Sujeitam-se às obrigações previstas nesta Circular as sociedades
seguradoras e de capitalização e as entidades abertas de previdência
complementar.
Parágrafo único. Deverá ser indicado um diretor responsável pelo
cumprimento da presente Circular.
Art. 3o Para fins do disposto nesta Circular consideram-se sociedades:
sociedades seguradoras e de capitalização e as entidades abertas de previdência
complementar.
CAPÍTULO I
DA AVALIAÇÃO DE RISCO E DOS CONTROLES INTERNOS
Art. 4o As sociedades deverão, no prazo constante do art. 9o desta
Circular, desenvolver estudos sobre o risco de ser objeto de fraudes,
principalmente com relação aos produtos comercializados e suas práticas
operacionais.
FL. 2 da CIRCULAR SUSEP No 344, de 21 de junho de 2007.
AT&M – Soluções em EDI – (19) 3885-2000 ou (11) 2283-2868 Página 103 de 109
Integração Webservice 2.0
AT&M – Soluções em EDI – (19) 3885-2000 ou (11) 2283-2868 Página 104 de 109
Integração Webservice 2.0
AT&M – Soluções em EDI – (19) 3885-2000 ou (11) 2283-2868 Página 105 de 109
Integração Webservice 2.0
AT&M – Soluções em EDI – (19) 3885-2000 ou (11) 2283-2868 Página 106 de 109
Integração Webservice 2.0
sem benefício financeiro à empresa emissora. Uma nota fiscal também pode
cancelar a validade de outra nota fiscal, como por exemplo, na devolução de
produtos industrializados, outros cancelamentos ou cancelamento de contratos
de serviços.
• Ordem de Carga: É um documento fiscal emitido pelo transportador que
executa serviço de coleta de carga destinado a documentar o trânsito ou
transporte municipal ou intermunicipal da carga coletadas.
• RCTRC: O decreto n° 61.867, de 07/12/1967, regulamentou os seguros
obrigatórios previstos no art. 20 do Decreto-Lei 73/66. Diz o art. 10 do Decreto
61.867: “As pessoas físicas ou jurídicas, de Direito Público ou Privado, que se
incumbirem do transporte de carga, são obrigadas a contratar seguro de
responsabilidade civil em garantia e danos sobrevindos à carga que lhes tenha
sido confiado para transportes, contra conhecimento ou nota de embarque. ” Com
base nesse dispositivo legal, o transportador está obrigado a contratar seguro
para garantir-se dos riscos rodoviários, sob pena de, não o fazendo responder
como se segurador fosse.
• RCF-DC: O seguro RCF DC – Responsabilidade Civil Facultativa Desvio
de Carga, garante riscos contra roubo de cargas transportadas.
• UF: Unidade federativa.
• Ramos:
21 – TN: Transporte Nacional.
32 - RCTRC/VI: Seguro obrigatório de Responsabilidade Civil do
Transportador Rodoviário de Carga em Viagem Internacional.
38 – RCTFC: Seguro obrigatório de Responsabilidade Civil do
Transportador Ferroviário de Carga.
52 – RCTAC: Seguro Obrigatório de Responsabilidade Civil do
Transportador Aéreo de Carga.
54 – RCTRC: Seguro obrigatório de Responsabilidade Civil do
Transportador Rodoviário de Cargas.
AT&M – Soluções em EDI – (19) 3885-2000 ou (11) 2283-2868 Página 108 de 109
Integração Webservice 2.0
28.0 AJUDA
Telefone: 019-3885-2000
E-mail: sac@atmtec.com.br
AT&M – Soluções em EDI – (19) 3885-2000 ou (11) 2283-2868 Página 109 de 109