Skip to main content

Bitácora Cumplimiento Mutations

This page documents all GraphQL mutations for managing compliance tracking data.

Available Mutations

The module provides create, update, and delete operations for all core entities.

Responsabilidad Mutations

Create Responsabilidad

Create a new compliance responsibility.
mutation {
  createBitCuResponsabilidad(input: {
    nombre: "Document Review"
    descripcion: "Review and approve compliance documents"
    activo: true
  }) {
    id
    nombre
    fechaCreacion
  }
}

Update Responsabilidad

mutation {
  updateBitCuResponsabilidad(input: {
    id: 1
    nombre: "Updated Name"
    activo: true
  }) {
    id
    nombre
  }
}

Requerimiento Primario Mutations

Create Requerimiento Primario

Create a primary regulatory requirement.
mutation {
  createBitCuRequerimientoPrimario(input: {
    nombre: "Annual Financial Report"
    descripcion: "Submit annual financial statements"
    idEnteRegulador: 1
    activo: true
  }) {
    id
    nombre
  }
}

Ente Regulador Mutations

Create Ente Regulador

Register a new regulatory entity.
mutation {
  createBitCuEnteRegulador(input: {
    nombre: "Superintendencia de Compañías"
    siglas: "SC"
    descripcion: "Government regulatory body"
    activo: true
  }) {
    id
    nombre
    siglas
  }
}

Entregable Mutations

Create Entregable

Create a compliance deliverable.
mutation {
  createBitCuEntregable(input: {
    nombre: "Q1 Report"
    descripcion: "First quarter compliance report"
    periodicidad: "Quarterly"
    fechaVencimiento: "2024-04-30"
    idRequerimientoPrimario: 1
    activo: true
  }) {
    id
    nombre
    fechaVencimiento
  }
}

Documento Responsabilidad Mutations

Create Documento Responsabilidad

Assign document responsibility.
mutation {
  createBitCuDocumentoResponsabilidad(input: {
    idEntregable: 1
    idResponsabilidad: 1
    activo: true
  }) {
    id
    fechaAsignacion
  }
}

Empresa Mutations

Create Empresa

Register a company for compliance tracking.
mutation {
  createBitCuEmpresa(input: {
    nombre: "Moderna Alimentos S.A."
    ruc: "1234567890001"
    activo: true
  }) {
    id
    nombre
    ruc
  }
}

Proceso Mutations

Create Proceso

Define a business process.
mutation {
  createBitCuProceso(input: {
    nombre: "Financial Reporting"
    descripcion: "Monthly and annual financial reporting"
    idLocalidad: 1
    activo: true
  }) {
    id
    nombre
  }
}

Localidad Mutations

Create Localidad

Create a physical location.
mutation {
  createBitCuLocalidad(input: {
    nombre: "Quito Office"
    direccion: "Av. 6 de Diciembre"
    idEmpresa: 1
    activo: true
  }) {
    id
    nombre
  }
}

Flujo Aprobación Mutations

Create Flujo Aprobación

Configure an approval workflow.
mutation {
  createBitCuFlujoAprobacion(input: {
    nombre: "Level 1 Approval"
    nivel: 1
    idRol: 1
    activo: true
  }) {
    id
    nombre
    nivel
  }
}

Rol Mutations

Create Rol

Define a compliance role.
mutation {
  createBitCuRol(input: {
    nombre: "Compliance Officer"
    descripcion: "Responsible for regulatory compliance"
    activo: true
  }) {
    id
    nombre
  }
}

Auditoría Mutations

Create Auditoría

Create an audit record.
mutation {
  createBitCuAuditoria(input: {
    fecha: "2024-03-05"
    accion: "Document Approval"
    idUsuario: 1
    detalle: "Approved quarterly report"
  }) {
    id
    fecha
    accion
  }
}

Auditoría Equipo Mutations

Create Auditoría Equipo

Assign team members to audit.
mutation {
  createBitCuAuditoriaEquipo(input: {
    idAuditoria: 1
    idUsuario: 1
    rol: "Lead Auditor"
  }) {
    id
    rol
    fechaAsignacion
  }
}

Jerarquía Mutation

Create Jerarquía

Create hierarchical compliance structure.
mutation {
  createBitCuJerarquia(input: {
    idEmpresa: 1
    idLocalidad: 1
    idProceso: 1
  }) {
    id
  }
}
All mutations require appropriate authorization. Ensure you have the necessary permissions before attempting to create or modify compliance records.

Best Practices

  1. Always set activo flag: Use activo: true for active records
  2. Maintain relationships: Ensure parent entities exist before creating children
  3. Track audit trails: Create audit records for significant changes
  4. Use hierarchical structure: Follow the Company → Location → Process flow
  5. Configure workflows: Set up approval flows before assigning documents

Build docs developers (and LLMs) love