Skip to main content

NCM Sugerida

O serviço de NCM sugerida permite listar as NCM's registradas pelos dos analistas Systax e identificadas como correta segundo sua análise. Com base nessas informações o cliente poderá aceita-la ou recusa-la.

Para aceitar, basta que o cliente reenvie a NCM sugerida como definitiva através do serviço de Alteração, para recusar, o cliente poderá enviar a NCM original ou mesmo uma terceira como NCM definitiva. 

Método: GET
URL: http://app.systax.com.br/cfm/products/ncm_sugerida

Request

Os campos que podem ser enviados são:

Nome Tipo Descrição
list_ids Texto Lista de id's separados por vírgula. Se enviado, os parâmetros cod_interno e origem_produto serão ignorados. 
cod_interno Texto Código do material enviado no cadastro.
origem_produto Inteiro Origem da mercadoria enviada no cadastro.
pagina_atual Inteiro Página que se deseja consultar.
por_pagina Inteiro Quantidade de registros por página.

JSON do request - Exemplo 1 - Consultando por id produto.
{
    "list_ids": "7233611",
    "pagina_atual": "1",
    "por_pagina": "50"
}    

JSON do request - Exemplo 2 - Consultando por código do material.
{
    "cod_interno": "00001",
    "origem_produto": "0",    
    "pagina_atual": "1",
    "por_pagina": "20"
}    

Importante: É permitido não informar lista de id's ou códigos de produto, nesse caso serão retornadas todas os materiais da página.

Response

Em caso de sucesso a API retornará a lista de materiais com sugestão de NCM.

{
  "produtos": [
    {
      "id": "7233611",
      "cod_interno": "00001",
      "origem_produto": "0",
      "ncm_original": "04064000",
      "ex_tipi_original": "",
      "ncm_sugerida": "04064000",
      "ex_tipi_sugerida": "",
      "ncm_definitiva": "",
      "ex_tipi_definitiva": "",
      "status_atual": "novo",
      "informacao_extra": "NCM Sugerida Preenchida"
    }
  ]
}

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:

Nome Tipo Descrição
total_registros Texto A quantidade total de registros disponíveis para consulta. 
num_paginas Texto A quantidade total de páginas em que esses registros se distribuem.
por_pagina Inteiro A quantidade de itens por págian informada na requisição.
pagina_atual Inteiro A página que se está consultando no momento.
itens_da_pagina Inteiro A quantidade de itens retornados na página atual. Será menor do que o tamanho da página quando se estiver lendo a última

Response

{
  "produtos": [
    {
      "id": "7233611",
      "cod_interno": "00001",
      "origem_produto": "0",
      "ncm_original": "04064000",
      "ex_tipi_original": "",
      "ncm_sugerida": "04064000",
      "ex_tipi_sugerida": "",
      "ncm_definitiva": "",
      "ex_tipi_definitiva": "",
      "status_atual": "novo",
      "informacao_extra": "NCM Sugerida Preenchida"
    },
    {
      "id": "7233561",
      "cod_interno": "cdigo",
      "origem_produto": "0",
      "ncm_original": "09786112",
      "ex_tipi_original": "",
      "ncm_sugerida": "04064000",
      "ex_tipi_sugerida": "",
      "ncm_definitiva": "",
      "ex_tipi_definitiva": "",
      "status_atual": "novo",
      "informacao_extra": "NCM Sugerida Preenchida"
    }
  ],
  "paginacao": {
    "total_registros": 3,
    "num_paginas": 2,
    "por_pagina": 2,
    "pagina_atual": 1,
    "itens_da_pagina": 2
  }
}

Request e Response

API Classificação Fiscal - NCM Sugerida (Imagem 1).jpg