v1

latestOpenAPI 3.0.3Licença Sankhya2026-07-24161242654.8 KB

Fiscal

Importar Nota Fiscal de Serviço

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.

post/v1/fiscal/servicos-tomados/nfse

Request body

notaModelointeger 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

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.

numeroNotastring required

Número da nota

numeroRPSinteger required

Número do RPS

serieRPSstring required

Série do RPS

dataEmissaostring date required

Data de emissão da nota

horaEmissaostring time required

Hora de emissão da nota

valorTotalNotanumber double required

Valor Total da Nota

valorDescontoCondicionadonumber double

Valor do desconto condicionado

valorDescontoIncondicionadonumber double

Valor do desconto incondicionado

valorDeducoesnumber double

Valor das deduções

issRetidoboolean required

Indica se o ISS foi retido

aliquotaissnumber double

Alíquota do ISS

valorIssnumber double required

Valor do ISS

observacaostring

Observação adicional

codigoVerificacaostring

Código de verificação da nota

Example request

{
  "notaModelo": 123,
  "prestador": {
    "cnpj": "12345678000100",
    "inscricaoMunicipal": "123456"
  },
  "numeroNota": "12345",
  "numeroRPS": 1234567890,
  "serieRPS": "NF",
  "dataEmissao": "08/01/2025",
  "horaEmissao": "15:05",
  "valorTotalNota": 1500,
  "issRetido": true,
  "aliquotaiss": 15,
  "valorIss": 225,
  "ir": {
    "valor": 45,
    "retido": true,
    "tipoRetencao": 1
  },
  "inss": {
    "valor": 75,
    "retido": true,
    "tipoRetencao": 1
  },
  "pis": {
    "valor": 30,
    "retido": true,
    "tipoRetencao": 2
  },
  "cofins": {
    "valor": 69,
    "retido": true,
    "tipoRetencao": 2
  },
  "csll": {
    "valor": 30,
    "retido": true,
    "tipoRetencao": 2
  },
  "observacao": "Pagamento em 30 dias.",
  "codigoVerificacao": "ABC123456",
  "servico": {
    "itemListaServico": "0103",
    "descricao": "Consultoria técnica",
    "quantidade": 1,
    "valorUnitario": 1500,
    "valorTotal": 1500
  }
}

Response

Operação bem sucedida. Clique aqui para mais detalhes.

statusstring

Status da importação

mensagemstring

Mensagem detalhada sobre a importação

Example response

{
  "status": "sucesso",
  "mensagem": "Nota Fiscal de Serviço importada com sucesso."
}