EDI - Integração de Pedidos de Venda

Objetivo

Este documento objetiva descrever, aos clientes Consinco, o modelo a ser utilizado para futuras integrações com softwares externos. As seções seguintes apresentarão o processo necessário para a integração de Pedido de Venda. Dado que serão utilizadas tabelas intermediárias no banco de dados, esse processo não utilizará arquivos de importação/exportação.

Os campos das tabelas de integração que estiverem com o plano de fundo em: azul estão associados diretamente com o E-Commerce. Para automação frente de venda, estes campos devem ser ignorados

Parametrização Especial para E-Commerce

Existem alguns parâmetros dinâmicos específicos da modalidade E-Commerce, que precisam ser configurados em:

MaxParametro → Dealer → Parâmetros Dinâmicos

• Parâmetros do Grupo: EDI_CAPTURA_PEDIDO
• Parâmetro: NUMERO_EMPRESA_ECOMMERCE(*)

 Define as empresas que aceitam integração com o E-Commerce. É possível informar mais de uma empresa, separadas apenas por vírgula. Deve se informar pelo menos uma empresa.

• Parâmetro: NRO_SEGMENTO_ECOMMERCE

 Define o segmento que será usado para fazer a integração. Caso não seja informado, será considerado o segmento principal da empresa de origem do pedido de venda.

• Parâmetro: NUMERO_TABVENDA_ECOMMERCE(*)

 Define a tabela de venda utilizada para integração com o E-Commerce. Deve se informar pelo menos uma tabela de venda.

(*) Parâmetros Obrigatórios.

Tabelas de Exportação de Dados

As views a seguir são utilizadas para a consulta dos itens disponíveis no Acrux ERP, assim como também informações complementares.

Observação: Importante lembrar que somente as empresas do Acrux ERP que forem configuradas para integração com E-Commerce serão mostradas. Quaisquer informações relacionadas a outras empresas que não foram configuradas serão ignoradas e omitidas.

• View: MADV_PEDIDO_CORTE_ECM

Essa view fornece as informações relacionadas ao corte de um determinado produto. Nela o usuário poderá consultar informações entre o que foi pedido(quantidade pedida) e o que foi atendido(quantidade atendida), assim como também informações referentes a esses valores, vlrpedido e vlratendido respectivamente.

• View: MADV_IMAGEM_ECM

Essa view relaciona os produtos com suas imagens, as quais são utilizadas para exibição no E-Commerce.

• View: MADV_PRODUTO_ECM

Essa view traz o cadastro dos itens do Acrux ERP. Ela nos traz informações relacionadas aos itens cadastrados no ERP da Consinco conforme campos acima.

• View: MADV_PRODUTO_STATUS_ECM

 Essa view serve como consulta para verificar quais itens estão disponíveis e em quais empresas essa disponibilidade acontece.

• View: MADV_ESTOQUE_ECM

Essa view mostra as informações de estoque de um produto relacionado com a empresa a qual ele pertence.

• View: MADV_PRODUTO_CATEGORIA_ECM

 Essa view relaciona produtos e categorias disponíveis no E-Commerce.

• View: MADV_CATEGORIA_ECM

 Essa view traz informações das categorias cadastradas no Acrux ERP. As categorias são relacionadas entre si mesma (auto relacionamento) através da chave estrangeira seqcategoriapai.

• View: MADV_PRECO_ECM

Essa view traz informações relacionadas aos preços de um determinado produto, se ele está ativo para venda, assim como informações comerciais.

• View: MADV_PEDIDO_STATUS_ECM

Essa view traz informações relacionadas aos pedidos integrados no sistema. Estes pedidos são aqueles que já passaram pelo processo de integração.

• View: MADV_MARCA_ECM

Essa view traz informações relacionadas ao cadastro de Marcas do Acrux ERP. Caso queira se consultar a marca de um determinado produto poderá se relacionar com a view MADV_PRODUTO_ECM através da chave seqmarca.

Tabelas de Integração

Esta seção descreve as tabelas e campos necessários para a perfeita execução do processo de integração. As tabelas de forma de pagamento e NSU estão ligadas diretamente com a integração do E-Commerce.

As informações deverão ser inseridas na seguinte ordem:

1. EDI_PEDVENDACLIENTE
2. EDI_PEDVENDA
3. EDI_PEDVENDAITEM
4. EDI_PEDVENDAFORMAPAGTO
5. EDI_PEDVENDANSU
6. EDI_PEDVENDADEVOL
7. EDI_PEDVENDAITEMDEVOL

Tabela Base dos Clientes: EDI_PEDVENDACLIENTE

Regras de integração:

1. Todo cliente deve ser inserido acompanhado do número do seu pedido(campo: ropedidoafv).
2. A busca do cliente será feita exclusivamente via CPF/CNPJ.
3. Caso não seja encontrado um cliente através da regra 2, será criado uma nova pessoa e um novo cliente.
4. O sistema funciona de forma automatizada, isso significa que o endereço inserido na tabela é comparado com o cadastro de endereços do Acrux ERP e caso não seja encontrado, será inserido um novo endereço para a pessoa(o cadastro de endereços do Acrux ERP cadastrará este novo cadastro apenas na modalidade E-Commerce).
5. Caso o endereço passado na tabela tenha sido encontrado no cadastro de endereços do Acrux ERP, será feita uma atualização direta no cadastro da pessoa(caso a pessoa exista). Caso não tenha sido encontrado, será aplicado a regra 4.
6. Caso o cliente tenha sido encontrado, seus dados serãoatualizados.
7. Campos que estão relacionados a CEP, CPF/CNPJ, RG, Inscrição Estadual, Endereços em geral e etc, devem vir sem qualquer pontuação, apenas números.

 Apurando os resultados da integração:

1.  O sistema importará todos os clientes(respeitando as regras do tópico 4.1.1) que tenham seu status(statusimportacao) obrigatoriamente como ‘P’.
2. Após a tentativa de importação do cliente, caso haja alguma falha, nosso sistema atualizará o status de importação(statusimportacao) para ‘R’(rejeição). Será necessário verificar os logs(Verificar tópico 6) para entender porque a importação foi rejeitada.
3. Caso o cliente tenha sido importado(conforme a regra do tópico 1.1) a coluna statusimportacao será atualizada para ‘F’(finalizado).
4. Caso a importação venha a ser rejeitada, o cliente poderá ser importado novamente, após ter suas rejeições corrigidas, atualizando a coluna para ‘P’.

Tabela Cabeçalho do Pedido de Venda: EDI_PEDVENDA

Regras de Integração:

1. Todo pedido(cabeçalho) ao ser inserido pela primeira vez deverá vir com a coluna statuspedido nula (null).
2. Os itens deverão ser inseridos logo após a inserção do pedido, e nunca antes.
3. Terminado o processo de inserção dos itens(regra 2), a coluna statuspedido deverá ser obrigatoriamente atualizada para ‘L’, indicando que o pedido está pronto para integração.

Tabela dos Itens do Pedido de Venda: EDI_PEDVENDAITEM

Tabela da forma de pagamento do Pedido:

EDI_PEDVENDAFORMAPAGTO

Tabela de uso exclusivo da integração para E-Commerce. Só deve ser utilizada quando a integração for na modalidade E-Commerce.

Tabela da forma de pagamento do Pedido:

EDI_PEDVENDANSU

Tabela de uso exclusivo da integração para E-Commerce. Só deve ser utilizada quando a integração for na modalidade E-Commerce.

Tabela Cabeçalho da Devolução de um Pedido de Venda:

EDI_PEDVENDADEVOL

 Regras de Integração:

1. Para devolver um Pedido é necessário que esse pedido já tenha sido integrado e faturado.
2. Toda Devolução de um pedido(cabeçalho) ao ser inserido na tabela deve vir com as colunas nroempresaecomm e nropedidoafv sempre informadas e a coluna ocorrenciadev pode ser informada nula(null), se ela vier como nula o sistema irá alimentá-la com o que estiver configurado na tabela mad_parametro, todas as outras colunas dessa tabela além dessas 3 informadas (nroempresaecomm, ocorrenciadev e ocorrenciadev) sempre devem ser nulas.
3. Os itens da devolução deverão ser inseridos logo após a inserção do pedido, e nunca antes.
4. Ao incluir um pedido a coluna statuspedido automaticamente ficará com o valor ‘N’, indicando que a devolução ainda não foi integrada, após rodar o processo de devolução se esse pedido tiver sido devolvido a coluna statuspedido passa a ter o valor ‘S’ indicando que a devolução já foi integrada.
5. Ao rodar o processo de devolução todos os pedidos a serem devolvidos devem ter itens a eles associados na tabela de itens de devolução.
6. Quando for rodada a procedure de devolução, os pedidos que forem importados corretamente terão seu statuspedido alterado para ‘S’, informando assim que esse pedido já foi importado, se por algum motivo algum pedido esteja com algum problema essa coluna continuará como ‘N’ e será inserido na tabela EDI_DEV_CRITICA, as informações dos pedidos que não foram importados.
7. Apos a importação das devoluções dos pedidos informados serão geradas as tabelas de devolução de acordo com as informações dos pedidos e itens informados nas tabelas, a partir disso o recebimento e emissão das notas deve ser feita pelo SM da mesma forma que a devolução tivesse sido feita pela aplicação MaxLoja→Recebimento→Geração de Cargas de Devolução.

Tabelados Itens da Devolução de um Pedido de Venda:

EDI_PEDVENDAITEMDEVOL

Regras de Integração:

1. Para inserir os itens do pedido de devolução é necessário que a informação do cabeçalho (EDI_PEDVENDADEVOL), já tenha sido informada.
2. Todos Itens da Devolução de um pedido ao ser inserido na tabela deve vir com as colunas nropedidoafv, seqproduto e qtddevol sempre informadas, a coluna seqpedvendaitem deve ser informada quando o ecommerce permitir que em um pedido exista mais de uma vez um mesmo produto e a coluna ocorrenciadev pode ser informada nula(null), se ela vier como nula o sistema irá alimentá-la com o que estiver na mesma coluna tá tabela cabeçalho, todas as outras colunas dessa tabela além dessas 5 informadas (nropedidoafv, seqpedvendaitem, seqproduto, qtddevol e ocorrenciadev) sempre devem ser nulas.
3. A quantidade a ser informada deve ser sempre em unidade, exemplo se estiver devolvendo 2 fardos de 12 unidades, o que deve ser informado na tabela é a quantidade de 24.
4. O Item que está sendo devolvido deve existir na nota gerada pelo pedido que está sendo devolvido.
5. A quantidade do Item que está sendo devolvida não deve ser nula, zero e também não pode ser maior do que a quantidade do mesmo item que foi gerado na nota do pedido que está sendo devolvido.

Exemplos Práticos

A fim de facilitar o processo de integração, disponibilizamos abaixo exemplos dos processos completos de integração. Vale lembrar que é responsabilidade de quem integrará ao Acrux ERP a consistência e legitimidade das informações inseridas nas tabelas de integração, sendo o exemplo abaixo meramente ilustrativo.

Integração

Exemplo:

Versão do BANCO: Oracle ora11g.

Declare

       vnNroPedidoAFV edi_pedvenda.nropedidoafv%type;
       vnNroEmpresa edi_pedvenda.nroempresa%type;
       vnCodOperadora edI_pedvenda.Codoperadoracartao%type;
       vnSeqEdiPedVenda edi_pedvenda.seqedipedvenda%type;
       vnNroCondPagto edi_pedvendaitem.nrocondicaopagto%type;
begin
       --Nro de pedido gerado por um terceiro que estará integrando com o Acrux ERP
       vnNroPedidoAfv := 1234;
       vnNroEmpresa := 1;
       vnCodOperadora := 123;
       vnNroCondPagto := 1;

insert into edi_pedvendacliente (

SEQEDIPEDVENDACLIENTE, NROEMPRESA, NROPEDIDOAFV, NROREPRESENTANTE, STATUSIMPORTACAO, NROCGCCPF, DIGCGCCPF, NOMERAZAO, FANTASIA, FISICAJURIDICA,

SEXO, CIDADE, UF, PAIS, BAIRRO, LOGRADOURO, NROLOGRADOURO, CMPLTOLOGRADOURO, CEP, FONEDDD1, FONENRO1, FONECMPL1, FONEDDD2, FONENRO2, FONECMPL2, FONEDDD3, FONENRO3, FONECMPL3, FAXDDD, FAXNRO, INSCRICAORG, DTANASCFUND, EMAIL, HOMEPAGE, ESTADOCIVIL, INSCMUNICIPAL, INSCPRODUTOR, EMAILNFE

) Values (

S_EDI_PEDVENDACLIENTE.Nextval,       --SEQEDIPEDVENDACLIENTE

vnNroEmpresa,                        --NROEMPRESA

vnNroPedidoAfv,                      --NROPEDIDOAFV

null,                                --NROREPRESENTANTE

'P',                                 --STATUSIMPORTACAO

313642040,                           --NROCGCCPF

37,                                  --DIGCGCCPF

'Pessoa Teste Edi',                    --NOMERAZAO

'CONSINCO',                          --FANTASIA

'F',                                 --FISICAJURIDICA

'M',                                 --SEXO

'Ribeirao Preto',                    --CIDADE

'SP',                                --UF

'Brasil',                            --PAIS

'Adelino Simioni',                   --BAIRRO

'Rua Maria Condexa',             --LOGRADOURO

'123',                               --NROLOGRADOURO

null,                                --CMPLTOLOGRADOURO

'14065180',                          --CEP

16,                                  --FONEDDD1

99993232,                            --FONENRO1

'Residencial',                       --FONECMPL1

null,                                --FONEDDD2

null,                                --FONENRO2

null,                                --FONECMPL2

null,                                --FONEDDD3

null,                                --FONENRO3

null,                                --FONECMPL3

null,                                --FAXDDD

null,                                --FAXNRO

'243019099',                         --INSCRICAORG

'01-jan-1980',                       --DTANASCFUND

null,                                --EMAIL

null,                                --HOMEPAGE

'S',                                 --ESTADOCIVIL

null,                                --INSCMUNICIPAL

null,                                --INSCPRODUTOR

'email@recebimento.de.nf',            --EMAILNFE

null      --INDCONTRIBICMS

);

vnSeqEdiPedVenda := S_EDI_PEDVENDA.NEXTVAL;

insert into edi_pedvenda (

SEQEDIPEDVENDA, STATUSPEDIDO, NROPEDIDOAFV, NROEMPRESA, CODSISTEMAAFV, NROREPRESENTANTE, CNPJINTERMEDIADOR, NOMEINTERMEDIADOR, NROFORMAPAGTO, CODGERALOPER, TIPPEDIDO, PERCDESCFINANC, OBSPEDIDO, OBSNOTAFISCAL, USUINCLUSAO, DTAINCLUSAO, INDENTREGARETIRA, NROBANCOCOBR, NROCARTEIRACOBR, NROEMPRESACOBR, SEQCTACORRENTE, VLRTOTPEDIDO, DTAPEDIDOAFV, NROSEGMENTO, NROPARCELAS, NROTABVENDA, NROLISTAPRECO, INDECOMMERCE, VLRTOTFRETE, TIPORATEIOFRETEPED, STATUSPEDECOMMERCE, CODOPERADORACARTAO, DTAHORINIPREVENTREGA, DTAHORFIMPREVENTREGA, DTAHORPREVEXPEDICAO, INDPRIORIDADESEPAR, NROGIFTCARD, IDTRANSACAOECOMMERCE, INDENVIOSITESTATUS

) Values (

vnSeqEdiPedVenda,                              --SEQEDIPEDVENDA

null,                                          --STATUSPEDIDO

vnNroPedidoAfv,                                --NROPEDIDOAFV

vnNroEmpresa,                                  --NROEMPRESA

0,                                             --CODSISTEMAAFV

NULL,                                          --NROREPRESENTANTE

null,                                              -- CNPJINTERMEDIADOR 

null,                                              -- NOMEINTERMEDIADOR

vnNroCondPagto,                                --NROFORMAPAGTO

508,                                           --CODGERALOPER

'V',                                           --TIPPEDIDO

0,                                             --PERCDESCFINANC

'Entregar somente após almoço',                --OBSPEDIDO

null,                                          --OBSNOTAFISCAL

'INTEGRACAO',                                  --USUINCLUSAO

sysdate,                                       --DTAINCLUSAO

'E',                                           --INDENTREGARETIRA

null,                                          --NROBANCOCOBR

null,                                          --NROCARTEIRACOBR

null,                                          --NROEMPRESACOBR

null,                                          --SEQCTACORRENTE

null,                                          --VLRTOTPEDIDO

sysdate,                                       --DTAPEDIDOAFV

1,                                             --NROSEGMENTO

2,                                             --NROPARCELAS

'6',                                           --NROTABVENDA

null,                                          --NROLISTAPRECO

'S',                                           --INDECOMMERC

30,                                             --VLRTOTFRETE

'V',                                           --TIPORATEIOFRETEPED

6,                                             --STATUSPEDECOMMERCE

vnCodOperadora,                                --CODOPERADORACARTAO

'30-jan-2017',                                 --DTAHORINIPREVENTREGA

'31-jan-2017',                                 --DTAHORFIMPREVENTREGA

null,                                          --DTAHORPREVEXPEDICAO

'N',                                           --INDPRIORIDADESEPAR

null,                                          --NROGIFTCARD

'NUMERO_NSU',                                  --IDTRANSACAOECOMMERCE

'S'                                            --INDENVIOSITESTATUS

);

insert into edi_pedvendaitem (

SEQEDIPEDVENDA, SEQPEDVENDAITEM, CODACESSO, SEQPRODUTO, NROCONDICAOPAGTO, QTDPEDIDA, QTDEMBALAGEM, VLREMBTABPRECO, VLREMBTABPROMOC, VLREMBINFORMADO, VLREMBDESCONTO, NROTABVENDA, OBSERVACAOITEM, NROEMPRESAESTQ, GRUPODESC, VLREMBDESCGRUPO, INDITEMINDENIZADO, PERCOMISSAO, QTDVOLUME, VLREMBDESCFORNEC, QTDBONIFICADA, SEQPESSOAGER, VLREMBDESCGERENTE, NROSUPERVISOR, VLREMBDESCSUPERVISOR, VLREMBDESCEMPRESA, INDSIMILARECOMMERCE, VLREMBDESCRESSARCSTSN

) Values (

vnSeqEdiPedVenda,      --SEQEDIPEDVENDA,

123,                   --SEQPEDVENDAITEM,

7896699007009,         --CODACESSO,

123,                   --SEQPRODUTO,

vnNroCondPagto,        --NROCONDICAOPAGTO,

123,                   --QTDPEDIDA,

1,                     --QTDEMBALAGEM,

1.99,                  --VLREMBTABPRECO,

null,                  --VLREMBTABPROMOC,

1.99,                  --VLREMBINFORMADO,

0,                     --VLREMBDESCONTO,

1,                     --NROTABVENDA,

null,                  --OBSERVACAOITEM,

null,                  --NROEMPRESAESTQ,

null,                  --GRUPODESC,

null,                  --VLREMBDESCGRUPO,

null,                  --INDITEMINDENIZADO,

null,                  --PERCOMISSAO,

null,                  --QTDVOLUME,

null,                  --VLREMBDESCFORNEC,

null,                  --QTDBONIFICADA,

null,                  --SEQPESSOAGER,

null,                  --VLREMBDESCGERENTE,

null,                  --NROSUPERVISOR,

null,                  --VLREMBDESCSUPERVISOR,

null,                  --VLREMBDESCEMPRESA,

'S',                   --INDSIMILARECOMMERCE,

null                   --VLREMBDESCRESSARCSTSN

);

end;

Devolução

Exemplo:

Versão do BANCO: Oracle ora11g.

-- DEVOLVER 10 UNIDADES DO PRODUTO DE SEQPRODUTO 27 E 15 UNIDADES DO PRODUTO 71245 DO PEDIDO AFV DE Nº
8956 DA EMPRESA 3
begin

-- INSERIR O CABEÇALHO COM AS INFORMAÇÕES DO PEDIDO A SER DEVOLVIDO

insert into edi_pedvendadevol(nropedidoafv, nroempresaecomm)

values (

8956, -- NROPEDIDOAFV

3 -- NROEMPRESAECOMM

);

-- INSERIR NA TABELA DE ITENS O NUMERO DO PEDIDO (NROPEDIDOAFV), O PRODUTO(SEQPRODUTO) E A QUANTIDADE(QTDDEVOL) DOS PRODUTOS QUE DESEJA DEVOLVER

-- INSERT DO PRODUTO 27

insert into edi_pedvendaitemdevol(seqproduto,nropedidoafv,qtddevol, seqpedvendaitem)

values(
27, -- SEQPRODUTO
8956, -- NROPEDIDOAFV
10, -- QTDDEVOL
2 -- SEQPEDVENDAITEM
);
-- INSERT DO PRODUTO 71245
insert into edi_pedvendaitemdevol(seqproduto,nropedidoafv,qtddevol, seqpedvendaitem)

values(

71245, -- SEQPRODUTO

8956, -- NROPEDIDOAFV

15, -- QTDDEVOL

3 -- SEQPEDVENDAITEM

);

-- CHAMAR A PROCEDURE PARA GERAR AS DEVOLUÇÕES DE ACORDO COM O QUE FOI INSERIDO NAS TABELAS DE DEVOLUÇÃO

call pkg_edi_pedvenda.sp_devecommerce();

end;

Verificação de Inconsistências

No decorrer do processo de importação é feita a consistências das informações inseridas. A este processo damos o nome de crítica do pedido.

Para consultar as críticas do pedido, basta abrir a aplicação AcruxVendas, e ir no menu:

Atacado>Pedidos>Log Críticas  de Importação EDI_PEDVENDA