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

> Retorna propriedades SNCR e CAFIR, infracoes IBAMA, autorizacoes florestais (AUTEX), transportes florestais (DOF), produtores organicos e resumo consolidado.



## OpenAPI

````yaml /openapi/rural.json get /rural/cpf/{cpf}
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/cpf/{cpf}:
    get:
      tags:
        - Rural
      summary: Perfil rural de uma pessoa
      description: >-
        Retorna propriedades SNCR e CAFIR, infracoes IBAMA, autorizacoes
        florestais (AUTEX), transportes florestais (DOF), produtores organicos e
        resumo consolidado.
      operationId: getRuralByCpf
      parameters:
        - name: cpf
          in: path
          required: true
          description: CPF (11 digitos)
          schema:
            type: string
            example: '12345678901'
      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: '12345678901'
                tipo: PF
                propriedades_sncr:
                  - codigo_imovel: '9200123456'
                    nome_imovel: Fazenda Boa Vista
                    municipio: Ribeirão Preto
                    uf: SP
                    area_total: 500.5
                    modulos_fiscais: 25
                    cod_ibge: '3543402'
                    nome_detentor: João Silva
                    cpf_cnpj_mask: 123.***.***-01
                    documento: '12345678901'
                    tipo: PF
                    tipo_detentor: Proprietário
                    fracao: 100
                    condicao_detentor: Proprietário
                    pais: BRASIL
                propriedades_cafir:
                  - nirf: '1234567890'
                    area_total: 500.5
                    codigo_incra: '9200123456'
                    nome_imovel: Fazenda Boa Vista
                    situacao: Ativo
                    logradouro: Estrada Rural km 5
                    distrito: Distrito Rural
                    uf: SP
                    municipio: Ribeirão Preto
                    cep: '14000000'
                    data_atualizacao: '2023-01-15'
                    imune_isento: Não
                    codigo_sncr: '9200123456'
                transportes:
                  total: 5
                  volume_total: 250
                  valor_total: 75000
                  produtos:
                    - Eucalipto
                  por_produto:
                    - produto: Eucalipto
                      qtd: 5
                      volume: 250
                      valor: 75000
                      unidade: m3
                  por_ano:
                    - ano: 2023
                      qtd: 3
                      volume: 150
                    - ano: 2024
                      qtd: 2
                      volume: 100
                  parceiros:
                    - documento: '98765432000188'
                      tipo: PJ
                      nome: Madeireira Central LTDA
                      uf: SP
                      municipio: Ribeirão Preto
                      direcao: destinatario
                      qtd_operacoes: 5
                      volume_total: 250
                      valor_total: 75000
                      produtos:
                        - Eucalipto
                      por_produto: []
                      periodo:
                        primeiro: '2023-03-10'
                        ultimo: '2024-08-20'
                      operacoes: []
                autorizacoes:
                  - numero_de_serie: AUTEX-2023-0001
                    tipo_autex: Supressão de vegetação
                    municipio: Ribeirão Preto
                    uf: SP
                    situacao: Ativa
                    data_emissao: '2023-02-01'
                    data_vencimento: '2024-02-01'
                    produtos:
                      - produto: Eucalipto
                        quantidade_autorizada: 500
                infracoes:
                  - numero_auto: '9876543'
                    tipo_auto: Multa
                    documento: '12345678901'
                    tipo: PF
                    nome_infrator: João Silva
                    municipio: Ribeirão Preto
                    uf: SP
                    descricao_dano: Desmatamento irregular de área de preservação permanente
                    area_embargada: 2.5
                    latitude: -21.1767
                    longitude: -47.8208
                    data_auto: '2022-06-15'
                    valor_multa: 50000
                    situacao_debito: Em cobrança
                produtor_organico:
                  - nome_produtor: João Silva
                    documento: '12345678901'
                    tipo: PF
                    cpf_cnpj_mask: 123.***.***-01
                    uf: SP
                    cidade: Ribeirão Preto
                    escopo: Produção primária vegetal
                    atividade: Olericultura
                    situacao: Ativo
                resumo:
                  area_total_ha: 1001
                  qtd_imoveis_sncr: 1
                  qtd_imoveis_cafir: 1
                  qtd_infracoes: 1
                  valor_total_multas: 50000
                  qtd_autorizacoes: 1
                  qtd_transportes: 5
                  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

````