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

# Renuncias fiscais de uma empresa

> Retorna renuncias fiscais, habilitacoes e imunidades tributarias da empresa.



## OpenAPI

````yaml /openapi/beneficios.json get /beneficios/cnpj/{cnpj}
openapi: 3.0.0
info:
  title: Sherlocker Beneficios API
  description: >-
    Mapeamento de beneficios sociais (Auxilio Brasil, Bolsa Familia, BPC,
    Auxilio Emergencial) por CPF e renuncias fiscais por CNPJ.
  version: '1.0'
servers:
  - url: https://221b-api.sherlocker.com.br/api/v1
security:
  - tokenAuth: []
paths:
  /beneficios/cnpj/{cnpj}:
    get:
      tags:
        - Beneficios
      summary: Renuncias fiscais de uma empresa
      description: >-
        Retorna renuncias fiscais, habilitacoes e imunidades tributarias da
        empresa.
      operationId: getBeneficiosByCnpj
      parameters:
        - name: cnpj
          in: path
          required: true
          description: CNPJ (apenas digitos)
          schema:
            type: string
            example: '12345678000199'
      responses:
        '200':
          description: Renuncias fiscais encontradas
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BeneficiosCnpjResponse'
              example:
                total: 1
                renuncias_fiscais:
                  - ano_calendario: '2023'
                    cnpj: '12345678000199'
                    razao_social: Silva Comércio Ltda
                    nome_fantasia: Silva Store
                    codigo_cnae: '4729699'
                    cnae: Comércio varejista de produtos alimentícios em geral
                    municipio: São Paulo
                    uf: SP
                    tipo_renuncia: >-
                      Declarado pelo Contribuinte para Apuração do IRPJ e da
                      CSLL
                    beneficio_fiscal: Simples Nacional
                    fundamento_legal: Lei Complementar 123/2006
                    descricao: Regime Especial Unificado de Arrecadação
                    tributo: IRPJ
                    forma_tributacao: Simples Nacional
                    valor_renuncia_fiscal: 12.000,00
                    created_at: '2024-01-15 10:30:00'
        '400':
          description: Parametro invalido
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Token ausente ou invalido
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    BeneficiosCnpjResponse:
      type: object
      properties:
        total:
          type: integer
        renuncias_fiscais:
          type: array
          items:
            $ref: '#/components/schemas/RenunciaFiscal'
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
          example: false
        erro:
          type: object
          properties:
            codigo:
              type: string
              description: 'Codigo do erro (ex: VALIDATION_ERROR, NOT_FOUND, UNAUTHORIZED)'
              example: VALIDATION_ERROR
            mensagem:
              type: string
              description: Mensagem descritiva do erro
              example: CPF invalido
    RenunciaFiscal:
      type: object
      description: >-
        Registro bruto (SELECT *) de empresas.renuncias_fiscais. Valores
        monetarios vem como string no formato brasileiro (ex: "1.263,00").
      properties:
        ano_calendario:
          type: string
        cnpj:
          type: string
        razao_social:
          type: string
        nome_fantasia:
          type: string
        codigo_cnae:
          type: string
          nullable: true
        cnae:
          type: string
          nullable: true
        municipio:
          type: string
        uf:
          type: string
          nullable: true
        tipo_renuncia:
          type: string
        beneficio_fiscal:
          type: string
        fundamento_legal:
          type: string
        descricao:
          type: string
        tributo:
          type: string
        forma_tributacao:
          type: string
          nullable: true
        valor_renuncia_fiscal:
          type: string
          description: 'Valor em R$ no formato brasileiro (ex: "1.263,00")'
        created_at:
          type: string
  securitySchemes:
    tokenAuth:
      type: apiKey
      in: query
      name: token

````