Alta de integrador y cupos

Flujo comercial (GridSoft SAS)

Entra a gridbilling.gridsoft.co → Empezar.
Crea cuenta (nombre, email, password).
El sistema crea dos accesos con el mismo correo:
- Sandbox (sandbox-api…): documentos ilimitados, DIAN habilitación.
- Producción (api…): cupo 0 hasta que pagues.
Correo con login, password y token maestro.
Con el token creas NITs y pruebas en Sandbox.
En producción: elige plan FACT-E → pagas con Wompi → el webhook suma el cupo.

Detalle de hosts: Ambientes.

Registrar integrador

POST /api/ubl2.1/integrators/register
Content-Type: application/json

{
  "name": "Dev Acme",
  "email": "dev@acme.co",
  "password": "secreto123"
}

Límite: 10 registros / minuto por IP (throttle).

Respuesta típica incluye integrator.token, login_url, URLs sandbox/prod y resumen de paquete.

Listar planes (FACT-E)

Público (sin token):

GET /api/ubl2.1/grid-pay/products

Ejemplo de ítem:

{
  "uuid": "0beeba3c-…",
  "name": "FACT-E MES 500",
  "value": 35000,
  "documents_limit": 500,
  "service_type": "FACT_E_MES",
  "payment_type": "PACKAGE",
  "subscription_days": 30
}

Comprar cupo (solo producción)

POST /api/ubl2.1/grid-pay/checkout
Authorization: Bearer <token_maestro_produccion>
Content-Type: application/json

{
  "product_id": "UUID_DEL_PLAN",
  "return_url": "https://gridbilling.gridsoft.co/?pago=ok",
  "customer": {
    "type_id": "CC",
    "number_id": "1234567890",
    "full_name": "Dev Acme",
    "email": "dev@acme.co",
    "phone_number": "3001234567"
  }
}

Respuesta: payload Wompi widget (public_key, amount_in_cents, reference, signature_integrity, transaction.return_url).
Abre el checkout Wompi en el navegador (igual que en la landing).

Tras pago APPROVED, GridPay llama el webhook de GridBilling, se suman documents_limit al integrador y se envía correo de confirmación.

Consultar cupo restante

GET /api/ubl2.1/plan/infoplanuser
Authorization: Bearer <token>

También el panel web muestra el cupo del paquete (docs usados / disponibles).

Cuando el cupo llega a 0 en producción, las emisiones fallan hasta comprar otro paquete. Empresas GridPOS internas sin paquete de integrador no se ven afectadas (siguen ilimitadas).

Tokens

Token	Uso
Maestro (integrador)	Crear NITs, checkout, ver cupo
Por empresa (NIT)	Emitir documentos DIAN de ese NIT

No mezcles token Sandbox con host Producción (ni al revés).

Checklist go-live

Integración completa en Sandbox
Misma config (software, certificado, resoluciones) en Producción
Compra de cupo FACT-E
Primer documento real + consulta de estado