Ambientes

GridBilling separa Sandbox y Producción en hosts distintos (mismo código, bases independientes). Así no mezclas tokens, NITs ni documentos de prueba con facturación real.

Base URLs

Ambiente	Base URL API	DIAN
Sandbox	https://sandbox-api.gridbilling.gridsoft.co/api	Siempre habilitación (type_environment_id = 2)
Producción	https://api.gridbilling.gridsoft.co/api	Configurable por empresa

Importante: Crea un Environment de Postman por host. El Bearer de Sandbox no sirve en Producción (y viceversa).

Cómo saber en qué instancia estás

GET /api/ubl2.1/environment

Respuesta típica (sandbox):

{
  "environment": "sandbox",
  "sandbox_mode": true,
  "base_url": "https://sandbox-api.gridbilling.gridsoft.co",
  "dian": "habilitacion"
}

Header de respuesta en todas las rutas:

X-GridBilling-Environment: sandbox

Reglas del Sandbox

1. Toda empresa nueva queda en habilitación DIAN.
2. PUT /api/ubl2.1/config/environment no permite pasar a producción DIAN (HTTP 422).
3. Usa certificado y resoluciones de pruebas (SETP, set de pruebas).
4. Datos y tokens no se comparten con producción.
5. Cupo de documentos de integrador: ilimitado.

Flujo recomendado

1. Integrar contra Sandbox (empresa, certificado de pruebas, resolución SETP).
2. Emitir con POST /api/ubl2.1/invoice/{testSetId} hasta cerrar el set DIAN.
3. Repetir configuración en Producción (certificado y resolución productivos).
4. Cambiar baseUrl del cliente al host de producción.

type_environment_id (solo host Producción)

Valor	Significado
2	Habilitación DIAN
1	Producción DIAN

En el host Sandbox ese valor se fuerza a 2.

→ Siguiente: Configurar empresa