> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/manage-disposition-codes.md).

# Gerenciar códigos de disposição

<a href="https://pxa.impact.com/student/activity/1117597?sid=0c0e3e5c-54c9-4435-9bee-ebcdccb7f292&#x26;sid_i=0?utm_source=app.impact.com&#x26;utm_medium=owned-platform&#x26;utm_content=tra-350&#x26;utm_campaign=help-center" class="button primary">Faça o curso PXA</a>

Uma *Código de disposição* é um código personalizado que inicializa o estado de uma ação ou atualiza o estado de uma ação quando ela foi atualizada.

Na maioria dos casos, os códigos de disposição são usados para definir motivos personalizados para que uma ação tenha mudado (ou seja, modificada, aprovada ou revertida). Em cenários com bloqueio aberto ou longas janelas de aprovação de ação, os códigos de disposição podem oferecer mais transparência aos parceiros, permitindo que eles vejam uma atualização do status de relatório de uma ação pendente.

Os Códigos de Disposição são usados ao enviar conversões para a impact.com ou ao enviar atualizações de ação (modificações e reversões).

#### **Criar um código de disposição**

1. Na barra de navegação superior, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[Perfil do usuário] → Configurações**.
2. No *Programa* na coluna da direita, encontre o *Rastreamento* seção e selecione **Tipos de evento**.
3. Encontre o tipo de evento ao qual você quer adicionar códigos de disposição e selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FMLtRUwWz0pujlfmYWOgg%2FMoreVN.svg?alt=media\&token=03a3c355-a347-4207-baf7-c44fadf6d080) **\[Menu] → Códigos de Disposição**.
4. Na *Códigos de Disposição* página, no canto superior direito, selecione **Adicionar Código de Disposição**.
5. Configure o código de disposição de acordo com suas necessidades:
   * **Código de Disposição:** Escolha se quer usar um código padrão ou criar o seu próprio código. Os códigos de disposição diferenciam maiúsculas de minúsculas — ao usá-los, você deve enviar o valor exato fornecido aqui.
   * **Nome da Disposição:** Forneça um nome para este código de disposição, que aparecerá na página de Códigos de Disposição para o tipo de evento.
   * **Transição de Estado:** Escolha o estado de relatório ao qual esta disposição será aplicada na ação — o parceiro poderá ver isso.
   * **Alteração da ação:** Escolha o que acontecerá com a ação quando este código de disposição for aplicado.
6. Selecione **Salvar** para criar o código.

#### **Excluir um código de disposição**

1. Na barra de navegação superior, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[Perfil do usuário] → Configurações**.
2. No *Programa* na coluna da direita, encontre o *Rastreamento* seção e selecione **Tipos de evento**.
3. Encontre o tipo de evento ao qual você quer adicionar códigos de disposição e selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FMLtRUwWz0pujlfmYWOgg%2FMoreVN.svg?alt=media\&token=03a3c355-a347-4207-baf7-c44fadf6d080) **\[Menu] → Códigos de Disposição**.
4. Na *Códigos de Disposição* página, encontre o código de disposição que você quer excluir.
5. No *Ações* coluna, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-df93ac0f80fc5cece7983980a5ce3fbcf19aabce%2F3ef9d737089bc07dbb7e4fd41a97edfbaec261e4f55ab3a1666f3daf957f69c3.svg?alt=media) **\[Menu suspenso] → Excluir**.
6. No modal de aviso, selecione **Entendo, continuar**.

#### **Editar um código de disposição**

1. Na barra de navegação superior, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[Perfil do usuário] → Configurações**.
2. No *Programa* na coluna (lado direito), encontre o *Rastreamento* seção e selecione **Tipos de evento**.
3. Encontre o tipo de evento ao qual você quer adicionar códigos de disposição e selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FMLtRUwWz0pujlfmYWOgg%2FMoreVN.svg?alt=media\&token=03a3c355-a347-4207-baf7-c44fadf6d080) **\[Menu] → Códigos de Disposição**.
4. Na *Códigos de Disposição* página, encontre o código de disposição que você quer editar.
5. No *Ações* coluna, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-df93ac0f80fc5cece7983980a5ce3fbcf19aabce%2F3ef9d737089bc07dbb7e4fd41a97edfbaec261e4f55ab3a1666f3daf957f69c3.svg?alt=media) **\[Menu suspenso] → Editar**.
6. Faça suas edições e, em seguida, selecione **Salvar**.

<details>

<summary>Exemplo de configuração</summary>

Neste exemplo, vamos configurar um código de disposição para um tipo de evento padrão de venda online/CPA que espera modificações e reversões via arquivo CSV.

Temos três requisitos:

* Queremos um código de disposição personalizado que indique quando uma ação foi modificada devido à devolução de um item.
* Quando modificarmos uma ação usando este código, queremos que o parceiro seja notificado de que isso ocorreu porque um item do pedido foi devolvido.
* O estado da ação será exibido como "modificado" na impact.com.

**Criando o código de disposição**

1. Na barra de navegação superior, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[Perfil do usuário] → Configurações**.
2. No *Programa* na coluna (lado direito), encontre o *Rastreamento* seção e selecione **Tipos de evento**.
3. Na lista de tipos de evento, precisamos encontrar o tipo de evento que queremos modificar. Neste exemplo, vamos modificar nosso único *Venda* tipo de evento.
4. Na coluna Ações, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-df93ac0f80fc5cece7983980a5ce3fbcf19aabce%2F3ef9d737089bc07dbb7e4fd41a97edfbaec261e4f55ab3a1666f3daf957f69c3.svg?alt=media) **\[Menu suspenso] → Códigos de Disposição**.
5. Na *Códigos de Disposição* página, no canto superior direito, selecione **Adicionar Código de Disposição**.
6. A partir daqui, configuramos o código de disposição de acordo com nossos requisitos.
7. Selecione **Salvar**. Agora este código de disposição pode ser usado como o `Motivo` ao modificar ações (seja [via um arquivo CSV](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-overview.md) ou [via a API](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-process-reversals-via-api-web-services-overview.md), dependendo da configuração do tipo de evento).

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/manage-disposition-codes.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
