GET
/api/mod/contabilidad/{espacio}/configLa 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
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| espacio | string | SÍ | El id del espacio (sale en GET /api/companies). Tiene que tener el módulo Contabilidad. |
RESPUESTA 200
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| proveedor | string | null | El software contable conectado. null si todavía no hay ninguno. |
| credenciales_set | string[] | Los nombres de las credenciales guardadas (email, api_token…), en orden alfabético. Sus valores nunca se devuelven. |
| sync_items · sync_stock | boolean | Si autorizas leer el catálogo y el stock de tu software. |
| push_invoice · push_payment | boolean | Si autorizas mandarle facturas y pagos. |
| push_customer | boolean | Si autorizas mandarle clientes. |
| write_back_stock | boolean | Si autorizas descontar las ventas del stock de tu software. Este sí lo comprueba el módulo: en false, no descuenta nada. |
| cadencia_sync_horas | integer | Cada cuántas horas toca volver a leer (por defecto 24). La usa sincronizar si toca. |
| plantilla_export | string | null | Las columnas del archivo de facturas al exportar: generico (por defecto), worldoffice o helisa. |
| bodega_default · mapeo_campos | string | null · object | Se guardan, pero hoy no cambian nada en el módulo. |
ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}
| STATUS | CUÁNDO | DETAIL LITERAL |
|---|---|---|
| 403 | El espacio no tiene el módulo Contabilidad | módulo no habilitado para este espacio. |
| 502 | El 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:
proveedornull,credenciales_setvacío ycadencia_sync_horas24. - Los interruptores
sync_*ypush_*se guardan, pero hoy no frenan nada: leer y encolar funcionan aunque estén en false. Solowrite_back_stockdecide de verdad.