Saltar al contenido principal
English (US) Português do Brasil

Estructuras Contables - API

Actualización

La API de Estructuras Contables permite consultar configuraciones contables creadas en Buk, revisar sus asignaciones y exportar los datos contables generados según la estructura definida.

Esta API está pensada para equipos técnicos que necesitan integrar Buk con sistemas externos, automatizar procesos o consumir la información contable desde otros servicios.

¿Cuándo usar esta API?

Te recomendamos usar esta API cuando necesites:

  • Consultar las estructuras contables disponibles para una empresa.
  • Revisar qué empresas tienen asignada una estructura contable.
  • Exportar datos contables generados por una estructura específica.
  • Integrar Buk con ERPs, middleware o procesos internos automatizados.

Endpoints disponibles

1. Obtener estructuras contables

Este endpoint permite obtener las estructuras contables creadas para una empresa.

GET /accounting_assistant/structures

Parámetro requerido:

  • empresa_id

¿Qué información devuelve?

  • ID de la estructura
  • Código
  • Nombre
  • Separador
  • Extensión del archivo
  • Fechas de creación y actualización

Uso habitual:

Consultar qué estructuras contables existen antes de exportar datos o validar una integración.

Ejemplo de respuesta:

{
  "data": [
    {
      "id": 12,
      "codigo": "ERP_SOFTLAND_01",
      "nombre": "Prueba",
      "separador": "coma",
      "extension_archivo": "csv",
      "created_at": "2024-08-01",
      "updated_at": "2024-10-15"
    }
  ]
}

2. Obtener asignaciones de estructuras contables

Este endpoint permite consultar las asignaciones activas entre estructuras contables y empresas.

GET /accounting_assistant/assignments

Parámetros disponibles:

  • empresa_id
  • accounting_structure_id

¿Qué información devuelve?

  • ID de la asignación
  • ID de la estructura contable
  • ID de la empresa
  • Datos de la estructura asociada
  • Datos de la empresa asociada

Uso habitual:

Revisar qué estructuras están asignadas a una empresa o identificar a qué empresas se encuentra asociada una estructura contable.

Ejemplo de respuesta:

{
  "data": [
    {
      "id": 44,
      "accounting_structure_id": 12,
      "empresa_id": 889,
      "accounting_structure": {
        "id": 12,
        "codigo": "ERP_SOFTLAND_01",
        "nombre": "Prueba",
        "separador": "coma",
        "extension_archivo": "csv"
      },
      "empresa": {
        "id": 889,
        "nombre": "Empresa Demo",
        "dni": "12345678-9"
      }
    }
  ]
}

3. Exportar datos contables

Este endpoint permite exportar los datos contables generados por una estructura asignada.

GET /accounting_assistant/export

Parámetros obligatorios:

  • accounting_structure_assignment_id
  • month
  • year

Parámetros opcionales:

  • page
  • page_size

¿Qué información devuelve?

  • Los datos contables generados según la estructura configurada
  • La información paginada cuando corresponda

Uso habitual:

Exportar la información contable para consumirla desde sistemas externos, middleware o integraciones personalizadas.

Ejemplo de respuesta:

{
  "data": {
    "12.345.678-9": [
      {
        "Column0": "92101",
        "Column1": "Sueldo base",
        "Column2": "500000",
        "Column3": "101"
      }
    ]
  },
  "pagination": {
    "current_page": 1,
    "total_pages": 3,
    "total_count": 1500
  }
}

Ejemplo de uso

Supongamos que tu equipo necesita integrar Buk con un sistema externo que consume la centralización contable de manera automática.

En ese caso, el flujo técnico podría ser:

  1. Consultar las estructuras contables disponibles para una empresa.
  2. Identificar la asignación correcta entre empresa y estructura.
  3. Exportar los datos contables del período requerido.

De esta manera, puedes automatizar la obtención de información contable desde Buk y enviarla a otro sistema según la estructura previamente configurada.

Artículos relacionados

Relacionada con

Artículos relacionados