POST/nfse

Emitir una nota de servicio

La API valida el esquema JSON y las reglas de negocio. Si todo es válido, recibe un ID por cada nota y el documento se envía a la Prefectura. Esta ruta es asíncrona. Consulte el estado en GET /nfse/consultar/{idNotaOrProtocol} o registre un webhook en la organización o en la empresa. Tomador extranjero: - En municipios atendidos por el proveedor DSF, informe el documento extranjero en tomador.cpfCnpj. Notas: - Genere un idIntegracao único por nota. Solicitudes duplicadas con el mismo identificador se procesan una sola vez. - El tiempo de procesamiento depende del webservice de la Prefectura. - Si el prestador nunca emitió por webservice, suele haber homologación previa. - El lote máximo es de 500 notas.

Producción: https://api.otentecnologia.com.brSandbox: https://api.sandbox.otentecnologia.com.br

Parámetros

Esta ruta no tiene parámetros de path o query.

Solicitud

cURL

curl -X POST 'https://api.otentecnologia.com.br/nfse' \
  -H 'x-api-key: $OTEN_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '[
  {
    "idIntegracao": "SP-2026-0001",
    "prestador": {
      "cpfCnpj": "00000000000000"
    },
    "tomador": {
      "cpfCnpj": "11111111000191",
      "razaoSocial": "Cliente Exemplo LTDA",
      "inscricaoMunicipal": "12345678",
      "email": "financeiro@cliente.com",
      "endereco": {
        "tipoLogradouro": "Avenida",
        "logradouro": "Paulista",
        "numero": "1000",
        "complemento": "Conjunto 101",
        "bairro": "Bela Vista",
        "tipoBairro": "Bairro",
        "codigoCidade": "3550308",
        "descricaoCidade": "Sao Paulo",
        "estado": "SP",
        "cep": "01310100"
      }
    },
    "cidadePrestacao": {
      "codigo": "3550308",
      "descricao": "Sao Paulo"
    },
    "servico": [
      {
        "codigo": "1.05",
        "codigoTributacao": "1.05",
        "discriminacao": "Licenca de uso de software e suporte tecnico mensal.",
        "cnae": "6203100",
        "codigoCidadeIncidencia": "3550308",
        "descricaoCidadeIncidencia": "SAO PAULO",
        "iss": {
          "tipoTributacao": 6,
          "exigibilidade": 1,
          "retido": false,
          "aliquota": 2.9
        },
        "valor": {
          "servico": 1500,
          "descontoCondicionado": 0,
          "descontoIncondicionado": 0
        }
      }
    ]
  }
]'

Body

application/json

[
  {
    "idIntegracao": "SP-2026-0001",
    "prestador": {
      "cpfCnpj": "00000000000000"
    },
    "tomador": {
      "cpfCnpj": "11111111000191",
      "razaoSocial": "Cliente Exemplo LTDA",
      "inscricaoMunicipal": "12345678",
      "email": "financeiro@cliente.com",
      "endereco": {
        "tipoLogradouro": "Avenida",
        "logradouro": "Paulista",
        "numero": "1000",
        "complemento": "Conjunto 101",
        "bairro": "Bela Vista",
        "tipoBairro": "Bairro",
        "codigoCidade": "3550308",
        "descricaoCidade": "Sao Paulo",
        "estado": "SP",
        "cep": "01310100"
      }
    },
    "cidadePrestacao": {
      "codigo": "3550308",
      "descricao": "Sao Paulo"
    },
    "servico": [
      {
        "codigo": "1.05",
        "codigoTributacao": "1.05",
        "discriminacao": "Licenca de uso de software e suporte tecnico mensal.",
        "cnae": "6203100",
        "codigoCidadeIncidencia": "3550308",
        "descricaoCidadeIncidencia": "SAO PAULO",
        "iss": {
          "tipoTributacao": 6,
          "exigibilidade": 1,
          "retido": false,
          "aliquota": 2.9
        },
        "valor": {
          "servico": 1500,
          "descontoCondicionado": 0,
          "descontoIncondicionado": 0
        }
      }
    ]
  }
]

Respuestas

200OK

JSON

{
  "documents": [
    {
      "idIntegracao": "XXXYY999",
      "prestador": "08187168000160",
      "id": "5eb6caf7cbb4e8dce016c39f"
    }
  ],
  "message": "Nota(as) em processamento",
  "protocol": "7c09beca-1b2a-4acb-bd63-2f37a0e2ee1a"
}

400Bad Request

JSON

{
  "error": {
    "message": "Não foi possível enviar 501 documentos, pois o limite máximo de 500 NFS-e em um único JSON foi atingido."
  }
}

401Unauthorized

JSON

{
  "error": {
    "message": "O token informado é inválido. Para o ambiente de produção, Acesse https://www.otentecnologia.com.br/, e gere o seu TOKEN de acesso"
  }
}

409Conflict

JSON

{
  "error": {
    "message": "Já existe um(a) NFSe com os parâmetros informados",
    "data": {
      "new": {
        "idIntegracao": "TESTE",
        "cnpj": "8187168000160"
      },
      "current": {
        "id": "5exxxe508efc9a95e999faa0",
        "idIntegracao": "TESTE",
        "emissao": "13/04/2020",
        "tipoAutorizacao": "WEBSERVICE",
        "situacao": "CONCLUIDO",
        "prestador": "8187168000160",
        "tomador": "8187168000160",
        "valorServico": 20,
        "numeroNfse": "999",
        "serie": "1",
        "lote": 0,
        "numero": 1,
        "codigoVerificacao": "XXXX",
        "autorizacao": "30/08/2011",
        "mensagem": "RPS Autorizada com sucesso",
        "pdf": "https://api.otentecnologia.com.br/nfse/pdf/5exxxe508efc9a95e999faa0",
        "xml": "https://api.otentecnologia.com.br/nfse/xml/5exxxe508efc9a95e999faa0"
      }
    }
  }
}