Configurar empresa

Antes de emitir documentos necesitas una empresa emisora en GridBilling (panel o API).

Tip: Trabaja primero en Sandbox. Panel: sandbox-api…/login.

Pasos

1. Crear compañía — NIT + DV, razón social, dirección, municipio, régimen, correo.
2. Certificado digital — .p12 / .pfx + contraseña. Sin certificado válido la DIAN rechaza la firma.
3. Resolución de numeración — prefijo, resolución, rango from–to, fechas y clave técnica (si aplica).
4. Ambiente DIAN — en Sandbox queda fijo en habilitación; en Producción puedes cambiarlo.
5. Guardar el token — el api_token de la respuesta o del panel.

Ejemplo resolución (Postman · Config-Resolution)

{
  "type_document_id": 1,
  "prefix": "SETP",
  "resolution": "18760000001",
  "resolution_date": "2019-01-19",
  "technical_key": "…",
  "from": 990000000,
  "to": 995000000,
  "date_from": "2019-01-19",
  "date_to": "2030-01-19"
}

Endpoints útiles

Acción	Método	Ruta
Crear empresa	POST	/api/ubl2.1/config/{nit}/{dv?}
Software DIAN	PUT	/api/ubl2.1/config/software
Certificado	PUT	/api/ubl2.1/config/certificate
Resolución	PUT	/api/ubl2.1/config/resolution
Ambiente	PUT	/api/ubl2.1/config/environment

Detalle: Empresa y resoluciones.

Token

Cada empresa/usuario tiene un api_token. Úsalo como Bearer en todas las peticiones.

→ Autenticación · Primer documento