endpoint.pe

Establecimientos anexos

Lista los locales anexos de un RUC registrados en SUNAT (sucursales, depósitos, oficinas y otros) con su código, tipo, dirección y actividad económica.

GEThttps://api.endpoint.pe/v1/ruc/{ruc}/anexos
Fuente:
SUNAT
Costo:
1 crédito por consulta con resultado
Estado:
Disponible
Probar en el playground Página de la API

Devuelve los establecimientos anexos que un contribuyente tiene registrados en SUNAT además de su domicilio fiscal: sucursales, depósitos, oficinas administrativas, locales comerciales y otros, cada uno con su código, tipo, dirección y, cuando SUNAT la registra, la actividad económica del local. Útil para validar direcciones de entrega, puntos de venta y la red de locales de un cliente.

Parámetros

NombreDóndeFormato
rucRuta11 dígitos con dígito verificador correcto, como en Consulta RUC.

Ejemplo

La respuesta está recortada a un establecimiento; la real trae los 349.

terminal
curl 'https://api.endpoint.pe/v1/ruc/20131312955/anexos' \  -H 'Authorization: Bearer TU_TOKEN'
respuesta.json
{  "success": true,  "message": "Consulta exitosa",  "data": {    "ruc": "20131312955",    "razon_social": "SUPERINTENDENCIA NACIONAL DE ADUANAS Y DE ADMINISTRACION TRIBUTARIA - SUNAT",    "cantidad": 349,    "establecimientos": [      {        "codigo": "0002",        "tipo": "SUCURSAL",        "tipo_codigo": "SU",        "direccion": "CAL.SANTA TERESA NRO. 370 CUSCO - CUSCO - CUSCO",        "actividad_economica": null      }    ]  },  "meta": {    "fuente": "SUNAT",    "consultado_en": "2026-10-12T07:40:12Z",    "creditos_cobrados": 1,    "creditos_disponibles": 14621  }}

Campos de data

CampoDescripción
rucNúmero de RUC consultado.
razon_socialRazón social del RUC.
cantidadCantidad de establecimientos.
establecimientosLista con codigo, tipo, tipo_codigo, direccion y actividad_economica.

Detalles

  • Un RUC inscrito que no tiene anexos responde 200 con cantidad: 0 y establecimientos: []. Descuenta un crédito, porque la consulta tuvo resultado: la empresa no tiene locales anexos.
  • tipo es la descripción del local tal como la registra SUNAT (SUCURSAL, por ejemplo) y tipo_codigo su abreviatura de dos letras (SU para sucursal).
  • actividad_economica puede ser null cuando SUNAT no la registra para ese local.
  • El domicilio fiscal no forma parte de la lista: está en direccion de Consulta RUC.
  • Las direcciones llegan en el formato de SUNAT, con el departamento, la provincia y el distrito al final separados por guiones.

Guía: Establecimientos anexos en SUNAT: qué son.

Errores

HTTPerrorCuándo
404no_encontradoEl RUC no está inscrito en el padrón. No descuenta créditos.
422validaciondetalles.ruc: "RUC inválido: deben ser 11 dígitos con dígito verificador correcto."

Los demás códigos (401, 402, 403, 502) son comunes a todas las APIs: Errores.

Relacionados