En esta guía te explicamos cómo funciona la API de Estructuras Contables en Buk y de qué manera puedes aprovecharla para optimizar la gestión de tu información financiera. Esta herramienta ha sido diseñada especialmente para equipos técnicos y desarrolladores que necesitan integrar Buk con sistemas externos, automatizar procesos internos o consumir datos contables desde otras plataformas.
Al utilizar esta API, podrás consultar las configuraciones contables previamente creadas en Buk, revisar a qué empresas han sido asignadas y exportar los registros generados según la estructura definida, todo de manera transparente, rápida y automatizada.
¿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_idaccounting_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_idmonthyear
Parámetros opcionales:
pagepage_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:
Consultar las estructuras contables disponibles para una empresa.
Identificar la asignación correcta entre empresa y estructura.
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.