> For the complete documentation index, see [llms.txt](https://help.ticto.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.ticto.com.br/sou-produtor/tictools-integracoes/notas-fiscais/notazz.md).

# Notazz

## Índice

* [Visão geral da integração](#visao-geral-da-integracao)
* [Pré-requisitos](#pre-requisitos)
* [Onde visualizar a API Key no Notazz](#onde-visualizar-a-api-key-no-notazz)
* [Como conectar a Ticto com o Notazz via API (1ª opção)](#como-conectar-a-ticto-com-o-notazz-via-api)
* [Como integrar a Ticto com o Notazz via Webhook (2ª opção)](#como-integrar-a-ticto-com-o-notazz-via-webhook)
* [Como integrar a Ticto com o Notazz utilizando Credencial de API Pública (3ª opção)](#como-integrar-a-ticto-com-o-notazz-utilizando-credencial-de-api-publica)

***

### 🚀 Visão geral da integração

A integração entre a Ticto e o Notazz permite automatizar o envio das informações das vendas para emissão de notas fiscais eletrônicas.

Depois que a integração é configurada, a Ticto envia automaticamente os dados das vendas aprovadas para o Notazz, que será responsável pela comunicação com a prefeitura e pela emissão da nota fiscal.

Benefícios da integração:

* Emissão automática de notas fiscais
* Redução de atividades manuais
* Agilidade no processo fiscal
* Menor risco de erros de preenchimento
* Acompanhamento do status das emissões

{% hint style="info" %}
**Importante**

A emissão das notas fiscais depende das configurações realizadas na Notazz e da autorização da prefeitura do município onde sua empresa está cadastrada.
{% endhint %}

***

### 📋 Pré-requisitos

Antes de realizar a integração, confirme que você possui:

* Conta ativa na Ticto;
* Conta ativa no Notazz;
* Empresa cadastrada e configurada no Notazz;
* Certificado Digital válido (quando exigido pelo município);
* Empresa habilitada para emissão de NFS-e;
* Permissão de administrador nas duas plataformas.

{% hint style="warning" %}
Caso sua empresa ainda não esteja autorizada pela prefeitura para emissão de notas fiscais, a integração funcionará, mas as emissões poderão ser rejeitadas.
{% endhint %}

***

### ⚙️ Onde visualizar a API Key no Notazz

{% stepper %}
{% step %}
Faça login na sua conta em: **<https://app.notazz.com/>** 

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FsLm59SFYLIdvc46uh0Ro%2Fimage.png?alt=media&amp;token=6067556b-0443-48fd-9679-3aa9c0003f5a" alt="" width="251"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Clique em **Configurações** no menu lateral esquerdo e em seguida clique em **Empresas.**

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FCOlRqSXnKrzyhytsxecm%2Fmenu%20esquerdo%20notazz.jpg?alt=media&amp;token=82d2c042-7ff7-433f-880d-bc2a57fd0c0d" alt="" width="179"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**C**lique em **"Copiar"** localizado na coluna chamada **API KEY**, conforme mostra abaixo:

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FQLsOBJ9rsTeksfzY0lMj%2Fimage.png?alt=media&amp;token=74ff6dcc-d5ea-45bd-b663-dcce636f240a" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Uma "janela" com a sua **chave API** irá se abrir, **copie esse código.**

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FI5TXhJl7JSd0RFXqggqc%2Fimage.png?alt=media&amp;token=f3254962-fbd1-4931-a625-6d83dc20bd2c" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="success" %}
Agora que a **API KEY** foi copiada, precisamos fazer login na **Ticto** e criar a integração.
{% endhint %}
{% endstep %}
{% endstepper %}

***

### 🔗 Como conectar a Ticto com o Notazz via API

{% stepper %}
{% step %}
Faça login na sua conta da Ticto e no menu lateral, clique em **TICTOOLS.**

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FYHp96q90S9yQQHDwGdDt%2Fimage.png?alt=media&amp;token=4ff3a5a3-792f-4aef-ad7f-ed524b682518" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Clique em **Notas Fiscais.**

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FghVaKE0IevLfqh4dRk4f%2Fnotas%20fiscais%20tictools.jpg?alt=media&amp;token=457297e7-65d5-4c2d-9255-ad4484b874fa" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Clique em **Notazz.**

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FJj74jC8FvPB2P5ovzzJ1%2Fnotas%20fiscais%20notazz.jpg?alt=media&amp;token=f4bbc53c-8114-4d21-8427-d38fcabb2979" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Clique em **Nova Integração.**

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2F8HEZdJxto0F6MIXzGs9Q%2Fnova%20int%20notazz.jpg?alt=media&amp;token=840c4a50-63d4-4b60-aea8-3c4f2a5d45e0" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Preencha os **campos da integração.**&#x20;

* Tipo da nota se for produto ou serviço
* Nome da integração
* Selecione o Produto
* Cole a API Key do sistema do Notazz
* Defina o nome do item enviado na nota

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FDG5KhIFuDoD4sWXRzTuS%2Fcadastrar%20integracao%20notazz.jpg?alt=media&amp;token=8bb5f880-088a-4b41-af9a-19025eace728" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
Cole exatamente a informação da **API\_KEY** do sistema de notas, para dentro da configuração da Ticto.
{% endhint %}

Clique em **Salvar**.✅

{% hint style="info" %}
Caso utilize ambientes de homologação e produção na Notazz, certifique-se de conectar o ambiente correto
{% endhint %}
{% endstep %}
{% endstepper %}

***

### 🔗 Como integrar a Ticto com o Notazz via Webhook

{% stepper %}
{% step %}
Faça login na sua conta em: **<https://app.notazz.com/>**  <br>

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FsLm59SFYLIdvc46uh0Ro%2Fimage.png?alt=media&amp;token=6067556b-0443-48fd-9679-3aa9c0003f5a" alt="" width="251"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
No menu lateral esquerdo, clique em **Configurações** e em seguida em **Integrações.**

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FZC4DtrtSJcOv37sc0Vak%2Fimage.png?alt=media&amp;token=3f8b0a8b-7ffd-444a-91f9-329ce1e704a6" alt="" width="179"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Clique no botão "+adicionar", pesquise a plataforma TICTO e selecione a opção TICTO 2.0&#x20;

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FAQYhiDG7JkKTUM0ezril%2Fimage.png?alt=media&amp;token=d44ba8a0-6c98-44b8-ae51-77a0cdf55977" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Preencha as informações conforme necessário e copie a **URL de CALLBACK** que será gerada. Iremos utilizá-la nos próximos passos dentro da Ticto.

{% hint style="info" %}
Vamos voltar para a plataforma da Ticto agora, para criar a integração via Webhook.
{% endhint %}
{% endstep %}

{% step %}
Faça login na sua conta da Ticto e no menu lateral, clique em **TICTOOLS.**

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FYHp96q90S9yQQHDwGdDt%2Fimage.png?alt=media&amp;token=4ff3a5a3-792f-4aef-ad7f-ed524b682518" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Clique em **Webhook.**

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FBIHzQ5tFkekgkZJgulnM%2Fwebhook%20tictools.jpg?alt=media&amp;token=f2d7166c-636d-4b79-88bf-56f34b8b0078" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Clique em **Adicionar.**

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2Fni4z7ihrZy4uHcJ1tiNG%2Fwebhooks%20pastas.jpg?alt=media&amp;token=e8c24837-10da-4949-9804-8cdcc9db4f63" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Configure os campos abaixo:

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FgnpntZvTCuIecCGmFZWg%2Fcriando%20webhook%20para%20devzapp.jpg?alt=media&amp;token=c5fbcde5-9f7d-4603-9e32-ddb580f63d4f" alt=""><figcaption></figcaption></figure></div>

| Campo               | Configuração                   |
| ------------------- | ------------------------------ |
| 📦 Produto          | Produto que enviará os eventos |
| 🌐 URL              | URL Callback copiada do Notazz |
| 🔖 Versão           | 2.0 (Recomendada)              |
| 🎯 Formato de Envio | JSON (Recomendado)             |
| 📤 Eventos          | Selecione os eventos desejados |
| {% endstep %}       |                                |

{% step %}
Clique em **Salvar**.✅

{% hint style="success" %}
Pronto, agora as plataformas estão integradas via **Webhook.**
{% endhint %}
{% endstep %}
{% endstepper %}

***

### 🔌 Como integrar a Ticto com o Notazz utilizando Credencial de API Pública

{% stepper %}
{% step %}
Faça login na sua conta da Ticto e clique na sua foto do **Perfil**, localizada no canto superior direito. Em seguida clique em **Credenciais de API**.

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FYl5dysxVWT6kShAPDHcM%2Fdashboard%20perfil%20credenciais.jpg?alt=media&amp;token=dc1be38f-7be7-4634-9dd9-6ababdc95b41" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Clique em **Nova Credencial.**

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2F3vhnC48rFNibA3DIclvO%2Fnova%20credencial%20api.jpg?alt=media&amp;token=6b2e3a9f-1e76-4a5d-8b51-44959aaeb2be" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Defina um **Nome para a Credencial.**

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FiisdEB8BVPY458E2kBnN%2Fimage.png?alt=media&amp;token=457efa22-0623-43a7-b7d7-a517390a6c23" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
A plataforma exibirá:

* **Client ID**
* **Client Secret**

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FqXsW0DcBwv4AJlY6sAhG%2Fimage.png?alt=media&amp;token=e6e03227-c86f-4202-8d29-47030473eaad" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
**Copie esses dados e salve em algum lugar em seu dispositivo para que depois você consiga utilizá-los na configuração do Notazz.**
{% endhint %}

{% hint style="warning" %}
**A chave de acesso só é exibida uma única vez. Copie imediatamente.**\
**Caso perca a chave, será necessário excluir a credencial e criar outra.**
{% endhint %}

{% hint style="danger" %}
**Compartilhe suas credenciais somente com pessoas de confiança.**\
**O uso indevido pode comprometer dados e integrações.**
{% endhint %}

Clique em **Concluir** ✅ para finalizar.
{% endstep %}

{% step %}
Agora vamos configurar dentro do **Notazz**. Em sua conta Notazz, clique em **Configurações** e depois em **Integrações**. Agora clique em **Adicionar.**

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FQimouSUwVYW3sClwEbtY%2Fimage.png?alt=media&amp;token=b77c9b4f-d11f-4ea2-9f61-d50e0aca1cf6" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Pesquise pela **Ticto** e na opção **Ticto API**, clique em **Adicionar Integração**

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2Fg29yO5WfhFZLLKsyvKS8%2Fimage.png?alt=media&amp;token=7dc6bbdb-d26f-4afd-b2d0-eae5b2e6ad8a" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Preencha as duas primeiras colunas.

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FUGeuv11fC4NafYVgX3w8%2Fimage.png?alt=media&amp;token=6c844453-0bb9-40ea-bc37-c999b49a5d38" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
Caso precise de detalhes dos campos, deixaremos aqui o link direto do artigo do Notazz explicando tudo.

<https://suporte.notazz.com/integracao-ticto-via-api/>
{% endhint %}
{% endstep %}

{% step %}
**Preencha os campos:**

* **Client ID**
* **Client Secret**

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2F2iF4YvaxjdEMzeBzgNWG%2Fnotazz%20tela%20de%20secret%20id%20.jpg?alt=media&amp;token=4a254f5a-a7a4-4e37-96b4-5ff8c9081dd0" alt=""><figcaption></figcaption></figure></div>

{% hint style="warning" %}
**Utilize exatamente os dados gerados e já copiados na tela de credencial que você criou na Ticto.**
{% endhint %}

Preencha os demais campos em relação às configurações de nota fiscal e clique em **Salvar**✅.

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FyjX094ARxdNw7ZBMAywX%2Fimage.png?alt=media&amp;token=2701a34b-532a-415c-ac43-c75294e01645" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

***