Web Service com.senior.g5.co.int.agr.pesagem
O serviço permite cadastrar o peso de entrada e saída do veículo para as operações de balança.
Para o correto funcionamento da rotina, as telas de Cadastro de Balança de Pesagem (F063BAL) e Cadastro de Câmera de Pesagem de Carga (F063CAM) devem estar com o campo Código Externo preenchido. Este campo corresponde à balança e câmeras utilizadas no processo de pesagem.
Tipo de execução
Para cada tipo de execução, existem diferentes parâmetros que podem ser comuns a todas as portas.
Autenticação
Caso seja utilizada alguma forma de autenticação para integração de informações através de web services, é necessário identificar o tipo no parâmetro <encryption>, conforme seus valores possíveis.
Campos numéricos
Orientação válida para qualquer campo de web service que possui objetivo de receber valores, independentemente do seu tipo ser Integer, Double e String. Estas orientações devem ser seguidas nas requisições efetuadas via SOAP e em execuções efetuadas através do SGI, relatórios e regras LSP.
- Envio no formato ZZZZ,ZZ
- É fundamental não enviar os campos numéricos com separador de milhar, pois ocorrerá erro ao executar a requisição
- Obrigatória a utilização do separador decimal com vírgula, e não com ponto
- Obrigatória a utilização do zero a direita. Por exemplo, se o valor for 350,20, a requisição deve ser enviada com este exato valor. Se o valor enviado for enviado como 350,2, o sistema não irá interpretar a requisição adequadamente
number(005,2) = 350,20 - o sistema espera que o número digitado contenha até 3 casas antes da vírgula e obrigatoriamente duas após;
number(015,2): 35000,20 - o sistema espera que o número digitado contenha até 13 casas antes da vírgula e obrigatoriamente duas após;
number(008,4) = 3200,2074 - o sistema espera que o número digitado contenha até 4 casas antes da vírgula e obrigatoriamente duas após.
- Envio no formato ZZZZ.ZZ
- É fundamental não enviar os campos numéricos com separador de milhar, pois ocorrerá erro ao executar a requisição
- Obrigatória a utilização do separador decimal com ponto, e não com vírgula
- number(005,2) = 350.20 - o sistema espera que o número digitado contenha até 3 casas antes da vírgula e obrigatoriamente duas após;
- number(015,2): 35000.20 - o sistema espera que o número digitado contenha até 13 casas antes da vírgula e obrigatoriamente duas após;
- number(008,4) = 3200.2074 - o sistema espera que o número digitado contenha até 4 casas antes da vírgula e obrigatoriamente duas após.
WSDL
- Síncrono: http://servidor:1234/g5-senior-services/sapiens_Synccom_senior_g5_co_int_agr_pesagem?wsdl
- Assíncrono: http://servidor:1234/g5-senior-services/sapiens_Asynccom_senior_g5_co_int_agr_pesagem?wsdl
- Agendamento: http://servidor:1234/g5-senior-services/sapiens_Schedulecom_senior_g5_co_int_agr_pesagem?wsdl
Portas
Necessita autenticação: Sim.
Situação da versão: Atual.
Versão: 1.
Versão atual: 1.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
<soapenv:Body>
<ser:RegistrarPeso>
<user>String</user>
<password>String</password>
<encryption>Integer</encryption>
<parameters>
<gridCadastros>
<ideExt>String</ideExt>
<tipoOperacao>String</tipoOperacao>
<codBalExt>String</codBalExt>
<pesInf>String</pesInf>
<gridFotos>
<codCamExt>String</codCamExt>
<imgFot>Blob</imgFot>
</gridFotos>
</gridCadastros>
</parameters>
</ser:RegistrarPeso>
</soapenv:Body>
</soapenv:Envelope>
| Nome | Tipo | Preenchimento | Ajuda |
|---|---|---|---|
| gridCadastros | Set | Obrigatório | (Obrigatório) - Lista de cadastros de peso de entrada e saída do veículo para as operações de balança. |
| gridCadastros.ideExt | String | Opcional | (Obrigatório) - String(050) - Identificador de registro de sistema externo. |
| gridCadastros.tipoOperacao | String | Opcional | (Obrigatório) - String(001) - Tipo de Operação (E- Entrada / S-Saída). |
| gridCadastros.codBalExt | String | Opcional | (Obrigatório) - Número(004) - Código de balança no sistema externo. |
| gridCadastros.pesInf | String | Opcional | (Obrigatório) - Número(009,3) - Peso informado na entrada. |
| gridFotos | Set | Opcional | (Opcional) - Lista de fotos. |
| gridFotos.codCamExt | String | Opcional | (Opcional) - Número(004) - Código da balança no sistema externo ao ERP. |
| gridFotos.imgFot | Blob | Opcional | (Opcional) - Imagem - Imagem da foto. |
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
<soapenv:Body>
<ser:RegistrarPesoResponse>
<result>
<gridRetorno>
<tipoRetorno>Integer</tipoRetorno>
<ideExt>Integer</ideExt>
<gridItensRetorno>
<msgRetorno>String</msgRetorno>
</gridItensRetorno>
</gridRetorno>
<erroExecucao>String</erroExecucao>
</result>
</ser:RegistrarPesoResponse>
</soapenv:Body>
</soapenv:Envelope>
| Nome | Tipo | Preenchimento | Ajuda |
|---|---|---|---|
| gridRetorno | Set | Opcional | Lista de retorno |
| gridRetorno.tipoRetorno | Integer | Opcional | (Obrigatório) - Número(001) - Tipo de Retorno de Processamento - Lista: 0 = Processado, -1 = Erro na Solicitação |
| gridRetorno.ideExt | Integer | Opcional | (Obrigatório) - String(050) - Identificador de registro de sistema externo |
| gridItensRetorno | Set | Opcional | Lista de mensagens de retorno |
| gridItensRetorno.msgRetorno | String | Opcional | (Obrigatório) - String(1000) - Mensagem de Retorno de Processamento |
| erroExecucao | String | Opcional |
Necessita autenticação: Sim.
Situação da versão: Atual.
Versão: 1.
Versão atual: 1.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
<soapenv:Body>
<ser:RegistrarPesagemAvulsa>
<user>String</user>
<password>String</password>
<encryption>Integer</encryption>
<parameters>
<gridCadastros>
<ideExt>String</ideExt>
<ideAux>String</ideAux>
<codEmp>Integer</codEmp>
<codFil>Integer</codFil>
<plaVei>String</plaVei>
<cpfMot>Double</cpfMot>
<nomMot>String</nomMot>
<codFor>Integer</codFor>
<seqOrm>Integer</seqOrm>
<codPro>String</codPro>
<codDer>String</codDer>
<pesEni>Double</pesEni>
<codBalExtEnt>String</codBalExtEnt>
<pesFim>Double</pesFim>
<obsCes>String</obsCes>
<codBalExtSai>String</codBalExtSai>
<gridFotos>
<tipoOperacao>String</tipoOperacao>
<codCamExt>String</codCamExt>
<uRL>String</uRL>
</gridFotos>
</gridCadastros>
</parameters>
</ser:RegistrarPesagemAvulsa>
</soapenv:Body>
</soapenv:Envelope>
| Nome | Tipo | Preenchimento | Ajuda |
|---|---|---|---|
| gridCadastros | Set | Obrigatório | (Obrigatório) - Lista de cadastros de peso de entrada e saída do veículo para as operações de balança. |
| gridCadastros.ideExt | String | Opcional | (Obrigatório) - String(050) - Identificador de registro de sistema externo. |
| gridCadastros.ideAux | String | Opcional | (Opcional) - String(050) - Identificador auxiliar de sistema externo |
| gridCadastros.codEmp | Integer | Opcional | (Obrigatório) - Number(004) - Código da Empresa no sistema ERPSenior |
| gridCadastros.codFil | Integer | Opcional | (Obrigatório) - Number(004) - Código da Filial no sistema ERPSenior |
| gridCadastros.plaVei | String | Opcional | (Obrigatório) - String(010) - Placa do veículo |
| gridCadastros.cpfMot | Double | Opcional | (Opcional/Obrigatório) - String(040) - Cpf do Motorista - Obrigatório se não a transportadora não for informada |
| gridCadastros.nomMot | String | Opcional | (Opcional/Obrigatório) - String(040) - Nome do motorista - Obrigatório se a transportadora não for informada |
| gridCadastros.codFor | Integer | Opcional | (Opcional) - Número(009) - Código de fornecedor no sistema ERPSenior |
| gridCadastros.seqOrm | Integer | Opcional | (Opcional) - Número(005) - Sequência de origem de mercadoria do fornecedor no sistema ERPSenior |
| gridCadastros.codPro | String | Opcional | (Opcional) - String(014) - Código de produto no sistema ERPSenior |
| gridCadastros.codDer | String | Opcional | (Opcional) - String(007) - Código de derivação do produto no sistema ERPSenior |
| gridCadastros.pesEni | Double | Opcional | (Opcional) - Número(009,3) - Peso informado na entrada do veículo |
| gridCadastros.codBalExt | String | Opcional | (Obrigatório) - Número(004) - Código de balança no sistema externo. |
| gridCadastros.pesFim | Double | Opcional | (Opcional) - Número(009,3) - Peso informado na saída do veículo |
| gridCadastros.obsCes | String | Opcional | (Opcional) - String(250) - Texto com observação geral para a pesagem / ticket no sistema ERPSenior |
| gridCadastros.codBalExtSai | String | Opcional | |
| gridFotos | Set | Opcional | (Opcional) - Lista de fotos. |
| gridFotos.tipoOperacao | String | Opcional | (Obrigatório) - String(001) - Tipo de Operação (E- Entrada / S-Saída) |
| gridFotos.codCamExt | String | Opcional | (Opcional) - Número(004) - Código da câmera no sistema externo ao ERP. |
| gridFotos.uRL | String | Opcional | (Opcional) - Imagem - URL para ser baixada a imagem - não pode ter autenticação |
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
<soapenv:Body>
<ser:RegistrarPesagemAvulsaResponse>
<result>
<gridRetorno>
<tipoRetorno>Integer</tipoRetorno>
<ideExt>String</ideExt>
<gridItensRetorno>
<msgRetorno>String</msgRetorno>
</gridItensRetorno>
</gridRetorno>
<erroExecucao>String</erroExecucao>
</result>
</ser:RegistrarPesagemAvulsaResponse>
</soapenv:Body>
</soapenv:Envelope>
| Nome | Tipo | Preenchimento | Ajuda |
|---|---|---|---|
| gridRetorno | Set | Opcional | Lista de retorno |
| gridRetorno.tipoRetorno | Integer | Opcional | (Obrigatório) - Número(001) - Tipo de Retorno de Processamento - Lista: 0 = Processado, -1 = Erro na Solicitação |
| gridRetorno.ideExt | Integer | Opcional | (Obrigatório) - String(050) - Identificador de registro de sistema externo |
| gridItensRetorno | Set | Opcional | Lista de mensagens de retorno |
| gridItensRetorno.msgRetorno | String | Opcional | (Obrigatório) - String(1000) - Mensagem de Retorno de Processamento |
| erroExecucao | String | Opcional |
Necessita autenticação: Sim.
Situação da versão: Atual.
Versão: 3.
Versão atual: 3.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
<soapenv:Body>
<ser:RegistrarEntradaManual>
<user>String</user>
<password>String</password>
<encryption>Integer</encryption>
<parameters>
<gridCadastros>
<ideExt>String</ideExt>
<ideAux>String</ideAux>
<codEmp>Integer</codEmp>
<codFil>Integer</codFil>
<plaVei>String</plaVei>
<plave2>String</plave2>
<codFor>Integer</codFor>
<seqOrm>Integer</seqOrm>
<cpfMot>Double</cpfMot>
<nomMot>String</nomMot>
<codTra>Integer</codTra>
<codPro>String</codPro>
<codDer>String</codDer>
<locPro>String</locPro>
<codSaf>String</codSaf>
<pesEni>Double</pesEni>
<codBalExtEnt>String</codBalExtEnt>
<pesFim>Double</pesFim>
<codBalExtSai>String</codBalExtSai>
<gridFotos>
<tipoOperacao>String</tipoOperacao>
<codCamExt>String</codCamExt>
<uRL>String</uRL>
<imgFot>Blob</imgFot>
</gridFotos>
<gridOrdensCompra>
<codFor>Integer</codFor>
<seqOrm>Integer</seqOrm>
<filOcp>Integer</filOcp>
<numOcp>Integer</numOcp>
<gridNotasFiscais>
<codFor>Integer</codFor>
<seqOrm>Integer</seqOrm>
<chvNel>String</chvNel>
<numNfc>Integer</numNfc>
<codSnf>String</codSnf>
</gridNotasFiscais>
</gridOrdensCompra>
</gridCadastros>
</parameters>
</ser:RegistrarEntradaManual>
</soapenv:Body>
</soapenv:Envelope>
| Nome | Tipo | Preenchimento | Ajuda |
|---|---|---|---|
| gridCadastros | Set | Obrigatório | Lista de cadastros de entrada via balança |
| gridCadastros.ideExt | String | Opcional | Identificador de registro de sistema externo |
| gridCadastros.ideAux | String | Opcional | Identificador auxiliar de sistema externo |
| gridCadastros.codEmp | Integer | Opcional | Código da Empresa no sistema ERPSenior |
| gridCadastros.codFil | Integer | Opcional | Código da Filial no sistema ERPSenior |
| gridCadastros.plaVei | String | Opcional | Placa do veículo |
| gridCadastros.plave2 | String | Opcional | Placa do Bitrem |
| gridCadastros.codFor | Integer | Opcional | Código de fornecedor no sistema ERPSenior |
| gridCadastros.seqOrm | Integer | Opcional | Sequência de origem de mercadoria do fornecedor no sistema ERPSenior |
| gridCadastros.cpfMot | Double | Opcional | Cpf do Motorista - Obrigatório se não a transportadora não for informada |
| gridCadastros.nomMot | String | Opcional | Nome do motorista - Obrigatório se a transportadora não for informada |
| gridCadastros.codTra | Integer | Opcional | Código de transportadora no sistema ERPSenior |
| gridCadastros.codPro | String | Opcional | Código de produto no sistema ERPSenior |
| gridCadastros.codDer | String | Opcional | Código de derivação do produto no sistema ERPSenior |
| gridCadastros.locPro | String | Opcional | Localização do Produto |
| gridCadastros.codSaf | String | Opcional | Código de safra no sistema ERPSenior |
| gridCadastros.pesEni | Double | Opcional | Peso informado na entrada do veículo |
| gridCadastros.codBalExtEnt | String | Opcional | |
| gridCadastros.pesFim | Double | Opcional | Peso informado na saída do veículo |
| gridCadastros.codBalExtSai | String | Opcional | |
| gridFotos | Set | Opcional | Lista de fotos |
| gridFotos.tipoOperacao | String | Opcional | Tipo de Operação (E- Entrada / S-Saída) |
| gridFotos.codCamExt | String | Opcional | Código da câmera no sistema externo ao ERPSenior |
| gridFotos.uRL | String | Opcional | Imagem - URL para ser baixada a imagem - não pode ter autenticação |
| gridFotos.imgFot | Blob | Opcional | Imagem - Foto capturada |
| gridOrdensCompra | Set | Opcional | Lista de ordens de compra na entrada via balança |
| gridOrdensCompra.codFor | Integer | Opcional | Código de fornecedor no sistema ERPSenior |
| gridOrdensCompra.seqOrm | Integer | Opcional | Sequência de origem de mercadoria do fornecedor no sistema ERPSenior |
| gridOrdensCompra.filOcp | Integer | Opcional | Código da Filial da ordem de compra no sistema ERPSenior |
| gridOrdensCompra.numOcp | Integer | Opcional | Número da ordem de compra no sistema ERPSenior |
| gridNotasFiscais | Set | Opcional | Lista de notas fiscais de compra na entrada via balança |
| gridNotasFiscais.codFor | Integer | Opcional | Código de fornecedor no sistema ERPSenior |
| gridNotasFiscais.seqOrm | Integer | Opcional | Sequência de origem de mercadoria do fornecedor no sistema ERPSenior |
| gridNotasFiscais.chvNel | String | Opcional | Chave de acesso da nota fiscal no sistema ERPSenior |
| gridNotasFiscais.numFfc | Integer | Opcional | Número da nota fiscal de entrada no sistema ERPSenior |
| gridNotasFiscais.codSnf | String | Opcional | Série da nota fiscal de entrada no sistema ERPSenior |
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
<soapenv:Body>
<ser:RegistrarEntradaManualResponse>
<result>
<gridRetorno>
<tipoRetorno>Integer</tipoRetorno>
<ideExt>String</ideExt>
<gridItensRetorno>
<msgRetorno>String</msgRetorno>
</gridItensRetorno>
</gridRetorno>
<erroExecucao>String</erroExecucao>
</result>
</ser:RegistrarEntradaManualResponse>
</soapenv:Body>
</soapenv:Envelope>
| Nome | Tipo | Preenchimento | Ajuda |
|---|---|---|---|
| gridRetorno | Set | Opcional | Lista de retorno |
| gridRetorno.tipoRetorno | Integer | Opcional | Tipo de Retorno de Processamento - Lista: 0 = Processado, -1 = Erro na Solicitação |
| gridRetorno.ideExt | String | Opcional | Identificador de registro de sistema externo |
| gridItensRetorno | Set | Opcional | Lista de mensagens de retorno |
| gridItensRetorno.msgRetorno | String | Opcional | Mensagem de Retorno de Processamento |
| erroExecucao | String | Opcional |
A criação da porta RegistrarEntradaManual no Web service com.senior.g5.co.int.agr.pesagem, tem a finalidade de integrar as pesagens ao ERP (Gestão Empresarial | ERP), que seriam colocadas manualmente. Abaixo, as formas de iteração com o webservice:
- A pesagem deve ser recebida pela porta RegistrarEntradaManual;
- Após o registro da pesagem na porta RegistrarEntradaManual, caso os pesos sejam capturados também no sistema externo ao ERP (Gestão Empresarial | ERP), eles podem ser enviados pela porta, já existe no mesmo Web service, RegistrarPeso;
- Após o registro da pesagem feito na porta RegistrarEntradaManual, pode ser solicitado o cancelamento da pesagem pela porta, já existe no mesmo web service, Cancelar;
O Web service pode receber apenas os dados da pesagem e posteriormente os pesos na porta RegistrarPeso, ou já pode receber a pesagem com o peso de entrada, peso de saída ou ambos.
No caso de receber a pesagem junto ao peso de entrada e saída, no momento da inclusão do registro acionado pela porta RegistrarEntradaManual, já é calculado a quantidade final da carga e realizado o fechamento da mesma.
Importante
A pesagem é apenas registrada, não são gerados documentos fiscais para ela, como, dependendo o cenário de negócio, é feito quando a pesagem é fechada pela tela F435CST, ou seja, ela é apenas registrada na base de dados como informação para ser consultada posteriormente.
No momento que receber o cadastro da pesagem pela porta RegistrarEntradaManual, caso esteja sem um ou ambos pesos, é possível, depois, na tela F435CST, fechar a pesagem.
Se ambos os pesos ou apenas o peso de saída venha ser recebido pela porta RegistrarPeso, embora pela ótica de negócio que a tela F435CST contempla atualmente a pesagem já estaria pronta para ser fechada, nesse caso, o sistema não realiza o fechamento de forma automática ao ter a informação de ambos os pesos. É necessário acessar a tela F435CST para realizar o fechamento da carga, e esse fechamento assume o comportamento de negócio da tela.
Se o usuário acessar a tela F435CST para concluir alguma pesagem recebida pelo Web service criado, o sistema irá assumir o comportamento de fechamento da carga da tela. Isso significa dizer que ao finalizar a pesagem na tela F435CST, o sistema poderá gerar a nota para ela caso ela já não tenha recebido uma nota ou ordem de compra no momento em que foi feito seu cadastro pela porta RegistrarEntradaManual.
Cabeçalho (lista obrigatória)
| Campo | Tipo | Preenchimento | Descrição |
|---|---|---|---|
| IdeExt | String(050) | Obrigatório | Identificador de registro de sistema externo |
| IdeAux | String(050) | Opcional | Identificador auxiliar de sistema externo |
| CodEmp | Number(004) | Obrigatório | Código da Empresa no sistema ERPSenior |
| CodFil | Number(004) | Obrigatório | Código da Filial no sistema ERPSenior |
| PlaVei | String(010) | Obrigatório | Placa do veículo |
| PlaVe2 | String(010) | Opcional | Placa do Bitrem |
| CodFor | Número(009) | Obrigatório | Código de fornecedor no sistema ERPSenior |
| SeqOrm | Número(005) | Opcional | Sequência de origem de mercadoria do fornecedor no sistema ERPSenior |
| CpfMot | String(040) | Opcional/Obrigatório | Cpf do Motorista - Obrigatório se não a transportadora não for informada |
| NomMot | String(040) | Opcional/Obrigatório | Nome do motorista - Obrigatório se a transportadora não for informada |
| CodPro | String(014) | Obrigatório | Código de produto no sistema ERPSenior |
| CodDer | String(007) | Obrigatório | Código de derivação do produto no sistema ERPSenior |
| CodTra | Número(009) | Opcional | Código de transportadora no sistema ERPSenior |
| CodSaf | String(010) | Opcional | Código de safra no sistema ERPSenior |
| CodBalExtEnt | Número(004) | Opcional | Código da balança no sistema externo ao ERP utilizada na pesagem de entrada |
| PesEni | Número(009,3) | Opcional | Peso informado na entrada do veículo |
| CodBalExtSai | Número(004) | Opcional | Código da balança no sistema externo ao ERP utilizada na pesagem de saída |
| PesFim | Número(009,3) | Opcional | Peso informado na saída do veículo |
| LocPro | String(060) | Opcional | Localização do Produto |
| CodSnf | String(003) | Opcional | Série da nota fiscal de entrada no sistema ERPSenior |
| NumNfc | Número(009) | Opcional | Número da nota fiscal de entrada no sistema ERPSenior |
| ChvNel | String(050) | Opcional | Chave de acesso da nota fiscal no sistema ERPSenior |
| NumOcp | Número(009) | Opcional | Número da ordem de compra no sistema ERPSenior |
Fotos (lista opcional) - Detalhe do cabeçalho
| Campo | Preenchimento | Tipo | Descrição |
|---|---|---|---|
| TipoOperacao | Obrigatório | String(001) | Tipo de Operação (E- Entrada / S-Saída) |
| CodCamExt | Opcional | Número(004) | Código da câmera no sistema externo ao ERPSenior |
| ImgFot | Opcional | Imagem | Foto capturada |
Retorno (lista obrigatória)
| Campo | Preenchimento | Tipo | Descrição |
|---|---|---|---|
| TipoRetorno | Obrigatório | Número(001) | Tipo de Retorno de Processamento - Lista: 0 = Processado, -1 = Erro na Solicitação |
| IdeExt | Obrigatório | String(050) | Identificador de registro de sistema externo |
Detalhes do retorno (lista opcional)
| Campo | Preenchimento | Tipo | Descrição |
|---|---|---|---|
| MsgRetorno | Obrigatório | String(1000) | Mensagem de Retorno de Processamento |
Através do parâmetro IdeExt recebemos a chave do registro no sistema externo ao ERP (Gestão Empresarial | ERP), no cenário que motivou a implementação, trata-se do identificador de registro de agendamento no sistema de Gestão de Pátio. Dessa forma, esse valor deve ser único na base de dados do ERP (Gestão Empresarial | ERP). Caso o sistema receba duas requisições com o parâmetro IdeExt, a primeira requisição realizada pode ser salva, porém, a segunda não será salva se a primeira já foi. Nessa situação, o sistema irá retornar ao requisitante com uma mensagem de erro.
O parâmetro IdeAux segue a mesma regra do parâmetro anterior em relação a unicidade na base de dados. Sua função é armazenar outro id auxiliar, podendo ser de sistemas terceiros, sendo seu pretexto original armazenar o identificador da pesagem do registro no Gestão de Fretes da Senior. Contudo, observe que a unicidade não é a combinação de ambos os parâmetros IdeExt e IdeAux, e sim cada um deles deve ser único.
O sistema irá verificar se o código recebido para o fornecedor está cadastrado na base de dados e encontra-se ativo. Além disso, se o identificador de regras COM-000DEFFO01 estiver ativo, é consistido se o fornecedor possuí ou não histórico cadastrado, F095HFO. Se a transportadora não foi informada na requisição e o fornecedor possuir em seu histórico uma transportadora informada, ela então é alimentada automaticamente, caso encontrar-se ativa.
Caso o fornecedor esteja parametrizado para utilizar origem de mercadoria, será consistido se foi informada a origem de mercadoria para ele. Caso não tenha sido informada, nesse cenário, a pesagem será rejeitada. Se a origem foi informada na requisição, será consistido se ela encontra-se ativa.
Não é permitido ter a mesma placa com duas pesagens em aberto para a rotina de devolução de grãos na tela F115COE, no entanto, ao receber uma requisição no Web service com uma placa, será verificado se já existe uma pesagem em aberto na placa recebida.
O produto e derivação aceitos são os mesmos precisam atender os seguintes critérios:
- o produto precisa ser do tipo: Comprado, Passagem Direta ou Produzido e Misto;
- a situação do produto precisa estar ativo;
- o indicativo que o produto pode ser comprado precisa estar parametrizado como S - Sim;
- o produto precisa ter uma terceira unidade de medida informada em seu cadastro;
- a derivação do produto precisa estar ativa.
Se a safra for informada, ela é consistida. É verificado se em seu cadastro ela está ativa. Caso a safra não seja encontrada ou não esteja ativa, o registro da pesagem é ignorado.
Caso o registro da pesagem venha com código de transportadora, será verificado se essa é cadastrada no ERP (Gestão Empresarial | ERP) e se está ativa. Caso não encontre ou ela não esteja ativa, o registro da pesagem será ignorado.
Observação
É obrigatório que seja informado os dados do motorista ou da transportadora.
Se o fornecedor da carga for pessoa jurídica, é procurada na base de dados uma nota de entrada, aberta ou fechada que seja de mesma empresa, filial, série e número do que foi recebido na requisição e que também seja do fornecedor informado. Se o fornecedor for pessoa física, a nota é considerada como nota de produtor e é armazenada como informação.
Se recebido o número de ordem de compra na requisição, é buscado uma ordem de compra na base de dados na mesma empresa e filial detalhada na requisição para o mesmo fornecedor.
Caso o peso de entrada for enviado PesEni e com ele as fotos capturadas, deve ser enviado também o código da balança no sistema externo ao ERP (Gestão Empresarial | ERP), através do campo CodBalExtEnt, onde foi capturado o peso junto com as fotos.
No cenário do peso de saída ser enviado PesFim e com ele as fotos, deve ser enviado juntamente o código da balança no sistema externo ao ERP (Gestão Empresarial | ERP), pelo campo CodBalExtSai.
O sistema externo ao ERP (Gestão Empresarial | ERP) pode capturar imagens do veículo nos momentos das pesagem. Como a impressão do ticket de pesagem irá ocorrer no ERP (Gestão Empresarial | ERP), é necessário recepcionar as imagens. Para isso, o Web service possuí alguns parâmetros relevantes, nesse contexto. São eles: CodBalExtEnt, CodBalExtSai, CodCamExt e ImgFot.
- No parâmetro ImgFot deve ser enviada a foto que foi capturada no sistema externo. Essa foto deve ser em base64;
- No parâmetro CodBalExtEnt deve ser enviado o código da balança da pesagem de entrada do veículo, no sistema externo, onde as fotos foram capturada;
- No parâmetro CodBalExtSai deve ser enviado o código da balança da pesagem de saída do veículo, no sistema externo, onde as fotos foram capturada;
- No parâmetro CodCamExt deve ser enviado o código da câmera que capturou a foto no sistema externo.
Esses parâmetros são necessários para permitir que o cliente consiga escolher, no código do relatório que imprime seu ticket de pesagem, precisamente, quais fotos ele quer imprimir, pois podem existir cenários onde o cliente tem mais de uma balança, cada uma das balanças pode ter várias câmeras capturando fotos de ângulos diferentes do veículo e da carga, para operações de entrada e de saída. Sem isso ele não conseguiria selecionar com precisão quais fotos gostaria de imprimir no ticket de pesagem.
Como o ERP (Gestão Empresarial | ERP) também possuí estruturas para captura de imagens e por isso tem recursos de armazenamento de imagens, foi utilizada a mesma estrutura para armazenar essas fotos. Dessa forma, no momento que o Web service receber a foto, ele irá fazer as seguintes consistências:
- Irá verificar se código recebido nos parâmetros CodBalExtEnt e CodBalExtSai atende a algum registro existente no cadastro de balanças, na rotina F063BAL, através do código cadastrado no campo Cód. Externo;
-
Observação
Caso não seja encontrada uma balança que tenha atenda ao código externo recebido, a foto será ignorada e será retornada uma mensagem com a informação.
- Irá verificar se código recebido no parâmetro CodExtCam atende a algum registro existente no cadastro de câmeras, na rotina F063CAM, através do código cadastrado no campo Cód. Externo;
- Depois que as duas validações anteriores foram feitas, irá verificar se existe a ligação parametrizada para balança x câmera x operação, que fica na tela F063BAL, guia Balança x Operação.
As fotos capturada do veículo ou carga podem ser recebidas diretamente na requisição. Inicialmente, a requisição deve receber o campo ImgFot, cujo valor trata-se de um campo String (texto) nos moldes do algorítmo base64. Esse valor, por sua vez, sofrerá uma transformação de texto para um grupo extenso de bytes, isso porque este é o modo que o banco de dados efetivamente irá armazenar essa imagem.
Como as fotos são capturadas em operações de pesagem de entrada ou saída (TipoOperacao), é verificado a respectiva ligação do código externo da câmera que capturou a foto de entrada com o código externo da balança que capturou o peso de entrada, aplicando a mesma lógica para fotos capturadas na saída do veículo.
Há informações que o sistema externo pode não ter, mas que são importantes e que é possível via regra de negócio decidir qual seria essa informação não alimentada no Web service, ou até mesmo corrigir uma informação recebida na requisição.
Um exemplo é a informação de safra, um sistema de Gestão de Pátio pode não ter um controle de safras em suas rotinas. Com isso, foi criado o identificador de regras CPR-115ALTDV01 que é executado exclusivamente pelo Web service, para cada registro de pesagem informado na requisição, para que via regra seja possível informar ao ERP (Gestão Empresarial | ERP) informações que podem não vir na requisição do web service ou até mesmo substituir alguma informação recebida como parâmetro por outra desejada e definida via regra customizada.
Necessita autenticação: Sim.
Situação da versão: Atual.
Versão: 1.
Versão atual: 1.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
<soapenv:Body>
<ser:RegistrarPeso>
<user>String</user>
<password>String</password>
<encryption>Integer</encryption>
<parameters>
<gridCadastros>
<ideExt>String</ideExt>
<tipoOperacao>String</tipoOperacao>
<codBalExt>String</codBalExt>
<pesInf>String</pesInf>
<gridFotos>
<codCamExt>String</codCamExt>
<imgFot>Blob</imgFot>
</gridFotos>
</gridCadastros>
</parameters>
</ser:RegistrarPeso>
</soapenv:Body>
</soapenv:Envelope>
| Nome | Tipo | Preenchimento | Ajuda |
|---|---|---|---|
| gridCadastros | Set | Opcional | (Obrigatório) - Lista de cadastros de entrada via balança |
| gridCadastros.ideExt | String | Opcional | (Obrigatório) - String(050) - Identificador de registro de sistema externo |
| gridCadastros.ideAux | String | Opcional | (Opcional) - String(050) - Identificador auxiliar de sistema externo |
| gridCadastros.codEmp | String | Opcional | (Obrigatório) - Number(004) - Código da Empresa |
| gridCadastros.codFil | String | Opcional | (Obrigatório) - Number(004) - Código da Filial |
| gridCadastros.plaVei | String | Opcional | (Obrigatório) - String(010) - Placa do veículo |
| gridCadastros.nomMot | String | Opcional | (Obrigatório) - String(040) - Nome do motorista |
| gridCadastros.datEnt | String | Opcional | (Obrigatório) - Date - Data de Entrada |
| gridCadastros.codFor | String | Opcional | (Obrigatório) - Number(009) - Código de produto |
| gridCadastros.seqOri | String | Opcional | (Obrigatório) - Number(005) - Sequência do endereço de origem da mercadoria |
| gridCadastros.codPro | String | Opcional | (Obrigatório) - String(014) - Código de produto |
| gridCadastros.codDer | String | Opcional | (Obrigatório) - String(007) - Código de derivação |
| gridCadastros.codDep | String | Opcional | (Opcional) - String(010) - Código de depósito |
| gridCadastros.codTra | String | Opcional | (Opcional) - Number(009) - Código da transportadora |
| gridCadastros.nfcPr | String | Opcional | (Opcional) - Number(009) - Número da nota fiscal de entrada para acobertar possíveis taxas descontadas em produto |
| gridCadastros.snfPro | String | Opcional | (Opcional) - String(003) - Código da série da nota fiscal de entrada para acobertar possíveis taxas descontadas em produto |
| gridCadastros.pesEni | String | Opcional | (Obrigatório/Opcional) - Número(009,3) - Peso informado na entrada |
| gridCadastros.codBalExtEnt | String | Opcional | (Opcional) - Número(004) - Código da balança no sistema externo ao ERP utilizada na pesagem de entrada |
| gridCadastros.pesSai | String | Opcional | (Obrigatório/Opcional) - Número(009,3) - Peso informado na saída |
| gridCadastros.codBalExtSai | String | Opcional | (Opcional) - Número(004) - Código da balança no sistema externo ao ERP utilizada na pesagem de saída |
| gridCadastros.capTotVei | String | Opcional | (Opcional) - Número(004) - Capacidade que o veículo tem para carregar produto |
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
<soapenv:Body>
<ser:RegistrarPesoResponse>
<result>
<gridRetorno>
<tipoRetorno>Integer</tipoRetorno>
<ideExt>Integer</ideExt>
<gridItensRetorno>
<msgRetorno>String</msgRetorno>
</gridItensRetorno>
</gridRetorno>
<erroExecucao>String</erroExecucao>
</result>
</ser:RegistrarPesoResponse>
</soapenv:Body>
</soapenv:Envelope>
| Nome | Tipo | Preenchimento | Ajuda |
|---|---|---|---|
| gridRetorno | Set | Opcional | Lista de retorno |
| gridRetorno.tipoRetorno | Integer | Opcional | (Obrigatório) - Número(001) - Tipo de Retorno de Processamento - Lista: 0 = Processado, -1 = Erro na Solicitação |
| gridRetorno.ideExt | String | Opcional | (Obrigatório) - String(050) - Identificador de registro de sistema externo |
| gridItensRetorno | Set | Opcional | Lista de mensagens de retorno |
| gridItensRetorno.msgRetorno | String | Opcional | (Obrigatório) - String(1000) - Mensagem de Retorno de Processamento |
| erroExecucao | String | Opcional |
Através do parâmetro IdeExt, recebemos a chave do registro do sistema externo para o ERP (Gestão Empresarial | ERP), trata-se do identificador de registro de agendamentos no Gestão de Pátio. Dessa forma, o valor deve ser único na base de dados do ERP (Gestão Empresarial | ERP), caso o sistema receba duas requisições com o parâmetro IdeExt, a primeira requisição realizada pode ser salva, porém, a segunda não será salva se a primeira já foi. Nessa situação, o sistema irá retornar ao requisitante com uma mensagem de erro.
O parâmetro IdeAux segue a mesma regra do parâmetro anterior em relação a unicidade na base de dados. Sua função é armazenar outro id auxiliar, podendo ser de sistemas terceiros, sendo seu pretexto original armazenar o identificador da pesagem do registro no Gestão de Fretes da Senior. Contudo, observe que a unicidade não é a combinação de ambos os parâmetros IdeExt e IdeAux, e sim cada um deles deve ser único.
Não é permitido ter a mesma placa com duas pesagens em aberto para a rotina de devolução de grãos na tela F115COE, no entanto, ao receber uma requisição no Web service com uma placa, será verificado se já existe uma pesagem em aberto na placa recebida.
O produto e derivação que são aceitos são os mesmos aceitos pela tela F115COE, ou seja, deverão estar devidamente cadastrados no sistema. Caso não sejam encontrados ou não estejam ativos, o registro da pesagem será ignorado.
Caso o fornecedor esteja parametrizado para utilizar origem de mercadoria, será consistido se foi informada a origem de mercadoria para ele. Caso não tenha sido informada, a pesagem será rejeitada.
Caso o registro da pesagem venha com código de transportadora, será consistido se está cadastrado no ERP (Gestão Empresarial | ERP) e se está ativo. Caso não encontre ou não esteja ativo, o registro da pesagem será ignorado.
Se informado o peso de entrada, esse precisa ser um valor positivo. Caso o peso de entrada não seja informado na requisição, é possível posteriormente informá-lo no Web service que registra peso ou através da tela F115COE.
Se informado o peso de entrada, esse precisa ser um valor positivo. Caso o peso de saída não seja informado na requisição, é possível posteriormente informá-lo no Web service que registra peso ou através da tela F115COE.
Código da balança externa de entrada. Deverá ser preenchido caso o tipo de operação seja E - Entrada.
Código da balança externa de saída. Deverá ser preenchido caso o tipo de operação seja S - Saída.
Se informado, será usado para acobertar as taxas do produto informado. Automaticamente o sistema irá inicializar essa nota de produtor em todos os registros que estão sendo devolvidos. Caso o produtor seja pessoa jurídica, essa nota não será utilizada posteriormente, visto que a rotina de devolução F115COE já não calcula taxa para operações com pessoa jurídica.
Se informado, será usado para acobertar as taxas do produto informado. Automaticamente o sistema irá inicializar essa nota de produtor em todos os registros que estão sendo devolvidos. Caso o produtor seja pessoa jurídica, essa nota não será utilizada posteriormente, visto que a rotina de devolução F115COE já não calcula taxa para operações com pessoa jurídica.
Este campo deverá ser preenchido para evitar que o sistema selecione uma quantidade de notas muito maior que a quantidade a devolver, tendo em vista que o processamento será mais lento. Caso não seja informado valor e o sistema verificar que foi informado valor no campo Peso de saída, o campo CapTotVei receberá o valor do Peso de Saída.
Se o valor do campo peso de saída também não foi informado, o sistema irá assumir um valor fixo de capacidade total de 80 mil, visto que nenhum caminhão é capaz de ser carregado com um peso maior do que esse.
O sistema externo pode capturar imagens do veículo nos momentos das pesagem. Como a impressão do ticket de pesagem irá ocorrer no ERP (Gestão Empresarial | ERP), é necessário recepcionar essas imagens. Para isso, o Web service possuí parâmetros relevantes, nesse contexto, CodExtBal, CodExtCam e ImgFot.
- No parâmetro ImgFot, deve ser recebida a foto que foi capturada no sistema externo. Essa foto deve estar em base64;
- No parâmetro CodExtBal, deve ser recebido o código da balança no sistema externo onde a foto foi capturada;
- No parâmetro CodExtCam deve ser recebido o código da câmera que capturou a foto no sistema externo;
- No parâmetro TipoOperacao deve ser informado se a foto foi capturada na entrada ou na saída da pesagem.
Observação
Os três parâmetros (CodExtBal, CodExtCam e ImgFot) são necessários para permitir que o cliente consiga selecionar o código que imprime seu ticket de pesagem, precisamente das fotos ele quer imprimir. Podem existir o cenário onde o cliente possuí mais de uma balança, cada uma delas podendo ter diversas câmeras capturando fotos de ângulos diferentes do veículo e da carga, sem os parâmetros, ele não consegue selecionar com precisão quais fotos gostaria de imprimir no ticket de pesagem.
Como o ERP (Gestão Empresarial | ERP) possuí estrutura para captura de imagens e tem o recurso de armazenamento, foi aproveitada a mesma estrutura para armazenar as fotos. Dessa forma, no momento que o Web Service recebe a foto, ele irá fazer as seguintes consistências:
- Verificar se código recebido no parâmetro CodExtBal atende algum registro existente no cadastro de balanças, na rotina F063BAL, através do código cadastrado no campo Cód. Externo. Caso não seja encontrada uma balança com esse código externo, a foto será ignorada e o sistema irá retornar com essa informação.
- Conferir se código recebido no parâmetro CodExtCam atende algum registro existente no cadastro de câmeras, na rotina F063CAM, através do código cadastrado no campo Cód. Externo.
- Depois que as validações anteriores serem feitas, será verificado se existe a ligação parametrizada da balança x câmera x operação, na tela F063BAL, guia Balança x Operação.
O sistema irá realizar a procura nas notas fiscais de entrada com o código da empresa logada, código da filial logada, código do fornecedor informado, código do produto informado, código da derivação do produto informado e a sequência de origem da mercadoria informada. Após, irá verificar se possui ordem de compra, calculando a quantidade já recebida para descontar da quantidade em aberto.
Será calculado também as taxas de cada nota selecionada e ao finalizar essas rotinas, o sistema irá gravar as informações nas tabelas E115CES e E115PRO, para que esses dados possam ser mostradas na tela F115COE, quando o usuário pesquisar pela placa que foi informada no Web service.
É importante ressaltar que embora o Web service permita receber a pesagem completa (informações e pesos de entrada e saída), ele não irá fazer a geração das notas de devolução automaticamente. Ainda assim, dependerá do usuário ir manualmente na tela F115COE e fazer o fechamento da carga.
Ao informar um número de placa já cadastrado no sistema e se identificado que o mesmo é oriundo do Web service com.senior.g5.co.int.agr.pesagem, porta RegistrarDevolucao, o sistema terá os seguintes comportamentos:
- Os campos Placa/motorista, Fornecedor, Filial/serie/n.f.entrada, Produto/derivação, Depósito e Transportadora estarão desabilitados, ou seja, o usuário não poderá alterá-los.
- Se o registro já possuir peso de entrada e saída, estes campos estarão desabilitados, ou seja, o usuário não poderá alterá-los.
No identificador de regra CPR-115ALTDV01, qual será executado para alterar dados dos campos Produto e Transportadora.
O mecanismo de ativação do Web service não deve ser complexo, isso porque deve ser mantido somente o serviço do ERP (Gestão Empresarial | ERP), utilizar porta correspondente (no caso, RegistrarDevolucao), preencher o envelope XML e observar os resultados do serviço. É importante observar as tratativas em torno das informações vindas desses campos preenchidos.
Com base nisso, abaixo as assertivas pertinentes a esse processo de devolução as quais devem ser trabalhadas:
| Nome | Tipo | Condição | Descrição | Estrutura |
|---|---|---|---|---|
| IdeExt | Número | Obrigatório | Identificador de registro no sistema externo | Guia Cadastros |
| IdeAux | Número | Opcional | Código adicional de identificação | Guia Cadastros |
| CodEmp | Número | Obrigatório | Código da Empresa | Guia Cadastros |
| CodFil | Número | Obrigatório | Código da Filial | Guia Cadastros |
| PlaVei | Alfa | Obrigatório | Placa do veículo | Guia Cadastros |
| NomMot | Alfa | Obrigatório | Nome do Motorista | Guia Cadastros |
| DatEnt | Data | Obrigatório | Data de Entrada | Guia Cadastros |
| CodFor | Número | Obrigatório | Código do Fornecedor | Guia Cadastros |
| SeqOrm | Número | Obrigatório | Código Origem de Mercadoria | Guia Cadastros |
| SnfNfc | Alfa | Obrigatório | Série Nota | Guia Cadastros |
| NumNfc | Número | Obrigatório | Número da nota | Guia Cadastros |
| CodPro | Alfa | Obrigatório | Código do Produto | Guia Cadastros |
| CodDer | Alfa | Obrigatório | Código da Derivação | Guia Cadastros |
| CodDep | Alfa | Obrigatório | Código do depósito | Guia Cadastros |
| CodTra | Número | Obrigatório | Código da Transportadora | Guia Cadastros |
| PesEni | Número | Opcional | Peso entrada | Guia Cadastros |
| PesSai | Número | Opcional | Peso saída | Guia Cadastros |
| NfcPro | Número | Opcional | Número da nota do produtor para acobertar taxas | Guia Cadastros |
| SnfPro | Alfa | Opcional | Série da nota do produtor para acobertar taxas | Guia Cadastros |
| CapTotVei | Número | Opcional | Capacidade Total do Veículo | Guia Cadastros |
| CodBalExtEnt | Número | Opcional | Código da Balança de entrada no sistema externo ao ERP | Guia Cadastros |
| CodBalExtSai | Número | Opcional | Código da Balança de saída no sistema externo ao ERP | Guia Cadastros |
| TipoOperacao | Alfa | Obrigatório | Tipo de Operação(E - Entrada / S - Saída) | Guia Fotos |
| CodCamExt | Número | Opcional | Código da Câmera no sistema externo ao ERP | Guia Fotos |
| ImgFot | Número | Opcional | Imagem da Foto | Guia Fotos |
Necessita autenticação: Sim.
Situação da versão: Atual.
Versão: 2.
Versão atual: 2.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
<soapenv:Body>
<ser:RegistrarEntradaViaBalancaContrato>
<user>String</user>
<password>String</password>
<encryption>Integer</encryption>
<parameters>
<gridCadastros>
<ideExt>String</ideExt>
<ideAux>String</ideAux>
<indPre>String</indPre>
<codEmp>Integer</codEmp>
<codFil>Integer</codFil>
<plaVei>String</plaVei>
<nomMot>String</nomMot>
<codPro>String</codPro>
<codDer>String</codDer>
<codTra>Integer</codTra>
<codTrg>String</codTrg>
<codSaf>String</codSaf>
<pesEni>Double</pesEni>
<pesOri>Double</pesOri>
<codDep>String</codDep>
<codBalExt>String</codBalExt>
<gridFotos>
<codCamExt>String</codCamExt>
<uRL>String</uRL>
<imgFot>Blob</imgFot>
</gridFotos>
<gridParticipantes>
<codFor>Integer</codFor>
<seqOrm>Integer</seqOrm>
<perPar>Double</perPar>
<gridContratos>
<numCtr>Integer</numCtr>
<filCtr>Integer</filCtr>
<seqCcp>Integer</seqCcp>
<datCpt>String</datCpt>
<gridNotasFiscais>
<codSnf>String</codSnf>
<numNfc>Integer</numNfc>
<chvNel>String</chvNel>
</gridNotasFiscais>
</gridContratos>
<eNotaDeProdutor>String</eNotaDeProdutor>
</gridParticipantes>
</gridCadastros>
</parameters>
</ser:RegistrarEntradaViaBalancaContrato>
</soapenv:Body>
</soapenv:Envelope>
| Nome | Tipo | Preenchimento | Ajuda |
|---|---|---|---|
| gridCadastros | Set | Obrigatório | (Obrigatório) - Lista de cadastros de entrada via balança |
| gridCadastros.ideExt | String | Opcional | (Obrigatório) - String(050) - Identificador de registro de sistema externo |
| gridCadastros.ideAux | String | Opcional | (Opcional) - String(050) - Identificador auxiliar de sistema externo |
| gridCadastros.indPre | String | Opcional | (Obrigatório) - String(001) - Indicativo de pré-cadastramento |
| gridCadastros.codEmp | String | Opcional | (Obrigatório) - Number(004) - Código da Empresa |
| gridCadastros.codFil | String | Opcional | (Obrigatório) - Number(004) - Código da Filial |
| gridCadastros.plaVei | String | Opcional | (Obrigatório) - String(010) - Placa do veículo |
| gridCadastros.nomMot | String | Opcional | (Obrigatório) - String(040) - Nome do motorista |
| gridCadastros.codPro | String | Opcional | (Obrigatório) - String(014) - Código de produto |
| gridCadastros.codDer | String | Opcional | (Obrigatório) - String(007) - Código de derivação |
| gridCadastros.codTra | String | Opcional | (Opcional) - Número(009) - Código de transportadora |
| gridCadastros.codTrg | String | Opcional | (Opcional) - String(010) - Código de classificação de transgênico |
| gridCadastros.codSaf | String | Opcional | (Opcional) - String(010) - Código de safra |
| gridCadastros.pesEni | String | Opcional | (Obrigatório/Opcional) - Número(009,3) - Peso informado na entrada (depende do indicativo de pré-cadastramento) |
| gridCadastros.pesOri | Double | Opcional | |
| gridCadastros.codDep | String | Opcional | (Opcional) - String(010) - Código de depósito |
| gridCadastros.codBalExt | String | Opcional | (Opcional) - Número(004) - Código de balança no sistema externo |
| gridFotos | Set | Opcional | (Opcional) - Lista de fotos |
| gridFotos.codCamExt | String | Opcional | (Opcional) - Número(004) - Código da balança no sistema externo ao ERP |
| gridFotos.uRL | String | Opcional | (Opcional) - Imagem - URL para ser baixada a imagem - não pode ter autenticação |
| gridFotos.imgFot | Blob | Opcional | (Opcional) - Imagem - Imagem da foto |
| gridParticipantes | Set | Opcional | (Obrigatório) - Lista de Participantes da pesagem |
| gridParticipantes.codFor | String | Opcional |
(Obrigatório) - Número(009) - Código de fornecedor
|
| gridParticipantes.seqOrm | String | Opcional | (Opcional) - Número(005) - Sequência de origem de mercadoria |
| gridParticipantes.perPar | String | Opcional | (Obrigatório) - Número(003,2) - Percentual de participação |
| gridNotasFiscais | Set | Opcional | (Opcional) - Lista de notas fiscais |
| gridNotasFiscais.codSnf | String | Opcional | (Opcional) - String(003) - Série da nota fiscal de entrada |
| gridNotasFiscais.numNfc | String | Opcional | (Opcional) - Número(009) - Número da nota fiscal de entrada |
| gridNotasFiscais.chvNel | String | Opcional | (Opcional) - String(050) - Chave de acesso da nota fiscal |
| gridContratos | Set | Opcional | (Opcional) - Lista de contratos |
| gridContratos.numCtr | String | Opcional | (Opcional) - Número(009) - Número interno de contrato |
| gridContratos.filCtr | Integer | Opcional | (Opcional) - Número(005) - Filial do contrato |
| gridContratos.seqCcp | String | Opcional | (Opcional) - Número(003) - Sequência de item de contrato |
| gridContratos.datCpt | String | Opcional | (Opcional) - Data - Data de competência de item de contrato |
| gridParticipantes.eNotaDeProdutor | String | Opcional | (Opcional) - String(001) - aceita valores S e N, sendo:
S - Nota de produtor rural N - Nota de empresa jurídica |
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
<soapenv:Body>
<ser:RegistrarEntradaViaBalancaContratoResponse>
<result>
<gridRetorno>
<tipoRetorno>Integer</tipoRetorno>
<ideExt>String</ideExt>
<gridItensRetorno>
<msgRetorno>String</msgRetorno>
</gridItensRetorno>
</gridRetorno>
<erroExecucao>String</erroExecucao>
</result>
</ser:RegistrarEntradaViaBalancaContratoResponse>
</soapenv:Body>
</soapenv:Envelope>
| Nome | Tipo | Preenchimento | Ajuda |
|---|---|---|---|
| gridRetorno | Set | Opcional | Lista de retorno |
| gridRetorno.tipoRetorno | Integer | Opcional | (Obrigatório) - Número(001) - Tipo de Retorno de Processamento - Lista: 0 = Processado, -1 = Erro na Solicitação |
| gridRetorno.ideExt | Integer | Opcional | (Obrigatório) - String(050) - Identificador de registro de sistema externo |
| gridItensRetorno | Set | Opcional | Lista de mensagens de retorno |
| gridItensRetorno.msgRetorno | String | Opcional | (Obrigatório) - String(1000) - Mensagem de Retorno de Processamento |
| erroExecucao | String | Opcional | Indica erros ocorridos no servidor ao executar o serviço, podendo conter os seguintes valores: Vazio ou nulo, indicando que a execução foi feita com sucesso; A mensagem do erro ocorrido no servidor. |
IdeExt, recebemos a chave do registro do sistema externo para o ERP (Gestão Empresarial | ERP), trata-se do identificador de registro de agendamentos no Gestão de Pátio. Dessa forma, o valor deve ser único na base de dados do ERP (Gestão Empresarial | ERP), caso o sistema receba duas requisições com o parâmetro IdeExt, a primeira requisição realizada pode ser salva, porém, a segunda não será salva se a primeira já foi. Nessa situação, o sistema irá retornar ao requisitante com uma mensagem de erro.
O parâmetro IdeAux segue a mesma regra do parâmetro anterior em relação a unicidade na base de dados. Sua função é armazenar outro id auxiliar, podendo ser de sistemas terceiros, sendo seu pretexto original armazenar o identificador da pesagem do registro no Gestão de Fretes da Senior. Contudo, observe que a unicidade não é a combinação de ambos os parâmetros IdeExt e IdeAux, e sim cada um deles deve ser único.
Não é permitido ter a mesma placa com duas pesagens em aberto para a rotina de devolução de grãos na tela F115COE, no entanto, ao receber uma requisição no Web service com uma placa, será verificado se já existe uma pesagem em aberto na placa recebida.
O produto e derivação aceitos precisam atender os seguintes critérios:
- O produto precisa ser do tipo Comprado; ou ser um produto Misto e seu tipo ser Produzido;
- A situação do produto precisa estar ativo;
- O indicativo que o produto pode ser comprado precisa estar como S - Sim;
- O produto precisa ter uma terceira unidade de medida;
- A derivação do produto precisa estar ativa.
O depósito recebido para a pesagem no Web service precisa estar parametrizado em seu cadastro como comprador, estar ativo, e vinculado ao produto da pesagem na tela F210EST.
Quando o produto ou a derivação do produto recebido na requisição do Web service ou alterado através do identificador de regras CPR-115CPLIP01, estiver parametrizado com um código de transgenia, o sistema irá consistir se a transgenia foi informada na requisição. Caso não tenha sido informada, o registro de pesagem será rejeitado. Caso a transgenia informada na requisição não esteja cadastrada no ERP (Gestão Empresarial | ERP), a requisição do registro de pesagem será ignorada.
Se o registro da pesagem não vir como pré-cadastro, é obrigatório informar a safra. A safra informada será consistida, verificando se o cadastro está ativo. Caso não seja encontrada ou não esteja ativa, o registro da pesagem é ignorado.
No caso do registro da pesagem vir com código de transportadora preenchido, será verificado o cadastrado no ERP (Gestão Empresarial | ERP) e se ele está ativo. Caso não encontre ou não encontra-se ativo, o registro da pesagem será ignorado.
Se informado o peso de entrada, é necessário que seja um valor positivo.
Toda pesagem no ERP (Gestão Empresarial | ERP) obrigatoriamente precisa de uma transação, no entanto, no Web service não há um campo específico para informar a transação. O Gestão de Pátio fará a tentativa de utilizar os recursos nativos do ERP (Gestão Empresarial | ERP) para encontrar a transação a ser utilizada na pesagem, pra isso, orientamos o uso do parâmetro Funcionamento Transação para Recebimento de Grãos.
Observação
Caso nenhuma transação seja encontrada, o registro de pesagem não é aceito pelo sistema.
O sistema externo pode capturar imagens do veículo nos momentos das pesagem. Como a impressão do ticket de pesagem irá ocorrer no ERP (Gestão Empresarial | ERP), é necessário recepcionar essas imagens. Para isso, o Web service possuí parâmetros relevantes, nesse contexto, CodExtBal, CodExtCam e ImgFot.
- No parâmetro ImgFot, deve ser recebida a foto que foi capturada no sistema externo. Essa foto deve estar em base64;
- No parâmetro CodExtBal, deve ser recebido o código da balança no sistema externo onde a foto foi capturada;
- No parâmetro CodExtCam deve ser recebido o código da câmera que capturou a foto no sistema externo;
- No parâmetro TipoOperacao deve ser informado se a foto foi capturada na entrada ou na saída da pesagem.
Esses parâmetros são necessários para permitir que o cliente consiga escolher, no código do relatório que imprime seu ticket de pesagem, precisamente, quais fotos ele quer imprimir, pois podem existir cenários onde o cliente tem mais de uma balança, cada uma das balanças pode ter várias câmeras capturando fotos de ângulos diferentes do veículo e da carga, para operações de entrada e de saída. Sem isso ele não conseguiria selecionar com precisão quais fotos gostaria de imprimir no ticket de pesagem.
Como o ERP (Gestão Empresarial | ERP) também possuí estruturas para captura de imagens e por isso tem recursos de armazenamento de imagens, foi utilizada a mesma estrutura para armazenar essas fotos. Dessa forma, no momento que o Web service receber a foto, ele irá fazer as seguintes consistências:
- Irá verificar se código recebido nos parâmetros CodBalExtEnt e CodBalExtSai atende a algum registro existente no cadastro de balanças, na rotina F063BAL, através do código cadastrado no campo Cód. Externo;
Observação
Caso não seja encontrada uma balança que tenha atenda ao código externo recebido, a foto será ignorada e será retornada uma mensagem com a informação.
- Irá verificar se código recebido no parâmetro CodExtCam atende a algum registro existente no cadastro de câmeras, na rotina F063CAM, através do código cadastrado no campo Cód. Externo;
- Depois que as duas validações anteriores foram feitas, irá verificar se existe a ligação parametrizada para balança x câmera x operação, que fica na tela F063BAL, guia Balança x Operação.
No caso desse Web service a operação é considerada, de forma implicita, como uma operação de entrada. Portanto, a câmera e a balança precisam estarem correlacionadas nessa tela com a operação de balança como Entrada ou Ambos, no parâmetro Ope. Balança.
Caso o fornecedor esteja parametrizado para utilizar origem de mercadoria, será consistido se foi informada a origem de mercadoria para ele. Caso não tenha sido informada, a pesagem será rejeitada.
O tratamento do número de nota fiscal informado no Web service, depende do fornecedor também informado no Web service. Será verificado se está parametrizado no ERP (Gestão Empresarial | ERP) como fornecedor, pessoa jurídica ou física.
- Pessoa física: o sistema interpreta como produtor rural. Nesse caso, o número e série de nota informados são aceitos sem fazer validações sobre ele. Ou seja, esse número e série de nota de produtor rural será referenciado na contra-nota gera pelo ERP (Gestão Empresarial | ERP)para o produtor rural, no momento que o ticket de pesagem for faturado.
- Pessoa jurídica: são aceitas notas fiscais do tipo 1 - compra e 11 - transferência entre filais, para esses tipos elas precisam estarem abertas. Também são aceitas notas do tipo 7 - Importação de produtos e elas podem estar abertas ou fechadas. Além disso, é consistido o produto da pesagem com o produto constante nas notas recebidas e é necessário que a nota tenha apenas um produto e que esse seja igual ao da pesagem, do contrário a nota é ignorada e é retornada essa informação.
Importante
É possivel informar a NF apenas pela chave de acesso, nesse caso, o número e série não precisam ser informados. Se informado chave de acesso, número e série será consistido primeiro a chave, caso a mesma seja valida, será consistido se ela bate com a NF informada e com o fornecedor esperado.
No Web service não há o recurso "Produção própria" que atualmente existe na tela F435CCC. Esse recurso, faz com que uma pessoa jurídica se comporte como uma pessoa física que não é emitente da nota.
Quando o identificador de regras CPR-435NMCTR01 estiver ativo, o contrato que for informado nos parâmetros do web service será o único contrato a ser considerado na pesagem.
Os contratos recebidos para o fornecedor participante de uma pesagem, uma primeira consistência é feita e é verificado o cadastrado no sistema. Caso o fornecedor não seja cadastrado, uma mensagem de retorno é encaminhada, porém, não impede o registro da pesagem. A informação do número de contrato é ignorada e a pesagem é registrada ainda assim.
Importante
Os dados de cabeçalho de pesagem recebidos por esse web service não poderão serem alterados manualmente pelo usuário na rotina F435CCC, já os participantes da carga, os contratos e as notas, esses são passíveis de manutenção posterior.
Filtro de contratos
No Web service com.senior.g5.co.int.agr.pesagem existem parâmetros de contratos, ou seja, é possível selecionar quais contratos sejam utilizados na pesagem. Com isso, ao receber um número de contrato no webservice, pode ocorrer as seguintes situações:
- o número de contrato passado como parâmetro não existir na base;
- o número de contrato passado como parâmetro não ter mais saldo disponível no ERP e portanto não pode ser utilizado;
- o número de contrato passado como parâmetro não atender os filtros/parâmetros padrão que já existem no ERP, e portanto não pode ser utilizado;
Para facilitar o entendimento, os filtros que são feitos para encontrar contratos disponíveis observam:
- Situação do contrato;
- Aprovação multinível. O contrato precisa estar aprovado;
- Saldo em aberto precisa ser maior que zero;
- Se o parâmetro global CtrFilLog estiver habilitado, é filtrados os contratos criados na filial que foi enviada como parâmetro do Web service para que a pesagem seja gerada.
- Na tela Parâmetros da Filial para Compras, se o campo Valida Vigência Ctr. estiver parametrizado como S - Sim, irá observar se na data de execução do Web service o contrato atende a essa vigência.
- Ainda na tela Parâmetros da Filial para Compras, se o campo Funcionamento Transação Para Recebimento de Grãos estiver parametrizado como "F", irá filtrar os contratos que atendam a transação retornada pelo identificador de regras.
- Se for recebido na execução do Web service a informação de safra ou vida identificador de regras CPR-115CPLIP01, será filtrado contratos que atendam a respectiva safra.
- Quando o identificador de regras CPR-435ORMER01 está habilitado, validações são feitas em relação a origem de mercadoria e a origem de mercadoria do contrato. Essas mesmas validações também são feitas na busca por contratos no Web service.
- Quando o identificador de regras CPR-435VALMOE1 está habilitado, é buscado apenas contratos que sejam do mesmo produto mas que também tenham a mesma moeda que está parametrizada no produto para ser utilizada.
Ordem de contrato vinculado a pesagem
São buscados todos os contratos que atendem aos critérios listados acima, que possam atender ao participante da pesagem assumindo o mesmo comportamento existente na tela correspondente do Web service. Com isso, mesmo os contratos que não vieram na requisição serão inicialmente vinculados a pesagem, mas, o usuário no momento do complemento de informações de pré-cadastro de pesagem pode desmarcar os contratos que não desejam.
A ordem padrão que os contratos são vinculados para atender a pesagem é dada por:
- Contratos prioritários;
- Contratos prioritários para pagamento de dívida;
- Contratos recebidos no web service para serem utilizados na pesagem;
- Contratos que consistem quantidade;
- Data de emissão do contrato;
- Contratos que consistem quantidade.
Dessa forma, é possível receber contratos no web service e no momento do peso líquido da pesagem podem não serem atendidos, pelo motivo do sistema ter atendido aos contratos mais prioritários. Essa mesma ordenação, com exclusão dos Contratos recebidos no web service para serem utilizados na pesagem, ocorrem na tela F435CCC caso realizado uma pesagem manual.
O identificador de regras CPR-435DOCTR01 pode alterar a ordenação padrão na busca pelos contratos, alterando o comportamento no web service e também na tela F435CCC para pesagens manuais.
Distribuição de notas x contratos - Pesagens para pessoas jurídica
A tentativa de distribuir as notas nos contratos se dará pela prioridade que os contratos foram vinculados a pesagem, vistos acima. Considerando a lista de contratos priorizandos pela ordem descrita, o sistema irá procurar, respeitando a ordem, um contrato que a nota recebida possa atender. Caso não encontrado o contrato, a nota será vinculada ao excedente de contratos (contrato 0) e o usuário poderá posteriormente, realizar ajustes na tela F435CCC.
Exemplo
É recebido na requisição para determinado fornecedor participante da pesagem, que deve ser utilizado o contrato 118 nesta pesagem. É verificado que ele possuí contratos que podem atender a pesagem seguindo os critérios de priorização, esses contratos ficariam vinculados a pesagem conforme a seguir:
| Contrato | Prioritário | Prioritário Pagamento Dívida | Consiste Quantidade | Saldo em aberto |
|---|---|---|---|---|
| 118 | Sim | Não | Sim | 500 |
| 117 | Sim | Não | Sim | 1000 |
| 119 | Não | Sim | Sim | 1000 |
| 105 | Não | Não | Sim | 1700 |
| 110 | Não | Não | Sim | 1600 |
Observe, o contrato 118 já é um contrato prioritário, assim como o 117. No entanto, como ele foi recebido na requisição para ser utilizado e já atende aos critérios de priorização, acaba sendo o primeiro a ser vinculado a pesagem.
Outro exemplo, utilizando a mesma requisição, mas considerando que o contrato 118 está parametrizado diferente:
| Contrato | Prioritário | Prioritário Pagamento Dívida | Consiste Quantidade | Saldo em aberto |
|---|---|---|---|---|
| 117 | Sim | Não | Sim | 1.000 |
| 119 | Não | Sim | Sim | 1.000 |
| 118 | Não | Não | Sim | 500 |
| 105 | Não | Não | Não | 1.700 |
| 110 | Não | Não | Sim | 1.600 |
Agora que o contrato 118 já não é mais prioritário, os contratos mais prioritários passam a frente dele e dentre os não prioritários, nesse grupo ele é prioritário por ter sido recebido na requisição.
Imagine um cenário, onde foi recebida na requisição do web service as notas 1, 2, 3 e 4, todas da série NFE para atender a carga e foi verificado no ERP (Gestão Empresarial | ERP) que elas tem a seguinte quantidade:
| Serie | Número | Quantidade |
|---|---|---|
| NFE | 1 | 1.500,00 |
| NFE | 2 | 1.700,00 |
| NFE | 3 | 2.000,00 |
| NFE | 4 | 500,00 |
A distribuição das notas com os contratos ficaria assim:
| Contrato | Prioritário | Prioritário pagamento dívida | Consiste quantidade | Saldo em aberto | Quantidade utilizada | Série | Número |
|---|---|---|---|---|---|---|---|
| 117 | Sim | Não | Sim | 1.000 | 500 | NFE | 4 |
| 119 | Não | Sim | Sim | 1.000 | |||
| 118 | Não | Não | Sim | 500 | |||
| 105 | Não | Não | Não | 1.700 | 1.500 + 1.700 + 2.000 = 5.200 | NFE | 1, 2, 3 |
| 110 | Não | Não | Sim | 1.600 |
A primeira da lista de notas é a de número 1, por ela ter 1.500 quilos e o contrato 117. Também como primeiro da lista de contratos, tem 1.000 quilos em aberto e consiste quantidade, não foi possível vincular a nota a ele pois passaria do saldo em aberto e o ERP (Gestão Empresarial | ERP) nesse momento, não consegue utilizar uma nota de pessoa jurídica para atender a dois contratos.
Diante disso, é percorrido os outros contratos da lista até encontrar um que a nota possa ser vinculada. Nesse caso, foi encontrado o contrato 105, embora ele tenha o saldo em aberto de 1.700 quilos, não consiste quantidade, portanto no momento que se tenta encontrar um contrato para as notas 1,2 e 3, elas acabam direcionadas para ele. Já no momento de vincular a nota 4, como ela tem 500 quilos, ela pode atender ao contrato 117, visto que ele tem 1.000 quilos em aberto.
Observação
Os cenários acima se preocuparam em demonstrar o vínculo da nota a respeito da parametrização de controle de saldo do contrato. No entanto, há mais uma avaliação que é feita antes de vincular a nota ao fornecedor participante do contrato. Caso no fornecedor participante do contrato verifique que tem definido um percentual para modalidade de compra imediata igual ou maior que 50%, assume-se que esse fornecedor participante dará entrada de 100%, como compra imediata (não é possível uma nota de pessoa jurídica ter dois CFOPS difentes) e com isso é verificado se o parâmetro global ConPreUni está habilitado, além da quantidade do contrato se o preço unitário do produto na nota é igual ao do contrato, do contrário a nota não é vinculada ao contrato.
Há informações que o sistema externo pode não ter, que são essenciais e que é possível via regra de negócio decidir qual seria essa informação. Um exemplo é a informação de depósito, um sistema de Gestão de Pátio não faz gestão dos depósito da empresa, no entanto, o ERP (Gestão Empresarial | ERP) sim, pois o depósito é uma informação crucial para um ticket de pesagem.
Com isso em mente, foi criado um identificador de regras CPR-115CPLIP01 que é executado exclusivamente pelo web service para que via regra seja possível informar ao ERP (Gestão Empresarial | ERP) informações que podem não vir na requisição do web service ou até mesmo substituir alguma informação recebida como parâmetro por outra desejada.
Importante
Ao inserir um Fornecedor Participante da Pesagem, além de buscar os contratos pelo fornecedor principal, serão buscados aqueles contratos que permitirem ser baixados por grupo de empresa/família e que participarem do mesmo grupo de empresa do fornecedor participante da pesagem.
Antes de processar a inclusão de um registro de pesagem, será validada as informações repetidas, como por exemplo: fornecedores participantes da carga, contratos dos fornecedores participantes, e notas para acobertar a carga. Encontrando informações repetidas, elas serão apagas, ficando com a informação apenas uma única vez.
Quando o identificador de regras CPR-435NMCTR01 estiver ativo, o contrato que for informado nos parâmetros do web service será o único contrato a ser considerado na pesagem.
Necessita autenticação: Sim.
Situação da versão: Atual.
Versão: 1.
Versão atual: 1.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
<soapenv:Body>
<ser:AtualizarPlacaPesagem>
<user>String</user>
<password>String</password>
<encryption>Integer</encryption>
<parameters>
<gridPesagens>
<ideExt>String</ideExt>
<novaPlaca>String</novaPlaca>
</gridPesagens>
</parameters>
</ser:AtualizarPlacaPesagem>
</soapenv:Body>
</soapenv:Envelope>
| Nome | Tipo | Preenchimento | Ajuda |
|---|---|---|---|
| gridPesagens | Set | Obrigatório | (Obrigatório) - Lista de pesagens |
| gridPesagens.ideExt | String | Opcional | (Obrigatório) - String(050) - Identificador de registro de sistema externo |
| gridPesagens.novaPlaca | String | Opcional | (Opcional) - String(010) - Placa no sistema externo |
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
<soapenv:Body>
<ser:AtualizarPlacaPesagemResponse>
<result>
<gridRetorno>
<tipoRetorno>Integer</tipoRetorno>
<ideExt>String</ideExt>
<gridItensRetorno>
<msgRetorno>String</msgRetorno>
</gridItensRetorno>
</gridRetorno>
<erroExecucao>String</erroExecucao>
</result>
</ser:AtualizarPlacaPesagemResponse>
</soapenv:Body>
</soapenv:Envelope>
| Nome | Tipo | Preenchimento | Ajuda |
|---|---|---|---|
| gridRetorno | Set | Opcional | Lista de retorno |
| gridRetorno.tipoRetorno | Integer | Opcional | (Obrigatório) - Número(001) - Tipo de Retorno de Processamento - Lista: 0 = Processado, -1 = Erro na Solicitação |
| gridRetorno.ideExt | Integer | Opcional | (Obrigatório) - String(050) - Identificador de registro de sistema externo |
| gridItensRetorno | Set | Opcional | Lista de mensagens de retorno |
| gridItensRetorno.msgRetorno | String | Opcional | (Obrigatório) - String(1000) - Mensagem de Retorno de Processamento |
| erroExecucao | String | Opcional |
Indica erros ocorridos no servidor ao executar o serviço, podendo conter os seguintes valores: Vazio ou nulo, indicando que a execução foi feita com sucesso; A mensagem do erro ocorrido no servidor. |
Na porta AlterarPesagem é possível receber e alterar as informações de pesagem do Ticket.
Somente será possível efetuar a alteração de informações das pesagens quando sua situação for igual a "1 - Digitada" ou "7 - Digitada Integração".
Necessita autenticação: Sim.
Situação da versão: Atual.
Versão: 1.
Versão atual: 1.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
<soapenv:Body>
<ser:AlterarPesagem>
<user>String</user>
<password>String</password>
<encryption>Integer</encryption>
<parameters>
<identificacaoSistema>String</identificacaoSistema>
<pesagem>
<codEmp>Integer</codEmp>
<codFil>Integer</codFil>
<datEnt>DateTime</datEnt>
<seqEnt>Integer</seqEnt>
<pesEnc>Double</pesEnc>
<pesEni>Double</pesEni>
<pesSac>Double</pesSac>
<pesSai>Double</pesSai>
</pesagem>
<produto>
<codEmp>Integer</codEmp>
<codFil>Integer</codFil>
<datEnt>DateTime</datEnt>
<seqEnt>Integer</seqEnt>
<seqPro>Integer</seqPro>
<obsPro>String</obsPro>
<qtdCal>Double</qtdCal>
<qtdInf>Double</qtdInf>
<bruCal>Double</bruCal>
<bruInf>Double</bruInf>
<liqCal>Double</liqCal>
<liqInf>Double</liqInf>
<qtdRec>Double</qtdRec>
<obsRec>String</obsRec>
<preUni>Double</preUni>
<perDsc>Double</perDsc>
</produto>
<classificacao>
<codEmp>Integer</codEmp>
<codFil>Integer</codFil>
<datEnt>DateTime</datEnt>
<seqEnt>Integer</seqEnt>
<seqPro>Integer</seqPro>
<codIcl>Integer</codIcl>
<tipIcl>String</tipIcl>
<perDsc>Double</perDsc>
<perDcl>Double</perDcl>
<qtdDsc>Double</qtdDsc>
<vphIni>Integer</vphIni>
<umiIni>Double</umiIni>
<umiFin>Double</umiFin>
<vlrMel>Integer</vlrMel>
<vphFin>Integer</vphFin>
<resAmo>Double</resAmo>
<pesAmo>Double</pesAmo>
</classificacao>
<cAQ>
<codEmp>Integer</codEmp>
<codFil>Integer</codFil>
<datEnt>DateTime</datEnt>
<seqEnt>Integer</seqEnt>
<temEns>Double</temEns>
<graInp>Double</graInp>
<temTan>Double</temTan>
<masEsp>Double</masEsp>
<capVei>Double</capVei>
<difEre>Double</difEre>
<volFat>Double</volFat>
<masE20>Double</masE20>
<fatRed>Double</fatRed>
<vol20g>Double</vol20g>
<conDut>Double</conDut>
<pH>Double</pH>
<aciDez>Double</aciDez>
<pisCar>String</pisCar>
<corCum>Double</corCum>
<polAri>Double</polAri>
<umiDa>Double</umiDa>
<pciNza>Double</pciNza>
<graCor>String</graCor>
<numCer>String</numCer>
<qtdLac>Integer</qtdLac>
<numLac>String</numLac>
<numTan>Integer</numTan>
</cAQ>
<lacres>
<codEmp>Integer</codEmp>
<codFil>Integer</codFil>
<datEnt>DateTime</datEnt>
<seqEnt>Integer</seqEnt>
<numAne>Double</numAne>
<numPfa>Integer</numPfa>
<numLcr>Integer</numLcr>
<sitReg>String</sitReg>
<obsLcr>String</obsLcr>
</lacres>
</parameters>
</ser:AlterarPesagem>
</soapenv:Body>
</soapenv:Envelope>
| Nome | Tipo | Preenchimento | Descrição |
|---|---|---|---|
| identificacaoSistema | String | Opcional | (Opcional) - String(15) - Sigla do Sistema de Integração |
| pesagem | Set | Opcional | Lista de controle de entrada e saída - Dados gerais |
| pesagem.codEmp | Integer | Opcional | Number(004) - Código da empresa |
| pesagem.codFil | Integer | Opcional | Number(005) - Código da filial |
| pesagem.datEnt | DateTime | Opcional | Date(DD/MM/YYYY) - Data da entrada |
| pesagem.seqEnt | Integer | Opcional | Number(006) - Sequência de entrada na data |
| pesagem.pesEnc | Double | Opcional | Number(014,5) - Peso registrado na entrada |
| pesagem.pesEni | Double | Opcional | Number(014,5) - Peso informado na entrada |
| pesagem.pesSac | Double | Opcional | Number(014,5) - Peso registrado na saída |
| pesagem.pesSai | Double | Opcional | Number(014,5) - Peso informado na saída |
| produto | Set | Opcional | Lista de controle de entrada e saída - Produtos/Derivação |
| produto.codEmp | Integer | Opcional | Number(004) - Código da empresa |
| produto.codFil | Integer | Opcional | Number(005) - Código da filial |
| produto.datEnt | DateTime | Opcional | Date(DD/MM/YYYY) - Data da entrada |
| produto.seqEnt | Integer | Opcional | Number(006) - Sequência de entrada na data |
| produto.seqPro | Integer | Opcional | Number(006) - Sequência de produto na data |
| produto.obsPro | String | Opcional | String(250) - Texto da observação do produto |
| produto.qtdCal | Double | Opcional | Number(014,5) - Quantidade do produto calculada |
| produto.qtdInf | Double | Opcional | Number(014,5) - Quantidade do produto Informada (Menos a Quantidade Desconto) |
| produto.bruCal | Double | Opcional | Number(014,5) - Peso bruto do produto calculado |
| produto.bruInf | Double | Opcional | Number(014,5) - Peso bruto do produto informado |
| produto.liqCal | Double | Opcional | Number(014,5) - Peso líquido do produto calculado |
| produto.liqInf | Double | Opcional | Number(014,5) - Peso líquido do produto Informado |
| produto.qtdRec | Double | Opcional | Number(014,5) - Quantidade do produto recebida pelo cliente |
| produto.obsRec | String | Opcional | String(250) - Texto da observação da quantidade recebida pelo cliente |
| produto.preUni | Double | Opcional | Number(021,10) - Preço unitário do item de produto |
| produto.perDsc | Double | Opcional | Number(005,2) - Percentual de desconto do item de produto |
| classificacao | Set | Opcional | Lista de controle de entrada e saída - Itens de classificação |
| classificacao.codEmp | Integer | Opcional | Number(004) - Código da empresa |
| classificacao.codFil | Integer | Opcional | Number(005) - Código da filial |
| classificacao.datEnt | DateTime | Opcional | Date(DD/MM/YYYY) - Data da entrada |
| classificacao.seqEnt | Integer | Opcional | Number(006) - Sequência de entrada na data |
| classificacao.seqPro | Integer | Opcional | Number(006) - Sequência de produto na data |
| classificacao.codIcl | Integer | Opcional | Number(004) - Código do item de classificação |
| classificacao.tipIcl | String | Opcional | String(001) - Tipo do recebimento da classificação - [ E=Empresa;C=Cliente ] |
| classificacao.perDsc | Double | Opcional | Number(010,4) - Percentual de desconto do item de produto informado |
| classificacao.perDcl | Double | Opcional | Number(010,4) - Percentual de desconto encontrado na classificação |
| classificacao.qtdDsc | Double | Opcional | Number(014,5) - Quantidade de desconto do item de produto informado |
| classificacao.vphIni | Integer | Opcional | Number(004) - Valor PH Inicial |
| classificacao.umiIni | Double | Opcional | Number(007,4) - Umidade Inicial |
| classificacao.umiFin | Double | Opcional | Number(007,4) - Umidade Final |
| classificacao.vlrMel | Integer | Opcional | Number(004) - Valor Melhoria PH |
| classificacao.vphFin | Integer | Opcional | Number(004) - Valor PH Final |
| classificacao.resAmo | Double | Opcional | Number(014,5) - Resultado da Amostra |
| classificacao.pesAmo | Double | Opcional | Number(014,5) - Peso da Amostra |
| cAQ | Set | Opcional | Lista de campos com informações do certificado de análise do produto |
| cAQ.codEmp | Integer | Opcional | Number(004) - Código da empresa |
| cAQ.codFil | Integer | Opcional | Number(005) - Código da filial |
| cAQ.datEnt | DateTime | Opcional | Date(DD/MM/YYYY) - Data da entrada |
| cAQ.seqEnt | Integer | Opcional | Number(006) - Sequência de entrada na data |
| cAQ.temEns | Double | Opcional | Number(014,5) - Temperatura do Ensaio |
| cAQ.graInp | Double | Opcional | Number(014,5) - Grau INPM |
| cAQ.temTan | Double | Opcional | Number(014,5) - Temperatura do Tanque V |
| cAQ.masEsp | Double | Opcional | Number(014,5) - Massa Esp/Temp. Ens |
| cAQ.capVei | Double | Opcional | Number(014,5) - Cap Veículo |
| cAQ.difEre | Double | Opcional | Number(014,5) - Diferença |
| cAQ.volFat | Double | Opcional | Number(014,5) - Vol Fat. |
| cAQ.masE20 | Double | Opcional | Number(014,5) - Massa Esp. 20 |
| cAQ.fatRed | Double | Opcional | Number(014,5) - Fator Red. Volume |
| cAQ.vol20g | Double | Opcional | Number(014,5) - Volume 20C |
| cAQ.conDut | Double | Opcional | Number(014,5) - Condutividade |
| cAQ.pH | Double | Opcional | Number(014,5) - PH |
| cAQ.aciDez | Double | Opcional | Number(014,5) - Acidez |
| cAQ.pisCar | String | Opcional | String(001) - Pista Carreg. Concretada |
| cAQ.corCum | Double | Opcional | Number(014,5) - Cor (Cuma) |
| cAQ.polAri | Double | Opcional | Number(014,5) - Polarização (OS) |
| cAQ.umiDa | Double | Opcional | Number(014,5) - USU Umida |
| cAQ.pciNza | Double | Opcional | Number(014,5) - Cinza (%) |
| cAQ.graCor | String | Opcional | Number(002) - Grau de Correção |
| cAQ.numCer | String | Opcional | String(020) - Certificado Álcool |
| cAQ.qtdLac | Integer | Opcional | Number(003) - Quantidade de Lacres |
| cAQ.nunLac | String | Opcional | String(600) - Número do Lacre |
| cAQ.nunTan | Integer | Opcional | Number(003) - Número do Tanque |
| lacres | Set | Opcional | Lista de campos com informações do controle de lacres |
| lacres.codEmp | Integer | Opcional | Number(004) - Código da empresa |
| lacres.codFil | Integer | Opcional | Number(005) - Código da filial |
| lacres.datEnt | DateTime | Opcional | Date(DD/MM/YYYY) - Data da entrada |
| lacres.seqEnt | Integer | Opcional | Number(006) - Sequência de entrada na data |
| lacres.numAne | Double | Opcional | Number(012) - Número da análise de embarque |
| lacres.numPfa | Integer | Opcional | Number(009) - Número da pré-fatura |
| lacres.numLcr | Integer | Opcional | Number(009) - Número do lacre que será entregue com a carga |
| lacres.sitReg | String | Opcional | String(001) - Situação do registro - [ A=Ativo;I=Inativo ] |
| lacres.obsLcr | String | Opcional | String(250) - Observação dos controles de lacre |
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
<soapenv:Body>
<ser:AlterarPesagemResponse>
<result>
<gridErros>
<msgErr>String</msgErr>
</gridErros>
<tipoRetorno>Integer</tipoRetorno>
<mensagemRetorno>String</mensagemRetorno>
<finalizaramRegistros>String</finalizaramRegistros>
<numeroLote>Integer</numeroLote>
<erroExecucao>String</erroExecucao>
</result>
</ser:AlterarPesagemResponse>
</soapenv:Body>
</soapenv:Envelope>
| Nome | Tipo | Preenchimento | Descrição |
|---|---|---|---|
| gridErros | Set | Opcional | (Opcional) - Lista dos erro |
| gridErros.msgErr | String | Opcional | (Opcional) - Itens da lista de erros |
| tipoRetorno | Integer | Opcional | (Opcional) - Number(001) - Tipo de Retorno de Processamento - Lista: 1 = Processado, 2 = Erro na Solicitação |
| mensagemRetorno | String | Opcional | (Opcional) - String(1000) - Mensagem de Retorno de Processamento |
| finalizaramRegistros | String | Opcional | (Opcional) - String(001) - Indicativo se existem mais informações a serem solicitadas - Lista: S = Sim, N = Não |
| numeroLote | Integer | Opcional | (Opcional) - Integer - Identificação do Lote de Exportação |
| erroExecucao | String | Opcional | Indica erros ocorridos no servidor ao executar o serviço, podendo conter os seguintes valores: Vazio ou nulo, indicando que a execução foi feita com sucesso; A mensagem do erro ocorrido no servidor. |
English
Español
English
Español


