> ## 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.

# Perfil rural de uma empresa

> Mesma estrutura de resposta de /rural/cpf/{cpf}; 'tipo' retorna PJ.



## OpenAPI

````yaml /openapi/rural.json get /rural/cnpj/{cnpj}
openapi: 3.0.0
info:
  title: Sherlocker Rural API
  description: >-
    Perfil rural completo: imoveis rurais (SNCR, CAFIR), fiscalizacao ambiental
    (IBAMA), autorizacoes florestais (AUTEX), transporte florestal (DOF) e
    produtores organicos por CPF ou CNPJ.
  version: '1.0'
servers:
  - url: https://221b-api.sherlocker.com.br/api/v1
security:
  - tokenAuth: []
paths:
  /rural/cnpj/{cnpj}:
    get:
      tags:
        - Rural
      summary: Perfil rural de uma empresa
      description: Mesma estrutura de resposta de /rural/cpf/{cpf}; 'tipo' retorna PJ.
      operationId: getRuralByCnpj
      parameters:
        - name: cnpj
          in: path
          required: true
          description: CNPJ (14 digitos)
          schema:
            type: string
            example: '12345678000199'
      responses:
        '200':
          description: >-
            Perfil rural completo. Em caso de documento invalido ou servico
            indisponivel, retorna { erro: string } tambem com status 200.
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/RuralProfile'
                  - $ref: '#/components/schemas/RuralErro'
              example:
                documento: '12345678000199'
                tipo: PJ
                propriedades_sncr:
                  - codigo_imovel: '9200654321'
                    nome_imovel: Fazenda Santa Clara
                    municipio: Campinas
                    uf: SP
                    area_total: 1200
                    modulos_fiscais: 60
                    cod_ibge: '3509502'
                    nome_detentor: Silva Comércio LTDA
                    cpf_cnpj_mask: 12.345.***/0001-99
                    documento: '12345678000199'
                    tipo: PJ
                    tipo_detentor: Proprietário
                    fracao: 100
                    condicao_detentor: Proprietário
                    pais: BRASIL
                propriedades_cafir:
                  - nirf: '9876543210'
                    area_total: 1200
                    codigo_incra: '9200654321'
                    nome_imovel: Fazenda Santa Clara
                    situacao: Ativo
                    logradouro: Rodovia SP-340 km 120
                    distrito: Distrito Industrial
                    uf: SP
                    municipio: Campinas
                    cep: '13000000'
                    data_atualizacao: '2023-06-20'
                    imune_isento: Não
                    codigo_sncr: '9200654321'
                transportes:
                  total: 0
                  volume_total: 0
                  valor_total: 0
                  produtos: []
                  por_produto: []
                  por_ano: []
                  parceiros: []
                autorizacoes: []
                infracoes: []
                produtor_organico: []
                resumo:
                  area_total_ha: 2400
                  qtd_imoveis_sncr: 1
                  qtd_imoveis_cafir: 1
                  qtd_infracoes: 0
                  valor_total_multas: 0
                  qtd_autorizacoes: 0
                  qtd_transportes: 0
                  estados:
                    - SP
        '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:
    RuralProfile:
      type: object
      description: >-
        Perfil rural agregado. Retornado de forma identica por /rural/cpf/{cpf}
        e /rural/cnpj/{cnpj}; a unica diferenca e o valor de 'tipo' (PF para
        CPF, PJ para CNPJ).
      properties:
        documento:
          type: string
          description: CPF/CNPJ consultado (somente digitos)
        tipo:
          type: string
          enum:
            - PF
            - PJ
          description: >-
            PF quando consultado por CPF (11 digitos), PJ quando consultado por
            CNPJ (14 digitos)
        propriedades_sncr:
          type: array
          items:
            $ref: '#/components/schemas/SncrRow'
        propriedades_cafir:
          type: array
          items:
            $ref: '#/components/schemas/CafirRow'
        transportes:
          type: object
          properties:
            total:
              type: integer
            volume_total:
              type: number
            valor_total:
              type: number
            produtos:
              type: array
              items:
                type: string
            por_produto:
              type: array
              items:
                $ref: '#/components/schemas/ProdutoAgrupado'
            por_ano:
              type: array
              items:
                type: object
                properties:
                  ano:
                    type: integer
                  qtd:
                    type: integer
                  volume:
                    type: number
            parceiros:
              type: array
              description: >-
                Parceiros comerciais (remetentes e destinatarios), limitado aos
                5 principais de cada direcao
              items:
                $ref: '#/components/schemas/TransporteAgrupado'
        autorizacoes:
          type: array
          items:
            $ref: '#/components/schemas/AutorizacaoAgrupada'
        infracoes:
          type: array
          items:
            $ref: '#/components/schemas/FiscalizacaoRow'
        produtor_organico:
          type: array
          items:
            $ref: '#/components/schemas/ProdutorRow'
        resumo:
          $ref: '#/components/schemas/RuralResumo'
    RuralErro:
      type: object
      description: >-
        Resposta de erro retornada com status HTTP 200 quando o documento e
        invalido ou o servico esta indisponivel.
      properties:
        erro:
          type: string
          example: CPF/CNPJ invalido
    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
    SncrRow:
      type: object
      properties:
        codigo_imovel:
          type: string
        nome_imovel:
          type: string
        municipio:
          type: string
        uf:
          type: string
        area_total:
          type: number
          description: Area em hectares
        modulos_fiscais:
          type: number
        cod_ibge:
          type: string
          description: Codigo IBGE do municipio
        nome_detentor:
          type: string
        cpf_cnpj_mask:
          type: string
          description: Documento mascarado do detentor
        documento:
          type: string
          description: CPF/CNPJ do detentor (somente digitos)
        tipo:
          type: string
          enum:
            - PF
            - PJ
          description: PF (CPF, 11 digitos) ou PJ (CNPJ, 14 digitos)
        tipo_detentor:
          type: string
        fracao:
          type: number
          description: Fracao de posse (%)
        condicao_detentor:
          type: string
        pais:
          type: string
    CafirRow:
      type: object
      properties:
        nirf:
          type: string
          description: Numero do Imovel na Receita Federal (CAFIR)
        area_total:
          type: number
          description: Area em hectares
        codigo_incra:
          type: string
        nome_imovel:
          type: string
        situacao:
          type: string
        logradouro:
          type: string
        distrito:
          type: string
        uf:
          type: string
        municipio:
          type: string
        cep:
          type: string
        data_atualizacao:
          type: string
        imune_isento:
          type: string
        codigo_sncr:
          type: string
    ProdutoAgrupado:
      type: object
      properties:
        produto:
          type: string
          description: Nome do material/produto florestal
        qtd:
          type: integer
          description: Quantidade de operacoes
        volume:
          type: number
          description: Volume total transportado
        valor:
          type: number
          description: Valor total em reais
        unidade:
          type: string
          description: Unidade de medida (m3, kg, etc)
    TransporteAgrupado:
      type: object
      description: >-
        Parceiro comercial com operacoes de transporte agrupadas. No perfil
        completo os campos 'por_produto' e 'operacoes' vem vazios (detalhe
        disponivel em endpoint dedicado).
      properties:
        documento:
          type: string
          description: CPF/CNPJ do parceiro (somente digitos)
        tipo:
          type: string
          enum:
            - PF
            - PJ
        nome:
          type: string
        uf:
          type: string
        municipio:
          type: string
        direcao:
          type: string
          enum:
            - remetente
            - destinatario
          description: Se o parceiro eh remetente ou destinatario
        qtd_operacoes:
          type: integer
        volume_total:
          type: number
        valor_total:
          type: number
        produtos:
          type: array
          items:
            type: string
        por_produto:
          type: array
          description: Vazio no perfil completo
          items:
            $ref: '#/components/schemas/ProdutoAgrupado'
        periodo:
          type: object
          properties:
            primeiro:
              type: string
            ultimo:
              type: string
        operacoes:
          type: array
          description: Vazio no perfil completo
          items:
            $ref: '#/components/schemas/TransporteDetalhe'
    AutorizacaoAgrupada:
      type: object
      description: Autorizacao de exploracao florestal (AUTEX) agrupada por numero de serie
      properties:
        numero_de_serie:
          type: string
        tipo_autex:
          type: string
        municipio:
          type: string
        uf:
          type: string
        situacao:
          type: string
        data_emissao:
          type: string
        data_vencimento:
          type: string
        produtos:
          type: array
          items:
            type: object
            properties:
              produto:
                type: string
              quantidade_autorizada:
                type: number
    FiscalizacaoRow:
      type: object
      properties:
        numero_auto:
          type: string
          description: Numero do auto de infracao
        tipo_auto:
          type: string
        documento:
          type: string
          description: CPF/CNPJ do infrator (somente digitos)
        tipo:
          type: string
          enum:
            - PF
            - PJ
        nome_infrator:
          type: string
        municipio:
          type: string
        uf:
          type: string
        descricao_dano:
          type: string
        area_embargada:
          type: number
          description: Area embargada em hectares
        latitude:
          type: number
        longitude:
          type: number
        data_auto:
          type: string
        valor_multa:
          type: number
          description: Valor da multa em reais
        situacao_debito:
          type: string
    ProdutorRow:
      type: object
      description: Produtor organico certificado
      properties:
        nome_produtor:
          type: string
        documento:
          type: string
          description: CPF/CNPJ do produtor (somente digitos)
        tipo:
          type: string
          enum:
            - PF
            - PJ
        cpf_cnpj_mask:
          type: string
          description: Documento mascarado
        uf:
          type: string
        cidade:
          type: string
        escopo:
          type: string
        atividade:
          type: string
        situacao:
          type: string
    RuralResumo:
      type: object
      properties:
        area_total_ha:
          type: number
        qtd_imoveis_sncr:
          type: integer
        qtd_imoveis_cafir:
          type: integer
        qtd_infracoes:
          type: integer
        valor_total_multas:
          type: number
        qtd_autorizacoes:
          type: integer
        qtd_transportes:
          type: integer
        estados:
          type: array
          items:
            type: string
    TransporteDetalhe:
      type: object
      properties:
        data_emissao:
          type: string
        produto:
          type: string
        nome_popular:
          type: string
        volume:
          type: number
        unidade:
          type: string
        valor_total:
          type: number
  securitySchemes:
    tokenAuth:
      type: apiKey
      in: query
      name: token

````