Pular para o conteúdo principal

sgrGerarAEv12

Cria a Autorização de Embarque com código IBGE

SoapAction

PARÂMETROS:

CampoTipoRequerido?Descrição
chaveacessostringSimChave retornada pelo método sgrLogin.
cdpasinteiroSimCódigo do PAS, retornado pelo método sgrListaPASUsuario
cdclienteinteiroSimCódigo do cliente, retornado pelo método sgrListaEmpresasPASUsuario.
cdpaisorigemcavalointeiroSimCódigo do país de origem do cavalo. Este código é retornado pelo método sgrListaPais.
nrplacacavalostringSimPlaca do cavalo.
cdpaisorigemcarreta1InteiroSimCódigo do país de origem da carreta 1. Este código é retornado pelo método sgrListaPais.
nrplacacarreta1stringSimPlaca da primeira carreta. Enviar ‘’ (branco) quando não houver.
cdpaisorigemcarreta2InteiroNãoCódigo do país de origem da carreta 2. Este código é retornado pelo método sgrListaPais. Enviar -1 quando não houver.
nrplacacarreta2stringNãoPlaca da segunda carreta. Enviar ‘’ (branco) quando não houver.
cdpaisorigemmot1inteiroSimCódigo do país de origem do primeiro Motorista. Este código é retornado pelo método sgrListaPais.
nrdocmotorista1stringSimNúmero do documento do primeiro motorista.
cdpaisorigemmot2InteiroNãoCódigo do país de origem do segundo Motorista. Este código é retornado pelo método sgrListaPais. Enviar -1 quando não houver.
nrdocmotorista2stringNãoNúmero do documento do segundo motorista. Enviar ‘’ (branco) quando não existir a informação.
nomemot1stringSimNome do primeiro Motorista. (50 caracteres)
nomemot2stringNão*Nome do segundo Motorista. *É obrigatório o preenchimento caso seja informado o nrdocmotorista2. Enviar “” (branco) quando não existir.
cdvincmot1stringSimCódigo do vínculo do primeiro motorista. Este código retornado pelo método sgrListaTiposVinculoPF. Enviar “” (branco) quando não informar.
cdvincmot2stringNão*Código do vínculo do segundo motorista, retornado pelo método sgrListaTiposVinculoPF *É obrigatório o preenchimento caso seja informado o nrdocmotorista2. Enviar “” (branco) quando não informar.
dtprevinistringSimData e Hora prevista para início da viagem. Enviar a data no formato “AAAA-MM-DD HH:MM”.
dtprevfimstringSimData e Hora prevista para fim da viagem. Enviar a data no formato “AAAA-MM-DD HH:MM”.
rastreadorcavalostringNãoNúmero do rastreador do Cavalo (50 caracteres). Enviar “” (branco) quando não existir.
cdemprastrcavaloInteiroNãoCódigo da empresa de Tecnologia de Rastreamento do cavalo, retornado pelo método sgrListaEmpresasRastreamento. Enviar -1 quando não informar.
rastreadorcarreta1stringNãoNúmero do rastreador da carreta (50 caracteres). Enviar “” (branco) quando não existir.
cdemprastrcarreta1InteiroNãoCódigo da empresa de Tecnologia de Rastreamento da carreta, retornado pelo método sgrListaEmpresasRastreamento. Enviar -1 quando não informar.
cdcidorigeminteiroSimCódigo da cidade de origem, retornado pelo método sgrListaCidades.
cdciddestinointeiroSimCódigo da cidade de destino, retornado pelos método sgrListaCidades.
cdrotainteiroSimCódigo da rota a ser utilizada na viagem. Este código é retornado pelo método sgrListaRotas, e será obrigatório dependendo da regra de gerenciamento de risco configurada. Enviar -1 quando não existir.
vlcargaDecimalSimValor total da carga.
cdtranspinteiroNãoCódigo da empresa transportadora, retornado pelo método sgrListaTransportadoras. Se não houver, enviar o código do próprio cliente [cdcliente].
nrfonecelstringSimNúmero do telefone celular do motorista da viagem.
cdtipooperacaointeiroSimCódigo do tipo de operação, retornado pelo método sgrListaTiposOperacao.
cdembarcadorinteiroSimCódigo do embarcador, retornado pelo método sgrListaEmbarcadores. Quando não existir a informação, enviar o código de cliente.
nrcontrolecargastringNãoCampo para livre utilização do cliente (20 caracteres). Enviar ‘’ (branco) quando não existir.
nrfrotastringNãoNúmero Frota do veículo. Enviar ‘’ (branco) quando não existir.
distanciatotaldecimalNãoDistância total da viagem. Enviar 0 (zero) quando não existir.
pesocargadecimalNãoPeso da carga. Enviar 0 (zero) quando não existir a informação.
dscontroleviag(1 ao 10)stringNãoControles de viagem. Enviar “” (branco) quando não existir.
produtoslistSimLista de produtos da AE. Para utilizar este parâmetro deve-se criar um array do tipo sgrProduto Este array será o resumo da carga transportada. Não é permitido repetir um código de produto nesta lista.
documentoslistSimLista de documentos da AE. Para utilizar este parâmetro deve-se criar um array do tipo sgrDocumentoProdutosSeqV2.
paradaslistNão*Lista de Pontos de Apoio. Para utilizar este parâmetro deve-se criar um array do tipo sgrPontoApoioViagem. *O preenchimento desse campo pode ser obrigatório dependendo da configuração do cliente. Quando não forem informadas as paradas, enviar um array vazio.
sensorestemperaturalistNãoLista de Sensores de Temperatura. Para utilizar este parâmetro deve-se criar um array do tipo sgrSensorTemperatura. Quando não forem informados os parâmetros de temperatura, enviar um array vazio.
nrDDDCelMotstringSimDDD do telefone do motorista
dsnomerespviagstringNãoNome do Responsável pela viagem. Enviar ‘’ (branco) quando não existir.
dsfone1respviagstringNão*Telefone do responsável pela viagem. * Será obrigatório somente se não houver telefones registrados na tela de [Contato cliente] para o tipo de contato Operacional.
dsfone2respviagstringNãoTelefone adicional do responsável pela viagem.
iscaslistNão*Lista de iscas. Para utilizar este parâmetro deve-se criar um array do tipo sgrIsca. Quando não forem informados os parâmetros de isca, deve-se enviar um array vazio. * Será obrigatório somente se estiver marcada a exigência de isca na configuração da regra de GR do cliente.
RotaslistNão*Lista de rotas. Para utilizar este parâmetro deve-se criar um array do tipo Rota. Quando não forem informados os parâmetros de rota, deve-se enviar um array vazio. * Será obrigatório somente se estiver marcada a exigência de rota na configuração do cliente.
dsListaProgramacaolistNão*Lista do código das programações
dsManifestoCargastringNão*Descrição do Manifesto da Carga
segsAdiconaislistNão*Lista de seguimentos adicionais
cnpjCpflocalDeOrigeminteiroNão*CNPJ ou CPF do local de origem
cdcidorigemIBGEinteiroNão*Código IBGE da cidade de Origem
cdciddestinoIBGEinteiroNão*Código IBGE da cidade de destino
cdCidIBGEInteiroNão*Código IBGE da cidade
cdcnpjembarcadorInteiroNãoCNPJ do embarcador

RETORNO DO MÉTODO:

ReturnDataset: Se os parâmetros estiverem corretos, o cadastro será enviado para pesquisa e o dataset irá apresentar:

CampoTipoDescrição
CDVIAGinteiroNúmero da autorização de embarque gerada

ReturnDescription: Se houver erro na execução do método, a propriedade irá apresentar:

ErroDescrição
Data de Previsão de Início/Fim inválidaO formato da data informada de previsão de início e/ou fim é inválido. Necessário preencher no formato "AAAA-MM-DDhh:mm".
Não foi possível gerar a Autorização de Embarque.Os erros que impossibilitaram o cadastro são listados no dataset, e podem ser vistos no Quadro 1.
Autorização de Embarque já criada!Já existe uma autorização de embarque com os dados informados.
Obrigatório informar Contato Responsável e Telefone(s)Indica que faltou preencher um dos seguintes parâmetros: dsnomerespviag, dsfone1respviag ou dsfone2respviag.
Exemplo de XML

Este é um exemplo de XML GerarAEv12, você pode copia-lo á direita

<tem:sgrGerarAEv12>
<!--Optional:-->
<tem:chaveacesso>SUA CHAVE DE ACESSO</tem:chaveacesso>
<tem:cdpas>1</tem:cdpas>
<tem:cdcliente>6999</tem:cdcliente>
<tem:cdpaisorigemcavalo>1</tem:cdpaisorigemcavalo>
<!--Optional:-->
<tem:nrplacacavalo>PLACA CAVALO</tem:nrplacacavalo>
<tem:cdpaisorigemcarreta1>1</tem:cdpaisorigemcarreta1>
<!--Optional:-->
<tem:nrplacacarreta1></tem:nrplacacarreta1>
<tem:cdpaisorigemcarreta2>1</tem:cdpaisorigemcarreta2>
<!--Optional:-->
<tem:nrplacacarreta2></tem:nrplacacarreta2>
<tem:cdpaisorigemmot1>1</tem:cdpaisorigemmot1>
<!--Optional:-->
<tem:nrdocmotorista1>DOCUMENTO MOTORISTA</tem:nrdocmotorista1>
<tem:cdpaisorigemmot2>1</tem:cdpaisorigemmot2>
<!--Optional:-->
<tem:nrdocmotorista2></tem:nrdocmotorista2>
<!--Optional:-->
<tem:nomemot1>NOME DO MOTORISTA</tem:nomemot1>
<!--Optional:-->
<tem:nomemot2></tem:nomemot2>
<!--Optional:-->
<tem:cdvincmot1>F</tem:cdvincmot1>
<!--Optional:-->
<tem:cdvincmot2>0</tem:cdvincmot2>
<!--Optional:-->
<tem:dtprevini>2022-12-20 08:39</tem:dtprevini>
<!--Optional:-->
<tem:dtprevfim>2022-12-20 08:39</tem:dtprevfim>
<!--Optional:-->
<tem:rastreadorcavalo></tem:rastreadorcavalo>
<tem:cdemprastrcavalo>0</tem:cdemprastrcavalo>
<!--Optional:-->
<tem:rastreadorcarreta1></tem:rastreadorcarreta1>
<tem:cdemprastrcarreta1>0</tem:cdemprastrcarreta1>
<tem:cdcidorigem>0</tem:cdcidorigem>
<tem:cdciddestino>3414</tem:cdciddestino>
<tem:cdcidorigemIBGE>3304557</tem:cdcidorigemIBGE>
<tem:cdciddestinoIBGE>3304557</tem:cdciddestinoIBGE>
<tem:cdrota>0</tem:cdrota>
<tem:vlcarga>2</tem:vlcarga>
<tem:cdtransp>6999</tem:cdtransp>
<!--Optional:-->
<tem:cdcnpjtransp>10887479000183</tem:cdcnpjtransp>
<!--Optional:-->
<tem:nrfonecel>82732235542</tem:nrfonecel>
<tem:cdtipooperacao>1</tem:cdtipooperacao>
<tem:cdembarcador>6999</tem:cdembarcador>
<!--Optional:-->
<tem:cdcnpjembarcador>10887479000183</tem:cdcnpjembarcador>
<!--Optional:-->
<tem:nrcontrolecarga></tem:nrcontrolecarga>
<!--Optional:-->
<tem:nrfrota></tem:nrfrota>
<tem:distanciatotal>31.34</tem:distanciatotal>
<tem:pesocarga>0</tem:pesocarga>
<!--Optional:-->
<tem:dscontroleviag1></tem:dscontroleviag1>
<!--Optional:-->
<tem:dscontroleviag2></tem:dscontroleviag2>
<!--Optional:-->
<tem:dscontroleviag3></tem:dscontroleviag3>
<!--Optional:-->
<tem:dscontroleviag4></tem:dscontroleviag4>
<!--Optional:-->
<tem:dscontroleviag5></tem:dscontroleviag5>
<!--Optional:-->
<tem:dscontroleviag6></tem:dscontroleviag6>
<!--Optional:-->
<tem:dscontroleviag7></tem:dscontroleviag7>
<!--Optional:-->
<tem:dscontroleviag8></tem:dscontroleviag8>
<!--Optional:-->
<tem:dscontroleviag9></tem:dscontroleviag9>
<!--Optional:-->
<tem:dscontroleviag10></tem:dscontroleviag10>
<!--Optional:-->
<tem:produtos>
<!--Zero or more repetitions:-->
<tem:sgrProduto>
<tem:cdprod>0</tem:cdprod>
<!--Optional:-->
<tem:cdprodutocliente>20221</tem:cdprodutocliente>
<tem:valor>2.00</tem:valor>
</tem:sgrProduto>
</tem:produtos>
<!--Optional:-->
<tem:documentos>
<!--Zero or more repetitions:-->
<tem:sgrDocumentoProdutosSeqV2>
<!--Optional:-->
<tem:nrDoc>TESTANDO VIC</tem:nrDoc>
<tem:tpDoc>1</tem:tpDoc>
<tem:valorDoc>2.00</tem:valorDoc>
<tem:tpOperacao>1</tem:tpOperacao>
<tem:dtPrevista>2022-12-20T08:39:00</tem:dtPrevista>
<!--Optional:-->
<tem:dtPrevistaSaida>2022-12-20 23:59</tem:dtPrevistaSaida>
<tem:cdCid>3414</tem:cdCid>
<!--Optional:-->
<tem:dsRua>CASA</tem:dsRua>
<!--Optional:-->
<tem:nrRua>21</tem:nrRua>
<!--Optional:-->
<tem:complementoRua></tem:complementoRua>
<!--Optional:-->
<tem:dsBairro>BOM RETIRO</tem:dsBairro>
<!--Optional:-->
<tem:nrCep></tem:nrCep>
<!--Optional:-->
<tem:nrFone1>773847466</tem:nrFone1>
<!--Optional:-->
<tem:nrFone2>73223554</tem:nrFone2>
<tem:cdEmbarcador>6999</tem:cdEmbarcador>
<tem:cdPaisOrigemEmitente>1</tem:cdPaisOrigemEmitente>
<!--Optional:-->
<tem:nrCnpjCpfEmitente></tem:nrCnpjCpfEmitente>
<tem:cdPaisOrigemDestinatario>1</tem:cdPaisOrigemDestinatario>
<!--Optional:-->
<tem:nrCnpjCPFDestinatario>21718667990</tem:nrCnpjCPFDestinatario>
<!--Optional:-->
<tem:nrCnpjCpfDestinatarioSequencia></tem:nrCnpjCpfDestinatarioSequencia>
<tem:Latitude>0</tem:Latitude>
<tem:Longitude>0</tem:Longitude>
<!--Optional:-->
<tem:dsNome>TESTE VITORIA</tem:dsNome>
<tem:qtVolumes>0</tem:qtVolumes>
<tem:qtPecas>0</tem:qtPecas>
<!--Optional:-->
<tem:nrLacreSIF></tem:nrLacreSIF>
<!--Optional:-->
<tem:nrLacreArmador></tem:nrLacreArmador>
<!--Optional:-->
<tem:dsNavio></tem:dsNavio>
<!--Optional:-->
<tem:dsSiglaOrig></tem:dsSiglaOrig>
<!--Optional:-->
<tem:dsSiglaDest></tem:dsSiglaDest>
<tem:flRegiao>0</tem:flRegiao>
<!--Optional:-->
<tem:nrControleCliente1></tem:nrControleCliente1>
<!--Optional:-->
<tem:nrControleCliente2></tem:nrControleCliente2>
<!--Optional:-->
<tem:nrControleCliente3></tem:nrControleCliente3>
<!--Optional:-->
<tem:vlCubagem>0</tem:vlCubagem>
<tem:vlPeso>0</tem:vlPeso>
<tem:cdTransp>0</tem:cdTransp>
<!--Optional:-->
<tem:nrDDDFone1>82</tem:nrDDDFone1>
<!--Optional:-->
<tem:nrDDDFone2>82</tem:nrDDDFone2>
<!--Optional:-->
<tem:nrControleCliente7></tem:nrControleCliente7>
<!--Optional:-->
<tem:nrControleCliente8></tem:nrControleCliente8>
<!--Optional:-->
<tem:nrControleCliente9></tem:nrControleCliente9>
<!--Optional:-->
<tem:nrControleCliente10></tem:nrControleCliente10>
<tem:flTrocaNota>0</tem:flTrocaNota>
<tem:cdTrocaNota>0</tem:cdTrocaNota>
</tem:sgrDocumentoProdutosSeqV2>
</tem:documentos>
<!--Optional:-->
<tem:paradas>
<!--Zero or more repetitions:-->
<tem:sgrPontoApoioViagem>
<tem:cdTrecho>0</tem:cdTrecho>
<tem:cdApoio>0</tem:cdApoio>
<tem:vlDistancia>0</tem:vlDistancia>
</tem:sgrPontoApoioViagem>
</tem:paradas>
<!--Optional:-->
<tem:sensorestemperatura>
<!--Zero or more repetitions:-->
<tem:sgrSensorTemperatura>
<tem:nrSensor>3</tem:nrSensor>
<tem:cdTpSensTemp>34</tem:cdTpSensTemp>
<tem:vlToleraSup>8</tem:vlToleraSup>
<tem:vlIdealSup>5</tem:vlIdealSup>
<tem:vlIdealInf>5</tem:vlIdealInf>
<tem:vlToleraInf>3</tem:vlToleraInf>
<tem:vlTempoPermitidoForaRange>21</tem:vlTempoPermitidoForaRange>
</tem:sgrSensorTemperatura>
</tem:sensorestemperatura>
<!--Optional:-->
<tem:nrDDDCelMot>21</tem:nrDDDCelMot>
<!--Optional:-->
<tem:dsnomerespviag></tem:dsnomerespviag>
<!--Optional:-->
<tem:dsfone1respviag></tem:dsfone1respviag>
<!--Optional:-->
<tem:dsfone2respviag></tem:dsfone2respviag>
<!--Optional:-->
<!--Optional:-->
<!--Optional:-->
<tem:dsListaProgramacao></tem:dsListaProgramacao>
<!--Optional:-->
<tem:dsManifestoCarga></tem:dsManifestoCarga>
<!--Optional:-->
<tem:segsAdiconais></tem:segsAdiconais>
<!--Optional:-->
<tem:cnpjLocalDeOrigem></tem:cnpjLocalDeOrigem>
<tem:cdcnpjembarcador></tem:cdcnpjembarcador>
</tem:sgrGerarAEv12>