--- title: "Importar Nota Fiscal de Serviço" method: POST path: "/v1/fiscal/servicos-tomados/nfse" tags: ["Fiscal"] --- # Importar Nota Fiscal de Serviço `POST /v1/fiscal/servicos-tomados/nfse` Disponível a partir da versão 4.32 do SankhyaOm, a API de Importação de Notas Fiscais de Serviços Tomados foi projetada para simplificar e automatizar o processo de importação de notas fiscais emitidas por fornecedores. Essa integração permite que empresas importem de forma eficiente e segura os dados fiscais diretamente para seus sistemas de gestão, eliminando a necessidade de inserção manual e reduzindo erros humanos. - Benefícios de utilizar a API estão na eficiência operacional, redução de erros, conformidade legal, integração flexivel e escalabilidade. - Para evitar a duplicidade na escrituração de documentos, o serviço utiliza uma chave única composta pelos seguintes elementos: CNPJ do Prestador, Número da Nota, Número do RPS, Série da Nota e data de emissão. Essa chave única garante que cada documento fiscal seja registrado apenas uma vez, prevenindo inconsistências e duplicações. ## Request body - NFSe - `notaModelo` integer, required — Este atributo é utilizado para preparar a inclusão do movimento no SankhyaOm, permitindo que o serviço obtenha informações essenciais, como empresa, tipo de operação, natureza, tipo de negociação, entre outros. Para saber mais como configurar um Modelo de Nota, Clique [aqui](https://ajuda.sankhya.com.br/hc/pt-br/articles/360051706514-Modelo-de-Notas-e-Pedidos) Observações importantes: - As informações minimas no Nota Modelo é Empresa, Tipo de Operação (TOP) e Tipo de Negociação, demais informações fica a cargo de utilização do usuário como CR, Natureza, etc. - Para que a escrituração aconteça a TOP informada no modelo deve ter a opção de "Cálculo de ICMS, IPI e ISS" como não calcula e digita. - `prestador` object, required - `cnpj` string, required — CNPJ do prestador - O CNPJ do prestador deve estar previamente cadastrado e com tipo "fornecedor" ativo. - `inscricaoMunicipal` string, required — Inscrição municipal do prestador - `numeroNota` string, required — Número da nota - `numeroRPS` integer, required — Número do RPS - `serieRPS` string, required — Série do RPS - `dataEmissao` string, date, required — Data de emissão da nota - `horaEmissao` string, time, required — Hora de emissão da nota - `valorTotalNota` number, double, required — Valor Total da Nota - `valorDescontoCondicionado` number, double — Valor do desconto condicionado - `valorDescontoIncondicionado` number, double — Valor do desconto incondicionado - `valorDeducoes` number, double — Valor das deduções - `issRetido` boolean, required — Indica se o ISS foi retido - `aliquotaiss` number, double — Alíquota do ISS - `valorIss` number, double, required — Valor do ISS - `ir` object, required - `valor` number, double — Valor do IR - `retido` boolean — Indica se o IR foi retido - `tipoRetencao` 1 | 2 — Tipo de retenção do IR, as opções são: - 1 - Competência - 2 - Baixa - `inss` object, required - `valor` number, double — Valor do INSS - `retido` boolean — Indica se o INSS foi retido - `tipoRetencao` 1 | 2 — Tipo de retenção do INSS, as opções são: - 1 - Competência - 2 - Baixa - `pis` object, required - `valor` number, double — Valor do PIS - `retido` boolean — Indica se o PIS foi retido - `tipoRetencao` 1 | 2 — Tipo de retenção do PIS, as opções são: - 1 - Competência - 2 - Baixa - `cofins` object, required - `valor` number, double — Valor do COFINS - `retido` boolean — Indica se o COFINS foi retido - `tipoRetencao` 1 | 2 — Tipo de retenção do COFINS, as opções são: - 1 - Competência - 2 - Baixa - `csll` object, required - `valor` number, double — Valor do CSLL - `retido` boolean — Indica se o CSLL foi retido - `tipoRetencao` 1 | 2 — Tipo de retenção do CSLL, as opções são: - 1 - Competência - 2 - Baixa - `observacao` string — Observação adicional - `codigoVerificacao` string — Código de verificação da nota - `servico` object, required - `itemListaServico` string — Item da lista de serviços: Neste item deve ser informado o código do serviço conforme a aplicabilidade do município, podendo utilizar a LC 116 que é uma lista de atividades de prestação de serviço de âmbito federal ou um código específico do município. Essa informação é de suma importância para identificação do serviço a ser escriturado. Para mais informações sobre essa Lista de serviços clique [aqui](https://ajuda.sankhya.com.br/hc/pt-br/articles/360044599414-Lista-de-Servi%C3%A7os) - `descricao` string — Descrição do serviço - `quantidade` integer — Quantidade do serviço - `valorUnitario` number, double — Valor unitário do serviço - `valorTotal` number, double — Valor total do serviço ## Response `200` Operação bem sucedida. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - ImportacaoResposta - `status` string — Status da importação - `mensagem` string — Mensagem detalhada sobre a importação ## Other responses - `400` — Informações Inválidas. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `401` — Não autenticado. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `403` — Autenticação inválida. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `404` — Dados não encontrados. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `500` — Erro interno no servidor. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `501` — Não implementado. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `502` — Retorno inválido do servidor. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `503` — Serviço indisponível no momento. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `504` — Tempo de execução excedido. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. --- [API](https://skmtc.net/sankhya/apis/api-sankhya.md) · [All operations](https://skmtc.net/sankhya/apis/api-sankhya/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sankhya/api-sankhya/revisions/0a3e81ca6195/schema)