# 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?**](https://ajuda.pdvlegal.com.br/pdv/funcionalidades-vendas/como-configurar-a-impressao-de-vale-ficha-ticket-no-pdv-legal)
  {% endhint %}

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

{% 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**&#x20;
  * **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 de **3 dígitos** (ex: 150).

Para versões: **25.06.01.600 ou superior não é necessário. (**[**Veja quais dados serão validados.**](#quais-dados-serao-validados)**)**
{% endhint %}

* Salve as alterações.

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2Fk1uAwoy9pTzRe56oB1l9%2F_%20(25).gif?alt=media&#x26;token=20731078-574b-4eed-897b-d511bccba808" 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="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FlZ0xSXC1H4xSMRLOVDeH%2F_%20(26).gif?alt=media&#x26;token=a808b720-f3dd-4eea-ad50-fc94460653c9" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2F35DGlSTzZuQ7f8VGARaU%2Fmataficha01.png?alt=media&#x26;token=d56f1488-bf87-451f-b75b-baa95f96fdd9" 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="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FvcVgFbSMUTt6UH27UYhs%2F0517db2f-1e47-4244-8bfe-aae918b88726.jpeg?alt=media&#x26;token=f092bb5f-108b-449b-810d-ff59d013ff64" 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="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2F0SRCSJmFg2whQoQdsG9e%2Fmataficha02.png?alt=media&#x26;token=3ecae0d3-15eb-4802-903b-016a82d01d07" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

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

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FVeHMXcvFr307h9q2LTxn%2FScreenshot_21.png?alt=media&#x26;token=ce67b916-6fdb-40f6-914a-84940a66c2bb" 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 %}
