# Consulta

O serviço de consulta lista os itens já classificados, ou seja, que contenham NCM definitiva.

**Método:** GET  
**URL:** https://app.systax.com.br/v2/cfm/products

# Descrição dos campos da Request e Response

**Request**

Os campos que podem ser enviados são:

<table border="1" cellpadding="2" cellspacing="0" id="bkmrk-nome-tipo-descri%C3%A7%C3%A3o-" style="width: 100%;"><tbody><tr><td style="width: 7.38975%;">**Nome**</td><td style="width: 11.3219%;">**Tipo**</td><td style="width: 81.2884%;">**Descrição**</td></tr><tr><td style="width: 7.38975%;">tipo\_retorno</td><td style="width: 11.3219%;">Texto</td><td style="width: 81.2884%;">Define quais informações devem ser retornadas. Opções possíveis: ncm, duvida ou infos (default). - ncm retorna: id, cod\_interno, origem\_produto, ncm\_sugerida e ex\_tipi\_sugerida;
- duvida retorna: id, cod\_interno, origem\_produto e duvida\_tecnica;
- infos retorna: retorna todos os dados do produto;

</td></tr><tr><td style="width: 7.38975%;">id</td><td style="width: 11.3219%;">Inteiro</td><td style="width: 81.2884%;">ID do produto. Se esse filtro for utilizado, todos os outros filtros serão ignorados, caso sejam utilizados ao mesmo tempo</td></tr><tr><td style="width: 7.38975%;">list\_ids</td><td style="width: 11.3219%;">Texto</td><td style="width: 81.2884%;">Lista de id's separados por vírgula. Se enviado, os parâmetros cod\_interno e origem\_produto serão ignorados. </td></tr><tr><td style="width: 7.38975%;">data\_criacao</td><td style="width: 11.3219%;">Texto</td><td style="width: 81.2884%;">Permite filtrar o dia exato 15/08/2019 ou uma faixa 20/04/2019a27/12/2019</td></tr><tr><td style="width: 7.38975%;">param</td><td style="width: 11.3219%;">Array\[Texto\]</td><td style="width: 81.2884%;">Array de parâmetros para filtrar os produtos. Deve ser combinado com o parâmetro value\[\]. Opções: cod\_interno, origem\_produto, ean, descricao, complemento, ncm\_original, ex\_tipi\_original, ncm\_sugerida, ex\_tipi\_sugerida, ncm\_definitiva, ex\_tipi\_definitiva, status\_atual.</td></tr><tr><td style="width: 7.38975%;">value</td><td style="width: 11.3219%;">Array\[Texto\]</td><td style="width: 81.2884%;">Array de valores para filtrar os produtos. Deve ser combinado com o parâmetro param\[\] Para o filtro status\_atual, utilizar os valores: novo, classificado, pendente ou aguardando-ncm-definitiva.</td></tr><tr><td style="width: 7.38975%;">pagina\_atual</td><td style="width: 11.3219%;">Inteiro</td><td style="width: 81.2884%;">Página que se deseja consultar.</td></tr><tr><td style="width: 7.38975%;">por\_pagina</td><td style="width: 11.3219%;">Inteiro</td><td style="width: 81.2884%;">Quantidade de registros por página.</td></tr><tr><td style="width: 7.38975%;">order\_by</td><td style="width: 11.3219%;">Inteiro</td><td style="width: 81.2884%;">Define a ordenação dos resultados. Opções: id, cod\_interno, descricao e data\_criacao. Acrescente .ASC ou .DESC se necessário. Exemplos cod\_interno, id.DESC, descricao.ASC</td></tr></tbody></table>

**Importante:** Os parâmetros deverão ser enviados na query string da url.

**Paginação**

Se a quantidade de itens retornados for maior do que uma página, um bloco adicional "paginacao" será devolvido contendo algumas informações importantes para a leitura dos itens paginados.

 Esse bloco conterá as seguintes informações:

<table border="1" cellpadding="2" cellspacing="0" id="bkmrk-nome-tipo-descri%C3%A7%C3%A3o--1" style="width: 100%;"><tbody><tr><td style="width: 15.1371%;">**Nome**</td><td style="width: 7.86495%;">**Tipo**</td><td style="width: 76.998%;">**Descrição**</td></tr><tr><td style="width: 15.1371%;">total\_registros</td><td style="width: 7.86495%;">Texto</td><td style="width: 76.998%;">A quantidade total de registros disponíveis para consulta. </td></tr><tr><td style="width: 15.1371%;">num\_paginas</td><td style="width: 7.86495%;">Texto</td><td style="width: 76.998%;">A quantidade total de páginas em que esses registros se distribuem.</td></tr><tr><td style="width: 15.1371%;">por\_pagina</td><td style="width: 7.86495%;">Inteiro</td><td style="width: 76.998%;">A quantidade de itens por págian informada na requisição.</td></tr><tr><td style="width: 15.1371%;">pagina\_atual</td><td style="width: 7.86495%;">Inteiro</td><td style="width: 76.998%;">A página que se está consultando no momento.</td></tr><tr><td style="width: 15.1371%;">itens\_da\_pagina</td><td style="width: 7.86495%;">Inteiro</td><td style="width: 76.998%;">A quantidade de itens retornados na página atual. Será menor do que o tamanho da página quando se estiver lendo a última</td></tr></tbody></table>

# Exemplo - Consulta de todos os itens

**Endpoint:** [https://app.systax.com.br/v2/cfm/products](https://app.systax.com.br/v2/cfm/products)

**Response**

<div id="bkmrk-%7B-%C2%A0-%C2%A0-%22success%22%3A-tru"><div>{</div><div> "success": true,</div><div> "message": "ok",</div><div> "record_count": 15,</div><div> "produtos": [</div><div> {</div><div> "id": 18893817,</div><div> "cod_interno": "00004-900",</div><div> "origem_produto": 1,</div><div> "ean": "",</div><div> "descricao": "Produto_Teste_001",</div><div> "descricao_sugerida": "",</div><div> "complemento": "Teste",</div><div> "ncm_original": "22021000",</div><div> "ex_tipi_original": "",</div><div> "ncm_sugerida": "25231000",</div><div> "ex_tipi_sugerida": "",</div><div> "ncm_definitiva": "25231000",</div><div> "ex_tipi_definitiva": "",</div><div> "cest": "1709100",</div><div> "status_atual": "classificado",</div><div> "username_classificacao": "paulo.campos",</div><div> "duvida_tecnica": "",</div><div> "resposta_tecnica": "Teste",</div><div> "fundamentacao": "",</div><div> "dt_classificacao": "2025-04-10 16:58:49",</div><div> "data_criacao": "2025-04-03 15:01:41",</div><div> "username_criacao": "Teste"</div><div> },</div><div> {</div><div> "id": 18893820,</div><div> "cod_interno": "00117000611",</div><div> "origem_produto": 1,</div><div> "ean": "",</div><div> "descricao": "Produto_Teste_002",</div><div> "descricao_sugerida": "",</div><div> "complemento": "",</div><div> "ncm_original": "22021000",</div><div> "ex_tipi_original": "",</div><div> "ncm_sugerida": "22021000",</div><div> "ex_tipi_sugerida": "",</div><div> "ncm_definitiva": "73181600",</div><div> "ex_tipi_definitiva": "",</div><div> "cest": null,</div><div> "status_atual": "classificado",</div><div> "username_classificacao": null,</div><div> "duvida_tecnica": "Dúvida Teste 1? Dúvida Teste 2?",</div><div> "resposta_tecnica": "Teste",</div><div> "fundamentacao": "",</div><div> "dt_classificacao": "2025-06-23 14:41:04",</div><div> "data_criacao": "2025-04-03 15:03:04",</div><div> "username_criacao": "Teste"</div><div> },</div><div> {</div><div> "id": 18893831,</div><div> "cod_interno": "00117000612",</div><div> "origem_produto": 1,</div><div> "ean": "",</div><div> "descricao": "Produto_Teste_003",</div><div> "descricao_sugerida": "",</div><div> "complemento": "",</div><div> "ncm_original": "87089990",</div><div> "ex_tipi_original": "",</div><div> "ncm_sugerida": "87089910",</div><div> "ex_tipi_sugerida": "",</div><div> "ncm_definitiva": "",</div><div> "ex_tipi_definitiva": "",</div><div> "cest": "0107500",</div><div> "status_atual": "novo",</div><div> "username_classificacao": null,</div><div> "duvida_tecnica": "Dúvida Teste 3? Dúvida Teste 4?",</div><div> "resposta_tecnica": "",</div><div> "fundamentacao": "",</div><div> "dt_classificacao": null,</div><div> "data_criacao": "2025-04-03 15:04:34",</div><div> "username_criacao": "Teste"</div><div> },</div><div> {</div><div> "id": 18928122,</div><div> "cod_interno": "10042025",</div><div> "origem_produto": 0,</div><div> "ean": "",</div><div> "descricao": "Produto_Teste_004",</div><div> "descricao_sugerida": "",</div><div> "complemento": "",</div><div> "ncm_original": "22021000",</div><div> "ex_tipi_original": "",</div><div> "ncm_sugerida": "",</div><div> "ex_tipi_sugerida": "",</div><div> "ncm_definitiva": "22021000",</div><div> "ex_tipi_definitiva": "",</div><div> "cest": null,</div><div> "status_atual": "classificado",</div><div> "username_classificacao": null,</div><div> "duvida_tecnica": "Dúvida Teste 5? Dúvida Teste 6?",</div><div> "resposta_tecnica": "Teste",</div><div> "fundamentacao": "",</div><div> "dt_classificacao": "2025-06-23 12:05:58",</div><div> "data_criacao": "2025-04-10 15:58:48",</div><div> "username_criacao": "Teste"</div><div> },</div><div> {</div><div> "id": 18933331,</div><div> "cod_interno": "000006",</div><div> "origem_produto": 0,</div><div> "ean": "",</div><div> "descricao": "Produto_Teste_005",</div><div> "descricao_sugerida": "",</div><div> "complemento": "",</div><div> "ncm_original": "22021000",</div><div> "ex_tipi_original": "",</div><div> "ncm_sugerida": "",</div><div> "ex_tipi_sugerida": "",</div><div> "ncm_definitiva": "22021000",</div><div> "ex_tipi_definitiva": "",</div><div> "cest": null,</div><div> "status_atual": "classificado",</div><div> "username_classificacao": null,</div><div> "duvida_tecnica": null,</div><div> "resposta_tecnica": "Teste",</div><div> "fundamentacao": null,</div><div> "dt_classificacao": "2025-04-11 10:56:16",</div><div> "data_criacao": "2025-04-11 10:21:48",</div><div> "username_criacao": "Teste"</div><div> },</div><div> {</div><div> "id": 19145713,</div><div> "cod_interno": "000009",</div><div> "origem_produto": 0,</div><div> "ean": "",</div><div> "descricao": "Produto_Teste_006",</div><div> "descricao_sugerida": "",</div><div> "complemento": "",</div><div> "ncm_original": "22021000",</div><div> "ex_tipi_original": "",</div><div> "ncm_sugerida": "",</div><div> "ex_tipi_sugerida": "",</div><div> "ncm_definitiva": "22021000",</div><div> "ex_tipi_definitiva": "",</div><div> "cest": "1711100",</div><div> "status_atual": "classificado",</div><div> "username_classificacao": null,</div><div> "duvida_tecnica": null,</div><div> "resposta_tecnica": "Teste",</div><div> "fundamentacao": null,</div><div> "dt_classificacao": "2025-08-26 14:15:39",</div><div> "data_criacao": "2025-05-26 14:36:46",</div><div> "username_criacao": "Teste"</div><div> },</div><div> {</div><div> "id": 19145715,</div><div> "cod_interno": "000011",</div><div> "origem_produto": 0,</div><div> "ean": "",</div><div> "descricao": "Produto_Teste_007",</div><div> "descricao_sugerida": "",</div><div> "complemento": "",</div><div> "ncm_original": "22021000",</div><div> "ex_tipi_original": "",</div><div> "ncm_sugerida": "",</div><div> "ex_tipi_sugerida": "",</div><div> "ncm_definitiva": "22021000",</div><div> "ex_tipi_definitiva": "",</div><div> "cest": "1711100",</div><div> "status_atual": "classificado",</div><div> "username_classificacao": null,</div><div> "duvida_tecnica": null,</div><div> "resposta_tecnica": "Teste",</div><div> "fundamentacao": null,</div><div> "dt_classificacao": "2025-08-26 14:16:08",</div><div> "data_criacao": "2025-05-26 14:37:04",</div><div> "username_criacao": "Teste"</div><div> },</div><div> {</div><div> "id": 19265044,</div><div> "cod_interno": "00012",</div><div> "origem_produto": 0,</div><div> "ean": "",</div><div> "descricao": "Produto_Teste_008",</div><div> "descricao_sugerida": "",</div><div> "complemento": "",</div><div> "ncm_original": "22021000",</div><div> "ex_tipi_original": "",</div><div> "ncm_sugerida": "",</div><div> "ex_tipi_sugerida": "",</div><div> "ncm_definitiva": "22021000",</div><div> "ex_tipi_definitiva": "",</div><div> "cest": null,</div><div> "status_atual": "classificado",</div><div> "username_classificacao": null,</div><div> "duvida_tecnica": null,</div><div> "resposta_tecnica": "Teste",</div><div> "fundamentacao": null,</div><div> "dt_classificacao": "2025-06-26 15:01:36",</div><div> "data_criacao": "2025-06-26 14:48:09",</div><div> "username_criacao": "Teste"</div><div> },</div><div> {</div><div> "id": 19483972,</div><div> "cod_interno": "00013",</div><div> "origem_produto": 0,</div><div> "ean": "",</div><div> "descricao": "Produto_Teste_009",</div><div> "descricao_sugerida": "",</div><div> "complemento": "",</div><div> "ncm_original": "21050010",</div><div> "ex_tipi_original": "",</div><div> "ncm_sugerida": "",</div><div> "ex_tipi_sugerida": "",</div><div> "ncm_definitiva": "21050010",</div><div> "ex_tipi_definitiva": "",</div><div> "cest": null,</div><div> "status_atual": "classificado",</div><div> "username_classificacao": null,</div><div> "duvida_tecnica": null,</div><div> "resposta_tecnica": "Teste",</div><div> "fundamentacao": null,</div><div> "dt_classificacao": "2025-08-28 11:23:20",</div><div> "data_criacao": "2025-08-28 11:19:41",</div><div> "username_criacao": "Teste"</div><div> },</div><div> {</div><div> "id": 19483985,</div><div> "cod_interno": "00004-900",</div><div> "origem_produto": 0,</div><div> "ean": "",</div><div> "descricao": "Produto_Teste_010",</div><div> "descricao_sugerida": "",</div><div> "complemento": "",</div><div> "ncm_original": "25231000",</div><div> "ex_tipi_original": "",</div><div> "ncm_sugerida": "",</div><div> "ex_tipi_sugerida": "",</div><div> "ncm_definitiva": "25231000",</div><div> "ex_tipi_definitiva": "",</div><div> "cest": null,</div><div> "status_atual": "classificado",</div><div> "username_classificacao": null,</div><div> "duvida_tecnica": null,</div><div> "resposta_tecnica": "Teste",</div><div> "fundamentacao": null,</div><div> "dt_classificacao": "2025-08-28 11:39:48",</div><div> "data_criacao": "2025-08-28 11:38:54",</div><div> "username_criacao": "Teste"</div><div> },</div><div> {</div><div> "id": 19484001,</div><div> "cod_interno": "SYS_536163",</div><div> "origem_produto": 0,</div><div> "ean": "8880000887281",</div><div> "descricao": "Produto_Teste_011",</div><div> "descricao_sugerida": "",</div><div> "complemento": "",</div><div> "ncm_original": "83014000",</div><div> "ex_tipi_original": "",</div><div> "ncm_sugerida": "83014000",</div><div> "ex_tipi_sugerida": "",</div><div> "ncm_definitiva": "83014000",</div><div> "ex_tipi_definitiva": "",</div><div> "cest": null,</div><div> "status_atual": "classificado",</div><div> "username_classificacao": null,</div><div> "duvida_tecnica": null,</div><div> "resposta_tecnica": null,</div><div> "fundamentacao": null,</div><div> "dt_classificacao": null,</div><div> "data_criacao": "2025-08-28 12:01:03",</div><div> "username_criacao": "Teste"</div><div> },</div><div> {</div><div> "id": 19511913,</div><div> "cod_interno": "00001",</div><div> "origem_produto": 0,</div><div> "ean": "76840002603",</div><div> "descricao": "Teste",</div><div> "descricao_sugerida": "",</div><div> "complemento": "",</div><div> "ncm_original": "21050010",</div><div> "ex_tipi_original": "10",</div><div> "ncm_sugerida": "21050010",</div><div> "ex_tipi_sugerida": "",</div><div> "ncm_definitiva": "",</div><div> "ex_tipi_definitiva": "",</div><div> "cest": null,</div><div> "status_atual": "aguardando-ncm-definitiva",</div><div> "username_classificacao": null,</div><div> "duvida_tecnica": null,</div><div> "resposta_tecnica": null,</div><div> "fundamentacao": null,</div><div> "dt_classificacao": null,</div><div> "data_criacao": "2025-09-12 11:30:42",</div><div> "username_criacao": "Teste"</div><div> },</div><div> {</div><div> "id": 19511999,</div><div> "cod_interno": "000002",</div><div> "origem_produto": 0,</div><div> "ean": "",</div><div> "descricao": "Teste_002",</div><div> "descricao_sugerida": "",</div><div> "complemento": "",</div><div> "ncm_original": "22021000",</div><div> "ex_tipi_original": "",</div><div> "ncm_sugerida": "",</div><div> "ex_tipi_sugerida": "",</div><div> "ncm_definitiva": "",</div><div> "ex_tipi_definitiva": "",</div><div> "cest": "1711100",</div><div> "status_atual": "novo",</div><div> "username_classificacao": null,</div><div> "duvida_tecnica": null,</div><div> "resposta_tecnica": null,</div><div> "fundamentacao": null,</div><div> "dt_classificacao": null,</div><div> "data_criacao": "2025-09-12 11:36:38",</div><div> "username_criacao": "Teste"</div><div> },</div><div> {</div><div> "id": 19512000,</div><div> "cod_interno": "000003",</div><div> "origem_produto": 0,</div><div> "ean": "",</div><div> "descricao": "Teste_003",</div><div> "descricao_sugerida": "",</div><div> "complemento": "",</div><div> "ncm_original": "85049090",</div><div> "ex_tipi_original": "",</div><div> "ncm_sugerida": "",</div><div> "ex_tipi_sugerida": "",</div><div> "ncm_definitiva": "",</div><div> "ex_tipi_definitiva": "",</div><div> "cest": null,</div><div> "status_atual": "novo",</div><div> "username_classificacao": null,</div><div> "duvida_tecnica": null,</div><div> "resposta_tecnica": null,</div><div> "fundamentacao": null,</div><div> "dt_classificacao": null,</div><div> "data_criacao": "2025-09-12 11:36:39",</div><div> "username_criacao": "Teste"</div><div> },</div><div> {</div><div> "id": 19512001,</div><div> "cod_interno": "000004",</div><div> "origem_produto": 0,</div><div> "ean": "",</div><div> "descricao": "Teste_004",</div><div> "descricao_sugerida": "",</div><div> "complemento": "",</div><div> "ncm_original": "22021000",</div><div> "ex_tipi_original": "",</div><div> "ncm_sugerida": "",</div><div> "ex_tipi_sugerida": "",</div><div> "ncm_definitiva": "",</div><div> "ex_tipi_definitiva": "",</div><div> "cest": "1711100",</div><div> "status_atual": "novo",</div><div> "username_classificacao": null,</div><div> "duvida_tecnica": null,</div><div> "resposta_tecnica": null,</div><div> "fundamentacao": null,</div><div> "dt_classificacao": null,</div><div> "data_criacao": "2025-09-12 11:36:39",</div><div> "username_criacao": "Teste"</div><div> }</div><div> ]</div><div>}</div></div>

# Exemplo - Consulta por NCM

**Endpoint:** http://app.systax.com.br/cfm/products/?por\_pagina=3&amp;tipo\_retorno=ncm&amp;order\_by=data\_criacao.ASC

**Response**

<div id="bkmrk-%7B-%C2%A0-%C2%A0-%22produtos%22%3A-%5B-"><div>{</div><div> "produtos": [</div><div> {</div><div> "id": "18893817",</div><div> "cod_interno": "00004-900",</div><div> "origem_produto": "1",</div><div> "ncm_original": "22021000",</div><div> "ex_tipi_original": "",</div><div> "ncm_sugerida": "25231000",</div><div> "ex_tipi_sugerida": "",</div><div> "ncm_definitiva": "25231000",</div><div> "ex_tipi_definitiva": "",</div><div> "status_atual": "classificado"</div><div> },</div><div> {</div><div> "id": "18893820",</div><div> "cod_interno": "00117000611",</div><div> "origem_produto": "1",</div><div> "ncm_original": "22021000",</div><div> "ex_tipi_original": "",</div><div> "ncm_sugerida": "22021000",</div><div> "ex_tipi_sugerida": "",</div><div> "ncm_definitiva": "73181600",</div><div> "ex_tipi_definitiva": "",</div><div> "status_atual": "classificado"</div><div> },</div><div> {</div><div> "id": "18893831",</div><div> "cod_interno": "00117000612",</div><div> "origem_produto": "1",</div><div> "ncm_original": "87089990",</div><div> "ex_tipi_original": "",</div><div> "ncm_sugerida": "87089910",</div><div> "ex_tipi_sugerida": "",</div><div> "ncm_definitiva": "",</div><div> "ex_tipi_definitiva": "",</div><div> "status_atual": "novo"</div><div> }</div><div> ],</div><div> "paginacao": {</div><div> "total_registros": 15,</div><div> "num_paginas": 5,</div><div> "por_pagina": 3,</div><div> "pagina_atual": 1,</div><div> "itens_da_pagina": 3</div><div> },</div><div> "success": true,</div><div> "message": "ok"</div><div>}</div></div>

# Exemplo - Consulta por Dúvida Técnica

**Endpoint:** http://app.systax.com.br/cfm/products/?por\_pagina=3&amp;tipo\_retorno=duvida&amp;order\_by=data\_criacao.DESC

**Response**

<div id="bkmrk-%7B-%C2%A0-%C2%A0-%22produtos%22%3A-%5B-"><div>{</div><div> "produtos": [</div><div> {</div><div> "id": "19512001",</div><div> "cod_interno": "000004",</div><div> "origem_produto": "0",</div><div> "duvida_tecnica": "",</div><div> "resposta_tecnica": "Resposta Teste"</div><div> },</div><div> {</div><div> "id": "19512000",</div><div> "cod_interno": "000003",</div><div> "origem_produto": "0",</div><div> "duvida_tecnica": "",</div><div> "resposta_tecnica": "Resposta Teste"</div><div> },</div><div> {</div><div> "id": "19511999",</div><div> "cod_interno": "000002",</div><div> "origem_produto": "0",</div><div> "duvida_tecnica": "",</div><div> "resposta_tecnica": "Resposta Teste"</div><div> }</div><div> ],</div><div> "paginacao": {</div><div> "total_registros": 15,</div><div> "num_paginas": 5,</div><div> "por_pagina": 3,</div><div> "pagina_atual": 1,</div><div> "itens_da_pagina": 3</div><div> },</div><div> "success": true,</div><div> "message": "ok"</div><div>}</div></div>