Saltar al contenido principal

Obtener CUIS

Inicializar Compañía (Obtener CUIS)​

  • URL: POST /api/partner/v1/companies/begin-operations
  • Cabeceras Obligatorias:
    • Authorization: Bearer <TOKEN_PARTNER_API>
    • tenant-key: <COMPANY_KEY_DE_LA_SUB_CUENTA>
  • Descripción: Se comunica con el SIN para inicializar operaciones y obtener el código CUIS de la Casa Matriz. Desencadena la sincronización básica de catálogos en segundo plano. No requiere payload de petición.

:::tip Procesamiento Asíncrono y Webhook Al llamar a este endpoint, el sistema solicitará el CUIS y despachará un trabajo asíncrono en segundo plano para obtener las paramétricas básicas. Una vez finalizado el proceso en segundo plano, Emizor emitirá la notificación al webhook global bajo el evento update_parametrics. Se recomienda tener previamente configurada la URL de webhook para capturar este evento automáticamente. :::

Ejemplo de Respuesta (200 OK)​

{
  "status": true,
  "message": "Operaciones inicializadas correctamente."
}

Respuestas de Error​

  • 401 Unauthorized: Token maestro inválido.
  • 403 Forbidden: No tienes permisos sobre este tenant.
  • 404 Not Found: tenant-key inválido o empresa no encontrada.