POST
/api/mod/contabilidad/{espacio}/sync/{datos}/dueSincroniza solo si toca
Como leer el catálogo o el stock, pero solo si toca: si nunca se leyó, si ya pasaron cadencia_sync_horas desde la última lectura o si hay cambios pendientes. Si no toca, no llama a tu software. Para llamarla a menudo desde una tarea programada.
- 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. |
| datos | string | SÍ | items (el catálogo) o stock. |
| force | boolean, query | no | true para leer aunque no toque. Por defecto false. |
RESPUESTA 200
Si toca, lo mismo que leer el catálogo o el stock. Si no:
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| skipped | true | No leyó nada. |
| reason | "cadencia" | Aún no toca. |
| modelo | string | items o stock. |
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 | — |
| 400 | datos no es items ni stock | modelo inválido (items|stock). |
| 400 | El espacio todavía no tiene proveedor configurado | No hay software contable configurado … |
| 400 | proveedor es worldoffice_cloud, quickbooks o xero: todavía no conectan | Adaptador '…' aún no implementado … |
Y los de cualquier ruta —clave inválida, cuenta no al día, IP, límites—, en Errores, límites y créditos.