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

# Consulta CPE

> Valida comprobantes electrónicos. Verifica estado y datos del comprobante. 



## OpenAPI

````yaml POST /cpe
openapi: 3.0.1
info:
  title: json.pe - API Consulta RUC, DNI, Placa, SOAT, Licencia de Conducir y más
  description: >-
    Documentación oficial de [json.pe](https://json.pe) — API Consulta RUC, DNI,
    Placa, SOAT, Licencia de Conducir y más. Regístrate gratis en
    [json.pe/signup](https://json.pe/signup).
  version: 1.0.0
servers:
  - url: https://api.json.pe/api
security:
  - bearerAuth: []
paths:
  /cpe:
    post:
      description: >-
        Valida comprobantes electrónicos. Verifica estado y datos del
        comprobante. 
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostCPE'
        required: true
      responses:
        '200':
          description: plant response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sunat-cpe'
        '404':
          description: Recurso no encontrado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
              example:
                success: false
                message: No se encontró RUC
components:
  schemas:
    PostCPE:
      type: object
      properties:
        ruc_emisor:
          type: string
          description: RUC Emisor del comprobante
        codigo_tipo_documento:
          type: string
          description: Tipo Documento del comprobante
        serie_documento:
          type: string
          description: Serie del comprobante
        numero_documento:
          type: string
          description: Correlativo del comprobante
        fecha_de_emision:
          type: string
          description: Debe tener el formato dd/mm/yyyy
        total:
          type: string
          description: Total del comprobante
      additionalProperties: false
    sunat-cpe:
      type: object
      properties:
        success:
          type: boolean
          description: El estado de la respuesta  true o false
        message:
          type: string
          description: Mensaje de la respuesta
        data:
          type: object
          description: Datos detallados de la respuesta
          properties:
            ruc_emisor:
              type: string
              description: RUC del emisor del comprobante
            codigo_tipo_documento:
              type: string
              description: Código del tipo de documento (ej. 01, 03)
            serie_documento:
              type: string
              description: Serie del comprobante
            numero_documento:
              type: string
              description: Número del comprobante
            fecha_de_emision:
              type: string
              description: Fecha de emisión del comprobante en formato dd/mm/yyyy
            total:
              type: number
              description: Importe total declarado en el comprobante
            comprobante_estado_codigo:
              type: string
              description: Código del estado del comprobante
            comprobante_estado_descripcion:
              type: string
              description: Descripción del estado del comprobante
            empresa_estado_codigo:
              type: string
              description: Código del estado del contribuyente emisor
            empresa_estado_description:
              type: string
              description: Descripción del estado del contribuyente emisor
            empresa_condicion_codigo:
              type: string
              description: Código de la condición del contribuyente emisor
            empresa_condicion_descripcion:
              type: string
              description: Descripción de la condición del contribuyente emisor
            observaciones:
              type: array
              description: Observaciones reportadas por SUNAT
              items:
                type: string
      example:
        success: true
        message: ACEPTADO
        data:
          ruc_emisor: '20525542689'
          codigo_tipo_documento: '03'
          serie_documento: B001
          numero_documento: '12374'
          fecha_de_emision: 08/11/2025
          total: 40
          comprobante_estado_codigo: '1'
          comprobante_estado_descripcion: ACEPTADO
          empresa_estado_codigo: '00'
          empresa_estado_description: ACTIVO
          empresa_condicion_codigo: '00'
          empresa_condicion_descripcion: HABIDO
          observaciones: []
    error:
      required:
        - message
        - success
      type: object
      properties:
        success:
          type: boolean
        message:
          type: string
      example:
        success: false
        message: Bad Request
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````