sgrGerarAEv10
Cria a Autorização de Embarque
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. |
dsListaProgramacao | list | Não* | Lista do código das programações |
dsManifestoCarga | string | Não* | Descrição do Manifesto da Carga |
segsAdiconais | list | Não* | Lista de seguimentos adicionais |
cnpjCpflocalDeOrigem | inteiro | Não* | CNPJ ou CPF do local de origem |
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 GerarAEv10, você pode copia-lo á direita
<tem:sgrGerarAEv10>
<!--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 DO 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>2023-03-16 15:00:00</tem:dtprevini>
<!--Optional:-->
<tem:dtprevfim>2023-03-16 15:00:00</tem:dtprevfim>
<!--Optional:-->
<tem:rastreadorcavalo></tem:rastreadorcavalo>
<tem:cdemprastrcavalo>0</tem:cdemprastrcavalo>
<!--Optional:-->
<tem:rastreadorcarreta1></tem:rastreadorcarreta1>
<tem:cdemprastrcarreta1>0</tem:cdemprastrcarreta1>
<tem:cdcidorigem>3439</tem:cdcidorigem>
<tem:cdciddestino>3042</tem:cdciddestino>
<tem:cdrota>2600368</tem:cdrota>
<tem:vlcarga>2</tem:vlcarga>
<tem:cdtransp>6999</tem:cdtransp>
<!--Optional:-->
<tem:nrfonecel>82732235542</tem:nrfonecel>
<tem:cdtipooperacao>1</tem:cdtipooperacao>
<tem:cdembarcador>6999</tem:cdembarcador>
<!--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>13402</tem:cdprod>
<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-13T08:39:00</tem:dtPrevista>
<!--Optional:-->
<tem:dtPrevistaSaida>2022-12-14 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:produtos>
<!--Zero or more repetitions:-->
<tem:sgrProduto>
<tem:cdprod>12402</tem:cdprod>
<tem:valor>2.00</tem:valor>
</tem:sgrProduto>
</tem:produtos>
<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:sgrGerarAEv10>