Neste artigo, mostraremos como cadastrar e realizar a gestão de NCMs na Ideris. Acompanhe o passo a passo e descubra como realizar de forma prática.
Request NCM
O NCM (Nomenclatura Comum do Mercosul) é um código utilizado para identificar a natureza de produtos, sendo fundamental para a emissão de Notas Fiscais e para o controle interno da operação.
Endpoints Disponíveis
1. Buscar NCM por ID
- Método: GET
- URL: https://apiv3.ideris.com.br/status/{statusId}
-
Objetivo:
Retornar informações de um NCM específico, utilizando seu ID.
2. Buscar Lista de NCMs
- Método: GET
- URL: https://apiv3.ideris.com.br/status/{statusId}
-
Objetivo:
Listar todos os NCMs cadastrados, sem a aplicação de filtros.
3. Cadastrar um Novo NCM
- Método: POST
- URL: https://apiv3.ideris.com.br/status/{statusId}
-
Objetivo:
Cadastrar um novo código NCM na base de dados do Ideris.
4. Atualizar um NCM Existente
- Método: PUT
- URL: https://apiv3.ideris.com.br/status/{statusId}
-
Objetivo:
Atualizar as informações de um NCM já cadastrado.
5. Deletar um NCM
- Método: DELETE
- URL: https://apiv3.ideris.com.br/status/{statusId}
-
Objetivo:
Deletar um NCM específico utilizando o ID do código.
Orientações Gerais
-
Cuidados na Exclusão:
Ao deletar um NCM, tenha certeza de que deseja realmente excluir o código, pois não existe uma "lixeira" para recuperação de dados após a exclusão. -
Cabeçalhos Necessários:
Inclua no header:
- Content-Type: application/json
- Token de autenticação JWT obtido no processo de login.
Documentação Eletrônica
A documentação completa da API está disponível em um ambiente eletrônico no endereço Swagger.
- Acesso: Não é necessário token para consultar essa documentação.
- Objetivo: Retornar exemplos de objetos padrão, permitindo que você teste as integrações sem precisar de credenciais de acesso.
Se precisar de mais ajuda com este processo, nossa equipe de suporte está pronta para atender você. É só clicar no ícone do whatsapp no canto inferior direito de qualquer página do seu painel Ideris ou abrir um ticket.
Conte sempre conosco. Até a próxima!