Skip to main content

​
Endpoint

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

​
Parâmetros

ParâmetroTipoOcorrênciaDescrição
tokenstringobrigatórioChave gerada para identificar sua empresa
idAssuntointobrigatórioNúmero de identificação do assunto na Olist
estagioAssuntointobrigatórioCódigo do estágio do assunto (1)
formatostringobrigatórioFormato 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

CampoTipoTamanhoOcorrênciaDescrição
retornoobject-obrigatórioElemento raiz do retorno
retorno.status_processamentoint-obrigatórioConforme tabela “Status de Processamento”
retorno.statusstring-obrigatório”OK” ou “Erro”
retorno.codigo_erroint-obrigatórioConforme tabela “Códigos de erro”
retorno.erros[]list-condicionalLista dos erros encontrados [0..n]
retorno.erros[].errostring-condicionalDescrição do erro

​
Exemplo de chamada

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

{
  "retorno": {
    "status_processamento": 1,
    "status": "Erro",
    "codigo_erro": 2,
    "erros": [
      {
        "erro": "token invalido"
      }
    ]
  }
}

​
Erro - Registro não encontrado

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

​
Sucesso

{
  "retorno": {
    "status_processamento": 3,
    "status": "OK"
  }
}