Sunat

Api rest para consultar información de sunat

Para sunat tenemos disponible los siguientes endpoint

Tipo de cambio

GET /v2/sunat/tipo-cambio

Extraer tipo de cambio del dolar por fecha o mensual

Headers

Nombre	Valor
Content-Type	application/json
Authorization	Bearer <token>

Filtro por fecha (querystring)

Nombre	Tipo	Descripción
date	date (YYYY-MM-DD)	Filtro por fecha en formato ISO

Filtro por mes (querystring)

Nombre	Tipo	Descripción
month	integer	acepta del 1 al 12 correspondiente a un mes
year	integer	fecha de 4 digitos

Body

Nombre	Tipo	Descripción
precioCompra	string	Precio de compra
precioVenta	number	Precio de venta
moneda	string	Simbolo del dolar
fecha	date (YYYY-MM-DD)	Fecha al que corresponde el tipo de cambio

Response

200

{
  "precioCompra": 3.762,
  "precioVenta": 3.769,
  "moneda": "USD",
  "fecha": "2025-01-11"
}

400

{
  "error": "Invalid request"
}

Consuta de RUC - Basico

POST /v2/sunat/ruc?numero=20601030013

Endpoint para consultar información de RUC

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

El token puedes incluir en el querystring (en la url) con &token=<token>

Body

Name	Type	Description
razonSocial	string
tipoDocumento	string	Según tabla de sunat
numeroDocumento	string	ruc de la empresa
estado	string
condicion	string
dicrección	string
ubigeo	string	ubigeo segun sunat
viaTipo	string
viaNombre	string
zonaCodigo	string
zonaTipo	string
numero	string
interior	string
lote	string
dpto	string	departamente
manzana	string
kilometro	string
distrito	string
provincia	string
departamento	string
EsAgenteRetension	bool
tipo

Response

200

{
  "razonSocial": "REXTIE S.A.C.",
  "tipoDocumento": "6",
  "numeroDocumento": "20601030013",
  "estado": "ACTIVO",
  "condicion": "HABIDO",
  "direccion": "AV. JOSE GALVEZ BARRENECHEA NRO 566 INT. 101 URB. CORPAC ",
  "ubigeo": "150131",
  "viaTipo": "AV.",
  "viaNombre": "JOSE GALVEZ BARRENECHEA",
  "zonaCodigo": "URB.",
  "zonaTipo": "CORPAC",
  "numero": "566",
  "interior": "101",
  "lote": "-",
  "dpto": "-",
  "manzana": "-",
  "kilometro": "-",
  "distrito": "SAN ISIDRO",
  "provincia": "LIMA",
  "departamento": "LIMA",
  "EsAgenteRetencion": false
}

422

{
  "message": "ruc no valido"
}

Consulta de ruc avanzado

GET /v2/sunat/ruc/full?numero=<ruc>

Consultar información adicional de una empresa

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body

Response

200

{
  "razonSocial": "REXTIE S.A.C.",
  "tipoDocumento": "6",
  "numeroDocumento": "20601030013",
  "estado": "ACTIVO",
  "condicion": "HABIDO",
  "direccion": "AV. JOSE GALVEZ BARRENECHEA NRO 566 INT. 101 URB. CORPAC ",
  "ubigeo": "150131",
  "viaTipo": "AV.",
  "viaNombre": "JOSE GALVEZ BARRENECHEA",
  "zonaCodigo": "URB.",
  "zonaTipo": "CORPAC",
  "numero": "566",
  "interior": "101",
  "lote": "-",
  "dpto": "-",
  "manzana": "-",
  "kilometro": "-",
  "distrito": "SAN ISIDRO",
  "provincia": "LIMA",
  "departamento": "LIMA",
  "EsAgenteRetencion": false,
  "tipo": "SOCIEDAD ANONIMA CERRADA",
  "actividadEconomica": "OTROS TIPOS DE INTERMEDIACION MONETARIA",
  "numeroTrabajadores": "54",
  "tipoFacturacion": "MANUAL/COMPUTARIZADO",
  "tipoContabilidad": "MANUAL/COMPUTARIZADO",
  "comercioExterior": "SIN ACTIVIDAD"
}

400

{
  "error": "Invalid request"
}