F066VAR - Parâmetros das Formas de Pagamento para Varejo

1. Imprime o relatório quando:

• possui template de relatório definido para a forma de pagamento
• está definido para emitir o comprovante, na forma de pagamento

2. O template é definido através de tags

A TAG tem inicio e fim, conforme as opções:

1. em pares: a primeira declaração define o início da TAG e a segunda declaração define o fim da TAG. Exemplo: <TAG>...texto...</TAG>
2. única: a TAG é definida uma só vez representando a definição de início e fim da TAG. Exemplo: <TAG/>

3. Condições

Tags de blocos podem ter uma condição definida através do texto “condição”

• A definição de TAG segue a representação de TAGs em pares;
• Todo o conteúdo delimitado entre a definição de TAG inicial e final do bloco somente deve ser processado caso a condição seja verdadeira;
• Não deve ser permitido alinhar TAGs de blocos condicionais dentro de outras TAGs de blocos condicionais;
• O sistema disponibiliza os tipos de formas de pagamento como condições fixas;

1. A condição fixa é definida através da propriedade "pagamento";
2. A propriedade "pagamento" pode ser definida simultaneamente com a propriedade "condição", neste caso é considerado como operador lógico o "E" entre as expressões;
3. Os tipos de formas de pagamento disponíveis para a propriedade "pagamento" são:

• "DINHEIRO"
• "CHEQUE"
• "CREDIARIO"
• "CARTAO"
• "POS"
• "APROVEITAMENTO_CREDITO"

4. O sistema imprime o template apenas uma vez, caso o template seja o mesmo e seja utilizado em formas de pagamento diferentes, ou seja, não repete a impressão do mesmo template para o mesmo relatório;

4. Listas

O sistema permite que sejam definidas TAG para tratamento de listas.

1. São consideradas TAGs de lista, as TAGs que permitem definir um looping em uma lista;
2. As TAGs de lista são:

1. <PRODUTOS>, define iteração na lista de itens de produtos do cupom fiscal;
2. <SERVICOS>, define iteração na lista de itens de serviços do cupom fiscal;
3. <PARCELAS>, define iteração na lista das parcelas do cupom fiscal;
4. <ENDERECOS>, define iteração na lista de endereços do cliente;
5. <VENDEDORES>, define iteração na lista de vendedores participantes;
6. <OUTRAS_INFORMACOES>, permite realizar a impressão de outras informações do pedido no relatório gerencial de pós-venda;

3. O sistema permite definir uma expressão para filtrar os itens da lista, através da tag “filter”.

1. A expressão de filtro deve ser válida; Do contrário será silenciosamente ignorada;

4. A lista que não contem ítens (vazia) será silenciosamente ignorada, e nada será impresso no relatório.

 

5. Expressões

O sistema interpreta e aplica filtros nas informações contidas em lista de dados.
Expressões disponíveis:

IGUAL A: representado pelo simbolo "=";
DIFERENTE DE: representado pelo simbolo "<>";
MAIOR QUE: representado pelo simbolo ">";
MENOR QUE: representado pelo simbolo "<";
MAIOR OU IGUAL A: representado pelo simbolo ">=";
MENOR OU IGUAL A: representado pelo simbolo "<=";

 

6. Máscaras

O sistema permite que sejam definidas máscaras para campos conforme o tipo do campo.

Campos numéricos:
A propriedade que define a máscara é "mascara".
Os valores permitidos são:

"0": representa um dígito ou zero
"#": representa um dígito; em caso de valor não representativo (zeros à esquerda) é substituído por branco;
"," : representa o ponto decimal (formato brasileiro);
"." : representa o separador de milhares (formato brasileiro);
";" : caracter separador para as máscaras de números positivos e negativos;

 

Datas
Os valores permitidos são:

d: representa o dia do mês;
M: representa o mês do ano (maiúsculo);
y: representa o ano;

Caso não seja definida nenhuma mascara, o sistema deverá assumir como padrão a máscara "dd/MM/yyyy"/>

 

7. Formatação de texto

O sistema permite a definição de TAGs pré-definidas, conforme segue:

• <CENTRO> ...texto... </CENTRO>: centraliza o texto contido entre as TAGs de início e fim;
• <MAIUSCULO> ...texto... </MAIUSCULO>: converte em letras maiúsculas o texto contido entre as TAGs de início e fim;
• <MINUSCULO> ...texto... </MINUSCULO>: converte em letras minúsculas o texto contido entre as TAGs de início e fim;
• <CORTEPAPEL/>: realiza o corte do papel, quando o recurso estiver disponível na impressora;

 

8. Limites

O sistema deve permite que sejam definidos os tamanhos máximo e mínimo para os campos do tipo alfanuméricos.
As propriedade que definem este limites são:

min: define o tamanho mínimo do campo alfanumérico. Se a string for menor que o tamanho mínimo, ela é preenchida com espaços em branco até atingir o tamanho mínimo definido. Caso não seja definido tamanho mínimo, não existirá preenchimento do valor;

max: define o tamanho máximo do campo alfanumérico. O conteúdo é truncado caso ultrapasse o valor definido. Caso não seja definido o tamanho máximo, então é assumido o tamanho mínimo se este estiver declarado.

Estas propriedades somente tem efeito em campos tipo alfanuméricos.

 

9. Referência à produtos

O sistema permite a definição de TAG para representar uma lista com os códigos dos produtos ao qual o serviço faz referência.
A definição da TAG é <PRODUTO_REF/>

 

10. Tags

As variáveis disponíveis e permitidas são:

Cupom:

<COO_CUPOM_REF>: número do cupom fiscal de referência ou número da NFC-e;
<TOTAL_CUPOM_REF>: valor total do cupom fiscal de referência;
<TOTAL_PAGO_CUPOM>: valor que já foi pago do cupom (em dinheiro, cartão ou qualquer outra forma, exceto a prazo);
<TOTAL_PARCELADO>: Valor total parcelado (valor a prazo);
<CRO_CUPOM_REF>: número do contador de reinício de operação, de referência;
<COD_ECF_CUPOM_REF>: número do equipamento fiscal, de referência;
<SERIE_ECF_CUPOM_REF>: número de série do equipamento fiscal de referência ou número da série da NFC-e;
<DAV_NUMERO>: número do DAV faturado na venda (pré-venda, pedido ou pedido para entrega futura);
<DAVS_MESCLADOS>: número dos DAVs utilizados na mesclagem de DAV (não inclui o novo DAV gerado), separados por vírgula (","). Exemplo de saída: "101,102,103".

 

Filial:

<COD_FILIAL>: código da filial;
<NOME_FILIAL>: nome da filial.

 

Operador:

<COD_OPERADOR>: código do operador;
<LOGIN_OPERADOR>: login do operador;
<NOME_OPERADOR>: nome do operador.

 

Cliente (os dados do endereço são referente ao endereço que está definido como principal para o cliente):

<COD_CLIENTE>: código do cliente (somente de permitido conforme a configuração “Entidade.ExibeCodigo”);
<NOME_CLIENTE>: nome do cliente;
<CPF_CLIENTE>: número do cadastro de pessoa fisica do cliente;
<RG_CLIENTE>: número do registro geral do cliente;
<DT_RG_CLIENTE>: data de expedição do registro geral do cliente;
<CL_END_TIPO>: Tipo do endereço (Cadastro, Entrega, Cobrança);
<CL_END_CODIGO>: Código do endereço;
<CL_END_UF>: UF do endereço;
<CL_END_MUNICIPIO>: município do endereço;
<CL_END_BAIRRO>: bairro do endereço;
<CL_END_LOGRADOURO>: logradouro do endereço;
<CL_END_NUMERO>: número do logradouro;
<CL_END_COMPLEMENTO>: complemento do endereço;
<CL_END_CEP>: código de endereçamento postal do endereço;
<CL_END_REFERENCIA>: ponto de referência;
<CL_END_CONTATO>: pessoa de contato;
<CL_END_CPF_CONTATO>: CPF da pessoa de contato;
<CL_END_TELEFONE>: telefone de contato;
<CL_END_CELULAR>: celular de contato.

 

Condições de pagamento / parcelamento

<QTD_PARCELAS>: número total de parcelas;
<COD_COND_PAGTO>: Código da condição de pagamento;
<DESC_COND_PAGTO>: Descrição da condição de pagamento.

 

Detalhamento do Produto, para serem definidos em conjunto com TAG de lista de dados <PRODUTOS>

<COD_PRODUTO>: código do produto;
<DESC_PRODUTO>: descrição do produto;
<SIT_PRODUTO>: situação do produto (entregue / entregar);
<QTD_ENTREGA>: quantidade do produto: o valor depende do filtro definido, podendo corresponder a quantidade "entregue" ou "entregar" respectivamente. Caso não tenha sido definido filtro, então é assumida a quantidade do produto, não importando se a situação é "entregue" ou "entregar";
<QTD_PRODUTO>: quantidade do produto.

 

Detalhamento do Serviço, para serem definidos em conjunto com TAG de lista de dados <SERVICOS>
(Os dados do endereço são referente ao relacionamento do serviço de frete ao endereço de entrega)

<COD_SERVICO>: código do serviço;
<DESC_SERVICO>: descrição do serviço;
<TOTAL_SERVICO>: Valor total do item de serviço;
<TIPO_SERVICO>: tipo do serviço (frete / garantia estendida / seguro parcela);
<PRODUTO_REF>: listagem dos códigos de produtos ao qual o item de serviço referencia;
<SV_END_TIPO>: Tipo do endereço (Cadastro, Entrega, Cobrança);
<SV_END_CODIGO>: Código do endereço;
<SV_END_UF>: UF do endereço;
<SV_END_MUNICIPIO>: município do endereço;
<SV_END_BAIRRO>: bairro do endereço;
<SV_END_LOGRADOURO>: logradouro do endereço;
<SV_END_NUMERO>: número do logradouro;
<SV_END_COMPLEMENTO>: complemento do endereço;
<SV_END_CEP>: código de endereçamento postal;
<SV_END_REFERENCIA>: ponto de referência;
<SV_END_CONTATO>: pessoa de contato;
<SV_END_CPF_CONTATO>: CPF da pessoa de contato;
<SV_END_TELEFONE>: telefone de contato;
<SV_END_CELULAR>: celular de contato.

 

Detalhamento do endereço, para serem definidos em conjunto com TAG de lista de dados <ENDERECOS>

<END_TIPO>: Tipo do endereço (Cadastro, Entrega, Cobrança);
<END_CODIGO>: Código do endereço;
<END_UF>: UF do endereço;
<END_MUNICIPIO>: município do endereço;
<END_BAIRRO>: bairro do endereço;
<END_LOGRADOURO>: logradouro do endereço;
<END_NUMERO>: número do logradouro;
<END_COMPLEMENTO>: complemento do endereço;
<END_CEP>: código de endereçamento postal;
<END_REFERENCIA>: ponto de referência;
<END_CONTATO>: pessoa de contato;
<END_CPF_CONTATO>: CPF da pessoa de contato;
<END_TELEFONE>: telefone de contato;
<END_CELULAR>: celular de contato.

 

Detalhamento da Parcela, para serem definidos em conjunto com TAG de lista de dados <PARCELAS>:

<NUM_PARCELA>: número da parcela;
<DT_VEN_PARCELA>: data de vencimento da parcela;
<VALOR_PARCELA>: valor da parcela;
<COD_BARRAS>: representação do localizador da parcela em código de barras;
<LOC_PARCELA>: código localizador da parcela.

 

Detalhamento do Vendedor, para serem definidos em conjunto com TAG de lista de dados <VENDEDORES><COD_VENDEDOR>: código do vendedor

<LOGIN_VENDEDOR>: login do vendedor;
<NOME_VENDEDOR>: nome do vendedor.

 

O sistema irá substituir a TAG definida no texto de modelo do relatório de pós-venda pelo respectivo valor armazenado na respectiva variável:

Cartão presente:

<CARTAO_PRESENTE>: para inserir as informação do cartão presente é necessário inserir essa tag;
<DESC_CARTAO_PRESENTE/>: descrição desejada para o cartão Presente;
<NUM_CARTAO_PRESENTE/>: número do cartão presente;
<VALOR_CARTAO_PRESENTE/>: valor do cartão presente;
<COD_BARRAS_CARTAO_PRESENTE/>: código de barras representando o número do cartão presente.

11. Código de barras

O sistema permite imprimir o localizador da parcela em código de barras, caso o ECF tenha esse recurso. Se o ECF não tiver esse recurso, caso contrário será impresso apenas o número do localizador.

Tag: <COD_BARRAS/>

 

12. Filtros

O sistema interpreta e aplica as expressões de filtro nas informações contidas em lista de dados:

IGUAL A : representado pelo simbolo "=";
DIFERENTE DE : representado pelo simbolo "<>";
MAIOR QUE : representado pelo simbolo ">";
MENOR QUE : representado pelo simbolo "<";
MAIOR OU IGUAL A : representado pelo simbolo ">=";
MENOR OU IGUAL A : representado pelo simbolo "<=";

O filtro deve ser definido dentro de um atributo chamado filter, na tag de lista. Todos os registros contidos na lista serão processados pela expressão de filtro e somente os que resultarem em verdade serão processados.

 

A expressão sempre deve seguir o seguinte formato:

[tag sendo filtrada] [símbolo] [valor alvo]

onde:

[tag sendo filtrada] = cada tag das possíveis tags que podem ser usadas dentro da lista atual.
[símbolo] = qualquer um dos símbolos definidos na listagem acima: =, <>, >, <, >= e <=.
[valor alvo] = um valor fixo que será comparado com a tag sendo filtrada. Se for número, digitar somente os números; se for uma enumeração, um campo textual ou uma data, digitar o valor entre apóstrofos.

Para realizar o filtro com datas, deve ser respeitada a mascara "dd/MM/yyyy", conforme definição de máscaras.

 

13. Enumerações

O sistema permite definir tags de enumerações, ou seja, tags que somente podem possuir um valor de um conjunto fixo de valores.

1) cada tag de enumeração possui somente um conjunto de valores possíveis;

2) as TAGs de enumeração são:

1. a) <CL_END_TIPO> - Tipo do endereço principal do cliente. Conjunto de valores: 'Cadastro', 'Entrega' e 'Cobrança'.
2. b) <SIT_PRODUTO> - Situação do produto usada dentro da lista <PRODUTOS>. Conjunto de valores: 'Entregue' e 'Entregar';
3. c) <TIPO_SERVICO> - Tipo do serviço, usado dentro da lista <SERVICOS>. Conjunto de valores: 'Frete', 'Garantia Estendida' e 'Seguro Parcela Protegida' - Frete só estará disponível como item quando for vendido como item no cupom fiscal, do contrário, quando for vendido por valor, utilizar a variável <TOTAL_FRETE>;
4. d) <SV_END_TIPO> - Tipo do endereço usado no frete. Conjunto de valores: 'Cadastro', 'Entrega' e 'Cobrança';
5. e) <END_TIPO> - Tipo do endereço usado dentro da lista <ENDERECOS>. Conjunto de valores: 'Cadastro', 'Entrega' e 'Cobrança'.

3) podem ser utilizadas como filtros, conforme item 12 deste documento.