A venda poderá ter a seguintes informações:
Informação | Coluna | Obrigatório | Tipo | Tamanho | Descrição | |||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Código de identificação no retaguarda | id_retaguarda | Não | Texto | 100 | ||||||||||||||||||
Número da venda | ccf | Não | Texto | 100 | Número da venda. No caso do SAT o numero do documento é retornado pelo hardware. No caso da NFCe NFC-e corresponde ao número da venda autorizada, com base na fiscal_controle_nfce | |||||||||||||||||
Número da venda | coo | Não | Texto | 100 | Número da venda. No caso do SAT o numero do documento é retornado pelo hardware. No caso da NFCe NFC-e corresponde ao número da venda autorizada, com base na fiscal_controle_nfce | |||||||||||||||||
Data/Hora da venda | venda_data | Não | Data | Data e hora que a venda foi efetuada. Data e hora da API | ||||||||||||||||||
ID da transação no fidelidade | id_transacao_fidelidade | Não | Texto | 36 | Durante a finalização da venda, quando fidelidade está ativo e o cliente foi identificado, há uma confirmação da transação no sistema do Fidelidade para computar a pontuação da venda. Essa coluna corresponde ao ID dessa transação com o fidelidade | |||||||||||||||||
Número do PDV | numero_pdv | Não | Texto | 100 | Corresponde ao número do PDV que realizou a venda, conforme a identificação na tabela dispositivo | |||||||||||||||||
Número da redução Z | numero_reducao_z | Não | Texto | 36 | ||||||||||||||||||
Situação da venda | situacao_venda | Não | Inteiro | Situação da venda, podendo ter os seguintes valores:
| ||||||||||||||||||
Valor líquido da venda | valor_liquido | Não | Numérico | Valor líquido da venda (valor bruto - descontos + acréscimos) | ||||||||||||||||||
Valor bruto da venda | valor_bruto | Não | Numérico | Valor bruto da venda, sem considerar descontos e acréscimos | ||||||||||||||||||
Valor de desconto ou acréscimo | valor_desconto_acrescimo | Não | Numérico | Defasado | ||||||||||||||||||
ID motivo | id_motivo | Não | Inteiro | Defasado | ||||||||||||||||||
ID do caixa aberto que realizou a venda | idid_caixa | Não | Texto | 36 | Vinculo da venda com o caixa que realizou a operação, conforme a tabela caixa_operacao | |||||||||||||||||
ID impressora | id_impressora_sat | Não | Inteiro | Defasado. Fixo valor 1 | ||||||||||||||||||
Situação de sincronização da venda | sincronizado_venda | Sim | Inteiro | Controla o estado da sincronização. Podendo ter os valores 0, 1 e 3.
Todas as vendas são gravadas no banco com o valor 0, exceto quando o tipo de venda corresponde a recebimento de titulo, nesse caso, o valor é fixo 1. Quando utilizado o Emissor fiscal PDV Omni (modelo NFCeNFC-e) e a venda é do tipo venda de produto, inicialmente o dado é gravado com valor 3. Após a emissão fiscal concluida concluída o valor é alterado para 0. | ||||||||||||||||||
Situação de sincronização do cancelamento | sincronizado_cancelamento | Sim | Inteiro | Controla o estado da sincronização. Podendo ter os valores 0, 1 e 3.
Todas as vendas são gravadas no banco com o valor 0, exceto quando o tipo de venda corresponde a recebimento de titulo, nesse caso, o valor é fixo 1. Quando utilizado o Emissor fiscal PDV Omni (modelo NFCeNFC-e) e a venda é do tipo venda de produto, inicialmente o dado é gravado com valor 3. Após a emissão fiscal concluída o valor é alterado para 0. | ||||||||||||||||||
Situação de sincronização com fidelidade | sincronizado_fidelidade | Sim | Inteiro | Controla o estado da sincronização com o sistema fidelidade. Podendo ter os valores 0 ou 1. Caso exista valor na id_transacao_fidelidade o valor será gravado como 1, ao contrario, será gravado como 0. | ||||||||||||||||||
CPF do cliente consumidor | identificacao_cliente | Não | Texto | 20 | Dado de identificação do consumidor, cliente identificado na venda como consumidor (não como cliente na venda), atualmente podendo ser o CPF ou CNPJmesmo do identificacao_fidelidade ou não, dependende o fidelidade está ativo). Não corresponde ao dado do consumidor e sim do cliente identificado juntamente no carrinho de venda. | |||||||||||||||||
CPF do cliente fidelidade | identificacao_fidelidade | Não | Não | Texto | 20 | Dado de identificação do cliente no fidelidade, identificado na venda como cliente (não como consumidor), atualmente podendo ser o CPF | ||||||||||||||||
CPF do cliente consumidor | cpf_cnpj_consumidor | Não | Texto | 20 | CPF OU CNPJ Dado de identificação do consumidor, identificado na venda como consumidor (não como cliente na venda), atualmente podendo ser o CPF ou CNPJ | |||||||||||||||||
Nome do consumidor | nome_consumidor | Não | Texto | 250 | Nome do consumidor identificado na venda | |||||||||||||||||
Endereço do consumidor | endereco_consumidor | Não | Texto | 250 | Endereço do consumidor identificado na venda | |||||||||||||||||
ID do operador | id_operador | Não | Inteiro | ID do operador do PDV logado no momento da venda | ||||||||||||||||||
Situação | situacao | Sim | Inteiro |
Padrão sempre como 1. | ||||||||||||||||||
Data/Hora do cadastro do registro | data_cadastro | Sim | Data | Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi cadastrado localmente. | ||||||||||||||||||
Data/Hora da atualização do registro | data_atualizacao | Sim | Data | Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi atualizado localmente. | ||||||||||||||||||
Chave de acesso da NF | chaveacesso | Não | Texto | 100 | Chave de acesso da NFCeNFC-e/SAT/NFe NF-e gerada após aprovação fiscal | |||||||||||||||||
ID pré-venda | id_pre_venda | Não | Inteiro | Vinculo da venda com a pré-venda que originou a mesma | ||||||||||||||||||
Série da venda | serie_nota | Sim | Inteiro | No caso de vendas NFCe/NFe NFC-e/NF-e essa coluna corresponde a serie utilizada para emissão fiscal do PDV que realizou a operação, o dado é encontrado na fiscal_controle_nfce | ||||||||||||||||||
Tipo venda | tipo_venda | Não | Inteiro | modelo_fiscal | Não | Inteiro | Tipo de operação de venda
| |||||||||||||||
Modelo fiscal de emissão | modelo_fiscal | Não | Inteiro | Modelo fiscal da emissão
| ||||||||||||||||||
CEP do consumidor | cep_consumidor | Não | Texto | 10 | CEP do consumidor identificado na venda | |||||||||||||||||
Número da residência do consumidor | numero_consumidor | Não | Texto | 15 | Numero da residencia residência do consumidor identificado na venda | |||||||||||||||||
Complemento do endereço do consumidor | complemento_consumidor | Não | Texto | 50 | Complemento do endereço do consumidor identificado na venda | |||||||||||||||||
Bairro do consumidor | bairro_consumidor | Não | Texto | 100 | Bairro do endereço do consumidor identificado na venda | |||||||||||||||||
Cidade do consumidor | cidade_consumidor | Não | Texto | 100 | Cidade do endereço do consumidor identificado na venda | |||||||||||||||||
Estado do endereço do consumidor | estado_consumidor | Não | Texto | 2 | Estado do endereço do consumidor identificado na venda | |||||||||||||||||
Promoção motor | promocaopormocao_motor | Não | Inteiro | |||||||||||||||||||
Promoção SMS | promocao_sms | Não | Inteiro | Defasado. Valor fixo 0 | ||||||||||||||||||
Campanha promocional | campanha_promocional | Não | Inteiro | Defasado | ||||||||||||||||||
Código promocional | codigo_promocional | Não | Texto | 30 | Defasado | |||||||||||||||||
ID campanha promocional | id_campanha_promocional | Não | Texto | 100 | Defasado | |||||||||||||||||
ID transação motor terceiro | id_transacao_motor_promocao_terceiro | Não | Texto | 100 | Durante a inicialização da venda, quando o motor terceiro está ativo, há uma criação e movimentação de comunicação com o motor. Essa coluna corresponde ao ID dessa transação. | |||||||||||||||||
ID canal de venda | id_canal_venda | Não | Texto | 100 | ||||||||||||||||||
ID pedido de venda | id_pedido_omni | Não | Inteironumero_ | ID do pedido omni resgatado e finalizado no PDV | ||||||||||||||||||
Número do pedido Omni | numero_pedido_omni | Não | _omniNão | Texto | 100 | Número do pedido omni resgatado e finalizado no PDV | ||||||||||||||||
Modalidade da venda | modalidade_venda | Não | Texto | 100 | ID retaguarda da modalidade de venda utilizado | |||||||||||||||||
MD5 PAF | md5_paf | Não | Texto | 64 | ||||||||||||||||||
Sistema PDV | sistema_pdv | Não | Inteiro | limite_compra | Não | Inteiro | Módulo do PDV que realizou a venda
| |||||||||||||||
Limite de compra | limite_compra | Não | Inteiro | |||||||||||||||||||
Versão PDV | versao_pdv | Não | Texto | 20 | Versão do PDV no momento da venda | |||||||||||||||||
Nome do cliente | versao_pdv | Não | Texto | 20 | nome_cliente | Não | Texto | 250 | Nome do cliente/consumidor identificado na venda. Independente se for cliente ou se for consumidor apenas, a coluna será preenchida. | |||||||||||||
E-mail do cliente | email_cliente | Não | Texto | 250 | E-mail do cliente/consumidor identificado na venda. Independente se for cliente ou se for consumidor apenas, a coluna será preenchida. | |||||||||||||||||
Frete total | frete_total | Não | Numérico | |||||||||||||||||||
Desconto percentual total | desconto_percentual_total | Sim | Numérico | |||||||||||||||||||
Múltiplos pedidos | multiplos_pedidos | Não | Boleano | Quando há mais de um tipo de retirada no mesmo carrinho (entrega, entrega posterior e retirada) o multiplos pedido é true, do contrario, false | ||||||||||||||||||
Telefone do consumidor | telefone_consumidor | Não | Texto | telefone_consumidor | Não | Texto | 20 | Telefone do consumidor identificado na venda | ||||||||||||||
Código do país da venda | codigo_pais | Não | Texto | 50 | Código do país do cliente/consumidor identificado na venda, caso nenhum tenha sido identificado será atribuído o país da loja | |||||||||||||||||
País do consumidor | pais_consumidor | Não | Texto | 50 | País do consumidor identificado na venda | |||||||||||||||||
Mensagem complementar da venda | mensagem_complementar | Não | Texto | Mensagem complementar da venda. Esse campo é gravado somente quando configurado como NFC-e e com o emissor PDV Omni | ||||||||||||||||||
CNPJ do intermediador | cnpj | cnpj_intermediador | Não | Texto | 20 | nome_intermediador | Não | Texto | 250 | data_ultimo_envio | Não | Data | quantidade_tentativa | Não | Inteiro | inscricao_estadual_consumidor | Não | Texto | 20 | detalhes_integracao | Não | Texto |
Venda_item
...
Informação
...
Coluna
...
Obrigatório
...
Tipo
...
Tamanho
...
Descrição
...
Padrão sempre como 1.
...
20 | Dado gravado somente quando a venda é originaria de um pedido omni e a rede da loja seja BOTICARIO ou QDB | ||||
Nome do intermediador | nome_intermediador | Não | Texto | 250 | Dado gravado somente quando a venda é originaria de um pedido omni e a rede da loja seja BOTICARIO ou QDB |
Data último envio | data_ultimo_envio | Não | Data | ||
Quantidade de tentativas | quantidade_tentativa | Não | Inteiro | ||
Inscrição estadual do consumidor | inscricao_estadual_consumidor | Não | Texto | 20 | |
Detalhes da integração | detalhes_integracao | Não | Texto | ||
Observação | observacao | Não | Texto | Quando o parâmetro chave 255 - Habilitar identificação do visitante estiver ativo e o usuário informar a identificação do mesmo na tela, o dado da identificação do mesmo será gravado nessa coluna. Esse dado não é utilizado para a geração da XML ou outros. No momento, é somente registrado o dado no banco. **Posteriormente a coluna poderá ser utilizada para outras informações, porém no momento ela é utilizada somente no fluxo do parâmetro 255 |
Venda_item
Informação | Coluna | Obrigatório | Tipo | Tamanho | Descrição |
---|---|---|---|---|---|
Código de identificação no retaguarda | id_retaguarda | Não | Texto | 100 | |
ID da venda | id_venda | Não | Inteiro | Vinculo da venda item com a venda, corresponde ao ID da tabela venda | |
Quantidade | qtde | Não | Numérico | Quantidade do item que foi vendida | |
Sequência | sequencia | Não | Inteiro | Sequencia do item no carrinho, ordem que o mesmo foi adicionado | |
Valor unitário do item | valor_unitario | Não | Numérico | Valor unitário bruto do item | |
Valor total do item | valor_total | Não | Numérico | Valor total do item (valor_unitario * qtde) | |
Valor do desconto ou acréscimo | valor_desconto_acrescimo | Não | Numérico | Defasado | |
ID motivo do desconto ou acréscimo | id_motivo_desconto_acrescimo | Não | Inteiro | Defasado | |
IDV produto | id_produto | Não | Inteiro | Id do produto que foi vendido, corresponde ao ID da tabela produto | |
Descrição | descricao | Não | Texto | 100 | Descrição do produto que foi vendido, corresponde ao produto da tabela produto |
ID do vendedor | id_vendedor | Não | Inteiro | ||
Situação | situacao | Sim | Inteiro |
Padrão sempre como 1. | |
Data/Hora do cadastro do registro | data_cadastro | Sim | Data | Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi cadastrado localmente. | |
Data/Hora da atualização do registro | data_atualizacao | Sim | Data | Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi atualizado localmente. | |
Status | status | Sim | Inteiro | ||
Valor líquido | valor_liquido | Não | Numérico | Valor liquido do item na venda (valor_total - descontos + acréscimos) | |
ID produto KIT | id_produto_kit | Não | Inteiro | ||
Código do NCM | codigo_ncm | Não | Texto | 8 | Código de NCM vinculado ao produto (coluna codigo_ncm da tabela NCM) |
Alíquota do tributo | aliquota_tributo | Não | Numérico | Alíquota de ICMS vinculada ao produto (colina aliquota_tributo da tabela Imposto) | |
Unidade de medida | unidade_medida | Não | Texto | 20 | Unidade de medida do produto |
MD5 PAF | md5_paf | Não | Texto | 64 | |
Código do produto | codigo_produto | Não | Texto | 20 | Código do produto inserido no carrinho (coluna codigo_produto da tabela produto) |
Frete | frete | Sim | Numérico | ||
Quantidade embalagem | qtde_embalagem | Não | Numérico | Quantidade do produto na embalagem dele | |
Desconto percentual | desconto_percentual | Sim | Numérico | ||
ID preço | id_preco | Não | Inteiro | ||
Outras despesas | outras_despesas | Não | Numérico | ||
Sequência KIT | sequencia_kit | Não | Inteiro |
Venda_Desconto_Acrescimo
...
Venda_Desconto_Acrescimo
...
Informação
...
Coluna
...
Obrigatório
...
Tipo
...
Tamanho
...
Descrição
...
Padrão sempre como 1.
...
Venda_Pagamento
Informação | Coluna | Obrigatório | Tipo | Tamanho | Descrição | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Código de identificação no retaguarda | id_retaguarda | Não | Texto | 100 | ||||||||||||||||||||||
ID venda | id_venda | Não | Inteiro | Id da venda que recebeu o pagamento (id da tabela venda) | id_pagamento_forma | Não | Inteiro | Id da forma de pagamento utilizada (id da tabela pagamento_forma) | Caso o desconto/acréscimo tenha ocorrido no valor total da venda, será identificado o id_venda. Caso tenha sido aplicado diretamente no item, essa coluna ficara nula | |||||||||||||||||
ID venda item | id_venda_itemid_pagamento_condicao | Não | Inteiro | Caso o pagamento tenha sido em Débito/Crédito/POS será identificado a condicao do pagamento (id da tabela pagamento_codicao) | id_pagamento_operadora | Não | Inteiro | Caso o pagamento tenha sido em Débito/Crédito/POS será identificado a operadora do pagamento (id da tabela pagamento_operadora) | valor_pago | Não | Numérico | Valor pago pelo cliente, independente do valor ter sido superior a venda | valor_troco | Não | Numérico | Valor do troco devolvido ao cliente | valor_liquido | Não | Numérico | Valor líquido da venda | id_troca | Não | Inteiro | Caso o pagamento tenha sido realizado com uma troca, é realizado o vinculo da troca utilizada. Corresponde a coluna ID da tabela troca | desconto/acréscimo tenha ocorrido diretamente no item, esse coluna irá identificar o id_venda_item. Caso tenha sido aplicado no total da venda, essa coluna ficara nula | |
Valor | valor | Não | Numérico | No caso de aplicado um desconto, esse campo será preenchido com o valor do desconto aplicado apresentando o valor como negativo, correspondendo ao desconto. Caso senha sido aplicado um acréscimo esse campo irá apresentar o valor do acréscimo positivo, identificando que o valor deve ser aumentado | ||||||||||||||||||||||
ID motivo | id_motivo | Não | Inteiro | Id do motivo (id da tabela motivo) que foi selecionado na tela para justificar o desconto | ||||||||||||||||||||||
Item toal | item_total | Sim | Inteiro | |||||||||||||||||||||||
Situação | situacao | Sim | Inteiro |
| situacao | Sim | Inteiro |
Padrão sempre como 1. | ||||||||||||||||||
Data/Hora do cadastro do registro | data_cadastro | Sim | Data | Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi cadastrado localmente. | ||||||||||||||||||||||
Data/Hora da atualização do registro | data_atualizacao | Sim | Data | Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi atualizado localmente. | ||||||||||||||||||||||
Complemento | complemento | Não | Texto | 25 | quantidade_parcelas||||||||||||||||||||||
100 | ||||||||||||||||||||||||||
Descrição motivo | descricao_motivo | Não | ||||||||||||||||||||||||
Texto | 255 | Descrição do motivo (descrição da tabela motivo) que foi selecionado na tela para justificar o desconto | ||||||||||||||||||||||||
Pontos | pontos | Sim | Inteiro | Quantidade de pontos do fidelidade que foram consumidos para aplicar o desconto, caso o desconto seja oriundo dos pontos do programa |
Venda_Pagamento
Informação | Coluna | Obrigatório | Tipo | Tamanho | Descrição |
---|---|---|---|---|---|
Código de identificação no retaguarda | id_retaguarda | id_divida | Não | Texto | 30 | id_pagamento_mfe | Não | Inteiro | sincronizado_pagamento_mfe | Não | Boleano | md5_paf | Não | Texto | 64 | descricao
Não | Texto | ||||
100 | |||||
ID venda | id_ | ||||
venda | Não | Inteiro | Id da venda que recebeu o pagamento (id | ||
da tabela venda) | Não | Texto | tipo | ||
ID pagamento forma | id_pagamento_forma | ||||
Não | Inteiro |
Venda_Pagamento_TEF
Id da forma de pagamento utilizada (id da tabela pagamento_forma) | ||||||||||||||||||||||||||||||||||||||||||
ID pagamento condição | id_pagamento_condicao | Não | Inteiro | Caso o pagamento tenha sido em Débito/Crédito/POS será identificado a condicao do pagamento (id da tabela pagamento_codicao) | ||||||||||||||||||||||||||||||||||||||
ID pagamento operadora | id_pagamento_operadora | Não | Inteiro | Caso o pagamento tenha sido em Débito/Crédito/POS será identificado a operadora do pagamento (id da tabela pagamento_operadora) | ||||||||||||||||||||||||||||||||||||||
Valor pago | valor_pago | Não | Numérico | Valor pago pelo cliente, independente do valor ter sido superior a venda | ||||||||||||||||||||||||||||||||||||||
Valor troco | valor_troco | Não | Numérico | Valor do troco devolvido ao cliente | ||||||||||||||||||||||||||||||||||||||
Valor líquido | valor_liquido | Não | Numérico | Valor líquido da venda | ||||||||||||||||||||||||||||||||||||||
ID troca | id_troca | Não | Inteiro | Caso o pagamento tenha sido realizado com uma troca, é realizado o vinculo da troca utilizada. Corresponde a coluna ID da tabela troca | ||||||||||||||||||||||||||||||||||||||
Situação | situacao | Sim | Inteiro |
| ||||||||||||||||||||||||||||||||||||||
Informação | Coluna | Obrigatório | Tipo | Tamanho | Descrição | |||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id_retaguarda | Não | Texto | 100 | id_venda_pagamento | Sim | Inteiro | bandeira | Sim | Texto | 30 | codigo_rede | Sim | Texto | 30 | data_pre_datado | Não | Data | dias_entre_parcelas | Não | Inteiro | numero_autorizacao | Não | Texto | 200 | numero_bin | Não | Texto | 50 | numero_parcelos | Não | Inteiro | primeira_parcela | Não | Data | nsu_host | Não | Texto | 50 | situacao | Sim | Inteiro |
Padrão sempre como 1. |
Data/Hora do cadastro do registro | data_cadastro | Sim | Data | Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi cadastrado localmente. | ||||||||||||||||||||||||||||||||||||||
Data/Hora da atualização do registro | data_atualizacao | Sim | Data | Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi atualizado localmente. | id_transacao_digital||||||||||||||||||||||||||||||||||||||
CPF/CNPJ do cliente | cpf_cnpj_cliente | Não | Texto | 50 | id_pagamento_mfe||||||||||||||||||||||||||||||||||||||
25 | Defasado | |||||||||||||||||||||||||||||||||||||||||
Quantidade de parcelas | quantidade_parcelas | Não | Inteiro | sincronizado_pagamento_mfe | Não | Boleano | nsu_sitef||||||||||||||||||||||||||||||||||||
Quantidade de parcelas no pagamento, selecionada no PDV | ||||||||||||||||||||||||||||||||||||||||||
ID divida | id_divida | Não | Texto | 50 | bandeira_nfce||||||||||||||||||||||||||||||||||||||
30 | ||||||||||||||||||||||||||||||||||||||||||
ID pagamento MFE | id_pagamento_mfe | Não | ||||||||||||||||||||||||||||||||||||||||
Inteiro | 20 | cnpj_credenciadora|||||||||||||||||||||||||||||||||||||||||
Sincronizado pagamento MFE | sincronizado_pagamento_mfe | Não | ||||||||||||||||||||||||||||||||||||||||
Boleano | ||||||||||||||||||||||||||||||||||||||||||
MD5 PAG |
Venda_Pagamento_Dado_Complementar
md5_paf | Não | Texto | 64 | Informação | Coluna | Obrigatório | Tipo | Tamanho
---|---|---|---|
Descrição | |||
descricao | Não | Texto | 100 | id_venda_pagamento | Não | Inteiro | id_pagamento_dado_complementar
50 | Descrição da pagamento forma mestre do pagamento realizado | ||
ID pré-venda | id_pre_venda | Não | Inteiro |
ID da pré-venda vinculado a venda | |||
ID retaguarda crédito | id_retaguarda_credito | Não | Texto |
Tipo | |||
tipo | |||
Não | Inteiro |
Padrão sempre como 1. | data_cadastro | Sim | Data | Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi cadastrado localmente. | data_atualizacao | Sim | Data | Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi atualizado localmente. |
Tipo da pagamento forma mestre
|
Venda_Pagamento_TEF
Somente vendas com pagamento em TEF (ou seja, com conexão com o Sitef, passando o cartão no pinpad) gravarão registros nessa tabelaVenda_Pagamento_Item
Informação | Coluna | Obrigatório | Tipo | Tamanho | Descrição | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Código de identificação no retaguarda | id_retaguarda | SimNão | Texto | 100 | ||||||||||||||||||||
ID venda pagamento | id_Vendavenda_pagamento | NãoSim | Inteiro | numero_parcela | Não | Inteiro | valor_parcela | Não | Numérico | data_vencimento | Não | Data | situacao | Sim | Inteiro |
Padrão sempre como 1. | data_cadastro | Sim | Data | Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi cadastrado localmente. | data_atualizacao | Sim | Data | Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi atualizado localmente. |
Venda_Custodia_XML
Vinculo entre a venda_pagamento_tef e a venda_pagamento | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Código da bandeira | bandeira | Sim | Texto | 30 | Bandeira da operadora do cartão retornado pelo TEF, mas caso não retornado, comparado com a pagamento_operadora.codigo_tef | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Código da rede | codigo_rede | Sim | Texto | 30 | Código da rede da operadora retornado pelo TEF | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Data do pagamento pré-datado | data_pre_datado | Não | Data | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Dias entre as parcelas | dias_entre_parcelas | Não | Inteiro | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Número da autorização da transação | numero_autorizacao | Não | Texto | 200 | Número da autorização da transação no TEF, retornado pela Sitef | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Número da BIN | numero_bin | Não | Texto | 50 | Número da BIN do cartão, normalmente composto pelos 8 primeiros dígitos do cartão do cliente | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Número de parcelar | numero_parcelas | Não | Inteiro | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Primeira parcela | primeira_parcela | Não | Data | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
NSU Host | nsu_host | Não | Texto | 50 | NSU da operação retornada pelo TEF | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Situação | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Informação | Coluna | Obrigatório | Tipo | Tamanho | Descrição | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id_retaguarda | Não | Texto | 100 | situacao | Sim | Inteiro |
Padrão sempre como 1. | data_cadastro | Sim | Data | Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi cadastrado localmente. | data_atualizacao | Sim | Data | Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi atualizado localmente. | xml | Não | Texto | chave_acesso | Não | Texto | 100 | numero_venda | Não | Texto | 100 | serie_venda | Não | Inteiro | modelo_fiscal | Não | Inteiro | tipo_xml | Não | Inteiro | codigo_rejeicao | Não | Texto | 100 | cupom_gerado | Não | Boleano | numero_autorizacao | Não | Texto | 100 | data_autorizacao | Não | Data | cancelado | Não | Boleano | processar | Não | Boleano | enviar_retaguarda | Não | Boleano | enviar_contingencia_retaguarda | Não | Boleano | contingencia | Não | Boleano | rejeitado | Não | Boleano |
Padrão sempre como 1. | |
Data/Hora do cadastro do registro | data_cadastro | Sim | Data | Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi cadastrado localmente. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Data/Hora da atualização do registro | data_atualizacao | Sim | Data | Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi atualizado localmente. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ID da transação digital | id_transacao_digital | Não | Texto | 50 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ID pagamento MFE | id_pagamento_mfe | Não | Inteiro | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Status sincronizado pagamento MFE | sincronizado_pagamento_mfe | Não | Boleano | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
NSU do Sitef | nsu_sitef | Não | Texto | 50 | NSU da operação retornada pelo TEF | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Bandeira NFCE | bandeira_nfce | Não | Texto | 20 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
CNPJ da credenciadora | cnpj_credenciadora | Não | Texto | 20 | Caso retornado na operação TEF o CNPJ da credenciadora (também configurado no módulo SITEF da loja) a informação é gravada |
Venda_Pagamento_Dado_Complementar
Informação | Coluna | Obrigatório | Tipo | Tamanho | Descrição |
---|---|---|---|---|---|
Código de identificação no retaguarda | id_retaguarda | Não | Texto | 100 | |
ID venda pagamento | id_venda_pagamento | Não | Inteiro | ID da pagamento_forma utilizada na venda | |
ID pagamento dado complementar | id_pagamento_dado_complementar | Não | Inteiro | ID do pagamento_dado_complementar que o dado informado | |
Valor informado | conteudo | Não | Texto | 30 | Valor informado no PDV para o dado |
Situação | situacao | Sim | Inteiro |
Padrão sempre como 1. | |
Data/Hora do cadastro do registro | data_cadastro | Sim | Data | Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi cadastrado localmente. | |
Data/Hora da atualização do registro | data_atualizacao | Sim | Data | Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi atualizado localmente. |
Venda_Pagamento_Item
Para pagamentos realizado que não tenham sido em dinheiro ou possua algum tipo de possível parcelamento, será gerado um registro na venda_pagamento_item
Informação | Coluna | Obrigatório | Tipo | Tamanho | Descrição |
---|---|---|---|---|---|
Código de identificação no retaguarda | id_retaguarda | Sim | Texto | 100 | |
ID venda pagamento | id_Venda_pagamento | Não | Inteiro | Vinculo entre a venda_pagamento e a venda_pagamento_item | |
Número da parcela | numero_parcela | Não | Inteiro | Número de parcela. Caso o pagamento tenha tido mais de uma parcela, haverá mais de uma linha para a mesma forma de pagamento, porém com número de parcelas diferentes | |
Valor da parcela | valor_parcela | Não | Numérico | Para pagamentos parcelados, esse será o valor de cada parcela do pagamento | |
Data do vencimento da parcela | data_vencimento | Não | Data | De acordo com a configuração de intervalo entre parcelas, será apresentado o vencimento das parcelas. | |
Situação | situacao | Sim | Inteiro |
Padrão sempre como 1. | |
Data/Hora do cadastro do registro | data_cadastro | Sim | Data | Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi cadastrado localmente. | |
Data/Hora da atualização do registro | data_atualizacao | Sim | Data | Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi atualizado localmente. |
Venda_Custodia_XML
Informação | Coluna | Obrigatório | Tipo | Tamanho | Descrição | |||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Código de identificação no retaguarda | id_retaguarda | Não | Texto | 100 | ||||||||||||||||||||||||
Situação | situacao | Sim | Inteiro |
Padrão sempre como 1. | ||||||||||||||||||||||||
Data/Hora do cadastro do registro | data_cadastro | Sim | Data | Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi cadastrado localmente. | ||||||||||||||||||||||||
Data/Hora da atualização do registro | data_atualizacao | Sim | Data | Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi atualizado localmente. | ||||||||||||||||||||||||
XML | xml | Não | Texto | XML gerada da transação fiscal | ||||||||||||||||||||||||
Chave de acesso | chave_acesso | Não | Texto | 100 | Chave de acesso da NF | |||||||||||||||||||||||
Número da venda | numero_venda | Não | Texto | 100 | Número da venda gerada | |||||||||||||||||||||||
Série da venda | serie_venda | Não | Inteiro | Série da venda no caso de modelo fiscal NFCe/Fe | ||||||||||||||||||||||||
Modelo fiscal | modelo_fiscal | Não | Inteiro | Modelo fiscal da emissão
| ||||||||||||||||||||||||
Tipo de XML | tipo_xml | Não | Inteiro | Tipo da XML registrada, podendo ter os valores:
| ||||||||||||||||||||||||
Código de rejeição | codigo_rejeicao | Não | Texto | 100 | Código de rejeição obtido da sefaz ao tentar realizar a emissão da NF | |||||||||||||||||||||||
Cupom gerado | cupom_gerado | Não | Boleano | Fixo true | ||||||||||||||||||||||||
Número de autorização | numero_autorizacao | Não | Texto | 100 | Numero da autorização da NF após a geração da mesma na sefaz. Caso a nota tenha sido rejeitada, esse dado ficará nulo | |||||||||||||||||||||||
Data de autorização | data_autorizacao | Não | Data | Data/Hora da autorização na sefaz. Caso a nota tenha sido rejeitada, esse dado ficará nulo | ||||||||||||||||||||||||
Cancelada | cancelado | Não | Boleano | Quando o registro corresponde a uma informação de tipo_xml 2, essa coluna é preenchida com o valor true, do contrario o valor é sempre false | ||||||||||||||||||||||||
Processar | processar | Não | Boleano | Caso a venda tenha sido emitida online e o registro corresponde a uma XML do tipo venda a informação será gravada como false. Caso a venda tenha sido emitida online, porém a o registro não seja uma XML do tipo venda, então o valor será gravado como true | ||||||||||||||||||||||||
Enviar para o retaguarda | enviar_retaguarda | Não | Boleano | Esse campo é usado para o rastreio do emissor se deve realizar a integração desse registro ou não. Na maioria dos casos, esse campo é sempre gravado como true, somente em alguns cenários é gravado como false.
| ||||||||||||||||||||||||
Enviar para o retaguarda o dado contingência | enviar_contingencia_retaguarda | Não | Boleano | Caso a nota tenha sido emitida em contingência essa coluna ficará com valor true, do contrario será false | ||||||||||||||||||||||||
Contingência | contingencia | Não | Boleano | Caso a nota tenha sido emitida em contingência essa coluna ficará com valor true, do contrario será false | ||||||||||||||||||||||||
Rejeitado | rejeitado | Não | Boleano | Caso a nota tenha sido rejeitada pela sefaz essa coluna ficará com valor true | ||||||||||||||||||||||||
Inutilizado | inutilizado | Não | Boleano | Caso a nota tenha sido inutilizada pela sefaz essa coluna ficará com valor true | ||||||||||||||||||||||||
Código de retorno | codigo_retorno | Não | Texto | 100 | Código de retorno obtido da sefaz ao tentar realizar a operação | |||||||||||||||||||||||
Descrição de retorno | descricao_retorno | Não | Texto | 1000 | Todo codigo_retorno possui um texto de descrição do mesmo, essa coluna corresponde a descrição do código de retorno | |||||||||||||||||||||||
Emissão comprovante | emissao_comprovante | Sim | Boleano | Para emissão de NFC-e temos a opção de utilizar o emissor PDV Omni e o Fiscal Manager. Caso a venda tenha sido emitida pelo emissor PDV Omni essa coluna irá ter o valor true | ||||||||||||||||||||||||
TimeOut na emissão | timeout_emissao | Sim | Boleano | Caso ao tentar emitir a NF tenhamos o retorno de timeout e consequentemente a NF entre em contingencia, será grava a informação que corresponde a um registro que caiu no timeout | ||||||||||||||||||||||||
Pendente de tratativa de contingência | pendente_tratativa_contingencia | Sim | Boleano | Caso a operação do registro tenha sido realizada em contingencia, essa coluna irá possuir o valor true até que a contingencia seja resolvida. Após o job do hangfire de TratarPendencia resolva a pendencia existente, essa coluna irá continuar com o valor true | ||||||||||||||||||||||||
Quantidade de tratativa de contingência | qtde_tratativa_contingencia | Sim | Inteiro | Quantidade de vezes que o job tentou realizar a tratativa da contingencia pendente | ||||||||||||||||||||||||
URL de consulta da nota | inutilizado | Não | Boleano | codigo_retorno | Não | Texto | 100 | descricao_retorno | Não | Texto | 1000 | emissao_comprovante | Sim | Boleano | timeout_emissao | Sim | Boleano | pendente_tratativa_contingencia | Sim | Boleano | qtde_tratativa_contingencia | Sim | Inteirourl_consulta_nota | Não | Texto | 500 |