# API CEST

Manual da API CEST - versão 3 - 29/06/2021

# Introdução

Retorna os códigos CEST relacionados ao NCM informado.

# Acesso

Informações de acesso e autenticação da API.

# Acesso

**Swagger**: [https://app.systax.com.br/auth/swagger#/cest/get\_cest](https://app.systax.com.br/auth/swagger#/cest/get_cest)

**API CEST (Rest / JSON)**

**Método**: POST

**Endpoint**: [http://app.systax.com.br/cest](http://app.systax.com.br/cest "http://app.systax.com.br/cest")

# Autenticação

A autenticação na API CEST é feita via bearer token.

Para mais informações sobre como gerá-la, acesse a última documentação do manual da API de geração de token.

# Funcionalidade

Descrição dos campos de chamada e retorno da API, e exemplos.

# Descrição dos campos de chamada

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-campo-pai-descri%C3%A7%C3%A3o-" style="width: 100%;"><tbody><tr><td style="width: 8.93538%;">**Campo**</td><td style="width: 7.03601%;">**PAI**</td><td style="width: 68.7723%;">**Descrição**</td><td style="width: 15.2563%;">**Obrigatório**</td></tr><tr><td style="width: 8.93538%;">itens</td><td style="width: 7.03601%;">/</td><td style="width: 68.7723%;">/</td><td style="width: 15.2563%;">/</td></tr><tr><td style="width: 8.93538%;">id</td><td style="width: 7.03601%;">itens</td><td style="width: 68.7723%;">Sequencial</td><td style="width: 15.2563%;">Não</td></tr><tr><td style="width: 8.93538%;">NCM</td><td style="width: 7.03601%;">itens</td><td style="width: 68.7723%;">NCM do produto</td><td style="width: 15.2563%;">Sim</td></tr><tr><td style="width: 8.93538%;">EX\_TIPI</td><td style="width: 7.03601%;">itens</td><td style="width: 68.7723%;">Código EX da TIPI</td><td style="width: 15.2563%;">Não</td></tr><tr><td style="width: 8.93538%;">UF</td><td style="width: 7.03601%;">itens</td><td style="width: 68.7723%;">UF de consulta. Se UF="vazio" busca na tabela um registro com UF\_origem=”vazio” e UF\_destino”=”vazio”. Senão, busca na tabela um registro com UF\_origem &lt;&gt; “vazio” ou UF destino &lt;&gt; “vazio” </td><td style="width: 15.2563%;">Não</td></tr><tr><td style="width: 8.93538%;">data</td><td style="width: 7.03601%;">itens</td><td style="width: 68.7723%;">Data de consulta. Se data="vazio" considera a data atual. Senão, busca na tabela CEST um registro vigente na data indicada </td><td style="width: 15.2563%;">Não</td></tr></tbody></table>

**Observação** Os dados são indicados em formato de lista com um limite de 100 itens por requisição.

# Descrição dos campos de retorno

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-campo-pai-descri%C3%A7%C3%A3o-"><tbody><tr><td>**Campo**</td><td>**PAI**</td><td>**Descrição**</td></tr><tr><td>itens</td><td>/</td><td>/</td></tr><tr><td>id</td><td>itens</td><td>Sequencial </td></tr><tr><td>NCM</td><td>itens</td><td>NCM de consulta</td></tr><tr><td>EX\_TIPI</td><td>itens</td><td>Código EX da TIPI de consulta</td></tr><tr><td>UF</td><td>itens</td><td>UF de consulta</td></tr><tr><td>data</td><td>itens</td><td>Data de consulta</td></tr><tr><td>NCMTabela</td><td>itens</td><td>Código NCM (tabela Systax) </td></tr><tr><td>CEST</td><td>itens</td><td>Código CEST</td></tr><tr><td>Descrição</td><td>itens</td><td>Descrição do CEST</td></tr><tr><td>UFTabela</td><td>itens</td><td>UF (tabela CEST Systax)</td></tr><tr><td>ExTipiTabela</td><td>itens</td><td>Código EX da TIPI (tabela Systax) </td></tr><tr><td>codigo</td><td>status</td><td>Código do retorno</td></tr><tr><td>msg</td><td>status</td><td>Mensagem do retorno</td></tr></tbody></table>

**Tabela de referência para os campos "codigo" e "mensagem":**

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-codigo-mensagem-0-su"><tbody><tr><td>**codigo**</td><td>**mensagem**</td></tr><tr><td>0</td><td>Sucesso</td></tr><tr><td>1</td><td>NCM\_Inválida</td></tr><tr><td>2</td><td>NCM\_Sem\_CEST</td></tr><tr><td>3</td><td>UF\_Inválida</td></tr><tr><td>4</td><td>EX\_TIPI\_Inválida</td></tr><tr><td>5</td><td>Data\_Inválida</td></tr><tr><td>6</td><td>ID\_Inválido</td></tr></tbody></table>

**Códigos de retorno HTTP:**

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-c%C3%B3digo-de-retorno-su"><tbody><tr><td>**Código de retorno**</td><td>**success**</td><td>**message**</td></tr><tr><td>200</td><td>true</td><td>Retorno com sucesso</td></tr><tr><td colspan="1" rowspan="2">400</td><td>false</td><td>missing\_token</td></tr><tr><td>false</td><td>expired\_token</td></tr><tr><td>406</td><td>false</td><td>Parâmetros insuficientes</td></tr></tbody></table>

# Exemplos de chamada

{  
 "itens": \[  
 {  
 "id": "1",  
 "NCM": "39181000",  
 "EX\_TIPI": "",  
 "UF": "",  
 "data": "01/10/2020"  
 }  
 \]  
}

# Exemplos de retorno

\[  
 {  
 "itens": \[  
 {  
 "id": "1",  
 "NCM": "39181000",  
 "EX\_TIPI": "",  
 "UF": "",  
 "data": "01\\/10\\/2020",  
 "NCMTabela": "39",  
 "EX\_TIPITabela": "",  
 "UFTabela": "PR",  
 "CEST": "1000600",  
 "descricao": "Mangueira de plástico de jardim",  
 "status": {  
 "codigo": 0,  
 "msg": "RETORNO COM SUCESSO"  
 }  
 },  
 {  
 "id": "1",  
 "NCM": "39181000",  
 "EX\_TIPI": "",  
 "UF": "",  
 "data": "01\\/10\\/2020",  
 "NCMTabela": "39",  
 "EX\_TIPITabela": "",  
 "UFTabela": "GO",  
 "CEST": "1000600",  
 "descricao": "Mangueira de plástico de jardim",  
 "status": {  
 "codigo": 0,  
 "msg": "RETORNO COM SUCESSO"  
 }  
 },  
 {  
 "id": "1",  
 "NCM": "39181000",  
 "EX\_TIPI": "",  
 "UF": "",  
 "data": "01\\/10\\/2020",  
 "NCMTabela": "3918",  
 "EX\_TIPITabela": "",  
 "UFTabela": "",  
 "CEST": "1000700",  
 "descricao": "Revestimento de pavimento de PVC e outros plásticos",  
 "status": {  
 "codigo": 0,  
 "msg": "RETORNO COM SUCESSO"  
 }  
 },  
 {  
 "id": "1",  
 "NCM": "39181000",  
 "EX\_TIPI": "",  
 "UF": "",  
 "data": "01\\/10\\/2020",  
 "NCMTabela": "39181000",  
 "EX\_TIPITabela": "",  
 "UFTabela": "",  
 "CEST": "0100300",  
 "descricao": "Protetores de caçamba",  
 "status": {  
 "codigo": 0,  
 "msg": "RETORNO COM SUCESSO"  
 }  
 }  
 \]  
 }  
\]