# API CEST V2

Manual da API CEST - versão 3 - 05/12/2023

# Introdução

Retorna os códigos CEST relacionados ao NCM informado. Assim como por meio de ponteiro retorna as atualizações ocorridas por meio da legislação.

# Acesso

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

# Acesso

**API CEST (Rest / JSON)**

**Método**: POST

**URL**: <u>[http://app.systax.com.br/cestv2](http://app.systax.com.br/cestv2)</u>

# Autenticação

A autenticação é feita via JWT bearer token ou Basic Auth.

Para mais informações sobre como gerar o token, acesse a última documentação no link:

[https://documentacao.systax.com.br/books/manual-da-api-de-geracao-de-token](https://documentacao.systax.com.br/books/manual-da-api-de-geracao-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: 70.7143%;"><tbody><tr><td style="width: 12.3103%;">**Campo**</td><td style="width: 8.59608%;">**PAI**</td><td style="width: 52.7867%;">**Descrição**</td><td style="width: 26.3069%;">**Obrigatório**</td></tr><tr><td style="width: 12.3103%;">Offset</td><td style="width: 8.59608%;">/</td><td style="width: 52.7867%;">Determina a página demonstrada no retorno

Ex.: Se o retorno possui 20 páginas, e na chamada for preenchido "offset": "12", trará apenas o retorno dos itens presentes na página 12.

Obs.: Caso marcado com 0 ou 1, traz retorno da primeira página

</td><td style="width: 26.3069%;">Não</td></tr><tr><td style="width: 12.3103%;">Itens</td><td style="width: 8.59608%;">/</td><td style="width: 52.7867%;">/</td><td style="width: 26.3069%;">/</td></tr><tr><td style="width: 12.3103%;">ID</td><td style="width: 8.59608%;">itens</td><td style="width: 52.7867%;">Sequencial</td><td style="width: 26.3069%;">Não</td></tr><tr><td style="width: 12.3103%;">NCM</td><td style="width: 8.59608%;">itens</td><td style="width: 52.7867%;">NCM do produto</td><td style="width: 26.3069%;">Apenas se não for informado o ponteiro</td></tr><tr><td style="width: 12.3103%;">EX\_TIPI</td><td style="width: 8.59608%;">itens</td><td style="width: 52.7867%;">Código EX da TIPI</td><td style="width: 26.3069%;">Não</td></tr><tr><td style="width: 12.3103%;">UF</td><td style="width: 8.59608%;">itens</td><td style="width: 52.7867%;">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: 26.3069%;">Não</td></tr><tr><td style="width: 12.3103%;">data</td><td style="width: 8.59608%;">itens</td><td style="width: 52.7867%;">Data de consulta. Se data="vazio" considera a data atual. Se não, busca na tabela CEST um registro vigente na data indicada</td><td style="width: 26.3069%;">Não</td></tr><tr><td style="width: 12.3103%;">ponteiro</td><td style="width: 8.59608%;">itens</td><td style="width: 52.7867%;">Se for enviado ponteiro busca dados a partir do ponteiro+1</td><td style="width: 26.3069%;">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-" style="width: 68.9286%;"><tbody><tr><td style="width: 16.955%;">**Campo**</td><td style="width: 13.8343%;">**PAI**</td><td style="width: 69.2107%;">**Descrição**</td></tr><tr><td style="width: 16.955%;">TotalPaginas</td><td style="width: 13.8343%;">/</td><td style="width: 69.2107%;">Número total de páginas do retorno</td></tr><tr><td style="width: 16.955%;">TotalItens</td><td style="width: 13.8343%;">/</td><td style="width: 69.2107%;">Numéro total de itens no retorno</td></tr><tr><td style="width: 16.955%;">ultPonteiro</td><td style="width: 13.8343%;">/</td><td style="width: 69.2107%;">Informa o último ponteiro de atualização da tabela.

Ex.: Numa chamada com 100 itens pode vir ponteiros diferentes pra cada item, a tag informa o último ponteiro da tabela de atualizações atualmente

</td></tr><tr><td style="width: 16.955%;">Itens</td><td style="width: 13.8343%;">/</td><td style="width: 69.2107%;">/</td></tr><tr><td style="width: 16.955%;">ID</td><td style="width: 13.8343%;">itens</td><td style="width: 69.2107%;">Sequencial</td></tr><tr><td style="width: 16.955%;">NCM</td><td style="width: 13.8343%;">itens</td><td style="width: 69.2107%;">NCM de consulta</td></tr><tr><td style="width: 16.955%;">EX\_TIPI</td><td style="width: 13.8343%;">itens</td><td style="width: 69.2107%;">Código EX da TIPI de consulta</td></tr><tr><td style="width: 16.955%;">UF</td><td style="width: 13.8343%;">itens</td><td style="width: 69.2107%;">UF de consulta</td></tr><tr><td style="width: 16.955%;">data</td><td style="width: 13.8343%;">itens</td><td style="width: 69.2107%;">Data de consulta</td></tr><tr><td style="width: 16.955%;">NCMTabela</td><td style="width: 13.8343%;">itens</td><td style="width: 69.2107%;">Código NCM (tabela Systax)</td></tr><tr><td style="width: 16.955%;">EX\_TIPITabela</td><td style="width: 13.8343%;">itens</td><td style="width: 69.2107%;">Código EX da TIPI (tabela Systax)</td></tr><tr><td style="width: 16.955%;">UFTabela</td><td style="width: 13.8343%;">itens</td><td style="width: 69.2107%;">UF (tabela CEST Systax)</td></tr><tr><td style="width: 16.955%;">CEST</td><td style="width: 13.8343%;">itens</td><td style="width: 69.2107%;">Código CEST</td></tr><tr><td style="width: 16.955%;">descricao</td><td style="width: 13.8343%;">itens</td><td style="width: 69.2107%;">Descrição do CEST</td></tr><tr><td style="width: 16.955%;">vigenciaDe</td><td style="width: 13.8343%;">itens</td><td style="width: 69.2107%;">Data inicial da vigência</td></tr><tr><td style="width: 16.955%;">vigenciaAte</td><td style="width: 13.8343%;">itens</td><td style="width: 69.2107%;">Data final da vigência</td></tr><tr><td style="width: 16.955%;">status</td><td style="width: 13.8343%;">/</td><td style="width: 69.2107%;">/</td></tr><tr><td style="width: 16.955%;">codigo</td><td style="width: 13.8343%;">status</td><td style="width: 69.2107%;">Código do retorno</td></tr><tr><td style="width: 16.955%;">ponteiro</td><td style="width: 13.8343%;">itens</td><td style="width: 69.2107%;">ponteiro de atualização da busca</td></tr><tr><td style="width: 16.955%;">msg</td><td style="width: 13.8343%;">status</td><td style="width: 69.2107%;">Mensagem de retorno</td></tr></tbody></table>

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

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-c%C3%B3digo-mensagem-0-re"><tbody><tr><td>**Código**</td><td>**Mensagem**</td></tr><tr><td>0</td><td>RETORNO COM SUCESSO</td></tr><tr><td>1</td><td>NCM INVÁLIDA</td></tr><tr><td>2</td><td>NCM NÃO POSSUI 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><tr><td>7</td><td>PONTEIRO INVÁLIDO</td></tr><tr><td>8</td><td>NÃO EXISTEM ATUALIZAÇOES</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>**sucess**</td><td>**message**</td></tr><tr><td>200</td><td>true</td><td>Retorno com sucesso</td></tr><tr><td>400</td><td>false</td><td>missing\_token</td></tr><tr><td>400</td><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

{  
 "offset": "1",  
 "itens": \[  
 {  
 "id": "1",  
 "NCM": "22089000",  
 "EX\_TIPI": "",  
 "UF": "",  
 "data": "",  
 "ponteiro": ""  
 }  
 \]  
}

# Exemplos de retorno

\[  
 {  
 "TotalPaginas": 1,  
 "totalItens": 13,  
 "ultPonteiro": "20231114020001",  
 "itens": \[  
 {  
 "id": "1",  
 "NCM": "22089000",  
 "EX\_TIPI": "",  
 "UF": "",  
 "data": "",  
 "NCMTabela": "2208",  
 "EX\_TIPITabela": "",  
 "UFTabela": "",  
 "CEST": "0299900",  
 "descricao": "Outras bebidas alcoólicas não especificadas nos itens anteriores",  
 "vigenciaDe": "2016-10-01",  
 "vigenciaAte": "",  
 "status": {  
 "codigo": 0,  
 "ponteiro": "20231013095117",  
 "msg": "RETORNO COM SUCESSO"  
 }  
 },  
 {  
 "id": "1",  
 "NCM": "22089000",  
 "EX\_TIPI": "",  
 "UF": "",  
 "data": "",  
 "NCMTabela": "22089000",  
 "EX\_TIPITabela": "",  
 "UFTabela": "",  
 "CEST": "0200100",  
 "descricao": "Aperitivos, amargos, bitter e similares",  
 "vigenciaDe": "2016-01-01",  
 "vigenciaAte": "",  
 "status": {  
 "codigo": 0,  
 "ponteiro": "20231013095117",  
 "msg": "RETORNO COM SUCESSO"  
 }  
 },  
 {  
 "id": "1",  
 "NCM": "22089000",  
 "EX\_TIPI": "",  
 "UF": "",  
 "data": "",  
 "NCMTabela": "22089000",  
 "EX\_TIPITabela": "",  
 "UFTabela": "",  
 "CEST": "0200200",  
 "descricao": "Batida e similares",  
 "vigenciaDe": "2016-01-01",  
 "vigenciaAte": "",  
 "status": {  
 "codigo": 0,  
 "ponteiro": "20231013095117",  
 "msg": "RETORNO COM SUCESSO"  
 }  
 },  
 {  
 "id": "1",  
 "NCM": "22089000",  
 "EX\_TIPI": "",  
 "UF": "",  
 "data": "",  
 "NCMTabela": "22089000",  
 "EX\_TIPITabela": "",  
 "UFTabela": "",  
 "CEST": "0200300",  
 "descricao": "Bebida ice",  
 "vigenciaDe": "2016-01-01",  
 "vigenciaAte": "",  
 "status": {  
 "codigo": 0,  
 "ponteiro": "20231013095117",  
 "msg": "RETORNO COM SUCESSO"  
 }  
 },  
 {  
 "id": "1",  
 "NCM": "22089000",  
 "EX\_TIPI": "",  
 "UF": "",  
 "data": "",  
 "NCMTabela": "22089000",  
 "EX\_TIPITabela": "",  
 "UFTabela": "",  
 "CEST": "0200500",  
 "descricao": "Catuaba e similares",  
 "vigenciaDe": "2016-01-01",  
 "vigenciaAte": "",  
 "status": {  
 "codigo": 0,  
 "ponteiro": "20231013095117",  
 "msg": "RETORNO COM SUCESSO"  
 }  
 },  
 {  
 "id": "1",  
 "NCM": "22089000",  
 "EX\_TIPI": "",  
 "UF": "",  
 "data": "",  
 "NCMTabela": "22089000",  
 "EX\_TIPITabela": "",  
 "UFTabela": "",  
 "CEST": "0200700",  
 "descricao": "Cooler",  
 "vigenciaDe": "2016-01-01",  
 "vigenciaAte": "",  
 "status": {  
 "codigo": 0,  
 "ponteiro": "20231013095117",  
 "msg": "RETORNO COM SUCESSO"  
 }  
 },  
 {  
 "id": "1",  
 "NCM": "22089000",  
 "EX\_TIPI": "",  
 "UF": "",  
 "data": "",  
 "NCMTabela": "22089000",  
 "EX\_TIPITabela": "",  
 "UFTabela": "",  
 "CEST": "0200900",  
 "descricao": "Jurubeba e similares",  
 "vigenciaDe": "2016-01-01",  
 "vigenciaAte": "",  
 "status": {  
 "codigo": 0,  
 "ponteiro": "20231013095117",  
 "msg": "RETORNO COM SUCESSO"  
 }  
 },  
 {  
 "id": "1",  
 "NCM": "22089000",  
 "EX\_TIPI": "",  
 "UF": "",  
 "data": "",  
 "NCMTabela": "22089000",  
 "EX\_TIPITabela": "",  
 "UFTabela": "",  
 "CEST": "0201400",  
 "descricao": "Steinhaeger",  
 "vigenciaDe": "2016-01-01",  
 "vigenciaAte": "",  
 "status": {  
 "codigo": 0,  
 "ponteiro": "20231013095117",  
 "msg": "RETORNO COM SUCESSO"  
 }  
 },  
 {  
 "id": "1",  
 "NCM": "22089000",  
 "EX\_TIPI": "",  
 "UF": "",  
 "data": "",  
 "NCMTabela": "22089000",  
 "EX\_TIPITabela": "",  
 "UFTabela": "",  
 "CEST": "0201500",  
 "descricao": "Tequila",  
 "vigenciaDe": "2016-01-01",  
 "vigenciaAte": "",  
 "status": {  
 "codigo": 0,  
 "ponteiro": "20231013095117",  
 "msg": "RETORNO COM SUCESSO"  
 }  
 },  
 {  
 "id": "1",  
 "NCM": "22089000",  
 "EX\_TIPI": "",  
 "UF": "",  
 "data": "",  
 "NCMTabela": "22089000",  
 "EX\_TIPITabela": "",  
 "UFTabela": "",  
 "CEST": "0201900",  
 "descricao": "Derivados de vodka",  
 "vigenciaDe": "2016-01-01",  
 "vigenciaAte": "",  
 "status": {  
 "codigo": 0,  
 "ponteiro": "20231013095117",  
 "msg": "RETORNO COM SUCESSO"  
 }  
 },  
 {  
 "id": "1",  
 "NCM": "22089000",  
 "EX\_TIPI": "",  
 "UF": "",  
 "data": "",  
 "NCMTabela": "22089000",  
 "EX\_TIPITabela": "",  
 "UFTabela": "",  
 "CEST": "0202000",  
 "descricao": "Arak",  
 "vigenciaDe": "2016-01-01",  
 "vigenciaAte": "",  
 "status": {  
 "codigo": 0,  
 "ponteiro": "20231013095117",  
 "msg": "RETORNO COM SUCESSO"  
 }  
 },  
 {  
 "id": "1",  
 "NCM": "22089000",  
 "EX\_TIPI": "",  
 "UF": "",  
 "data": "",  
 "NCMTabela": "22089000",  
 "EX\_TIPITabela": "",  
 "UFTabela": "",  
 "CEST": "0202300",  
 "descricao": "Sangrias e coquetéis",  
 "vigenciaDe": "2016-01-01",  
 "vigenciaAte": "",  
 "status": {  
 "codigo": 0,  
 "ponteiro": "20231013095117",  
 "msg": "RETORNO COM SUCESSO"  
 }  
 },  
 {  
 "id": "1",  
 "NCM": "22089000",  
 "EX\_TIPI": "",  
 "UF": "",  
 "data": "",  
 "NCMTabela": "22089000",  
 "EX\_TIPITabela": "",  
 "UFTabela": "",  
 "CEST": "1101000",  
 "descricao": "Álcool etílico para limpeza",  
 "vigenciaDe": "2016-01-01",  
 "vigenciaAte": "",   
 "status": {  
 "codigo": 0,  
 "ponteiro": "20231013095117",  
 "msg": "RETORNO COM SUCESSO"  
 }  
 }  
 \]  
 }  
\]