Exibir código-fonte para Integração com WMS da Próton

Este artigo descreve a integração com o WMS da Próton.

== Pedido de Reposição ==

=== Processo ===

* No Backoffice, usuário registra Pedido de Reposição;
* No Backoffice, supervisor autoriza o pedido;
* Próton executa função CriaSeparacaoReposicao;
* Próton lê separação na view TV_ESEP;
* Processo de separação pelo WMS é realizado;
* Próton insere separação na tabela TI_SEP;
* Middleware de tempos-em-tempos processa as separações da TI_SEP;
* No CheckOut, usuário emite NF de Pedido de Reposição baseado na separação;
* Próton lê nota na view TV_EVEN;
* Processo de entrega pelo WMS é realizado.

Observações:<br/>
Existe possibilidade do pedido ser cancelado ou desautorizado após já ter separações criadas. Neste caso, a função CriaSeparacaoReposicao irá cancelar as separações.<br/>
Ou seja, ao receber a separação na TI_SEP, sistema apresentará um erro no processamento do registro.<br/>
O usuário deverá desfazer o processo no WMS manualmente.<br/>
Sistema não permitirá o cancelamento de separações que já vieram pela TI_SEP, ou seja, que já estão separadas ou em falta.

=== Criar Separações ===

<syntaxhighlight lang="SQL">
SELECT CriaSeparacaoReposicao(<Filial>, <Número de Dias>)
</syntaxhighlight>

Parâmetros:
Filial: Filial onde foi registrado o pedido. Se mandar NULL vai processar todas as filiais.<br/>
Número de Dias: Número de dias pretéritos que serão considerados para encontrar pedidos. Se mandar NULL serão considerados 7 dias apenas.

=== Disponibilização de Dados ===

Condições que a Próton deve usar para obter as separações deste processo:

<syntaxhighlight lang="SQL">
SELECT *
  FROM TV_ESEP
 WHERE SEP_ORIGEM = 'P'
    AND SEP_FLGEST = 'A'
</syntaxhighlight>

=== Retorno de Dados ===

Como a Próton deve mandar o registro na TI_SEP:
* CODFIL -> Deve devolver o dado que puxou da view TV_ESEP no campo SEP_CODFIL;
* SEQUEN -> Deve devolver o dado que puxou da view TV_ESEP no campo SEP_SEQUEN;
* DATCRI -> Data e hora atuais;
* CONTEM -> Quantidade separada (pode ser menor ou igual a SEP_QTDSEP da view);
* QTDFAL -> Quantidade em falta (pode ser menor ou igual a SEP_QTDSEP da view).

Observações:<br/>
A soma de CONTEM e QTDFAL nunca pode ultrapassar SEP_QTDSEP da view.

=== Alteração em Separações ===

Depois que a Próton mandar as separações, elas estarão disponíveis na view de integração até que o usuário emita a NF.<br/>
Com isso, pode-se fazer separações incrementais, ou alteração nas separações.<br/>
Nesses casos, a quantidade a separar é limitada a quantidade que foi separada anteriormente.

<syntaxhighlight lang="SQL">
SELECT *
  FROM TV_ESEP
 WHERE SEP_ORIGEM = 'P'
  AND SEP_FLGEST IN ('P','F')
</syntaxhighlight>

== Entrega pela Loja ==

Processo:
-> No Order, usuário registra um orçamento com tipo de entrega Loja Entrega Sem Televendas;
-> No CheckOut, usuário resgata o orçamento e emite a Fatura;
-> Próton executa função CRIA_SEPARACAO_FULL('T');
-> Próton lê separação na view TV_ESEP;
-> Processo de WMS é realizado;
-> Próton insere romaneio na tabela TI_ROM;
-> Próton insere separação na tabela TI_SEP;
-> Próton fecha romaneio na tabela TI_ROM quando todas as separações da carga foram incluídas;
-> Middleware de tempos-em-tempos processa os romaneios da TI_ROM;
-> Middleware de tempos-em-tempos processa as separações da TI_SEP;
-> No CheckOut, usuário utiliza Impressão em Grupo para gerar a Remessa da carga informada.
-> Próton lê nota na view TV_EVEN;
-> Processo de entrega pelo WMS é realizado.

Observações:
Apesar de serem processos bem diferentes no Totall Commerce, não há diferença na integração para os tipos de entrega pela loja:
- Loja Entrega sem Televendas;
- Entrega Futura;
- Venda Sob Encomenda sem Televendas.

Função para Criar Separações:
SELECT CRIA_SEPARACAO_FULL(<Processa Devoluções de Separação>)

Parâmetros:
Processa Devoluções de Separação: "T" ou "F". Enviar "T" se quiser que a procedure confira notas canceladas ou devolvidas para gerar separações com situação "Devolver". Essas separações já estavam "Separadas" e vinculadas a algum romaneio. De "Devolver", a situação da separação só pode ser alterada para "Cancelado".

Disponibilização de Dados da Separação:
Condições que a Próton deve usar para obter as separações deste processo:
SELECT *
  FROM TV_ESEP
 WHERE SEP_ORIGEM = 'V'
    AND SEP_FLGEST = 'A'
    AND SEP_TIPENT IN ('2','5','7')

Disponibilização de Dados do Motorista:
Condições que a Próton deve usar para obter os dados de motorista:
SELECT *
  from TV_EPAR
 where TIPCLI7 = 'T'

Retorno de Dados do Romaneio:
Como a Próton deve mandar o registro na TI_ROM:
CODFIL -> Filial do processo;
CODEXT -> Identificador único da carga no sistema da Próton;
DATCRI -> Data e hora atuais;
FILMOT -> Utilizar FILCLI obtido na TV_EPAR;
CODMOT -> Utilizar CODCLI obtido na TV_EPAR;
PLACA -> Informar placa do veículo;
FLGEST -> "A".

Retorno de Dados da Separação:
Como a Próton deve mandar o registro na TI_SEP:
CODFIL -> Deve devolver o dado que puxou da view TV_ESEP no campo SEP_CODFIL;
SEQUEN -> Deve devolver o dado que puxou da view TV_ESEP no campo SEP_SEQUEN;
DATCRI -> Data e hora atuais;
CONTEM -> Quantidade separada (pode ser menor ou igual a SEP_QTDSEP da view);
QTDFAL -> Quantidade em falta (pode ser menor ou igual a SEP_QTDSEP da view);
ROM_CODEXT -> Identificador único da carga no sistema da Próton.

Observações:
A soma de CONTEM e QTDFAL nunca pode ultrapassar SEP_QTDSEP da view.

Retorno de Fechamento do Romaneio:
Como a Próton deve mandar o registro na TI_ROM:
CODFIL -> Filial do processo;
CODEXT -> Identificador único da carga no sistema da Próton;
DATCRI -> Data e hora atuais;
FILMOT -> Informar mesmo FILCLI informado anteriormente;
CODMOT -> Informar mesmo CODCLI informado anteriormente;
PLACA -> Informar mesma placa do veículo informada anteriormente;
FLGEST -> "F".

Observação:
Só mandar o fechamento do romaneio, depois de ter certeza de que todos os itens da separação foram processados.

SELECT COUNT(*)
  FROM TI_SEP
 WHERE STATUS = 0
  AND ROM_CODEXT = <Identificador único da carga no sistema da Próton>

Alteração em Separações:
Antes que a carga esteja fechada, é possível realizar alterações nas quantidades separadas ou em falta.
SELECT *
  FROM TV_ESEP
 WHERE SEP_ORIGEM = 'V'
  AND SEP_FLGEST IN ('P','F')

== Entrega com Televendas ==

Processo:
-> No Order, usuário registra um orçamento com tipo de entrega Loja Entrega Com Televendas;
-> Próton executa função CRIA_SEPARACAO_FULL('T');
-> Próton lê separação na view TV_ESEP;
-> Processo de WMS é realizado;
-> Próton insere romaneio na tabela TI_ROM;
-> Próton insere separação na tabela TI_SEP;
-> Próton fecha romaneio na tabela TI_ROM quando todas as separações da carga foram incluídas;
-> Middleware de tempos-em-tempos processa os romaneios da TI_ROM;
-> Middleware de tempos-em-tempos processa as separações da TI_SEP;
-> No CheckOut, usuário utiliza Impressão em Grupo para gerar uma nota completa da carga informada.
-> Próton lê nota na view TV_EVEN;
-> Processo de entrega pelo WMS é realizado.

Observações:
Apesar de serem processos bem diferentes no Totall Commerce, não há diferença na integração para os tipos de entrega pela loja:
- Loja Entrega com Televendas;
- Venda Sob Encomenda com Televendas.

Função para Criar Separações:
Idem Entrega pela Loja.

Disponibilização de Dados da Separação:
Condições que a Próton deve usar para obter as separações deste processo:
SELECT *
  FROM TV_ESEP
 WHERE SEP_ORIGEM = 'O'
    AND SEP_FLGEST = 'A'
    AND SEP_TIPENT IN ('2','7')

Disponibilização de Dados do Motorista:
Idem Entrega pela Loja.

Retorno de Dados do Romaneio:
Idem Entrega pela Loja.

Retorno de Dados da Separação:
Idem Entrega pela Loja.

Retorno de Fechamento do Romaneio:
Idem Entrega pela Loja.

Alteração em Separações:
Antes que a carga esteja fechada, é possível realizar alterações nas quantidades separadas ou em falta.
SELECT *
  FROM TV_ESEP
 WHERE SEP_ORIGEM = 'O'
  AND SEP_FLGEST IN ('P','F')
    AND SEP_TIPENT IN ('2','7')

== Retira no Depósito ==

Processo:
-> No Order, usuário registra um orçamento com tipo de entrega Retira no Depósito;
-> No CheckOut, usuário resgata o orçamento e emite a Fatura;
-> Próton executa função CRIA_SEPARACAO_FULL('T');
-> Próton lê separação na view TV_ESEP;
-> Processo de WMS é realizado;
-> Próton insere separação na tabela TI_SEP;
-> Middleware de tempos-em-tempos processa as separações da TI_SEP;
-> No CheckOut, usuário utiliza Emissão de Nota Vinculada para gerar a Remessa da carga informada.

Função para Criar Separações:
Idem Entrega pela Loja.

Disponibilização de Dados da Separação:
Condições que a Próton deve usar para obter as separações deste processo:
SELECT *
  FROM TV_ESEP
 WHERE SEP_ORIGEM = 'V'
    AND SEP_FLGEST = 'A'
    AND SEP_TIPENT = '3'

Retorno de Dados da Separação:
Idem Entrega pela Loja.

== Dados para Entrega ==

As notas de Pedido de Reposição e Remessa deve ser consultada na TV_EVEN, juntamente com seus itens na TV_EIVE para obtenção dos produtos que deverão ser entregues.
Bem como, endereço, caso seja necessário.
É preciso distinguir essas notas, das demais notas que não devem ser entregues.
Abaixo maiores informações.

Disponibilização de Dados para Entrega (Pedido de Reposição):

Notas:
select tab.codfil, tab.sequen, tab.numecf, tab.codser, tab.numnot, sum(tab.vlrliq) as ven_vlrliq, count(*) as qtditens
  from (
 
<Select dos Itens>

) tab
 group by tab.codfil, tab.sequen, tab.numecf, tab.codser, tab.numnot

Itens:
select ive.*
  from tv_eive ive                                                                                   
 where 1=1
   and ive.codfil = <Filial>
   and ive.ven_dathor >= <Filtro de Data>
   and exists (select 1 as ok
                 from tt_ipe ipe inner join tt_ivo ivo on ivo.filipe = ipe.codfil
                                                      and ivo.numipe = ipe.numped
                                                      and ivo.iteipe = ipe.numite
                where ipe.filive = ive.codfil
                  and ipe.seqive = ive.sequen
                  and ipe.numive = ive.numite)

Observações:
- Usar tabelas internas somente para filtros. Seus valores podem não ter a correspondência exata do layout de integração.
- Os filtros de filial e data são obrigatórios por questão de desempenho.

Disponibilização de Dados para Entrega (Entrega pela Loja):

Notas:
select tab.codfil, tab.sequen, tab.numecf, tab.codser, tab.numnot, sum(tab.vlrliq) as ven_vlrliq, count(*) as qtditens
  from (
 
<Select dos Itens>

) tab
 group by tab.codfil, tab.sequen, tab.numecf, tab.codser, tab.numnot

Romaneios:
select tab.rom_codfil, tab.rom_sequen, tab.rom_codext, tab.rom_placa, sum(tab.vlrliq) as ven_vlrliq, count(*) as qtditens
  from (

<Select dos Itens>

) tab
 group by tab.rom_codfil, tab.rom_sequen, tab.rom_codext, tab.rom_placa


Itens:
select ive.codfil, ive.sequen, ive.numite, ive.numecf, ive.codser, ive.numnot, ive.vlrliq,
       /*Incluir aqui qualquer coluna da TV_EIVE que se queira*/
       rom.codfil as rom_codfil,
       rom.sequen as rom_sequen,
       rom.codext as rom_codext,
       rom.placas as rom_placa
  from tv_eive ive inner join tt_ive fat on fat.codfil = ive.filori
                                        and fat.sequen = ive.numori
                                        and fat.numite = ive.iteori
                   inner join tt_ivo ivo on ivo.filive = fat.codfil
                                        and ivo.seqive = fat.sequen
                                        and ivo.numive = fat.numite
                   inner join tt_rom rom on rom.codfil = ivo.filrom
                                        and rom.sequen = ivo.seqrom                                                                                 
 where 1=1
   and ive.codfil = <Filial>
   and ive.ven_dathor >= <Filtro de Data>
 group by ive.codfil, ive.sequen, ive.numite, ive.numecf, ive.codser, ive.numnot, ive.vlrliq,
          /*Incluir aqui qualquer coluna da TV_EIVE que se queira*/
          rom.codfil, rom.sequen, rom.codext, rom.placas

Disponibilização de Dados para Entrega (Entrega com Televendas):

Notas:
select tab.codfil, tab.sequen, tab.numecf, tab.codser, tab.numnot, sum(tab.vlrliq) as ven_vlrliq, count(*) as qtditens
  from (
 
<Select dos Itens>

) tab
 group by tab.codfil, tab.sequen, tab.numecf, tab.codser, tab.numnot

Romaneios:
select tab.rom_codfil, tab.rom_sequen, tab.rom_codext, tab.rom_placa, sum(tab.vlrliq) as ven_vlrliq, count(*) as qtditens
  from (

<Select dos Itens>

) tab
 group by tab.rom_codfil, tab.rom_sequen, tab.rom_codext, tab.rom_placa


Itens:
select ive.codfil, ive.sequen, ive.numite, ive.numecf, ive.codser, ive.numnot, ive.vlrliq,
       /*Incluir aqui qualquer coluna da TV_EIVE que se queira*/
       rom.codfil as rom_codfil,
       rom.sequen as rom_sequen,
       rom.codext as rom_codext,
       rom.placas as rom_placa
  from tv_eive ive inner join tt_ior ior on ior.filive = ive.codfil
                                        and ior.seqive = ive.sequen
                                        and ior.numive = ive.numite
                   inner join tt_ivo ivo on ivo.filped = ior.codfil
                                        and ivo.tipped = ior.tipped
                                        and ivo.numped = ior.numped
                                        and ivo.numite = ior.numite
                   inner join tt_rom rom on rom.codfil = ivo.filrom
                                        and rom.sequen = ivo.seqrom                                                                                 
 where 1=1
   and ive.codfil = <Filial>
   and ive.ven_dathor >= <Filtro de Data>
 group by ive.codfil, ive.sequen, ive.numite, ive.numecf, ive.codser, ive.numnot, ive.vlrliq,
          /*Incluir aqui qualquer coluna da TV_EIVE que se queira*/
          rom.codfil, rom.sequen, rom.codext, rom.placas


Disponibilização de Dados para Entrega (Retira no Depósito):
select ive.codfil, ive.sequen, ive.numite, ive.numecf, ive.codser, ive.numnot, ive.vlrliq
       /*Incluir aqui qualquer coluna da TV_EIVE que se queira*/
  from tv_eive ive inner join tt_ive fat on fat.codfil = ive.filori
                                        and fat.sequen = ive.numori
                                        and fat.numite = ive.iteori
                   inner join tt_ivo ivo on ivo.filive = fat.codfil
                                        and ivo.seqive = fat.sequen
                                        and ivo.numive = fat.numite
                   inner join tt_ior ior on ior.filive = fat.codfil
                                        and ior.seqive = fat.sequen
                                        and ior.numive = fat.numite                                       
 where 1=1
   and ior.tipent = '3'
   and ive.codfil = <Filial>
   and ive.ven_dathor >= <Filtro de Data>
 group by ive.codfil, ive.sequen, ive.numite, ive.numecf, ive.codser, ive.numnot, ive.vlrliq
          /*Incluir aqui qualquer coluna da TV_EIVE que se queira*/