Este manual tem o objetivo de orientar o usuário a importar os cadastros básicos necessários para utilização do Storex.
É importante frisar que a ordem que consta neste documento precisa ser seguida, pois algumas tabelas dependem de tabelas citadas anteriormente no documento. 


Cadastro de Loja

Para realizar a importação do cadastro de Lojas, é necessário executar a integração seguindo a ordem abaixo:

Tabela API Objetivo

HUB_ESTABELECIMENTO

storeImportação dos dados básicos da loja

HUB_ENDERECO_ESTBLCM

store-addressImportação do endereço da loja

HUB_TELEFONE_ESTBLCM

store-telephoneImportação do telefone da loja

Cadastro de Usuário

Para realizar a importação do cadastro de Usuário, é necessário executar a integração seguindo a ordem abaixo:

Tabela API Objetivo
P2K_PERFILuser-profileImportação dos perfis de usuário do sistema. 
P2K_CAB_USUARIOuserImportação dos usuários habilitados a utilizar o sistema. Para que um usuário seja cadastrado, este obrigatoriamente deverá estar associado a um perfil.
P2K_LJ_USUARIOuser-storeImportação da associação dos usuários às lojas. Esta informação é utilizada para determinar em que lojas da empresa o usuário terá acesso ao sistema.  

Cadastro de Produto

Para realizar a importação do cadastro de produto, é necessário executar a integração seguindo a ordem abaixo:

TabelaAPI Objetivo 
P2K_NIV_MERC category-levelImportação dos níveis de mercadológico que estabelecem a formatação das categorias.
P2K_CAB_MERC categoryImportação das informações do mercadológico.
P2K_PERC_IMP taxImportação dos percentuais de imposto existentes na legislação para ICMS para serem utilizados no cálculo de valores tributados de mercadorias.
P2K_CAB_PRODUTOproductImportação das informações dos produtos.
P2K_AUT_PRODUTO product-barcodeImportação dos códigos de automação para o produto.
P2K_LJ_PRODUTO product-storeImportação dos produtos para determinada loja
P2K_VIGENCIA_PRECO product-price-validityImportação dos diversos preços que determinado produto pode assumir considerando para isso sua vigência, ou seja, a data de início e fim de validade do preço informado.

Cadastro de Regra de Desconto

Para realizar a importação do cadastro de Regra de Desconto, é necessário executar a integração seguindo a ordem abaixo:

TabelaAPI Objetivo 
P2K_TP_DESCONTOdiscount-rule-type Importação dos tipos de descontos praticados na venda. 
P2K_REGRA_DESCONTOdiscount-rule Importação das regras para aplicação do desconto .
P2K_REGRA_DESC_PRODdiscount-rule-product Importação da relação entre regras de desconto e produtos que serão afetados por esta regra. 
P2K_REGRA_DESC_MERCdiscount-rule-category Importação da  relação entre regras de desconto e mercadológicos que serão afetados por esta regra.
P2K_REGRA_DESC_LOJAdiscount-rule-store Importação da a relação entre regras de desconto e lojas onde tais regras estarão habilitadas.
P2K_REGRA_DESC_GRUPOdiscount-rule-customer-group Importação dos grupos de regras de desconto.
P2K_REGRA_DESC_GRUPO_LOJAdiscount-rule-customer-group-store Importação das informações das regras de desconto para Grupos de Lojas.
P2K_REGRA_DIAS_SEMdiscount-rule-weekday Importação dos dias da semana  onde as regras de descontos estarão vigentes.
P2K_REGRA_DIA_FIXO_MESdiscount-rule-fixed-day-month Importação dos dias fixos onde as regras de descontos estarão vigentes.
P2K_REGRA_DESC_AGRUPAMENTOdiscount-rule-grouping Importação das informações das regras de desconto por agrupamento. 

Cadastro de Campanha

Para realizar a importação do cadastro de Campanha, é necessário executar a integração seguindo a ordem abaixo:

TabelaAPI Objetivo 

P2K_CAMPANHA

campaignImportação das campanhas que serão utilizadas nas lojas.
P2K_CAMPANHA_PRODUTO_CESTAcampaign-detailImportação dos  parâmetros específicos para as campanhas cesta de produtos
P2K_CAMP_CUPOMcampaign-couponImportação do texto a ser impresso em cada cupom quando ativado por uma determinada campanha. 
P2K_CAMPANHA_PRODUTOcampaign-productImportação dos produtos que participam da campanha. Deve-se inserir um registro para cada produto na campanha
P2K_CAMP_DIA_FIXO_MEScampaign-fixed-day-monthImportação dos dias do mês onde uma campanha está ativa. Deve conter um registro para cada dia do mês.
P2K_CAMP_DIAS_SEMcampaign-weekdayImportação dos dias da semana onde uma campanha está ativa. Deve conter um registro para cada dia da semana. 
P2K_CAMPANHA_GRUPOcampaign-customer-groupImportação dos grupos de clientes ativos para a campanha. 
P2K_CAMPANHA_LOJAcampaign-storeImportação das lojas uma determinada campanha está habilitada. Deve-se incluir um registro para cada loja onde a campanha está ativa.
P2K_CAMP_MERCcampaign-categoryImportação  dos mercadológicos uma determinada campanha está habilitada. Deve-se incluir um registro para cada mercadológico participante da campanha.
P2K_CAMP_PRODUTO_INTVLOcampaign-product-quantity-rangeImportação  da quantidade mínima e máxima de produtos para a campanha. Deve-se incluir um registro para cada produto participante da campanha.
P2K_CAMP_EVENTOcampaign-payment-conditionImportação  eventos de recebimento participantes da campanha. Deve-se incluir um registro para cada evento participante da campanha.
P2K_CAMP_EVENTO_PRODUTOcampaign-payment-condition-productImportação dos produtos que participam da campanha associada a evento recebimento. Deve-se incluir um registro para cada produto participante da campanha/evento. 

Cadastro de Planos e Eventos

É PRÉ-CONDIÇÃO antes de iniciar a importação de Eventos, acessar o Portal e cadastrar seus Planos.

Acesse no Portal, Menu > Cadastros > Planos de Pagamento > Planos Ev de Recebimentos e faça os cadastros.


Para realizar a importação do cadastro de Eventos, é necessário executar a integração seguindo a ordem abaixo:

TabelasAPI Objetivo 
P2K_EVENTO_RECpayment-conditionTabela utilizada para armazenar os eventos dos recebimentos
P2K_EV_REC_PLANPAGpayment-condition-payment-planImportação dos planos de pagamento associados aos eventos de recebimento
P2K_EV_REC_OPERACAOpayment-condition-operationImportação das operações associadas aos eventos de recebimento.
P2K_EV_REC_PRODpayment-condition-productImportação dos produtos associados aos eventos de recebimento
P2K_EV_REC_SEMNpayment-condition-weekdayImportação dos dias da semana associados aos eventos de recebimento
P2K_EV_REC_FORMAUTpayment-condition-payment-methodImportação das autorizadoras associadas as formas de recebimento
P2K_EV_REC_INTVLOpayment-condition-date-rangeImportação dos intervalos dos eventos de recebimento. 
P2K_EV_REC_LOJApayment-condition-storeImportação das lojas associadas aos eventos de recebimento. 
P2K_EV_REC_MERCpayment-condition-categoryImportação dos mercadológicos associados aos eventos de recebimento

Tabelas de subidas de transações 

Essas são as tabelas e serviços de subidas de transações para o DataHub

Vendas

Tabela

API

Objetivo

P2K_CAB_TRANSACAO

sale-header

Recupera as transações de venda existentes na loja na data informada, com o STATUS_REGISTRO = 'NP’.
Traz apenas as informações da tabela principal, sem os detalhes.

P2K_CAB_TRANSACAO

P2K_ITEM_TRANSACAO

P2K_CAB_CAMPANHA

P2K_ITEM_CAMPANHA

P2K_CAMPANHA_GENERICA

P2K_ITEM_TRANS_PINCODE

P2K_ITEM_SERVICO

P2K_ITEM_GARANTIA

P2K_ITEM_TRANS_ENTREGA_FUTURA

P2K_TRANS_LISTA_PRESENTE

P2K_ITEM_LISTA_PRESENTE

HUB_TRANS_ESPELHO_CUPOM

HUB_TRANS_RUPTURA_VENDA

HUB_TRANS_ESTACIONAMENTO

HUB_TRANS_OPERACAO_GENERICA

P2K_RECB_TRANSACAO

P2K_RECB_GENERICO

P2K_CAMPO_GENERICO

P2K_RECB_CARTAO

P2K_RECB_CHEQUE

P2K_TRANS_AUTORIZACAO
HUB_TMO

sale-transaction

Recupera a transação de venda completa

P2K_CAB_TRANSACAO

sale-transaction-process

Processa a transação, marcando o STATUS_REGISTRO como PR

Status das Notas

Tabela

API

Objetivo

P2K_TRANS_STATUS_NFCE

eletronic-invoice-status-header

Recupera os status das notas NFCE existentes na loja e na data informada, com o status_registro = 'NP'.

P2K_TRANS_STATUS_NFCE

eletronic-invoice-status-transaction-process

Processa a transação, marcando o status_registro como PR.

Pagamentos

Tabela

API

Objetivo

P2K_CAB_PAGAMENTO

non_fiscal_operation-header

Recupera as transações de pagamento existentes na loja na data informada, com o status_registro = 'NP'. Retorna apenas as informações da tabela principal, sem os detalhes.

P2K_CAB_PAGAMENTO
P2K_INFO_PAGAMENTO
P2K_TRANS_AUTORIZACAO
P2K_RECB_TRANSACAO
P2K_RECB_CARTAO
P2K_RECB_CHEQUE
P2K_RECB_GENERICO
P2K_CAMPO_GENERICO

P2K_TRANS_AUTORIZACAO
HUB_TMO

non_fiscal_operation-transaction

Recupera a transação de pagamento completa.

P2K_CAB_PAGAMENTO

non_fiscal_operation-transaction-process

Processa a transação, marcando o status_registro como PR.

Fechamento de dia

Tabela

API

Objetivo

P2K_FECHAMENTO

day-end-closing-header

Recupera as transações de fechamento de dia existentes na loja na data informada, com o STATUS_REGISTRO = 'NP'. Traz apenas as informações da tabela principal, sem os detalhes.

P2K_FECHAMENTO

P2K_TRIB_FECH

P2K_FZ_TOTALIZADORES

P2K_FZ_FINALIZADORES

P2K_OPER_FECH

P2K_RECB_FECH

P2K_TEF_FECH

P2K_TOT_OP_RECEBTO

P2K_TOTAIS_PAGAMENTO

P2K_CONFERENCIA_CEGA
P2K_TRANS_AUTORIZACAO
HUB_TMO

day-end-closing-transaction

Recupera a transação de fechamento de dia completa

P2K_FECHAMENTO

closing-transaction-process

Processa a transação de fechamento, marcando o STATUS_REGISTRO como PR

Fechamento de operador

Tabela

API

Objetivo

P2K_FECHAMENTO

session_end_closing-header

Recupera as transações de fechamento de operador existentes na loja na data informada, com o STATUS_REGISTRO = 'NP'. Traz apenas as informações da tabela principal, sem os detalhes.

P2K_FECHAMENTO

P2K_OPER_FECH

P2K_TOT_OP_RECEBTO

P2K_TRANS_AUTORIZACAO

session_end_closing-transaction

Recupera a transação de fechamento de dia completa

P2K_FECHAMENTO

session_end_closing-transaction-process

Processa a transação de fechamento, marcando o STATUS_REGISTRO como PR

Tesouraria

Tabela

API

Objetivo

P2K_MVTO_TES

cash-flow-header

Recupera os movimentos de tesouraria existentes na loja na data informada, com o status_registro = 'NP'. Retorna apenas as informações da tabela principal, sem os detalhes.
Tipo do movimento a ser recuperado. Opções possíveis:
• E = movimentos de entrada
• S = movimentos de saída
• T = movimentos de transferência
Caso não seja informado nada, serão retornados todos os tipos de movimento.

P2K_MVTO_TES
P2K_MVTO_TES_NUM
P2K_MVTO_TES_GEN
P2K_MVTO_TES_TRANSF

cash-flow-transaction

Recupera a transação de movimento de tesouraria completa.

P2K_MVTO_TES

cash-flow-transaction-process

Processa a transação, marcando o status_registro como PR.

ATD - Anulação, Troca e Devolução

Tabela

API

Objetivo

P2K_CAB_TRANSACAO

sale_return-header

Recupera as transações de Anulação, Troca ou Devolução existentes na loja na data informada, com o STATUS_REGISTRO = 'NP’.
Traz apenas as informações da tabela principal, sem os detalhes.
Tipo do transação a ser recuperada. Opções possíveis:
• A = Anulação
• T = Troca
• D = Devolução

Caso não seja informado nada, serão retornados todos os tipos de ATDs.

P2K_CAB_TRANSACAO
P2K_ITEM_TRANSACAO
P2K_RECB_TRANSACAO
P2K_RECB_GENERICO
P2K_CAMPO_GENERICO
P2K_RECB_CARTAO
P2K_RECB_CHEQUE
P2K_CAB_CAMPANHA
P2K_ITEM_CAMPANHA
P2K_TRANS_AUTORIZACAO
HUB_TMO

sale_return-transaction

Recupera a transação de Anulação, Devolução ou Troca completa.

P2K_CAB_TRANSACAO

sale_return-transaction-process

Processa a transação, marcando o status_registro como PR.


Cancelamento TEF

Tabela

API

Objetivo

P2K_CANC_TEF

eft-cancel-header

Recupera as transações de Cancelamento TEF existentes na loja na data informada, com o STATUS_REGISTRO = 'NP’.
Traz apenas as informações da tabela principal, sem os detalhes.

P2K_CANC_TEF
P2K_TRANS_AUTORIZACAO

eft-cancel-transaction

Recupera a transação de Cancelamento TEF completa.

P2K_CANC_TEF

eft-cancel-process

Processa a transação, marcando o status_registro como PR.

Cancelamento último cupom

Tabela

API

Objetivo

P2K_CANC_CUPOM

cancellation-header

Recupera as transações de Cancelamento de último cupom existentes na loja na data informada, com o STATUS_REGISTRO = 'NP’.
Traz apenas as informações da tabela principal, sem os detalhes.

P2K_CANC_CUPOM
P2K_TRANS_AUTORIZACAO

cancellation-transaction

Recupera a transação de Cancelamento de último cupom completa.

P2K_CANC_CUPOM

cancellation-transaction.process

Processa a transação, marcando o status_registro como PR.

Abertura de Caixa

Tabela

API

Objetivo

P2K_TRANS_ABE_CAIXA

open-cashier-header

Recupera as transações de abertura de caixa existentes na loja na data informada, com o STATUS_REGISTRO = 'NP’.
Traz apenas as informações da tabela principal, sem os detalhes.

Coluna TIPO_ABERTURA = 2

P2K_TRANS_ABE_CAIXA
P2K_TRANS_AUTORIZACAO
HUB_TMO

open-cashier-transaction

Recupera a transação de abertura de caixa completa.

P2K_TRANS_ABE_CAIXA

open-cashier-transaction-process

Processa a transação, marcando o status_registro como PR.

Abertura de Operador

Tabela

API

Objetivo

P2K_TRANS_ABE_CAIXA

cashier-login-header

Recupera as transações de abertura de caixa existentes na loja na data informada, com o STATUS_REGISTRO = 'NP’.
Traz apenas as informações da tabela principal, sem os detalhes.

Coluna TIPO_ABERTURA = 1

P2K_TRANS_ABE_CAIXA
P2K_TRANS_AUTORIZACAO
HUB_TMO

cashier-login-transaction

Recupera a transação de abertura de caixa completa.

P2K_TRANS_ABE_CAIXA

cashier-login-transaction-process

Processa a transação, marcando o status_registro como PR.

Sangria e Suprimento 

Tabela

API

Objetivo

P2K_CAB_SANGRIA

cash_out-header

Recupera as transações de sangria existentes na loja na data informada, com o STATUS_REGISTRO = 'NP’.
Traz apenas as informações da tabela principal, sem os detalhes.

Coluna TIPO_TRANSACAO = S

P2K_CAB_SANGRIA

P2K_REC_SANGRIA

P2K_TRANS_AUTORIZACAO

HUB_TMO

cash_out-transaction

Recupera a transação de sangria completa.

P2K_CAB_SANGRIA

cash_out-transaction-process

Processa a transação, marcando o status_registro como PR.

Suprimento 

Tabela

API

Objetivo

P2K_CAB_SANGRIA

cash_in-header

Recupera as transações de suprimento existentes na loja na data informada, com o STATUS_REGISTRO = 'NP’.
Traz apenas as informações da tabela principal, sem os detalhes.

Coluna TIPO_TRANSACAO = R

P2K_CAB_SANGRIA

P2K_REC_SANGRIA

P2K_TRANS_AUTORIZACAO

HUB_TMO

cash_in-transaction

Recupera a transação de suprimento completa.

P2K_CAB_SANGRIA

cash_in-transaction-process

Processa a transação, marcando o status_registro como PR.

Pedido

Tabela

API

Objetivo

P2K_CAB_PEDIDO

order-header

Recupera as transações de pedido existentes na loja na data informada, com o STATUS_REGISTRO = 'NP’.
Traz apenas as informações da tabela principal, sem os detalhes.

P2K_CAB_PEDIDO

P2K_ITEM_PEDIDO

P2K_TRANS_AUTORIZACAO

HUB_TMO

order-transaction

Recupera a transação de pedido completa.

P2K_CAB_PEDIDO

order-transaction-process

Processa a transação, marcando o status_registro como PR.

  • Sem rótulos