POST/api/mod/comercial/{espacio}/tarifas/draft

Sube una tabla de tarifas

Sube el Excel de tu transportadora: qué zona es cada ciudad y cuánto cuesta enviar a cada zona según el peso. Queda como borrador: no se usa hasta que la actives.

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 Comercial.

CUERPO · MULTIPART/FORM-DATA

CAMPO	TIPO	REQUERIDO	QUÉ ES
file	archivo	SÍ	Un .xlsx de hasta 10 MB con una hoja de ciudades y otra de precios. Su forma, en la guía.

RESPUESTA 201

CAMPO	TIPO	QUÉ ES
import_id	string	El id de la carga. Guárdalo.
estado	"draft"	Borrador.
n_ciudades · n_precios	integer	Cuántos destinos y cuántos rangos de peso se leyeron.
ciudad_origen	string \| null	La ciudad de origen, si la hoja de ciudades la trae.
warnings	string[]	Lo que no se pudo leer: filas descartadas, una hoja sin encabezado, ninguna ciudad… Vacío si todo fue bien.

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

STATUS	CUÁNDO	DETAIL LITERAL
403	El espacio no tiene el módulo Comercial	módulo no habilitado para este espacio.
403	La clave es de solo lectura	Tu cuenta es de solo lectura en este espacio.
400	El archivo está vacío	archivo vacío.
413	El archivo pasa de 10 MB	archivo demasiado grande: máximo 10485760 bytes.
413	Una hoja pasa de 20 000 filas o de 64 columnas. No se guarda nada	hoja '<hoja>': excede 20000 filas; archivo rechazado
415	El archivo no termina en .xlsx ni .xls	extensión no soportada para tarifas: <extensión>
422	Falta el campo file	—

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

Revisa n_ciudades, n_precios y warnings antes de activar: la API no devuelve las filas de un borrador. Un 0 en cualquiera de los dos quiere decir que esa hoja no se leyó.
Sube un .xlsx. Un archivo que no se pueda abrir como libro de Excel no se rechaza con un 4xx: responde 500.