Skip to main content

​
Endpoint

POST https://api.tiny.com.br/api2/crm.alterar.situacao.acao.php

​
Parâmetros

ParâmetroTipoOcorrênciaDescrição
tokenstringobrigatórioChave gerada para identificar sua empresa
idAcaointobrigatórioNúmero de identificação da ação do assunto na Olist
situacaoAcaointobrigatórioCódigo conforme tabela de Situações da ação
formatostringobrigatórioFormato do retorno (json)

​
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.situacao.acao.php \
  -d "token=SEU_TOKEN&idAcao=123456&situacaoAcao=1&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"
  }
}