Layout de Importação do PDV

Este material apresenta o layout necessário para a integração dos processos de vendas, financeiro e fiscal entre os sistemas das Lojas (Ponto de Vendas) e o EVEREST.

 

diagrama

1.0 Importação de Vendas

Nessa seção são encontradas as informações que compõem o layout necessário para a realização da integração dos processos de vendas de outros sistemas de lojas ao Sistema EVEREST. Estes registros baseiam-se em:

“Parte do dia”: –Essa informação pertence à conta e deverá fazer parte da linha R02. Essa informação também é conhecida como “período””, que se refere ao período do dia em que a conta foi aberto.

Número da Mesa:” –Essa informação pertence à conta e deverá fazer parte da linha R02. Essa informação se refere à qual mesa a conta está relacionada.

“Razão de cancelamento”–: Essa informação pertence ao Item e Modificador e deverá fazer parte da linha R03 ou R04. Contém o motivo quando o item é cancelado.

Tipo de desconto:” Essa informação pertence ao Item e Modificador e deverá fazer parte da linha R03 ou R04. Contém o tipo de desconto concedido no item.

“Tipo de pedido:”– Essa informação pertence ao Item e Modificador e deverá fazer parte da linha R03 ou R04. Contém o modo de pedido do item, ex.: “Viagem”, “Não fazer”, etc. Essas informações serão capturadas dos arquivos datados e inseridas no arquivo de exportação.

1.1 Escopo

A solução sob medida a ser desenvolvida tem como único objetivo exportar as informações detalhadas de todas as Contas e salvá-las em arquivo-texto no formato definido.

É responsabilidade desta solução garantir que:

  • As informações geradas estejam 100% alinhadas com o conteúdo das informações;
  • As informações geradas estejam 100% alinhadas com o formato de arquivo estabelecido.

1.2 Detalhes Técnicos

Esses campos serão recuperados através dos arquivos datados referentes ao movimento.

Separar os campos através de “Tabulação” .

Campos numéricos não dever ser adicionado zeros a esquerda.

Campos carácter alinhar a esquerda.

1.3 Layout de Importação de Vendas

O layout do arquivo será alterado para contemplar as novas alterações. Os registros que sofrerão alterações estão destacados abaixo em azul:

integracaopdv

Registro R01 – Cabeçalho do Arquivo

Deve existir uma e somente uma ocorrência deste registro por arquivo e deve ser a primeira linha.

• Registro R02 – Conta

Deve existir uma ocorrência deste registro por Conta. No arquivo, os registros do tipo R02, são intercalados com os registros dos tipos R03 e R05, que são considerados registros-filhos do registro R02.

A informação Taxa Adicional está contida neste registro.

• Registro R03 – Item

Deve existir uma ocorrência deste registro para cada item vendido ou cancelado em cada Conta.

• Registro R04 – Modificador

Deve existir uma ocorrência deste registro para cada item modificador vendido em cada Conta. O registro R04 é considerado filho do registro R03.

• Registro R05 – Pagamento

Deve existir uma ocorrência deste registro para cada pagamento aplicado em cada Conta.

• Registro R99 – Rodapé do Arquivo

Deve existir uma e somente uma ocorrência deste registro por arquivo e deve ser a última linha.

1.3.1 REGISTRO R01 – CABEÇALHO DO ARQUIVO

Nome Descrição Tipo Tam
TIPO_REGISTRO Identificador do tipo de registro. Constante “R01”. Texto 3
DATA_MOVIMENTO Data do movimento às quais as informações se referem, no formato “aaaammdd.

É importante destacar que as vendas realizadas após às 23:59:59 se referem à mesma data de movimento. A data de movimento somente é alterada após a realização do processo de Fim-do-Dia.

Texto 8
QTDE_CONTAS Quantidade de contas no dia de movimento. Numérico 10
QTDE_CLIENTES Quantidade de clientes no dia de movimento. Numérico 10
VENDA_BRUTA Somatório do valor bruto de todos os itens e itens modificadores vendidos, inclusive os cancelados.

VENDA_BRUTA = (R03.VALOR) + (R04.VALOR)

Monetário 15,2
CANCELAMENTOS Somatório do valor bruto de todos os itens e itens modificadores cancelados.

CANCELAMENTOS = (R03.VALOR) + (R04.VALOR)

Monetário 15,2
DESCONTOS Somatório do valor o desconto sobre todos os itens e itens modificadores vendidos.

DESCONTOS = (R03.DESCONTO) + (R04.DESCONTO)

Monetário 15,2
TAXAS_ADICIONAIS Somatório do valor de todas as taxas adicionais. TAXAS_ADICIONAIS = (R02.TOTAL_TAXAS_ADICIONAIS) Monetário 15,2
PAGAMENTOS Somatório do valor de todos os pagamentos. PAGAMENTOS = (R05.VALOR) Monetário 15,2
CNPJ Informar o CNPJ sem formatação. Texto 14

1.3.2 REGISTRO R02 – CONTA

Nome Descrição Tipo Tam
TIPO_REGISTRO Identificador do tipo de registro. Constante “R02”. Texto 3
COD_EMPREGADO Código identificador do empregado que fechou a conta, mas não necessariamente do que vendeu os itens. Numérico 10
NOME_EMPREGADO Nome do empregado que fechou a conta, mas não necessariamente do que vendeu os itens. Texto 70
CONTA Número da conta. Numérico 10
MESA Número da mesa relacionada à conta. Numérico 10
HORARIO_ABERTURA Horário de abertura da conta, no formato “hh:mm”. Não inclui a data. Texto 5
HORARIO_FECHAMENTO Horário de fechamento da conta, no formato “hh:mm”. Não inclui a data. Texto 5
PARTE_DIA Período do dia em que a conta foi fechada. Numérico 2
TOTAL_CONTA Valor total da conta.

TOTAL_CONTA = (R03.VALOR – R03.DESCONTO) + (R04.VALOR – R04.DESCONTO)

ATENÇÃO: O valor devido da conta é TOTAL_CONTA + TOTAL_TAXAS_ADICIONAIS.

Monetário 15,2
TOTAL_TAXAS_ADICIONAIS Valor total das taxas adicionais. Por exemplo, taxa de delivery, taxa de serviço (10%).

ATENÇÃO: Neste formato, os tipos de taxa não poderão ser identificados. Apenas o valor total em taxas adicionais associado à conta.

Monetário 15,2
QTDE_CLIENTES Número de clientes. Numérico 3
CENTRO_RENDA Centro de renda. Numérico 10

1.3.3 REGISTRO R03 – ITEM

Nome Descrição Tipo Tam
TIPO_REGISTRO Identificador do tipo de registro. Constante “R03”. Texto 3
COD_EMPREGADO Código identificador do empregado que vendeu o item, mas não necessariamente do que fechou a conta. Numérico 10
NOME_EMPREGADO Nome do empregado que vendeu o item, mas não necessariamente o empregado que fechou a conta. Texto 70
CONTA Número da conta. Numérico 10
HORARIO Horário de venda do item, no formato “hh:mm”. Não inclui a data. Texto 5
COD_ITEM Código do item. Numérico 10
NOME_ITEM Nome do item. Texto 25
MODO_PEDIDO Tipo de pedido utilizado no item Numérico 2
CANCELADO Indica se o item foi cancelado. O valor “1” indica cancelado e o valor “0 indica não cancelado. Numérico 1
MOTIVO_CANCELAMENTO Código do motivo de cancelamento, caso o item tenha sido cancelado. Quando essa informação não estiver disponível, deverá ser enviado o valor padrão “0”. Numérico 2
VALOR Valor de venda do item.

VALOR = (<PRECO_UNITARIO> * QUANTIDADE)

Monetário 15,2
QUANTIDADE Quantidade vendida do item.

ATENÇÃO: Esta informação não está disponível quando o item é cancelado. O valor default “1” será utilizado.

Monetário 15,4
DESCONTO Valor do desconto concedido sobre o valor de venda. O desconto pode ser concedido utilizando-se diversos recursos como promoções e cortesias, sendo diluído entre os itens referentes. Monetário 15,2
CODIGO_DESCONTO Código do desconto concedido, caso haja. Quando essa informação não estiver disponível, deverá enviar o valor padrão “0”. Numérico 2
TERMINAL Número do terminal onde o item foi vendido.

ATENÇÃO: Esta informação não está disponível quando o item é cancelado. O valor default “0” será utilizado.

Numérico 10

1.3.4 REGISTRO R04 – MODIFICADOR

Nome Descrição Tipo Tam
TIPO_REGISTRO Identificador do tipo de registro. Constante “R03”. Texto 3
COD_EMPREGADO Código identificador do empregado que vendeu o item modificador, mas não necessariamente o que fechou a conta. Numérico 10
NOME_EMPREGADO Nome do empregado que vendeu o item modificador, mas não necessariamente o que fechou a conta. Texto 70
CONTA Número da conta. Numérico 10
HORARIO Horário de venda do item modificador, no formato “hh:mm”. Não inclui a data! Texto 5
COD_ITEM Código do item modificador. Numérico 10
NOME_ITEM Nome do item modificador. Texto 25
CANCELADO Indica se o item modificador foi cancelado. O valor “1” indica cancelado e o valor “0” indica não cancelado. Numérico 1
MOTIVO_CANCELAMENTO Código do motivo de cancelamento, caso o item tenha sido cancelado. Quando essa informação não estiver disponível, deverá ser enviado o valor padrão “0”. Numérico 2
VALOR Valor de venda do item modificador.

VALOR = (<PRECO_UNITARIO> * QUANTIDADE)

Monetário 15,2
QUANTIDADE Quantidade vendida do item modificador.

ATENÇÃO: Esta informação não está disponível quando o item modificador é cancelado. O valor default “1” será utilizado.

Monetário 15,4
DESCONTO Valor do desconto concedido sobre o valor de venda. O desconto pode ser concedido utilizando-se diversos recursos como promoções e cortesias, sendo diluído entre os itens referentes. Monetário 15,2
CODIGO_DESCONTO Código do desconto concedido, caso haja.

Quando essa informação não estiver disponível, deverá ser enviado o valor padrão “0”.

Numérico 2
TERMINAL Número do terminal onde o item modificador foi vendido. ATENÇÃO: Esta informação não está disponível quando o item modificador é cancelado. O valor default “0 será utilizado. Numérico 10

1.3.5 REGISTRO R05 –- PAGAMENTO

Nome Descrição Tipo Tam
TIPO_REGISTRO Identificador do tipo de registro. Constante “R05”. Texto 3
COD_EMPREGADO Código identificador do empregado que fechou a conta, mas não necessariamente do que vendeu os itens. Numérico 10
NOME_EMPREGADO Nome do empregado que fechou a conta, mas não necessariamente do que vendeu os itens. Texto 70
CONTA Número da conta. Numérico 10
HORARIO Horário em que o pagamento foi aplicado, no formato “hh:mm”. Não inclui a data! Texto 5
COD_FORMA_PAGAMENTO Código da forma de pagamento. Numérico 10
NOME_FORMA_PAGAMENTO Nome da forma de pagamento. Texto 10
VALOR Valor pago.

ATENÇÃO: O valor pode ser negativo caso a forma de pagamento seja Dinheiro, para indicar troco.

Monetário 15,2

1.3.6 REGISTRO R99 -– RODAPÉ DO ARQUIVO

Nome Descrição Tipo Tam
TIPO_REGISTRO Identificador do tipo de registro. Constante “R99”. Texto 3
QTDE_LINHAS A quantidade total de linhas do arquivo, incluindo todos os tipos de registro. Numérico 10
ASSINATURA Informar o CNPJ sem formatação Texto 14

2.0 Importação do Financeiro

Essa seção descreve o layout de integração dos processos de financeiros de outros sistemas de lojas (PDV) com o EVEREST.

2.1 Layout de Importação do Financeiro

A conciliação de caixa é um processo que deve ser realizado diariamente, sempre que houver vendas. Após o fechamento da conciliação, caso esteja configurado, é gerado no diretório especificado o Arquivo de Integração com o EVEREST.

Cada arquivo é nomeado da seguinte forma:

FINANCEIRO_<data-do-movimento>_<código-da-filial>.txt

A “<data-do-movimento>” indica a data à qual as vendas se referem no PDV, no formato “dd-mm-aaaa”.

O “<código-da-filial>” é o número único que representa o estabelecimento no EVEREST.

O arquivo de integração é gerado em formato texto plano, utilizando-se o caractere “TAB” como delimitador de campos. Abaixo, a estrutura que o arquivo segue:

importacaopdv2•

Registro R01 – Cabeçalho do Arquivo

Deve existir uma e somente uma ocorrência deste registro por arquivo e deve ser a primeira linha.

Registro R02 – Pagamentos

Deve existir uma ocorrência deste registro por forma de pagamento no Sistema de Loja (PDV).

Registro R99 – Rodapé do Arquivo

Deve existir uma e somente uma ocorrência deste registro por arquivo e deve ser a última linha.

2.1.1 REGISTRO R01 – CABEÇALHO DO ARQUIVO

Nome Descrição Tipo Tam
TIPO_REGISTRO Identificador do tipo de registro. Constante “R01”. Texto 3
DATA_MOVIMENTO A data do movimento às quais as informações se referem no formato “dd/mm/aaaa”. É importante destacar que as vendas realizadas após às 23:59:59 se referem à mesma data de movimento. A data de movimento somente é alterada após a realização do processo de Fim-do-Dia no sistema de loja (PDV). Texto 10
VALOR Totalizador do arquivo financeiro (soma do campo valor do registro R2) Monetário 15,2
DATA_GERACAO Data/hora de geração do arquivo, no formato “dd/mm/aaaa hh:mm:ss” Texto 19
CNPJ Informar o CNPJ sem formatação. Texto 14

2.1.2 REGISTRO R02 – CONTA

Nome Descrição Tipo Tam
TIPO_REGISTRO Identificador do tipo de registro. Constante “R02”. Texto 3
NOME_FORMA_PAGAMENTO Nome da forma de pagamento no sistema de loja (PDV). Texto 10
VALOR Valor recebido. Este valor é o informado durante o processo de conciliação de caixa e, portanto, pode ser diferente ao valor indicado pelo sistema de loja (PDV). Monetário 15,2
CODIGO_FORMA_PAGAMENTO Código interno da forma de pagamento Texto 10

2.1.3 REGISTRO R99 -– RODAPÉ DO ARQUIVO

Nome Descrição Tipo Tam
TIPO_REGISTRO Identificador do tipo de registro. Constante “R99”. Texto 3
ASSINATURA Informar o CNPJ sem formatação Texto 14

2.2 Exemplo do Nome do Arquivo

Nome do arquivo:“ FINANCEIRO_01-07-2014_0000000.txt

 

Tags