sgrGerarAEv13
Cria a Autorização de Embarque junto com o Local de Destino e escolta
PARÂMETROS:
Campo | Tipo | Requerido? | Descrição |
---|---|---|---|
chaveacesso | string | Sim | Chave retornada pelo método sgrLogin. |
cdpas | inteiro | Sim | Código do PAS, retornado pelo método sgrListaPASUsuario |
cdcliente | inteiro | Sim | Código do cliente, retornado pelo método sgrListaEmpresasPASUsuario. |
cdpaisorigemcavalo | inteiro | Sim | Código do país de origem do cavalo. Este código é retornado pelo método sgrListaPais. |
nrplacacavalo | string | Sim | Placa do cavalo. |
cdpaisorigemcarreta1 | Inteiro | Sim | Código do país de origem da carreta 1. Este código é retornado pelo método sgrListaPais. |
nrplacacarreta1 | string | Sim | Placa da primeira carreta. Enviar ‘’ (branco) quando não houver. |
cdpaisorigemcarreta2 | Inteiro | Não | Código do país de origem da carreta 2. Este código é retornado pelo método sgrListaPais. Enviar -1 quando não houver. |
nrplacacarreta2 | string | Não | Placa da segunda carreta. Enviar ‘’ (branco) quando não houver. |
cdpaisorigemmot1 | inteiro | Sim | Código do país de origem do primeiro Motorista. Este código é retornado pelo método sgrListaPais. |
nrdocmotorista1 | string | Sim | Número do documento do primeiro motorista. |
cdpaisorigemmot2 | Inteiro | Não | Código do país de origem do segundo Motorista. Este código é retornado pelo método sgrListaPais. Enviar -1 quando não houver. |
nrdocmotorista2 | string | Não | Número do documento do segundo motorista. Enviar ‘’ (branco) quando não existir a informação. |
nomemot1 | string | Sim | Nome do primeiro Motorista. (50 caracteres) |
nomemot2 | string | Não* | Nome do segundo Motorista. *É obrigatório o preenchimento caso seja informado o nrdocmotorista2. Enviar “” (branco) quando não existir. |
cdvincmot1 | string | Sim | Código do vínculo do primeiro motorista. Este código retornado pelo método sgrListaTiposVinculoPF. Enviar “” (branco) quando não informar. |
cdvincmot2 | string | Nã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. |
dtprevini | string | Sim | Data e Hora prevista para início da viagem. Enviar a data no formato “AAAA-MM-DD HH:MM”. |
dtprevfim | string | Sim | Data e Hora prevista para fim da viagem. Enviar a data no formato “AAAA-MM-DD HH:MM”. |
rastreadorcavalo | string | Não | Número do rastreador do Cavalo (50 caracteres). Enviar “” (branco) quando não existir. |
cdemprastrcavalo | Inteiro | Não | Código da empresa de Tecnologia de Rastreamento do cavalo, retornado pelo método sgrListaEmpresasRastreamento. Enviar -1 quando não informar. |
rastreadorcarreta1 | string | Não | Número do rastreador da carreta (50 caracteres). Enviar “” (branco) quando não existir. |
cdemprastrcarreta1 | Inteiro | Não | Código da empresa de Tecnologia de Rastreamento da carreta, retornado pelo método sgrListaEmpresasRastreamento. Enviar -1 quando não informar. |
cdcidorigem | inteiro | Sim | Código da cidade de origem, retornado pelo método sgrListaCidades. |
cdciddestino | inteiro | Sim | Código da cidade de destino, retornado pelos método sgrListaCidades. |
cdrota | inteiro | Sim | Có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. |
vlcarga | Decimal | Sim | Valor total da carga. |
cdtransp | inteiro | Não | Código da empresa transportadora, retornado pelo método sgrListaTransportadoras. Se não houver, enviar o código do próprio cliente [cdcliente]. |
nrfonecel | string | Sim | Número do telefone celular do motorista da viagem. |
cdtipooperacao | inteiro | Sim | Código do tipo de operação, retornado pelo método sgrListaTiposOperacao. |
cdembarcador | inteiro | Sim | Código do embarcador, retornado pelo método sgrListaEmbarcadores. Quando não existir a informação, enviar o código de cliente. |
nrcontrolecarga | string | Não | Campo para livre utilização do cliente (20 caracteres). Enviar ‘’ (branco) quando não existir. |
nrfrota | string | Não | Número Frota do veículo. Enviar ‘’ (branco) quando não existir. |
distanciatotal | decimal | Não | Distância total da viagem. Enviar 0 (zero) quando não existir. |
pesocarga | decimal | Não | Peso da carga. Enviar 0 (zero) quando não existir a informação. |
dscontroleviag(1 ao 10) | string | Não | Controles de viagem. Enviar “” (branco) quando não existir. |
produtos | list | Sim | Lista 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. |
documentos | list | Sim | Lista de documentos da AE. Para utilizar este parâmetro deve-se criar um array do tipo sgrDocumentoProdutosSeqV2. |
paradas | list | Nã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. |
sensorestemperatura | list | Não | Lista 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. |
nrDDDCelMot | string | Sim | DDD do telefone do motorista |
dsnomerespviag | string | Não | Nome do Responsável pela viagem. Enviar ‘’ (branco) quando não existir. |
dsfone1respviag | string | Nã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. |
dsfone2respviag | string | Não | Telefone adicional do responsável pela viagem. |
iscas | list | Nã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. |
Rotas | list | Nã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. |
localdeorigem | list | Não* | Lista do Local de origem da viagem. Para utilizar esse parâmetro deve-se criar um array do tipo sgrlocaldeorigem.Quando não forem informados os parâmetros de origem, deve-se enviar um array vazio. * Será obrigatório caso queira que o roterizador mostre o Local de origem da viagem |
escolta | list | Não* | Lista escolta da viagem. Para utilizar esse parâmetro deve-se criar um array do tipo sgrescolta. Quando não forem informados os parâmetros da escolta, deve-se enviar um array vazio. * Será obrigatório caso queira registar a escolta do veiculo |
NrDocAgente1 | string | Não | Numero do documento do Agente |
NomeAgente1 | string | Não | Nome do Agente |
NrFornecel1 | string | Não | Telefone do Agente |
NrDocAgente2 | string | Não | Numero do documento do segundo Agente |
NomeAgente2 | string | Não | Nome do segundo Agente |
NrFornecel2 | string | Não | Telefone do segundo Agente |
NrPlacaViatura1 | string | Não | Placa da viatura do Agente |
RastreadorViatura1 | string | Não | Rastreador da viatura |
CdEmprastrViatura1 | inteiro | Não | Codigo empresa de rastreamento da viatura |
NrPlacaViatura2 | string | Não | Placa da viatura do segundo Agente |
RastreadorViatura2 | string | Não | Rastreador da viatura segundo Agente |
CdEmprastrViatura2 | inteiro | Não | Codigo empresa de rastreamento da viatura do segundo Agente |
RETORNO DO MÉTODO:
ReturnDataset: Se os parâmetros estiverem corretos, o cadastro será enviado para pesquisa e o dataset irá apresentar:
Campo | Tipo | Descrição |
---|---|---|
CDVIAG | inteiro | Número da autorização de embarque gerada |
ReturnDescription: Se houver erro na execução do método, a propriedade irá apresentar:
Erro | Descrição |
---|---|
Data de Previsão de Início/Fim inválida | O 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 GerarAEv13, você pode copia-lo á direita
<sgrGerarAEv13 xmlns="https://tempuri.org/">
<chaveacesso>SUA CHAVE DE ACESSO</chaveacesso>
<cdpas>1</cdpas>
<cdcliente>6999</cdcliente>
<cdpaisorigemcavalo>1</cdpaisorigemcavalo>
<nrplacacavalo>PLACA CAVALO</nrplacacavalo>
<cdpaisorigemcarreta1>1</cdpaisorigemcarreta1>
<nrplacacarreta1> </nrplacacarreta1>
<cdpaisorigemcarreta2>-1</cdpaisorigemcarreta2>
<nrplacacarreta2 />
<cdpaisorigemmot1>1</cdpaisorigemmot1>
<nrdocmotorista1>DOCUMENTO MOTORISTA</nrdocmotorista1>
<cdpaisorigemmot2>0</cdpaisorigemmot2>
<nrdocmotorista2 />
<nomemot1>NOME MOTORISTA</nomemot1>
<nomemot2 />
<cdvincmot1>F</cdvincmot1>
<cdvincmot2 />
<dtprevini>2023/05/06 15:00:00</dtprevini>
<dtprevfim>2023/05/06 15:00:00</dtprevfim>
<rastreadorcavalo>475432</rastreadorcavalo>
<cdemprastrcavalo>164048</cdemprastrcavalo>
<cdemprastrcarreta1>0</cdemprastrcarreta1>
<cdcidorigem>5169</cdcidorigem>
<cdciddestino>4175</cdciddestino>
<cdrota>0</cdrota>
<vlcarga>0.01</vlcarga>
<cdtransp>6999</cdtransp>
<nrfonecel>9 9717-4701 </nrfonecel>
<cdtipooperacao>0</cdtipooperacao>
<cdembarcador>6999</cdembarcador>
<nrcontrolecarga />
<nrfrota />
<distanciatotal>0</distanciatotal>
<pesocarga>0</pesocarga>
<dscontroleviag1 />
<dscontroleviag2 />
<dscontroleviag3 />
<dscontroleviag4 />
<dscontroleviag5 />
<dscontroleviag6 />
<dscontroleviag7 />
<dscontroleviag8 />
<dscontroleviag9 />
<dscontroleviag10 />
<produtos>
<sgrProduto>
<cdprod>24720</cdprod>
<valor>0.0100</valor>
</sgrProduto>
</produtos>
<documentos>
<sgrDocumentoProdutosSeqV2>
<nrDoc>4378750 - 1</nrDoc>
<tpDoc>4</tpDoc>
<valorDoc>0.0000</valorDoc>
<tpOperacao>2</tpOperacao>
<dtPrevista>2023-02-08T15:00:00</dtPrevista>
<dtPrevistaSaida>08/02/2023 19:00:00</dtPrevistaSaida>
<cdCid>5075</cdCid>
<dsRua>DECIO DA SILVA</dsRua>
<nrRua>29 </nrRua>
<complementoRua />
<dsBairro>JARDIM N. SRA APARECIDA</dsBairro>
<nrCep>07177150</nrCep>
<nrFone1>9232134613 </nrFone1>
<nrFone2></nrFone2>
<cdEmbarcador>6999</cdEmbarcador>
<cdPaisOrigemEmitente>0</cdPaisOrigemEmitente>
<nrCnpjCpfEmitente />
<cdPaisOrigemDestinatario>1</cdPaisOrigemDestinatario>
<nrCnpjCPFDestinatario>06149282000255</nrCnpjCPFDestinatario>
<nrCnpjCpfDestinatarioSequencia />
<Latitude>-23.41706</Latitude>
<Longitude>-46.3918</Longitude>
<dsNome>ADITEX INDUSTRIA E COMERCIO DE ADITIVOS QUIMICOS</dsNome>
<qtVolumes>0</qtVolumes>
<qtPecas>0</qtPecas>
<nrLacreSIF />
<nrLacreArmador />
<dsNavio />
<dsSiglaOrig />
<dsSiglaDest />
<flRegiao>0</flRegiao>
<nrControleCliente1 />
<nrControleCliente2 />
<nrControleCliente3 />
<produtos>
<sgrProduto>
<cdprod>24720</cdprod>
<valor>0.0000</valor>
</sgrProduto>
</produtos>
<vlCubagem>0</vlCubagem>
<vlPeso>0</vlPeso>
<cdTransp>0</cdTransp>
<nrDDDFone1 />
<nrControleCliente7 />
<nrControleCliente8 />
<nrControleCliente9 />
<nrControleCliente10 />
<flTrocaNota>0</flTrocaNota>
<cdTrocaNota>0</cdTrocaNota>
<cdProgramacaoDestinatario xsi:nil="true" />
<vlInicioDiariaNoPrazo xsi:nil="true" />
<vlInicioDiariaAtrasado xsi:nil="true" />
<flReentrega xsi:nil="true" />
</sgrDocumentoProdutosSeqV2>
</documentos>
<paradas />
<sensorestemperatura />
<nrDDDCelMot>47</nrDDDCelMot>
<dsnomerespviag />
<dsfone1respviag />
<dsfone2respviag />
<iscas />
<rotas> </rotas>
<dsListaProgramacao />
<dsManifestoCarga />
<segsAdiconais />
<localDeOrigem>
<cdCid>4275</cdCid>
<!--Optional:-->
<dsRua>rua dos buzios</dsRua>
<!--Optional:-->
<nrRua>30</nrRua>
<!--Optional:-->
<complementoRua>ap 302</complementoRua>
<!--Optional:-->
<dsBairro>Bom Retiro</dsBairro>
<!--Optional:-->
<nrCep></nrCep>
<!--Optional:-->
<nrFone1></nrFone1>
<!--Optional:-->
<nrFone2></nrFone2>
<!--Optional:-->
<email></email>
<!--Optional:-->
<observacao></observacao>
<cdPaisOrigemEmitente>1</cdPaisOrigemEmitente>
<!--Optional:-->
<nrCnpjCpfEmitente>59187522000197</nrCnpjCpfEmitente>
<Latitude>-23.41706</Latitude>
<Longitude>-46.3918</Longitude>
<!--Optional:-->
<dsNome>EMPRESA guarana</dsNome>
<!--Optional:-->
<razaoSocial></razaoSocial>
<!--Optional:-->
<inscricaoEstadual></inscricaoEstadual>
<!--Optional:-->
<nomeFantasia></nomeFantasia>
<!--Optional:-->
<nrDDDFone1></nrDDDFone1>
<!--Optional:-->
<nrDDDFone2></nrDDDFone2>
</localDeOrigem>
</sgrGerarAEv13>