> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.erp.olist.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Alterar Estágio do Assunto do CRM

> Serviço destinado a alterar o estágio do assunto no CRM.

## Endpoint

```
POST https://api.tiny.com.br/api2/crm.alterar.estagio.assunto.php
```

## Parâmetros

| Parâmetro      | Tipo   | Ocorrência  | Descrição                                   |
| -------------- | ------ | ----------- | ------------------------------------------- |
| token          | string | obrigatório | Chave gerada para identificar sua empresa   |
| idAssunto      | int    | obrigatório | Número de identificação do assunto na Olist |
| estagioAssunto | int    | obrigatório | Código do estágio do assunto (1)            |
| formato        | string | obrigatório | Formato do retorno (json)                   |

> (1) Código conforme configuração da conta Olist, obtidos através da "Lista de estágios de assuntos do CRM"

## Retorno

| Campo                         | Tipo   | Tamanho | Ocorrência  | Descrição                                 |
| ----------------------------- | ------ | ------- | ----------- | ----------------------------------------- |
| retorno                       | object | -       | obrigatório | Elemento raiz do retorno                  |
| retorno.status\_processamento | int    | -       | obrigatório | Conforme tabela "Status de Processamento" |
| retorno.status                | string | -       | obrigatório | "OK" ou "Erro"                            |
| retorno.codigo\_erro          | int    | -       | obrigatório | Conforme tabela "Códigos de erro"         |
| retorno.erros\[]              | list   | -       | condicional | Lista dos erros encontrados \[0..n]       |
| retorno.erros\[].erro         | string | -       | condicional | Descrição do erro                         |

## Exemplo de chamada

```bash theme={null}
curl -X POST https://api.tiny.com.br/api2/crm.alterar.estagio.assunto.php \
  -d "token=SEU_TOKEN&idAssunto=12356&estagioAssunto=2&formato=json"
```

## Exemplos de retorno

### Erro - Token inválido

```json theme={null}
{
  "retorno": {
    "status_processamento": 1,
    "status": "Erro",
    "codigo_erro": 2,
    "erros": [
      {
        "erro": "token invalido"
      }
    ]
  }
}
```

### Erro - Registro não encontrado

```json theme={null}
{
  "retorno": {
    "status_processamento": 2,
    "status": "Erro",
    "registros": [
      {
        "registro": {
          "sequencia": "1",
          "status": "Erro",
          "codigo_erro": "32",
          "erros": [
            {
              "erro": "Registro não encontrado"
            }
          ]
        }
      }
    ]
  }
}
```

### Sucesso

```json theme={null}
{
  "retorno": {
    "status_processamento": 3,
    "status": "OK"
  }
}
```