POST
/api/mod/contabilidad/{espacio}/config/testPrueba la conexión
Comprueba que las credenciales guardadas abren tu software: hace una lectura del catálogo o del stock, sin escribir nada. Siempre responde 200: el resultado va en ok.
- PERMISOescribe
- 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 |
|---|---|---|
| ok | boolean | true si tu software respondió bien. |
| detalle | string | conexión válida, sin proveedor/credenciales configurados o el motivo del fallo que dio tu software. |
| capacidades | object | Solo si ok: lo que puede hacer, como en capacidades. |
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. |
| 403 | La clave es de solo lectura | Tu cuenta es de solo lectura en 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
- Con un catálogo grande puede tardar: la lectura de prueba recorre el catálogo de tu software.
- Con
csv_exportsiempre daok: no hay nada a lo que conectarse.