Saltar al contenido principal
PUT
cURL

Autorizaciones

Authorization
string
header
requerido

Para tus propios scripts e integraciones de servidor a servidor. Crea una clave en la app en Configuración > Acceso > Claves de API y cópiala entonces, porque se muestra una sola vez. Envíala como Authorization: Bearer <key>. La clave actúa como el miembro que la creó, en la organización en la que se creó. Una llamada necesita el permiso del miembro y uno de los alcances de la clave, como inventory:read o sales:write. Una clave con * tiene todos los alcances.

Cuerpo

application/json

La configuración de ventas de la organización que se va a cambiar. Una opción que no envíes queda como está, salvo reservation_hold_hours, que siempre se envía.

reservation_hold_hours
integer | null
requerido

Cuántas horas retiene un pedido en borrador sus existencias, de 1 a 8760. Envíalo siempre: null retiene las existencias hasta que se cancele el pedido.

Rango requerido: 1 <= x <= 8760
reserve_on
enum<string>

Cuándo retiene un pedido sus existencias: confirm, payment o manual. Con payment, un pedido retiene existencias cuando un canal de venta indica que está pagado, y un pedido sin canal espera a que alguien lo reserve. Si se omite, se queda como está.

Opciones disponibles:
confirm,
payment,
manual
short_stock
enum<string>

Lo que hace una línea cuando se acaban las existencias: refuse, backorder o partial. Si no se envía, queda como está.

Opciones disponibles:
refuse,
backorder,
partial
over_allocation_percent
string

Cuánto puede reservar una línea por encima de lo que queda por prometer, en porcentaje, hasta 100. Si se omite, no cambia.

Maximum string length: 100
Pattern: ^\d{1,3}(\.\d{1,4})?$
invoice_timing
enum<string>

Lo que factura una factura: after_shipping para lo que se ha enviado, o before_shipping para lo que se pidió. Si no se envía, queda como está.

Opciones disponibles:
after_shipping,
before_shipping
tax_rounding
enum<string>

Dónde se redondea al centavo el impuesto de una factura: per_line o per_invoice. Si se omite, se queda como está.

Opciones disponibles:
per_line,
per_invoice
return_status
enum<string>

El estado de existencias con el que regresan los productos devueltos: quarantined, para inspeccionarlos primero, o available. Si no se envía, queda como está.

Opciones disponibles:
quarantined,
available
quote_validity_days
integer

Cuántos días permanece válida una cotización nueva, de 1 a 365. Si se omite, no cambia.

Rango requerido: 1 <= x <= 365

Respuesta

SalesSettingsResource

data
SalesSettingsResource · object
requerido

La configuración de ventas de la organización: cómo los pedidos reservan existencias, qué cobran las facturas, cómo se redondean los impuestos, a dónde van los productos devueltos y cuánto tiempo siguen vigentes las cotizaciones.