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 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 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 | id_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 seguintes valores:
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 NFC-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 do cancelamento | sincronizado_cancelamento | Sim | Inteiro | Controla o estado da sincronização. Podendo ter os seguintes valores:
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 NFC-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 do cliente identificado na venda (podendo ser o mesmo 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 | 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 | 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 NFC-e/SAT/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 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 | 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 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 | promocao_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 | Inteiro | ID do pedido omni resgatado e finalizado no PDV | |
Número do pedido Omni | numero_pedido_omni | Nã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 | 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 | 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 | 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_intermediador | Não | Texto | 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 | ||
Valor ICMS Desonerado | valor_icms_desonerado | Não | Numérico | Valor do ICMS Desonerado que foi descontado do valor do produto , para atender a NT 2023.004. | |
Valor original do produto | valor_produto_icms_desonerado | Não | Numérico | Valor do produto sem a desoneração do ICMS. |
Venda_Desconto_Acrescimo
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 | 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_item | Não | Inteiro | Caso o 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 |
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 | 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 | 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 | id_pagamento_forma | Não | Inteiro | 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 |
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. | |
CPF/CNPJ do cliente | cpf_cnpj_cliente | Não | Texto | 25 | Defasado |
Quantidade de parcelas | quantidade_parcelas | Não | Inteiro | Quantidade de parcelas no pagamento, selecionada no PDV | |
ID divida | id_divida | Não | Texto | 30 | |
ID pagamento MFE | id_pagamento_mfe | Não | Inteiro | ||
Sincronizado pagamento MFE | sincronizado_pagamento_mfe | Não | Boleano | ||
MD5 PAG | md5_paf | Não | Texto | 64 | |
Descrição | descricao | Não | Texto | 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 | 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 tabela
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 | Sim | Inteiro | 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 | 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 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 | url_consulta_nota | Não | Texto | 500 |
O objetivo do monitor de status de venda é acompanhar todo o ciclo de vida das vendas nas últimas 24 horas, permitindo que o gestor compreenda em que fase que está. Para isso, existem duas entidades que representam o status. No servidor do Sync, no banco Comercial, a tabela VendaMensagem exibe os diferentes estágios pelos quais a venda passa nas retaguardas. Já no ponto de venda (PDV), a tabela Venda indica em quais estágios a venda se encontra na retaguarda. Resumindo: a tabela venda do PDV deve refletir o status da venda na retaguarda.
O Cliente Down do Sync tem a missão de atualizar o status da venda conforme status do Sync server de acordo com a tabela de equivalência abaixo.
Status na tabela VendaMensagem (SyncServer) | Status na tabela Venda do PDV |
---|---|
-- |
0 - Pendente envio para o Sync |
0 - Pendente consumo pela retaguarda | 10 - Integrado no Sync |
1 - Consumido pela retaguarda | 11 - Consumido pela retaguarda |
2 - Consumido com erro pela retaguarda | 12 - Consumido com erro pela retaguarda |
3 - Reprocessar | -- |
4 - Integrado com sucesso pela retaguarda | 1 - Integrado com sucesso pela retaguarda |
-- | 99 - Erro ao tentar integrar no Sync |
5 - Venda enviada mais de uma vez, já integrado com sucesso. | 13 - Venda enviada mais de uma vez, já integrado com sucesso. |
Se múltiplos registros para a mesma venda forem encontrados na tabela VendaMensagem do SyncServer, o status será atualizado de acordo com a data de atualização mais recente.
Aqui está um exemplo hipotético:
Na tabela VendaMensagem do SyncServer temos a venda de CCF 5738 com três registros e o mais recente está com status = 2 (Consumido com erro pela retaguarda) e com a coluna observacao preenchida.
Na tabela Venda do PDV o campo sincronizado_venda será marcado com 12 (consumido com erro pela retaguarda) e atualizar a coluna detalhes_integracao com a mesma observação do SyncServer.