English
Español
Web service Com.senior.g5.co.mcm.ven.manualpedidos
Quando a chamada do identificador de regra VEN-135QTATE01 tiver como origem este web service, porta AtenderManualPedidos, a variável VSTelaOrigem terá o valor igual a WEB. Também estarão disponíveis as variáveis VSNumAne e VSNumPFa contendo, respectivamente, o número da análise/carga e o número da pré-fatura. Quando a chamada do web service for por meio da tela F135APM, a variável VSTelaOrigem terá valor igual a F135APM.
- A fim de diminuir a probabilidade de um pedido ser utilizado indevidamente na geração de duas pré-faturas e, assim, reduzir o risco de problemas envolvendo multiusuários, utilize o Identificador de Regras VEN-135LCKPD02.
- Caso seja necessário que os campos abaixo sejam herdados do pedido/ou web-service para a pré-fatura inserida em uma carga, utilize o identificador de regra VEN-135TRPED02.
CodTra: Código da transportadora;
CodVia: Código da via de transportes;
PlaVei: Placa do veículo;
TraMtr: Código da transportadora do motorista;
CodMtr: Código do motorista.
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.
Campos que representam valores monetários, quantidade e percentual e estão declarados como String
- 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
Exemplo:
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.
Campos que representam valores monetários, quantidade e percentual e não estão declarados como String
- 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
Exemplo:
- 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://example.com/g5-senior-services/sapiens_Synccom_senior_g5_co_mcm_ven_manualpedidos?wsdl
- Assíncrono: http://example.com/g5-senior-services/sapiens_Asynccom_senior_g5_co_mcm_ven_manualpedidos?wsdl
- Agendado: http://example.com/g5-senior-services/sapiens_Scheduledcom_senior_g5_co_mcm_ven_manualpedidos?wsdl
Porta
AtenderManualPedidos_2
Mercado - Gestão de Faturamento e Outras Saídas - Notas Fiscais de Saída - Atendimento Manual de Pedidos
Nota
Para que seja gerado um novo número de análise de embarque a cada vez que este web service for executado, o parâmetro dinâmico FILIAL.ANALISEEMBARQUE.NOVONUMEROPOREXECUCAO deve estar definido como "S - Sim".
Necessita autenticação: Sim
Situação de versão: Atual
Versão: 2
Classe do sistema ERP que implementa a porta do web service: TSr135Apm.
Requisição:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
<soapenv:Body>
<ser:AtenderManualPedidos>
<user>String</user>
<password>String</password>
<encryption>Integer</encryption>
<parameters>
<dadosGerais>
<codEmp>String</codEmp>
<codFil>String</codFil>
<cnpjFil>String</cnpjFil>
<numAne>String</numAne>
<numPfa>String</numPfa>
<datAge>String</datAge>
<numPed>String</numPed>
<codCli>String</codCli>
<codTra>String</codTra>
<plaVei>String</plaVei>
<somFre>String</somFre>
<cifFob>String</cifFob>
<anaPep>String</anaPep>
<ateTot>String</ateTot>
<fatGre>String</fatGre>
<gerBlo>String</gerBlo>
<sExceptionMsg>String</sExceptionMsg>
<filPed>Integer</filPed>
</dadosGerais>
</parameters>
</ser:AtenderManualPedidos>
</soapenv:Body>
</soapenv:Envelope>
Parâmetros da requisição:
| Nome | Tipo | Descrição |
|---|---|---|
| dadosGerais | Set | |
| dadosGerais.codEmp | String | (Obrigatório) - Number(004) -Código da Empresa |
| dadosGerais.codFil | String | (Obrigatório) - Number(005) - Código da Filial. O campo codfil é o campo da filial de faturamento, de forma que é possível gerar uma pré-fatura na filial 1, utilizando um pedido da filial 2. |
| dadosGerais.cnpjFil | String | (Opcional) - Number(015) - CNPJ da Filial |
| dadosGerais.numAne | String | (Obrigatório) - Number(012) - Número da Análise de Embarque |
| dadosGerais.numPfa | String | (Obrigatório) - Number(009) - Número da Pré-Fatura |
| dadosGerais.datAge | String | (Opcional) - Date(000) - Data Agendamento Entrega |
| dadosGerais.numPed | String | (Obrigatório) - Number(008) - Número do Pedido |
| dadosGerais.codCli | String | (Opcional) - Number(009) - Código do Cliente. Permite faturar um pedido de um cliente para outro cliente. Exemplo: Pedido 1, da filial 1, está atrelado ao cliente 100. Será possível faturá-lo para a porta 2. |
| dadosGerais.codTra | String | (Obrigatório) - Number(009) - Código da Transportadora |
| dadosGerais.plaVei | String | (Obrigatório) - String(010) - Placa do Veículo que irá transportar |
| dadosGerais.somFre | String | (Opcional) - String(001) - Soma Frete Líquido - Lista: S = Sim, N = Não |
| dadosGerais.cifFob | String | (Opcional) - String(001) - Frete CIF/FOB - Lista: C = Por conta do emitente, F = Por conta do destinatário, T = Por conta de terceiros, X = Sem frete |
| dadosGerais.anaPep | String | (Opcional) - String(001) - Atender itens de pedido em preparação. |
| dadosGerais.ateTot | String | (Opcional) - String(001) - Somente atender pedido se todos os itens forem pré-faturados. |
| dadosGerais.fatGre | String | (Opcional) - String(001) - Faturar Grupo de Empresas |
| dadosGerais.gerBlo | String | (Opcional) - String(001) - Gerar pré-fatura bloqueada quando houver análise de crédito. Opções (S-Sim/N-Não) por padrão o sistema assumirá "N-Não". |
| dadosGerais.sExceptionMsg | String | |
| dadosGerais.filPed | Integer | Código da filial do pedido. Se o campo filial do pedido estiver preenchido, o sistema procurará o pedido na filial informada neste campo. Caso não esteja preenchido, o pedido será procurado a partir do campo codFil. |
Resposta:
Observação
Envelope SOAP de resposta de requisições síncronas. Para requisições assíncronas ou agendamentos, a resposta é apenas uma String chamada "result" com o valor "OK", se foi executado com sucesso ou, caso contrário, a mensagem do erro ocorrido.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
<soapenv:Body>
<ser:AtenderManualPedidosResponse>
<result>
<retornosPfa>
<codEmp>Integer</codEmp>
<codFil>Integer</codFil>
<numAne>Double</numAne>
<numPfa>Integer</numPfa>
<numPed>Integer</numPed>
<codCli>Integer</codCli>
<retorno>String</retorno>
</retornosPfa>
<erroExecucao>String</erroExecucao>
</result>
</ser:AtenderManualPedidosResponse>
</soapenv:Body>
</soapenv:Envelope>
Atributos da resposta:
| Nome | Tipo | Descrição |
|---|---|---|
| erroExecucao | String | 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 sucessoA mensagem do erro ocorrido no servidorSó impede a gravação quando o retorno.tipRet for igual a "2" |
| retornosPfa | Set | |
| retornosPfa.codEmp | Integer | |
| retornosPfa.codFil | Integer | |
| retornosPfa.numAne | Double | |
| retornosPfa.numPfa | Integer | |
| retornosPfa.numPed | Integer | |
| retornosPfa.codCli | Integer | |
| retornosPfa.retorno | String |
English
Español
