Sunat

Api rest para consultar información de sunat

Para sunat tenemos disponible los siguientes endpoint

Tipo de cambio

GET https://api.decolecta.com/v1/tipo-cambio/sunat?month=7&year=2025

GET https://api.decolecta.com/v1/tipo-cambio/sunat

Extraer tipo de cambio del dolar por fecha o mensual

Headers

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

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
buy_price	string	Precio de compra
sell_price	string	Precio de venta
base_currency	string	Moneda Base , para sunat siempre es dolar USD
quote_currency	string	Siempre es PEN
date	date (YYYY-MM-DD)	Fecha al que corresponde el tipo de cambio

Response

200

{
	"buy_price": "3.540",
	"sell_price": "3.552",
	"base_currency": "USD",
	"quote_currency": "PEN",
	"date": "2025-07-26"
}

400

{
  "error": "Invalid request"
}

Consuta de RUC - Basico

POST /v1/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
razon_social	string
numero_documento	string	ruc de la empresa
estado	string
condicion	string
dirección	string
ubigeo	string	ubigeo segun sunat
via_tipo	string
via_nombre	string
zona_codigo	string
zona_tipo	string
numero	string
interior	string
lote	string
dpto	string	departamente
manzana	string
kilometro	string
distrito	string
provincia	string
departamento	string
es_agente_retencion	bool
es_buen_contribuyente
locales_anexos	List

Response

200

{
	"razon_social": "REXTIE S.A.C.",
	"numero_documento": "20601030013",
	"estado": "ACTIVO",
	"condicion": "HABIDO",
	"direccion": "AV. JOSE GALVEZ BARRENECHEA NRO 566 INT. 101 URB. CORPAC ",
	"ubigeo": "150131",
	"via_tipo": "AV.",
	"via_nombre": "JOSE GALVEZ BARRENECHEA",
	"zona_codigo": "URB.",
	"zona_tipo": "CORPAC",
	"numero": "566",
	"interior": "101",
	"lote": "-",
	"dpto": "-",
	"manzana": "-",
	"kilometro": "-",
	"distrito": "SAN ISIDRO",
	"provincia": "LIMA",
	"departamento": "LIMA",
	"es_agente_retencion": false,
	"es_buen_contribuyente": false,
	"locales_anexos": null
}

422

{
  "message": "ruc no valido"
}

Consulta de ruc avanzado

GET /v1/sunat/ruc/full?numero=20601030013

Consultar información adicional de una empresa

Headers

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

Body

Response

200

{
	"razon_social": "REXTIE S.A.C.",
	"numero_documento": "20601030013",
	"estado": "ACTIVO",
	"condicion": "HABIDO",
	"direccion": "AV. JOSE GALVEZ BARRENECHEA NRO 566 INT. 101 URB. CORPAC ",
	"ubigeo": "150131",
	"via_tipo": "AV.",
	"via_nombre": "JOSE GALVEZ BARRENECHEA",
	"zona_codigo": "URB.",
	"zona_tipo": "CORPAC",
	"numero": "566",
	"interior": "101",
	"lote": "-",
	"dpto": "-",
	"manzana": "-",
	"kilometro": "-",
	"distrito": "SAN ISIDRO",
	"provincia": "LIMA",
	"departamento": "LIMA",
	"es_agente_retencion": false,
	"es_buen_contribuyente": false,
	"locales_anexos": null,
	"tipo": "SOCIEDAD ANONIMA CERRADA",
	"actividad_economica": "OTROS TIPOS DE INTERMEDIACION MONETARIA",
	"numero_trabajadores": "45",
	"tipo_facturacion": "MANUAL/COMPUTARIZADO",
	"tipo_contabilidad": "MANUAL/COMPUTARIZADO",
	"comercio_exterior": "SIN ACTIVIDAD"
}

400

{
  "error": "Invalid request"
}