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

# RUC - Establecimientos

> Consulta establecimientos por RUC



## OpenAPI

````yaml POST /ruc/establecimientos
openapi: 3.1.0
info:
  title: API JSON
  description: Documentación de la API JSON
  version: 1.0.0
servers:
  - url: https://api.json.com.pe
security:
  - bearerAuth: []
paths:
  /ruc/establecimientos:
    post:
      summary: Consultar establecimientos de un RUC
      description: Consulta establecimientos por RUC
      requestBody:
        description: Datos necesarios para realizar la consulta.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConsultaRucEstablecimientosRequest'
            example:
              ruc: '20123456789'
      responses:
        '200':
          description: Consulta realizada correctamente.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConsultaRucEstablecimientosResponse'
              example:
                success: true
                message: exito
                data:
                  - codigo: '0001'
                    tipo_establecimiento: SU. SUCURSAL
                    actividad_economica: '-'
                    direccion: AV. NICOLÁS DE PIÉROLA 789.
                    direccion_completa: AV. NICOLÁS DE PIÉROLA 789., LIMA - LIMA - CERCADO DE LIMA
                    departamento: LIMA
                    provincia: LIMA
                    distrito: CERCADO DE LIMA
                    ubigeo_sunat: '150101'
                    ubigeo:
                      - '15'
                      - '1501'
                      - '150101'
                  - codigo: '0002'
                    tipo_establecimiento: SU. SUCURSAL
                    actividad_economica: '-'
                    direccion: AV. ALFONSO UGARTE 848.
                    direccion_completa: AV. ALFONSO UGARTE 848., LIMA - LIMA - CERCADO DE LIMA
                    departamento: LIMA
                    provincia: LIMA
                    distrito: LIMA
                    ubigeo_sunat: '150101'
                    ubigeo:
                      - '15'
                      - '1501'
                      - '150101'
        '404':
          description: No se encontró información para el RUC enviado.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseRucEstablecimientos'
              example:
                success: false
                message: No se encontró RUC
components:
  schemas:
    ConsultaRucEstablecimientosRequest:
      type: object
      required:
        - ruc
      properties:
        ruc:
          type: string
          description: Ruc de 11 dígitos a consultar.
          example: '20123456789'
    ConsultaRucEstablecimientosResponse:
      type: object
      properties:
        success:
          type: boolean
          description: Indica si la consulta fue exitosa.
          example: true
        message:
          type: string
          description: Mensaje descriptivo del resultado.
          example: Exito
        data:
          type: object
          properties:
            codigo:
              type: string
              description: Codigo del local.
            tipo_establecimiento:
              type: string
              description: Tipo de establecimiento del local.
            actividad_economica:
              type: string
              description: Actividad economica del local.
            departamento:
              type: string
              description: Departamento del local.
            provincia:
              type: string
              description: Provincia del local.
            distrito:
              type: string
              description: Distrito del local.
            direccion:
              type: string
              description: Dirección específica.
            direccion_completa:
              type: string
              description: >-
                Dirección completa, incluyendo distrito, provincia y
                departamento.
            ubigeo_sunat:
              type: string
              description: Ubigeo según SUNAT.
            ubigeo:
              type: array
              description: Ubigeo desglosado por componentes.
    ErrorResponseRucEstablecimientos:
      type: object
      properties:
        success:
          type: boolean
          description: Indica si la consulta fue exitosa.
          example: false
        message:
          type: string
          description: Mensaje descriptivo del error.
          example: No se encontró RUC
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````