giansalex/peru-consult-api

秘鲁RUC和DNI查询API

https://github.com/giansalex/peru-consult-api/workflows/CI/badge.svg](https://github.com/giansalex/peru-consult-api/actions)

用于查询秘鲁DNI（个人身份号码）和RUC（统一税号）的API服务，基于https://github.com/giansalex/peru-consult%E5%8C%85%E5%AE%9E%E7%8E%B0%E6%A0%B8%E5%BF%83%E5%8A%9F%E8%83%BD%E3%80%82

镜像概述和主要用途

该镜像提供了一个轻量级API服务，允许开发者和企业通过编程方式查询秘鲁的个人（DNI）和企业（RUC）信息。支持RESTful接口和GraphQL查询，适用于需要验证秘鲁用户身份或企业信息的应用场景。

核心功能和特性

• 多接口支持：同时提供RESTful API和GraphQL接口
• 信息查询：支持DNI个人信息查询、RUC企业信息查询、SOL用户有效性验证
• 安全访问：通过API令牌控制访问权限
• 标准化响应：返回结构化JSON数据，包含详细信息字段
• GraphQL工具支持：兼容GraphiQL客户端，便于接口测试和调试

系统要求

• 容器运行环境需支持PHP 7.4或更高版本

使用方法和配置说明

Docker部署

直接从Docker Hub拉取并运行镜像：

bash
docker run -d -p 8080:8080 --name peru-consult -e API_TOKEN=your_key giansalex/peru-consult-api

参数说明：

• -p 8080:8080：将容器的8080端口映射到主机的8080端口
• --name peru-consult：指定容器名称为peru-consult
• -e API_TOKEN=your_key：设置API访问令牌（必填，用于验证请求合法性）

从源码构建（可选）

若需自定义构建，可执行以下步骤：

bash
git clone https://github.com/giansalex/peru-consult-api.git
cd peru-consult-api
composer install
php -S 0.0.0.0:8080 -t public

使用示例

GraphQL查询

通过/api/graph端点使用GraphQL查询，支持同时查询个人和企业信息：

graphql
query {
    person(dni: "48004836") {
        dni
        nombres
    },
    company(ruc: "20131312955") {
        ruc
        razonSocial
    }
}

响应示例：

json
{
    "data": {
        "person": {
            "dni": "48004836",
            "nombres": "ROBERTO CARLOS"
        },
        "company": {
            "ruc": "20131312955",
            "razonSocial": "SUPERINTENDENCIA NACIONAL DE ADUANAS Y DE ADMINISTRACION TRIBUTARIA - SUNAT"
        }
    }
}

DNI查询（REST）

使用Curl查询个人DNI信息：

bash
curl -H "Accept: application/json" http://localhost:8080/api/v1/dni/48004836?token=abcxyz

响应示例：

json
{
  "dni": "48004836",
  "nombres": "ROBERTO CARLOS",
  "apellidoPaterno": "SULCA",
  "apellidoMaterno": "BASILIO",
  "codVerifica": "4"
}

RUC查询（REST）

使用Curl查询企业RUC信息：

bash
curl -H "Accept: application/json" http://localhost:8080/api/v1/ruc/20131312955?token=abcxyz

响应示例：

json
{
  "ruc": "20131312955",
  "razonSocial": "SUPERINTENDENCIA NACIONAL DE ADUANAS Y DE ADMINISTRACION TRIBUTARIA - SUNAT",
  "nombreComercial": "-",
  "tipo": "INSTITUCIONES PUBLICAS",
  "estado": "ACTIVO",
  "condicion": "HABIDO",
  "direccion": "AV. GARCILASO DE LA VEGA NRO. 1472",
  "departamento":"LIMA",
  "provincia":"LIMA",
  "distrito":"LIMA",
  "fechaInscripcion": "1993-05-04T00:00:00.000Z",
  "sistEmsion": "MANUAL/COMPUTARIZADO",
  "sistContabilidad": "COMPUTARIZADO",
  "actExterior": "SIN ACTIVIDAD",
  "actEconomicas": [
    "75113 - ACTIV. ADMINIST. PUBLICA EN GENERAL"
  ],
  "cpPago": [
    "FACTURA",
    "BOLETA DE VENTA",
    "NOTA DE CREDITO",
    "NOTA DE DEBITO",
    "GUIA DE REMISION - REMITENTE",
    "COMPROBANTE DE RETENCION",
    "POLIZA DE ADJUDICACION POR REMATE DE BIENES"
  ],
  "sistElectronica": [
    "FACTURA PORTAL                      DESDE 07/08/2013",
    "BOLETA PORTAL                       DESDE 01/04/2016"
  ],
  "fechaEmisorFe": "2013-08-07T00:00:00.000Z",
  "cpeElectronico": [
    "FACTURA (desde 07/08/2013)",
    "BOLETA (desde 01/04/2016)"
  ],
  "fechaPle": "2013-01-01T00:00:00.000Z",
  "padrones": [
    "Incorporado al Régimen de Agentes de Retención de IGV (R.S.037-2002) a partir del 01/06/2002"
  ],
  "fechaBaja": null,
  "profesion": ""
}

SOL用户有效性查询

验证SUNAT SOL系统用户有效性：

bash
curl http://localhost:8080/api/v1/user-sol/20000000001/GMABCI?token=abcxyz

响应示例：

text
true

GraphiQL工具

推荐使用GraphiQL客户端（可从Chrome商店下载）进行API测试，访问端点/api/v1/graph。该工具提供自动补全功能和实时文档，界面如下：

!https://raw.githubusercontent.com/giansalex/peru-consult-api/master/docs/screenshot-graph.png

适用范围

• 秘鲁电子商务平台的用户身份验证
• 企业客户信息管理系统
• 财务和会计软件的供应商信息验证
• 需要秘鲁个人或企业信息的各类应用集成