# Validador de ficha/vale/ticket, o que preciso saber?

{% hint style="danger" %}

#### **Pré-requisitos:**

* **Licença habilitada**: Solicite a ativação do módulo *Validador de Tickets* via OEM.
* **Dispositivo Android**: Para instalação do aplicativo *Validador de Tickets*.
* **Acesso à retaguarda**: Para obter o código do grupo econômico e token.
* **Veja o material:** [**Como Configurar a Impressão de Ficha/Ticket no PDV Legal?**](/pdv/funcionalidades-vendas/como-configurar-a-impressao-de-vale-ficha-ticket-no-pdv-legal.md)
  {% endhint %}

## Como configurar o Validador de ficha/vale/ticket (Mata Ficha)? 

{% stepper %}
{% step %}

### **Ativar o Módulo no OEM**

* Contate o suporte para habilitar *Validador de Tickets* na licença.
  {% endstep %}

{% step %}

### **Configurar Produtos**

* No Retaguarda Cloud:
  * Acesse **Retaguarda Cloud > Produtos > Produtos** 
  * **Localize o produto** e clique em: **Editar**.

{% hint style="warning" %}
Para versões inferiores á 25.06.01.600, No campo Código de Venda, insira um número dentro da faixa 3 dígitos (ex: 150).

Para versões: **25.06.01.600** ou superior insira um número à partir de 3 dígitos (ex: 100). **(**[**Veja quais dados serão validados.**](#quais-dados-serao-validados)**)**
{% endhint %}

* Salve as alterações.

<figure><img src="/files/T6bFVhgyHGHDP9BVoCVW" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### **Baixar e Instalar o Aplicativo**

* Acesse [app.tabletcloud.com.br](http://app.tabletcloud.com.br/)&#x20;
* Faça download do **Validador de Tickets**.
* Instale o APK no dispositivo Android (habilite *Fontes Desconhecidas*).
  {% endstep %}

{% step %}

### **Configurar Login no Aplicativo**

* **Obtenha os dados na retaguarda**:
  1. Acesse **Administrativo > Filiais > Editar > Meus Terminais > Visualizar**.
  2. Anote:
     * **Cód. Empresa**: Código do grupo econômico (apenas números).
     * **Senha do WebService**.
     * **Token Validar**.

<figure><img src="/files/DwtuN07iZDsxdEg6eaS6" alt=""><figcaption></figcaption></figure>

* **No aplicativo**:
  * Insira os dados coletados e clique em **Registrar**.

<figure><img src="/files/kHwdtlnw50g5gTHTL1Xm" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### **Validar Fichas/Vales/Tickets**

* Abra o aplicativo e aproxime o código de barras do ticket do leitor.

<figure><img src="/files/z5YmNCnBIQ1nHd0iCSmG" alt=""><figcaption></figcaption></figure>

* **Resultados possíveis**:
  * **Válido**: Exibe *"Ticket válido! Consumo liberado."*
  * **Inválido**: Exibe *"Ticket já utilizado!"*
  * **Urgente**: Exibe *"Produto não localizado"*

<figure><img src="/files/T57nka2jVQk6y6aPwxCi" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## **Quais dados serão validados?**

<figure><img src="/files/5mYVJN5Zz2xwRZWSQc9V" alt=""><figcaption></figcaption></figure>

| Versão:                                      | v2                                                       |
| -------------------------------------------- | -------------------------------------------------------- |
| **Tamanho:**                                 | 36 caracteres                                            |
| **Leitura humana:**                          | AX8878000000000001071D5PABCDEFGHIJKL                     |
| **Token Filial:**                            | <p><strong>AX8</strong>878000000000001071D5PABCDEFGHIJKL |
| <br>(Tamanho 3)</p>                          |                                                          |
| **Código Produto:**                          | <p>AX8<strong>8780000000000</strong>01071D5PABCDEFGHIJKL |
| <br>(Tamanho 13)</p>                         |                                                          |
| **Sequência&#xD; (ID venda):**               | <p>AX88780000000000<strong>0107</strong>1D5PABCDEFGHIJKL |
| <br>(Tamanho 4)</p>                          |                                                          |
| **\*\* Contador de&#xD; Item&#xD; (1..33):** | <p>AX887800000000000107<strong>1</strong>D5PABCDEFGHIJKL |
| <br>(Tamanho 1)</p>                          |                                                          |
| **\*\* Data Impressão&#xD; (codificada):**   | <p>AX8878000000000001071<strong>D5P</strong>ABCDEFGHIJKL |
| <br>(Tamanho 3)</p>                          |                                                          |
| **TAG/MAC&#xD; terminal:**                   | <p>AX8878000000000001071D5P<strong>ABCDEFGHIJKL</strong> |
| <br>(Tamanho 12)</p>                         |                                                          |

{% hint style="info" %}
**(\*\*)** utilizamos a representando alfanumérica de números de 1 até 33; desta forma: <br>

a) Números de 1..9 serão representados por eles mesmos;
\
b) Números de 10..33 serão codificados por letras maiúsculas de A..Z , onde A representa número 10 e
&#x20;Z, representa 33.&#x20;

**Exemplo:** Para converter 13/05/25 , teríamos 13->D, 5->5 e 25 ->P, ou seja, D5P.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ajuda.pdvlegal.com.br/integracoes/validador-de-ficha-vale-ticket-o-que-preciso-saber.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.