Skip to main content
GET
/
master-entities
Buscar entidad por RUT
curl --request GET \
  --url https://api.tupana.ai/v1/master-entities \
  --header 'Authorization: <api-key>'
{
  "id": 371,
  "tax_id": "76.798.398-0",
  "name": "SUPLO SPA",
  "email": "contacto@suplo.cl",
  "addresses": [
    {
      "id": 6,
      "address": "AV TAJAMAR 183 OF 401   OFIC",
      "district": {
        "id": 7,
        "name": "LAS CONDES",
        "city": {
          "id": 3,
          "name": "SANTIAGO"
        }
      },
      "sii_branch_code": null,
      "phone": null
    }
  ],
  "activities": [
    {
      "id": 1,
      "code": "620900",
      "name": "OTRAS ACTIVIDADES DE TECNOLOGIA DE LA IN"
    }
  ]
}

​
Qué hace

  • Busca una entidad maestra específica por su RUT
  • Obtiene todos los detalles completos de la entidad, incluyendo direcciones y actividades económicas
  • Proporciona información esencial para determinar el tipo de documento a emitir
  • Permite consultar direcciones y actividades económicas registradas de la entidad

​
Ejemplos de uso

  • Buscar información de un cliente antes de crear un documento
  • Obtener el ID de una entidad para usar en otros endpoints (como crear credenciales)
  • Consultar las direcciones disponibles de una entidad
  • Verificar las actividades económicas para determinar el tipo de DTE a emitir
  • Validar que una entidad existe en el sistema antes de emitir documentos

​
Información importante sobre tipos de documento

La información de actividades económicas es fundamental para decidir qué tipo de documento debes emitir:
  • Si la entidad tiene actividad económica: Debes emitir una Factura Electrónica (DTE 33) o Factura Exenta (DTE 34)
  • Si la entidad NO tiene actividad económica: Debes emitir una Boleta (DTE 39)
Esta información es esencial para validar que estás emitiendo el tipo correcto de documento tributario según las características de la entidad receptora.

Authorizations

​
Authorization
string
header
required

API Key para autenticación. Debe proporcionarse en el header Authorization con el formato: 'Api-Key YOUR-API-KEY' (incluye el prefijo 'Api-Key ' seguido de tu API key)

Query Parameters

​
rut
string
required

RUT del cliente a consultar (formato: 76543210-1, sin puntos)

Pattern: ^[0-9]{7,8}-[0-9K]$
Example:

"76543210-1"

Response

Entidad encontrada exitosamente

​
id
integer

ID único de la entidad maestra

Example:

371

​
tax_id
string

RUT de la entidad maestra

Example:

"76.798.398-0"

​
name
string

Razón social de la entidad

Example:

"SUPLO SPA"

​
email
string | null

Correo electrónico de contacto

Example:

null

​
addresses
object[]

Lista de direcciones de la entidad

​
activities
object[]

Lista de actividades económicas de la entidad