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
Existem alguns parâmetros dinâmicos específicos da modalidade E-Commerce, que precisam ser configurados em:
...
(*) Parâmetros Obrigatórios.
As views a seguir são utilizadas para a consulta dos itens disponíveis no Acrux ERP, assim como também informações complementares.
...
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.
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.
...
Regras de integração:
...
COLUNA | TIPO | NULO | COMENTÁRIO |
SEQEDIPEDVENDACLIENTE | NUMBER | N | Chave primária da tabela, inserir de forma sequencial. Não inserir de forma manual, utilizar exclusivamente o sequence: S_EDI_PEDVENDACLIENTE |
NROEMPRESA | NUMBER(3) | N | Empresa de origem do pedido. |
NROPEDIDOAFV | NUMBER | N | Número do pedido realizado pelo cliente |
NROREPRESENTANTE | NUMBER(5) | S | Representante associado ao cliente |
STATUSIMPORTACAO | VARCHAR2(1) | N | Passar fixo ‘P’. |
NROCGCCPF | NUMBER(13) | N | CPF ou CNPJ da pessoa |
DIGCGCCPF | NUMBER(2) | N | Dígito do CPF ou CNPJ |
NOMERAZAO | VARCHAR2(40) | N | Nome ou Razão Social pessoa(empresa) |
FANTASIA | VARCHAR2(30) | S | Nome Fantasia |
FISICAJURIDICA | VARCHAR2(1) | N | F – Física J - Jurídica |
SEXO | VARCHAR2(1) | S | Informar apenas para pessoa física: M - Masculino F - Feminino |
CIDADE | VARCHAR2(30) | N | Cidade do cliente. A cidade deve estar de acordo com o cadastro do IBGE, não sendo abreviada. |
UF | VARCHAR2(2) | N | UF do cliente |
PAIS | VARCHAR2(25) | N | País do cliente |
BAIRRO | VARCHAR2(30) | N | Bairro do cliente |
LOGRADOURO | VARCHAR2(35) | N | Logradouro do cliente |
NROLOGRADOURO | VARCHAR2(10) | N | Nº do Logradouro do cliente |
CMPLTOLOGRADOURO | VARCHAR2(10) | S | Complemento do Logradouro do cliente |
CEP | VARCHAR2(12) | N | CEP do Logradouro do cliente |
FONEDDD1 | VARCHAR2(5) | S | Nº de DDD do telefone principal |
FONENRO1 | NUMBER(8) | S | Número principal do cliente |
FONECMPL1 | VARCHAR2(12) | S | Descrição do telefone principal do cliente |
FONEDDD2 | VARCHAR2(5) | S | Nº de DDD da segunda opção de telefone |
FONENRO2 | NUMBER(8) | S | Segunda opção de número |
FONECMPL2 | VARCHAR2(12) | S | Descrição da segunda opção de número |
FONEDDD3 | VARCHAR2(5) | S | Nº de DDD da terceira opção de telefone |
FONENRO3 | NUMBER(8) | S | Terceira opção de número |
FONECMPL3 | VARCHAR2(12) | S | Descrição da terceira opção de número |
FAXDDD | VARCHAR2(5) | S | DDD do número de FAX |
FAXNRO | NUMBER(8) | S | Número do FAX |
INSCRICAORG | VARCHAR2(20) | S | Inscrição Estadual ou R.G. |
DTANASCFUND | DATE | S | Pessoas Físicas – Data de nascimento Pessoas Jurídicas - Data da Fundação da Empresa Formato: dd/MM/yyyy |
VARCHAR2(50) | S | E-mail do cliente | |
HOMEPAGE | VARCHAR2(80) | S | Website do cliente |
ESTADOCIVIL | VARCHAR2(1) | S | Informar somente para pessoas Físicas. Opções: S - Solteiro C – Casado V – Viúvo Q – Desquitado D – Divorciado A – Amasiado P – Separado O – Outros |
INSCMUNICIPAL | VARCHAR2(15) | S | Número da inscrição municipal do cliente. |
INSCPRODUTOR | VARCHAR2(15) | S | Número da inscrição de produtor rural do cliente |
EMAILNFE | VARCHAR2(50) | S | E-mail do cliente utilizado para recepção de NF-e |
INDCONTRIBICMS | VARCHAR2(1) | S | Indica se a pessoa é contribuinte de ICMS |
Regras de Integração:
COLUNA | TIPO | NULO | COMENTÁRIO |
SEQEDIPEDVENDA | NUMBER | N | Chave primária da tabela, inserir de forma sequencial. Recomendado utilizar o sequence S_EDI_PEDVENDA. |
STATUSPEDIDO | VARCHAR2(1) | S | Passar sempre nulo na primeira inserção e alterar para ‘L’ após a inserção de todos itens. Opções: L – Liberado para importação R – Rejeitado(*) F – Finalizado(*) (*) Opções geradas pela integração |
NROPEDIDOAFV | NUMBER | N | Número do Pedido E-Commerce ou AFV |
NROEMPRESA | NUMBER(3) | N | Número da Empresa que originou o pedido de venda |
CODSISTEMAAFV | NUMBER | N | Código do sistema AFV relacionado ao representante. No caso de e-commerce, gerar fixo ‘0’ (zero) |
NROREPRESENTANTE | NUMBER(5) | N | Número do representante responsável pelo pedido de venda. No caso de e- commerce, gerar em nome do representante padrão da empresa do pedido |
CNPJINTERMEDIADOR | VARCHAR2(14) | S | Ao preencher esse campo o NOMEINTERMEDIADOR é acionado automaticamente, devendo ser preenchido. |
NOMEINTERMEDIADOR | VARCHAR2(60) | S | Será acionado quando o campo CNPJINTERMEDIADOR for preenchido. Os dois devem ser preenchidos! |
NROFORMAPAGTO | NUMBER(3) | N | Número da forma de pagamento no ERP. Exemplo de formas de pagamento : DINHEIRO, CARTÃO DE CREDITO VISA, CARTÃO DE CREDITO MASTERCARD, etc... |
CODGERALOPER | NUMBER(3) | N | Código Geral da Operação(CGO) que irá centralizar as vendas do canal e- commerce. Sugestão : Criar um específico para suportas as vendas deste canal |
TIPPEDIDO | VARCHAR2(1) | N | V – Venda C – Cotação No caso de e-commerce, sempre deverá ser fixo ‘V’ (venda) |
PERCDESCFINANC | NUMBER(5,3) | S | Percentual Desconto Financeiro |
OBSPEDIDO | VARCHAR2(240) | S | Observação do pedido |
OBSNOTAFISCAL | VARCHAR2(250) | S | Observação da nota fiscal. Caso a observação informada no pedido tenha que ser repassada tbém como observação de NF, replicar neste campo o mesmo conteúdo do campo ‘OBSPEDIDO’ |
USUINCLUSAO | VARCHAR2(12) | N | Usuário do sistema que incluiu o pedido de venda |
DTAINCLUSAO | DATE | N | Data de inclusão do pedido Formato: dd/MM/yyyy hh24:mi:ss |
INDENTREGARETIRA | VARCHAR2(1) | S | Indica se o pedido é para entrega ou se será retirado. ‘E’ – Entrega ‘R’ – Retira |
NROBANCOCOBR | NUMBER(4) | S | Número do banco de cobrança |
NROCARTEIRACOBR | NUMBER(3) | S | Número da carteira de cobrança |
NROEMPRESACOBR | NUMBER(3) | S | Número da empresa de cobrança |
SEQCTACORRENTE | NUMBER(15) | S | Número da conta-corrente referente ao banco |
VLRTOTPEDIDO | NUMBER(13,2) | S | Valor total do pedido |
DTAPEDIDOAFV | DATE | N | Data efetiva de registro do pedido. Formato dd/MM/yyyy hh24:mi:ss |
NROSEGMENTO | NUMBER(2) | S | Número do segmento onde o pedido será integrado |
NROPARCELAS | NUMBER(2) | S | Número de parcelas da forma de pagamento |
NROTABVENDA | VARCHAR2(3) | N | Número da tabela de venda utilizada para realizar o pedido. Quando se tratar de pedidos originados do E-Commerce, o parâmetro NUMERO_TABVENDA_ECOMMERCE irá sobrepor este valor |
NROLISTAPRECO | NUMBER | S | É o número da lista de preço utilizada no pedido de venda (caso se trabalhe desta forma) |
INDECOMMERCE | VARCHAR2(1) | N | Indica se tem origem do E-Commerce. S - Sim N – Não Observação: Deve se informar obrigatoriamente ‘S’ sempre que for relacionado a E-Commerce. |
VLRTOTFRETE | NUMBER(15,4) | S | Valor total do frete |
TIPORATEIOFRETEPED | VARCHAR2(1) | S | V - Rateio por Valor P - Rateio por Peso Bruto O - Rateio por Volume(m3) T - Conforme Cálculo de Frete do Transportador no Pedido de Venda. |
STATUSPEDECOMMERCE | VARCHAR2(3) | S | Opções: 6-Aguardando Pagamento. 7-Pagamento Confirmado. Caso no escopo da integração tenha sido definido que só será integrado para o ERP pedidos que já tenha sido pago, deverá gravar como ‘7’. A opção ‘6’ só faz sentido em situações de boleto ‘contra-apresentação’ |
CODOPERADORACARTAO | NUMBER | S | Código da operadora de cartão 1- 'Tecban' 4- 'Cielo' 5- 'Redecard' 6- 'Amex' 21- 'Banrisul' 31- 'Ticket combustível' 82- 'GetNet' * obrigatório preenchimento caso seja operação de e-commerce e seja venda na modalidade ‘cartão de crédito/débito’ Caso o pedido tenha sido finalizada com mais de um cartão de crédito/débito, este campo deverá ser preenchido mas sim o campo correspondente na tabela EDU_PEDVENDAFORMAPAGTO |
DTAHORINIPREVENTREGA | DATE | S | Data e hora início da previsão de entrega (E-Commerce) Formato: dd/MM/yyyy hh24:mi:ss |
DTAHORFIMPREVENTREGA | DATE | S | Data e hora fim da previsão de entrega (E-Commerce) Formato: dd/MM/yyyy hh24:mi:ss |
DTAHORPREVEXPEDICAO | DATE | S | Data e hora prevista para expedição para a transportadora. Formato: dd/MM/yyyy hh24:mi:ss |
INDPRIORIDADESEPAR | VARCHAR2(1) | S | Indica se o pedido tem prioridade para separação S - Sim N - Não |
NROGIFTCARD | NUMBER(15) | S | Número do cartão de vale presente utilizado no pedido |
IDTRANSACAOECOMMERCE | VARCHAR2(80) | S | Código de transação gerado no sistema de e-commerce |
INDENVIOSITESTATUS | VARCHAR2(1) | S | Campo que indica que o pedido precisa ter o seu atual status enviado para o e- commerce no sentido ERP → e-commerce. Este campo é gerenciado pelo ERP |
COLUNA | TIPO | NULO | COMENTÁRIO |
SEQEDIPEDVENDA | NUMBER | N | Chave primária composta: Número do cabeçalho do pedido |
SEQPEDVENDAITEM | NUMBER(10) | N | Chave primária composta: Número sequencial dos itens |
CODACESSO | VARCHAR2(14) | N | Código de acesso do produto referente a embalagem de venda |
SEQPRODUTO | INTEGER | S | Código interno do produto |
NROCONDICAOPAGTO | NUMBER(3) | N | Condição de pagamento do item |
QTDPEDIDA | NUMBER(12,3) | N | Quantidade pedida do item em unidades |
QTDEMBALAGEM | NUMBER(12,6) | N | Quantidade da embalagem |
VLREMBTABPRECO | NUMBER(13,2) | N | Valor da tabela de venda referente a uma embalagem |
VLREMBTABPROMOC | NUMBER(13,2) | S | Valor promocional de tabela de venda referente a uma embalagem |
VLREMBINFORMADO | NUMBER(17,6) | N | Valor informado referente a uma embalagem |
VLREMBDESCONTO | NUMBER(13,2) | S | Valor de desconto referente a uma embalagem |
NROTABVENDA | VARCHAR2(3) | N | Número da tabela de venda do item |
OBSERVACAOITEM | VARCHAR2(250) | S | Observação referente ao item |
NROEMPRESAESTQ | NUMBER(3) | S | Número da empresa de onde será abatido o estoque |
GRUPODESC | VARCHAR2(3) | S | Grupo de desconto utilizado no item |
VLREMBDESCGRUPO | NUMBER(13,2) | S | Valor do desconto referente a uma embalagem para o grupo de desconto |
INDITEMINDENIZADO | VARCHAR2(1) | S | Indica se é um item indenizado |
PERCOMISSAO | NUMBER(5,2) | S | Percentual de comissão do representante |
QTDVOLUME | NUMBER(12,6) | S | Volume do item (m3) |
VLREMBDESCFORNEC | NUMBER(13,2) | S | Valor de desconto de fornecedor referente a uma embalagem |
QTDBONIFICADA | NUMBER | S | Quantidade bonificada do item |
SEQPESSOAGER | NUMBER(8) | S | Código sequencial da pessoa referente ao Gerente |
VLREMBDESCGERENTE | NUMBER(13,2) | S | Valor de desconto do gerente referente a uma embalagem |
NROSUPERVISOR | NUMBER(8) | S | Número do supervisor |
VLREMBDESCSUPERVISOR | NUMBER(13,2) | S | Valor de desconto de supervisor referente a uma embalagem |
VLREMBDESCEMPRESA | NUMBER(13,2) | S | Valor de desconto da empresa referente a uma embalagem |
INDSIMILARECOMMERCE | VARCHAR2(1) | S | Indica se o produto permite similar S - Sim N - Não |
VLREMBDESCRESSARCSTSN | NUMBER(17,6) | S | Valor de desconto de ressarcimento de ST referente a uma embalagem |
Tabela de uso exclusivo da integração para E-Commerce. Só deve ser utilizada quando a integração for na modalidade E-Commerce.
COLUNA | TIPO | NULO | COMENTÁRIO |
SEQEDIPEDVENDA | NUMBER | N | Chave estrangeira: Número do cabeçalho do pedido |
SEQPEDVENDAFORMAPAGTO | NUMBER(10) | N | Chave primária. Utilizar obrigatoriamente o SEQUENCE: S_EDI_PEDVENDAFORMAPAGTO |
NROFORMAPAGTO | NUMBER(5) | N | Código da forma de pagamento no ERP |
NROCONDPAGTO | NUMBER(3) | N | Código da condição de pagamento no ERP |
VALOR | NUMBER(13,2) | N | Valor transacionado relacionado a forma de pagamento utilizada |
LINKERP | NUMBER(15) | N | Gerar nulo |
CODOPERADORACARTAO | NUMBER | S | Código da operadora de cartão 1- 'Tecban' 4- 'Cielo' 5- 'Redecard' 6- 'Amex' 21- 'Banrisul' 31- 'Ticket combustível' 82- 'GetNet' * obrigatório preenchimento caso seja operação de e-commerce e seja venda na modalidade ‘cartão de crédito/débito’ |
NROGIFTCARD | NUMBER(15) | S | Número do cartão de presente / vale compra |
NROCARTAO | NUMBER(15) | S | Número do cartão de crédito/débito utilizado |
NROPARCELA | NUMBER(15) | S | Quantidade de parcelas na referida forma de pagamento |
CODGERALOPER | NUMBER(3) | S | Código Geral de operação referente ao Item. |
TIPOTABVENDA | VARCHAR2(1) | S | Tipo de operação. B-Bonificação V ou Nulo = Venda |
NROCGCCPFCARTAO | NUMBER(13) | S | Número do CPF/CNPJ do cartão informado no pagamento. |
DIGCGCCPFCARTAO | NUMBER(2) | S | Dígito do CPF/CNPJ do cartão informado no pagamento. |
CNPJINSTITUICAOPAGTO | VARCHAR2(15) | S | Número do CNPJ da instituição de pagamento (gateway de pagamento) |
NROAUTORIZACAO | VARCHAR2(15) | S | Número da autorização obtida pelo gateway de pagamento |
Tabela de uso exclusivo da integração para E-Commerce. Só deve ser utilizada quando a integração for na modalidade E-Commerce.
COLUNA | TIPO | NULO | COMENTÁRIO |
SEQNSUPEDVENDA | NUMBER | N | Chave primária: Deverá ser inserido um sequencial único para cada incidência |
SEQEDIPEDVENDA | NUMBER | N | Número do cabeçalho do pedido |
NROEMPRESA | NUMBER(3) | N | Número da Empresa que originou o pedido de venda |
NSU | VARCHAR2(20) | N | Número Sequencial Único – é o código de retorno emitido pela Rede Adquirente de uma operação de venda realizada com cartões |
VALORPARCELA | NUMBER(15,2) | N | Valor transacionado na referida forma de pagamento |
NROCARTAO | VARCHAR2(20) | N | Número do Cartão de Crédito/Débito transacionado |
REDE | VARCHAR2(12) | S | Adquirente (operadora ou rede autorizadora) responsável em fazer a transação junto às bandeiras: ‘Cielo' 'Redecard' 'GetNet' 'Elagvon' 'Global Payments' 'First Data' 'Vero' 'Stone' Obs: Gerar igual ao informado nas opções acima |
BANDEIRA | VARCHAR2(12) | S* | ‘Marca’ do cartão: ‘Visa' 'Mastercard' 'Diners' 'American Express' 'Sollo' 'Sidecard (Redecard)' 'Private Label (Redecard)' 'Redeshop' 'Fininvest (Visanet)' 'JCB' 'Hipercard' 'Aura' 'Losango' 'Sorocred' Obs : Gerar igual ao informado nas opções acima |
BIN | VARCHAR2(12) | S* | Bank Identification Number: “Número de Identificação Bancária” |
Regras de Integração:
COLUNA | TIPO | Informar | NULO | COMENTÁRIO |
SEQEDIPEDVENDADEVOL | NUMBER | Não | S | Alimentado por sequence, chave primária da tabela |
NROPEDIDOAFV | NUMBER | Sim | N | Número do pedido de venda gerado pelo ecommerce que será devolvido |
NROEMPRESA | NUMBER(3) | Não | S | Número do pedido, será alimentado de acordo com nroempresaecomm e os cadastros das empresas ecommerce nos parâmetros do dealer |
NROEMPRESAECOMM | NUMBER(3) | Sim | N | Número da empresa ecommerce |
SEQPESSOA | NUMBER(3) | Não | S | SeqPessoa do Pedido |
OCORRENCIADEV | NUMBER(5) | Sim ou Não | S | Ocorrência de devolução, pode ou não ser informado, se não for informado buscará a ocorrência cadastrada na mad_parametro |
STATUSPEDIDO | VARCHAR2(1) | Não | S | Status, será informado automaticamente como ‘N’ ao inserir o pedido, indicando que não foi importado |
NROPEDVENDA | NUMBER(10) | Não | S | Número do pedido de venda gerado pelo pedido que está sendo devolvido |
NROCARGA | NUMBER(8) | Não | S | Número de carga gerado ao ter faturado o pedido do ecommerce |
COLUNA | TIPO | Informar | NULO | COMENTÁRIO |
SEQPRODUTO | INTEGER | Sim | N | SeqProduto que está sendo devolvido |
NROPEDIDOAFV | NUMBER | Sim | N | Número do pedido de venda gerado pelo ecommerce que será devolvido |
SEQPEDVENDAITEM | NUMBER(10) | Sim ou Não | S | Número do item no pedido que está sendo devolvido, se o ecommerce permitir vender o produto repetido em um pedido deve ser informado |
SEQEDIPEDVENDADEVOL | NUMBER | Não | S | Chave estrangeira lincando com a tabela EDI_PEDVENDADEVOL, essa coluna será setada pela procedure no momento da devolução |
QTDDEVOL | NUMBER(12.3) | Sim | N | Quantidade do item que está sendo devolvido |
OCORRENCIADEV | NUMBER(5) | Sim ou Não | S | Ocorrência de devolução, pode ou não ser informado, se não for informado buscará a ocorrência cadastrada na mad_parametro |
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.
Exemplo:
Versão do BANCO: Oracle ora11g.
...
'P', --STATUSIMPORTACAO
458101811313642040, --NROCGCCPF
0437, --DIGCGCCPF
'Bruno Bim DiasPessoa Teste Edi', --NOMERAZAO
...
null, --CMPLTOLOGRADOURO
'1407142014065180', --CEP
16, --FONEDDD1
9932323299993232, --FONENRO1
...
'email@recebimento.de.nf' , --EMAILNFE
null --INDCONTRIBICMS
);
vnSeqEdiPedVenda := S_EDI_PEDVENDA.NEXTVAL;
...
null --VLREMBDESCRESSARCSTSN
);
end;
Exemplo:
Versão do BANCO: Oracle ora11g.
...
call pkg_edi_pedvenda.sp_devecommerce();
end;
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.
...