Saltar al contenido
API v1 · https://bentho.org/api
POST/api/mod/ventas/{espacio}/pricing/tables

Sube una tabla de tarifas de envío

Subes tu tabla de envíos (zona, tarifa, días) y queda como una versión en borrador para revisarla. No cotiza nada hasta que la actives.

  • PERMISOescribe
  • 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 Ventas.

CUERPO · MULTIPART/FORM-DATA

CAMPOTIPOREQUERIDOQUÉ ES
filearchivoSÍLa tabla en CSV, XLSX o PDF, hasta 10 MB. Sus columnas, en la guía.

RESPUESTA 201

CAMPOTIPOQUÉ ES
version_idstringLa versión creada. Guárdala: con ella la revisas y la activas.
estado"draft"Siempre borrador al subir.
origen · sha256stringEl tipo de archivo y su huella.
filas_insertadasintegerLas filas que entraron al borrador, completas o no.
filas_incompletas[{ zona, warnings, coste }]Las que necesitan tu revisión: sin tarifa o sin días legibles. Entran con 0 y no dejan activar la versión hasta corregirlas.
warningsstring[]Avisos del archivo entero, como «no se reconoció una tabla».

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

STATUSCUÁNDODETAIL LITERAL
403El espacio no tiene el módulo Ventasmódulo no habilitado para este espacio.
403La clave es de solo lecturaTu cuenta es de solo lectura en este espacio.
400El archivo no es CSV, XLSX o PDFextensión no soportada para tabla de tarifas.
400El archivo llegó vacíoarchivo vacío.
413El archivo pasa de 10 MBarchivo demasiado grande (máximo … bytes).
429El espacio mandó demasiadas peticiones seguidas: espera unos segundosDemasiadas solicitudes; intenta en un momento.

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

  • CSV o XLSX exportados de tu hoja dan menos trabajo que un PDF: no hay que adivinar la tabla.
  • Si tu espacio usa el módulo Comercial (comercial_activo), el envío lo calcula Comercial y estas tablas no se usan.