> ## Documentation Index
> Fetch the complete documentation index at: https://docs.invo.work/llms.txt
> Use this file to discover all available pages before exploring further.

# Detalhes da Nota de Serviço (NFS-e)



## OpenAPI

````yaml /openapi-nfse.json get /notas/{id}
openapi: 3.0.1
info:
  title: Invo API Docs — NFS-e
  version: v1
servers:
  - url: https://invo.work/api/nfse/v1
security: []
tags:
  - name: Notas de Serviço
paths:
  /notas/{id}:
    get:
      tags:
        - Notas de Serviço
      summary: Detalhes da Nota de Serviço (NFS-e)
      parameters:
        - name: X-Empresa-CNPJ
          in: header
          required: false
          schema:
            description: >-
              CNPJ da empresa emitente. Ausente, usa a primeira empresa da
              conta.
            type: string
        - name: id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: integer
                  codigo_externo:
                    type: string
                  descricao:
                    type: string
                  observacoes:
                    type: string
                  valor_servicos:
                    description: >-
                      * Número decimal codificado como texto. Por exemplo:
                      '123.45'
                    type: string
                    pattern: ^\d*\.?\d*$
                    format: decimal number
                  iss:
                    type: object
                    properties:
                      valor_liquido:
                        description: >-
                          * Número decimal codificado como texto. Por exemplo:
                          '123.45'
                        type: string
                        pattern: ^\d*\.?\d*$
                        format: decimal number
                      base_calculo:
                        description: >-
                          * Número decimal codificado como texto. Por exemplo:
                          '123.45'
                        type: string
                        pattern: ^\d*\.?\d*$
                        format: decimal number
                      aliquota_iss:
                        description: >-
                          * Número decimal codificado como texto. Por exemplo:
                          '123.45'
                        type: string
                        pattern: ^\d*\.?\d*$
                        format: decimal number
                      valor_iss:
                        description: >-
                          * Número decimal codificado como texto. Por exemplo:
                          '123.45'
                        type: string
                        pattern: ^\d*\.?\d*$
                        format: decimal number
                    required:
                      - valor_liquido
                      - base_calculo
                      - valor_iss
                    additionalProperties: false
                  rps:
                    type: object
                    properties:
                      situacao:
                        type: string
                      numero:
                        type: integer
                      serie:
                        type: string
                      tipo:
                        type: string
                      data_emissao:
                        type: string
                    additionalProperties: false
                  nfse:
                    type: object
                    properties:
                      situacao:
                        type: string
                      numero:
                        type: string
                      codigo_verificacao:
                        type: string
                      data_emissao:
                        type: string
                    required:
                      - situacao
                    additionalProperties: false
                  tomador:
                    type: object
                    properties:
                      razao_social:
                        type: string
                      cpf_cnpj:
                        type: string
                      email:
                        type: string
                      telefone:
                        type: string
                      endereco:
                        type: object
                        properties:
                          cep:
                            type: string
                          logradouro:
                            type: string
                          numero:
                            type: string
                          complemento:
                            type: string
                          bairro:
                            type: string
                          municipio:
                            type: string
                          uf:
                            type: string
                        required:
                          - cep
                          - logradouro
                          - numero
                          - bairro
                          - municipio
                          - uf
                        additionalProperties: false
                    required:
                      - razao_social
                      - cpf_cnpj
                      - endereco
                    additionalProperties: false
                  servico:
                    type: object
                    properties:
                      descricao:
                        type: string
                      codigo_cnae:
                        type: string
                      codigo_item_lista:
                        type: string
                    required:
                      - codigo_cnae
                      - codigo_item_lista
                    additionalProperties: false
                  nbs:
                    type: object
                    properties:
                      codigo:
                        type: string
                      cst:
                        type: string
                      ct:
                        type: string
                      indop:
                        type: string
                    additionalProperties: false
                required:
                  - id
                  - codigo_externo
                  - valor_servicos
                  - iss
                  - rps
                  - nfse
                  - tomador
                  - servico
                  - nbs
                additionalProperties: false
          description: OK
        '401':
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    enum:
                      - 'HTTP Basic: Access denied.'
                required:
                  - error
                additionalProperties: false
          description: Unauthorized
        '404':
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    enum:
                      - Nota fiscal não encontrada
                required:
                  - error
                additionalProperties: false
          description: Not Found
        '422':
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    enum:
                      - invalid_params
                  params:
                    description: An object containing error messages for all invalid params
                    type: object
                    additionalProperties:
                      type: string
                required:
                  - error
                  - params
                additionalProperties: false
          description: Unprocessable Content
      security:
        - basicAuth: []
components:
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````