Saltar al contenido
API v1 · https://bentho.org/api
GET/api/mod/contabilidad/{espacio}/config

La configuración del conector

Qué software contable tiene conectado el espacio, qué autorizas hacer con él y qué credenciales hay guardadas, sin sus valores.

  • PERMISOlee (vale cualquier clave)
  • CRÉDITOSno gasta
  • AUTENTICACIÓNBearer bth_…

PARÁMETROS

CAMPOTIPOREQUERIDOQUÉ ES
espaciostringSÍEl id del espacio (sale en GET /api/companies). Tiene que tener el módulo Contabilidad.

RESPUESTA 200

CAMPOTIPOQUÉ ES
proveedorstring | nullEl software contable conectado. null si todavía no hay ninguno.
credenciales_setstring[]Los nombres de las credenciales guardadas (email, api_token…), en orden alfabético. Sus valores nunca se devuelven.
sync_items · sync_stockbooleanSi autorizas leer el catálogo y el stock de tu software.
push_invoice · push_paymentbooleanSi autorizas mandarle facturas y pagos.
push_customerbooleanSi autorizas mandarle clientes.
write_back_stockbooleanSi autorizas descontar las ventas del stock de tu software. Este sí lo comprueba el módulo: en false, no descuenta nada.
cadencia_sync_horasintegerCada cuántas horas toca volver a leer (por defecto 24). La usa sincronizar si toca.
plantilla_exportstring | nullLas columnas del archivo de facturas al exportar: generico (por defecto), worldoffice o helisa.
bodega_default · mapeo_camposstring | null · objectSe guardan, pero hoy no cambian nada en el módulo.

ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}

STATUSCUÁNDODETAIL LITERAL
403El espacio no tiene el módulo Contabilidadmódulo no habilitado para este espacio.
502El módulo no está disponible en este momento: reintenta en unos minutos—

Y los de cualquier ruta —clave inválida, cuenta no al día, IP, límites—, en Errores, límites y créditos.

CONVIENE SABER

  • Un espacio que nunca se configuró responde con todo apagado: proveedor null, credenciales_set vacío y cadencia_sync_horas 24.
  • Los interruptores sync_* y push_* se guardan, pero hoy no frenan nada: leer y encolar funcionan aunque estén en false. Solo write_back_stock decide de verdad.