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