Obtener empresa actual

GET

/api/v1/billing/empresa

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
    Method = HttpMethod.Get,
    RequestUri = new Uri("https://api.simplo.cl/api/v1/billing/empresa"),
    Headers =
    {
        { "Authorization", "Bearer <token>" },
    },
};
using (var response = await client.SendAsync(request))
{
    response.EnsureSuccessStatusCode();
    var body = await response.Content.ReadAsStringAsync();
    Console.WriteLine(body);
}

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.simplo.cl/api/v1/billing/empresa"))
    .header("Authorization", "Bearer <token>")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

const url = 'https://api.simplo.cl/api/v1/billing/empresa';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://api.simplo.cl/api/v1/billing/empresa \
  --header 'Authorization: Bearer <token>'

Retorna los datos tributarios de la empresa asociada a la sesión actual.

Solo sesión (JWT): esta operación no es accesible por API key — una key billing:dte recibe 403 BILLING_API_KEY_ROUTE_NOT_ALLOWED. Se gestiona desde la cuenta en app.simplo.cl.

Autenticación

BearerAuth

Respuestas

200

Datos de la empresa

application/json

object

requerido

string format: uuid

rut

requerido

string

razon_social

requerido

string

giro

requerido

string

direccion

requerido

string

comuna

requerido

string

ciudad

requerido

string

ambiente

requerido

Ambiente SII en que opera la empresa

string

Valores permitidos: certificacion produccion

fecha_resolucion

requerido

Fecha de la resolución SII que autoriza la emisión electrónica

string format: date

numero_resolucion

requerido

Número de la resolución SII (puede ser 0)

integer

inbound_email

Casilla de recepción de DTE de proveedores asignada a la empresa

string

inbound_status

string

Example

{
  "id": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
  "rut": "76123456-0",
  "razon_social": "Empresa Ejemplo SpA",
  "giro": "Servicios de software",
  "direccion": "Av. Apoquindo 1234",
  "comuna": "Las Condes",
  "ciudad": "Santiago",
  "ambiente": "produccion",
  "fecha_resolucion": "2026-01-10",
  "numero_resolucion": 0,
  "inbound_email": "[email protected]",
  "inbound_status": "active"
}

401

Token o API key inválido o ausente

application/json

object

code

requerido

Código de error máquina-legible

string

message

requerido

Mensaje descriptivo del error. Este es el campo canónico para clientes nuevos.

string

error

Alias de compatibilidad de message mantenido hacia atrás.

string

details

Array<object>

object

field

requerido

Campo con error (dot notation para nested)

string

code

requerido

Código de validación

string

message

requerido

Mensaje descriptivo

string

action

Acción recomendada para el cliente

string

severity

Severidad opcional del error

string

Valores permitidos: critical error warning info

context

Contexto estructurado opcional para debugging

object

key

additional properties

any

Example

{
  "code": "VALIDATION_ERROR",
  "message": "Error de validacion en los campos enviados",
  "details": [
    {
      "field": "receptor.rut",
      "code": "INVALID_RUT",
      "message": "RUT invalido: digito verificador no coincide"
    }
  ],
  "severity": "critical"
}