Empresa

Para qué sirve

• Comprobar la conexión: al configurar la integración, confirma que el token es válido, de la empresa correcta y del ambiente esperado.
• Elegir el punto de emisión: los códigos de establecimientos[].codigo y establecimientos[].puntosEmision[].codigo son los que van en establecimiento y puntoEmision al emitir.
• Anticipar errores: sin créditos la emisión responde 402 SIN_CREDITOS, y sin firma vigente 422 FIRMA_NO_VIGENTE. Consultar estos datos antes de un lote de emisiones evita esos rechazos.

Datos de la empresa

Estos datos se cambian en la aplicación; el API solo los consulta.

Firma electrónica

firma indica si la empresa tiene una firma cargada (configurada), si está vigente (vigente), su fecha de vencimiento (vence) y si vence en 30 días o menos (porVencer). El API nunca devuelve el certificado ni su clave.

Cuando porVencer es true, renueva la firma con tu entidad de certificación y cárgala en la aplicación antes de la fecha de vence: sin firma vigente no se puede emitir.

Token

token describe el token que hizo la solicitud:

• nombre, prefijo y ambiente: para reconocerlo en Cuenta > API e integraciones.
• puntoPorDefecto: el punto que se usa cuando la emisión no indica establecimiento y puntoEmision; null si no tiene.
• puntosPermitidos: los puntos en los que puede emitir; null si puede emitir en todos. Una lista vacía significa que sus puntos ya no existen y el token no puede emitir.

Establecimientos y secuenciales

Cada establecimiento trae su código, descripción, dirección, si es la matriz y sus puntos de emisión. Cada punto trae en siguientesSecuenciales el próximo número de factura, nota de crédito y retención en el ambiente del token: los de pruebas y los de producción son independientes.

Los secuenciales son informativos. Golem asigna el número al emitir y lo devuelve en la respuesta: no calcules el número en tu sistema a partir de este valor, porque otra emisión (desde el API o desde la aplicación) puede usarlo antes.

curl https://api.golem.ec/v1/empresa \
  --max-time 30 \
  -H "Authorization: Bearer $GOLEM_TOKEN"

const respuesta = await fetch('https://api.golem.ec/v1/empresa', {
  headers: {
    Authorization: `Bearer ${process.env.GOLEM_TOKEN}`,
  },
  signal: AbortSignal.timeout(30000),
});
const datos = await respuesta.json();
console.log(respuesta.status, datos);

import os

import requests

respuesta = requests.get(
    "https://api.golem.ec/v1/empresa",
    headers={
        "Authorization": f"Bearer {os.environ['GOLEM_TOKEN']}",
    },
    timeout=30,
)
print(respuesta.status_code, respuesta.json())

<?php
// composer require guzzlehttp/guzzle
require 'vendor/autoload.php';

use GuzzleHttp\Client;

$cliente = new Client(['base_uri' => 'https://api.golem.ec/v1/', 'timeout' => 30]);

$respuesta = $cliente->get('empresa', [
    'headers' => [
        'Authorization' => 'Bearer ' . getenv('GOLEM_TOKEN'),
    ],
    'http_errors' => false,
]);

echo $respuesta->getStatusCode(), PHP_EOL, $respuesta->getBody(), PHP_EOL;

{
  "ruc": "1790000000001",
  "razonSocial": "TU EMPRESA S.A.",
  "nombreComercial": "TU EMPRESA",
  "regimen": "GENERAL",
  "obligadoContabilidad": true,
  "contribuyenteEspecial": false,
  "resolucionContribuyenteEspecial": null,
  "agenteRetencion": true,
  "resolucionAgenteRetencion": "1",
  "ambiente": "PRODUCCION",
  "creditosDisponibles": 48,
  "firma": {
    "configurada": true,
    "vigente": true,
    "vence": "2027-03-01",
    "porVencer": false
  },
  "token": {
    "nombre": "ERP principal",
    "prefijo": "glm_prod_7Qx4",
    "ambiente": "PRODUCCION",
    "puntoPorDefecto": {
      "establecimiento": "001",
      "puntoEmision": "001"
    },
    "puntosPermitidos": null
  },
  "establecimientos": [
    {
      "codigo": "001",
      "descripcion": "Matriz",
      "direccion": "Av. Amazonas N24-03 y Colón, Quito",
      "matriz": true,
      "puntosEmision": [
        {
          "codigo": "001",
          "descripcion": "Caja 1",
          "siguientesSecuenciales": {
            "factura": 150,
            "notaCredito": 10,
            "retencion": 23
          }
        },
        {
          "codigo": "002",
          "descripcion": "Tienda en línea",
          "siguientesSecuenciales": {
            "factura": 1,
            "notaCredito": 1,
            "retencion": 1
          }
        }
      ]
    }
  ]
}