Web service Com.senior.g5.co.mcm.ven.analiseembarque

Segue uma descrição do contexto/processo em que a utilização deste web service está inserida. Também apresenta outros web services a serem chamados, mas não se limita apenas a isso.

Em um contexto de entrega futura pelo CD:

1 - O processo dentro do ERP começa somente após a conclusão de todo o processo de venda de mercadoria, o que significa que devem ter sido realizadas as seguintes etapas:
1.1 - A importação do pedido pelo web service com.senior.g5.co.int.varejo.pedido, porta GravarPedidosVarejo.
1.2 - A solicitação do retorno da integração pelo web service com.senior.g5.co.int.varejo.RetornoIntegracao, porta Exportar, de modo que o sistema terceiro tenha as informações do pedido.
1.3 - A importação da nota autorizada através do web service com.senior.g5.co.int.varejo.NotaAutorizada, porta ImportarNotaAutorizada.
1.4 - A solicitação do retorno da integração pelo web service com.senior.g5.co.int.varejo.RetornoIntegracao, porta Exportar, de maneira que o sistema terceiro tenha as informações da nota fiscal.
1.5 - A importação da entrega pelo web service com.senior.g5.co.int.varejo.entrega, porta Importar, para importar as informações de entrega.
1.6 - A execução do web service com.senior.g5.co.int.varejo.RetornoIntegracao, porta Exportar, disponibilizando as informações da entrega integrada ao ERP.

2 - Neste momento do processo, nas tabelas do ERP, teremos os seguintes artefatos: a nota fiscal de saída de simples faturamento, o pedido e os itens de entrega. A ligação entre as tabelas, partindo da nota fiscal de simples faturamento até a entrega, ocorre da seguinte forma:
2.1 - A ligação entre os itens da nota fiscal (E140IPV) e os itens de pedido (E120IPD) é feita nos itens de pedido da seguinte maneira: E120IPD.FILNCO = E140IPV.CODFIL, E120IPD.SNFNCO = E140IPV.CODSNF, E120IPD.NUMNCO = E140IPV.NUMNFV;
2.2 - A ligação entre os itens de pedido (E120IPD) e os itens de entrega (E147ITE) ocorre nos itens da entrega da seguinte forma: E147ITE.EMPPED = E120IPD.CODEMP, E147ITE.FILPED = E120IPD.CODFIL, E147ITE. NUMPED = E120IPD.NUMPED AND E147ITE.SEQIPD = E120IPD.SEQIPD;
2.3 - A ligação entre os itens da entrega (E147ITE) e a entrega (E147ENT) é feita pelo vínculo dos campos E147ITE.IDEENT = E147ENT.IDEUNI.

3 - A entrega, neste momento, deve estar com a situação "1 - Aberta".
4 - Logar no ERP na filial que é o CD. Vale ressaltar que estamos tratando do processo de entrega futura CD.
5 - Acessar a tela Formação de Cargas (via Pedidos) (F135FCP) e efetuar a formação da carga. Esta ação gerará registros nas tabelas Vendas - Análise de embarque - Pré-faturas (E135PFA) e Vendas - Análise de embarque - Itens de produto e serviço (E135PES).
6 - Dentro do ERP, deve ser acessada a tela Agrupado e Entrega Via CD (F149ECD), onde será emitida a nota de transferência. Deve-se observar que a opção "Entregas futura com NF transf. já emitidas" esteja desmarcada.
7 - Após a autorização dessa nota, novamente na tela Agrupado e Entrega Via CD (F149ECD), deverá ser emitida a nota de remessa. Neste momento, é importante verificar se a opção "Entregas futuras com NF transf. já emitidas" está marcada.
8 - Após a emissão da nota de remessa, a situação da entrega e do item será alterada para "3 - Entregue". Esta informação é exportada pelo web service com.senior.g5.co.int.varejo.entrega, porta Exportar.

• 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.

• 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.

Mercado - Gestão de Faturamento e Outras Saídas - Notas Fiscais de Saída - Atendimento Pré-faturas.

Necessita autenticação: sim.

Situação de versão: atual.

Versão: 1.

Classe do sistema ERP que implementa a porta do web service: TSr135AnaliseEmbarque.

Requisição:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:ExecutarAnalise>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <criAne>Integer</criAne>
        <entIni>DateTime</entIni>
        <abgCrp>String</abgCrp>
        <fatIni>DateTime</fatIni>
        <codEmp>Integer</codEmp>
        <criSpd>Integer</criSpd>
        <entFim>DateTime</entFim>
        <emiIni>DateTime</emiIni>
        <fatFim>DateTime</fatFim>
        <codFil>Integer</codFil>
        <criSp2>Integer</criSp2>
        <abgPed>String</abgPed>
        <emiFim>DateTime</emiFim>
        <criSp3>Integer</criSp3>
        <abgTns>String</abgTns>
        <abgRep>String</abgRep>
        <criSp4>Integer</criSp4>
        <abgCpg>String</abgCpg>
        <abgTra>String</abgTra>
        <obsAne>String</obsAne>
        <abgGre>String</abgGre>
        <abgPor>String</abgPor>
        <venVmn>Double</venVmn>
        <abgCli>String</abgCli>
        <abgOri>String</abgOri>
        <recVmt>Double</recVmt>
        <abgCat>String</abgCat>
        <abgFam>String</abgFam>
        <perMpe>Double</perMpe>
        <abgRam>String</abgRam>
        <abgPro>String</abgPro>
        <qtdMpe>Double</qtdMpe>
        <abgRoe>String</abgRoe>
        <abgDep>String</abgDep>
        <perCan>Double</perCan>
        <abgSro>String</abgSro>
        <abgPrd>String</abgPrd>
        <ratEst>String</ratEst>
        <abgUfs>String</abgUfs>
        <abgFab>String</abgFab>
        <gerPfb>String</gerPfb>
        <abgRve>String</abgRve>
        <abgFor>String</abgFor>
        <excPfv>String</excPfv>
        <abgFil>String</abgFil>
        <negAbg>String</negAbg>
        <conVmt>String</conVmt>
        <tnsLin>String</tnsLin>
        <anaDep>String</anaDep>
        <anaPep>String</anaPep>
        <mulFil>String</mulFil>
        <conMin>String</conMin>
      </parameters>
    </ser:ExecutarAnalise>
  </soapenv:Body>
</soapenv:Envelope>

Parâmetros da requisição:

Nome	Tipo	Descrição
criAne	Integer	Critério de análise.
entIni	DateTime
abgCrp	String	Abrangência de grupo receber.
fatIni	DateTime	Previsão de faturamento inicial
codEmp	Integer	Código da empresa.
criSpd	Integer	Primeiro critério de seleção de pedidos.
entFim	DateTime
emiIni	DateTime	Data de emissão inicial.
fatFim	DateTime	Previsão de faturamento final
codFil	Integer	Código da filial.
criSp2	Integer	Segundo critério de seleção de pedidos.
abgPed	String	Abrangência de pedidos.
emiFim	DateTime	Data de emissão final.
criSp3	Integer	Terceiro critério de seleção de pedidos.
abgTns	String	Abrangência de transações.
abgRep	String	Abrangência de representantes.
criSp4	Integer	Quarto critério de seleção de pedidos.
abgCpg	String	Abrangência de condições de pagamento.
abgTra	String	Abrangência de transportadoras.
obsAne	String	Observações.
abgGre	String	Abrangência de grupos de clientes.
abgPor	String	Abrangência de portador.
venVmn	Double	Valor mínimo para nota fiscal.
abgCli	String	Abrangência de clientes.
abgOri	String	Abrangência de origem de produto.
recVmt	Double	Valor mínimo para título.
abgCat	String	Abrangência de categoria de clientes.
abgFam	String	Abrangência de família de produto.
perMpe	Double	Percentual mínimo do pedido em estoque.
abgRam	String
abgPro	String	Abrangência de produtos.
qtdMpe	Double	Quantidade mínima do pedido em estoque.
abgRoe	String	Abrangência de rotas de entrega.
abgDep	String	Abrangência de depósitos.
perCan	Double	Percentual de pedidos sem estoque a cancelar.
abgSro	String	Abrangência de sub-rotas de entrega.
abgPrd	String	Abrangência de rel. produção (lote).
ratEst	String	Distribui estoque.
abgUfs	String	Abrangência de UF.
abgFab	String	Abrangência de fabricantes.
gerPfb	String	Gera pré-fatura bloqueada.
abgRve	String	Abrangência de região de venda.
abgFor	String	Abrangência de fornecedores.
excPfv	String	Cancelar Pré-Faturas vencidas.
abgFil	String	Abrangência de filiais. Somente se a opção Gerar Análise Multi-Filial estiver selecionada.
negAbg	String	Negação das abrangências.
conVmt	String	Consistir Valor Mínimo dos Títulos.
tnsLin	String	Gravar a cada Pré-Fatura
anaDep	String	Analisar Outros Depósitos
anaPep	String	Analisar Pedidos em Preparação
mulFil	String	Gerar Análise Multi-Filial
conMin	String	Considerar Mínimos Reposição

Observação sobre o campo negAbg

Para informar a negação de algum filtro no campo é necessário que informe o número “1” (em forma numérica).

Qualquer outro valor informado será considerado como falso, ou seja, não será negado o campo. Ao todo temos 25 campos que podem ser negados.

Abaixo seguem as posições referentes a cada filtro dentro do campo de negação:

Posições

• Posição 1 - Campo: DatEnt (Data Entrega)
• Posição 2 - Campo: DatEmi (Data Emissão)
• Posição 3 - Campo: AbgPed (Abrangência de Pedido)
• Posição 4 - Campo: AbgTns (Abrangência de Transação)
• Posição 5 - Campo: AbgCpg (Abrangência de Condição Pgto)
• Posição 6 - Campo: AbgGre (Abrangência de Grupo Cliente)
• Posição 7 - Campo: AbgCli (Abrangência de Cliente)
• Posição 8 - Campo: AbgCat (Abrangência de Categoria Cliente)
• Posição 9 - Campo: AbgRam (Abrangência de Ramo Atividade)
• Posição 10 - Campo: AbgRoe (Abrangência de Ramo Entrega)
• Posição 11 - Campo: AbgUfs (Abrangência de Estado)
• Posição 12 - Campo: AbgRve (Abrangência de Região Venda)
• Posição 13 - Campo: AbgCrp (Abrangência de Grupo Receber)
• Posição 14 - Campo: AbgRep (Abrangência de Representante)
• Posição 15 - Campo: AbgTra (Abrangência de Transportadora)
• Posição 16 - Campo: AbgPor (Abrangência de Portador)
• Posição 17 - Campo: AbgOri (Abrangência de Origem)
• Posição 18 - Campo: AbgFam (Abrangência de Família)
• Posição 19 - Campo: AbgPro (Abrangência de Produto)
• Posição 20 - Campo: AbgDep (Abrangência de Depósito)
• Posição 21 - Campo: AbgPrd (Abrangência de Produção)
• Posição 22 - Campo: AbgFab (Abrangência de Fabricante)
• Posição 23 - Campo: AbgFor (Abrangência de Fornecedor)
• Posição 24 - Campo: AbgSro (Abrangência de Sub-Rota)
• Posição 25 - Campo: AbgFil (Abrangência de Filial)

Exemplo de uso do campo de negação para negar o filtro do campo Família:

Campo: Negação Abrangência

Valor: 0000000000000000010000000

O número “1” na posição “18” dentro do campo de negação de abrangência, indica que deve ser negado o filtro do campo

“Família”.

Exemplo de uso do campo de negação para negar o filtros dos campos de Pedido e Filial:

Campo: Negação Abrangência

Valor: 0010000000000000000000001

O número “1” na posição “3” dentro do campo de negação de abrangência, indica que deve ser negado o filtro do campo “Pedido”.

O número “1” na posição “25” dentro do campo de negação de abrangência, indica que deve ser negado o filtro do campo “Filial”

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:ExecutarAnaliseResponse>
      <result>
        <logAne>String</logAne>
        <erroExecucao>String</erroExecucao>
      </result>
    </ser:ExecutarAnaliseResponse>
  </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"
logAne	String	Resultado do processo.