sgrGerarAEv9

Cria a Autorização de Embarque (Mercosul).

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.

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.

Após a criação da autorização de embarque, recomenda-se que seja executado o método sgrVerificaCombEsc, para alertar o usuário sobre a necessidade de criar AE´s para escolta/comboio: