GET
/api/mod/contabilidad/{espacio}/exports/{lote}Exporta a un archivo
Para programas contables sin API (csv_export): arma un CSV con las facturas, los pagos o los clientes de la cola, con las columnas de la plantilla de importación de tu programa. Lo importas tú.
- 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. |
| lote | string | SÍ | Qué exportar: invoice (facturas), payment (pagos) o customer (clientes). |
| estado | string, query | no | Las entradas en qué estado. Por defecto done. |
RESPUESTA 200
Un JSON con el archivo dentro, no el archivo: guarda contenido con filename.
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| filename | string | <lote>_<plantilla>.csv, p. ej. invoice_worldoffice.csv. |
| contenido | string | El CSV, con cabecera y una fila por línea de factura (o por pago, o por cliente). |
| content_type | "text/csv" | Siempre text/csv. |
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 | — |
| 400 | lote no es invoice, payment ni customer | tipo inválido (invoice|payment|customer). |
| 409 | Tu software tiene API: lo encolado se le manda directamente | el proveedor configurado tiene API; el export de archivo no aplica. |
| 409 | El espacio todavía no tiene proveedor configurado | No hay software contable configurado … |
| 409 | 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.
CONVIENE SABER
- Solo salen las entradas ya procesadas (
done): encola, procesa la cola y luego exporta. - Exportar no marca nada: cada vez trae todas las entradas de ese tipo en ese estado (las 1000 más recientes). Lleva tú la cuenta de qué importaste.
plantilla_exportcambia las columnas de las facturas:generico,worldofficeohelisa. Pagos y clientes van siempre en genérico. Un texto que empieza por = + - o @ sale con un apóstrofo delante, para que tu programa no lo lea como fórmula.