Passer au contenu principal
PUT
cURL

Autorisations

Authorization
string
header
requis

Pour vos propres scripts et vos intégrations de serveur à serveur. Créez une clé dans l'application sous Paramètres > Accès > Clés d'API et copiez-la à ce moment-là, car elle n'est affichée qu'une fois. Envoyez-la sous la forme Authorization: Bearer <key>. La clé agit en tant que le membre qui l'a créée, dans l'organisation où elle a été créée. Un appel exige l'autorisation du membre et l'une des portées de la clé, comme inventory:read ou sales:write. Une clé avec * a toutes les portées.

Corps

application/json

Les paramètres de vente de l'organisation à modifier. Un paramètre omis reste tel quel, sauf reservation_hold_hours, qui est toujours envoyé.

reservation_hold_hours
integer | null
requis

Combien d'heures une commande en brouillon réserve son stock, de 1 à 8760. Envoyez-le toujours : null réserve le stock jusqu'à l'annulation de la commande.

Plage requise: 1 <= x <= 8760
reserve_on
enum<string>

Le moment où une commande réserve son stock : confirm, payment ou manual. Avec payment, une commande réserve du stock dès qu'un canal de vente indique qu'elle est payée, et une commande d'aucun canal attend que quelqu'un la réserve. Si omis, le réglage reste inchangé.

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

Ce que fait une ligne lorsque le stock manque : refuse, backorder ou partial. S'il est omis, il reste tel quel.

Options disponibles:
refuse,
backorder,
partial
over_allocation_percent
string

De combien une ligne peut retenir au-delà de ce qu'il reste à promettre, en pourcentage, jusqu'à 100. Si omis, la valeur reste inchangée.

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

Ce qu'une facture facture : after_shipping pour ce qui a été expédié, ou before_shipping pour ce qui a été commandé. S'il est omis, il reste tel quel.

Options disponibles:
after_shipping,
before_shipping
tax_rounding
enum<string>

Où la taxe d'une facture est arrondie au cent : per_line ou per_invoice. Si omis, le réglage reste inchangé.

Options disponibles:
per_line,
per_invoice
return_status
enum<string>

Le statut de stock dans lequel les marchandises retournées reviennent : quarantined, pour les inspecter d'abord, ou available. S'il est omis, il reste tel quel.

Options disponibles:
quarantined,
available
quote_validity_days
integer

Combien de jours une nouvelle soumission reste valide, de 1 à 365. Si omis, la valeur reste inchangée.

Plage requise: 1 <= x <= 365

Réponse

SalesSettingsResource

data
SalesSettingsResource · object
requis

Les paramètres de vente de l'organisation : comment les commandes réservent le stock, ce que les factures facturent, comment la taxe est arrondie, où vont les marchandises retournées et combien de temps les soumissions restent valides.