Configurar empresa
Antes de emitir documentos necesitas una empresa emisora configurada en GridBilling (panel admin o endpoints de configuración).
1. Crear / configurar compañía
Sección titulada «1. Crear / configurar compañía»En el admin (/configuration_admin) o vía API de configuración:
- NIT + DV
- Razón social, dirección, municipio
- Régimen y responsabilidades
- Correo para notificaciones
2. Certificado digital
Sección titulada «2. Certificado digital»Carga el certificado .p12 / .pfx y la contraseña en la empresa. Sin certificado válido la DIAN rechaza la firma.
3. Resolución de numeración
Sección titulada «3. Resolución de numeración»Registra prefijo, resolución DIAN, rango from–to, fechas y (si aplica) clave técnica.
Ejemplo conceptual (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"}4. Ambiente
Sección titulada «4. Ambiente»| Ambiente | Uso |
|---|---|
| Habilitación / pruebas | Set de pruebas DIAN (…/invoice/{testSetId}) |
| Producción | Endpoint síncrono sin test set |
Cambio de ambiente: sección Paso a Producción de la colección Postman.
5. Token de acceso
Sección titulada «5. Token de acceso»Cada empresa/usuario tiene un api_token. Úsalo como Bearer en todas las peticiones.