> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.fr/docs/llms.txt > Use this file to discover all available pages before exploring further. # Update a price book item > Mettre à jour un élément spécifique au sein d'un catalogue des prix dans votre compte HubSpot. Cette opération vous permet de modifier des détails tels que la tarification, la fréquence de facturation et les propriétés personnalisées pour l'élément spécifié. Assurez-vous que l'élément est correctement identifié par ses identifiants uniques priceBookId et priceBookItemId. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2026-09/commerce-price-books-v2026-09.json PATCH /commerce/price-books/2026-09/price-books/{priceBookId}/items/{priceBookItemId} openapi: 3.0.1 info: title: Commerce Price Books description: Basepom for all HubSpot Projects version: 2026-09 x-hubspot-product-tier-requirements: marketing: FREE sales: FREE service: FREE cms: FREE commerce: FREE crmHub: FREE dataHub: FREE servers: - url: https://api.hubapi.com security: [] tags: - name: Advanced - name: Basic - name: Batch - name: Items paths: /commerce/price-books/2026-09/price-books/{priceBookId}/items/{priceBookItemId}: patch: tags: - Items summary: Mettre à jour un élément de catalogue des prix description: >- Mettre à jour un élément spécifique au sein d'un catalogue des prix dans votre compte HubSpot. Cette opération vous permet de modifier des détails tels que la tarification, la fréquence de facturation et les propriétés personnalisées pour l'élément spécifié. Assurez-vous que l'élément est correctement identifié par ses identifiants uniques priceBookId et priceBookItemId. operationId: >- patch-/commerce/price-books/2026-09/price-books/{priceBookId}/items/{priceBookItemId} parameters: - name: priceBookId in: path description: >- L'identifiant unique du catalogue de prix contenant l'élément à mettre à jour. required: true style: simple explode: false schema: type: integer format: int64 - name: priceBookItemId in: path description: >- L'identifiant unique de l'élément à mettre à jour dans le catalogue des prix. required: true style: simple explode: false schema: type: integer format: int64 - name: archived in: query description: S'il faut renvoyer uniquement les résultats qui ont été archivés. required: false style: form explode: true schema: type: boolean requestBody: content: application/json: schema: $ref: '#/components/schemas/PriceBookItemUpdateRequest' required: true responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/PriceBookItemResponse' default: $ref: '#/components/responses/Error' description: '' security: [] components: schemas: PriceBookItemUpdateRequest: required: - billingFrequency - billingPeriod - customProperties - status type: object properties: archived: type: boolean description: Un booléen indiquant si l'élément du catalogue de prix est archivé. billingFrequency: type: object properties: {} description: >- Un objet indiquant la fréquence de facturation de l'élément du catalogue des prix. billingPeriod: type: object properties: {} description: >- Un objet indiquant la période sur laquelle la facturation a lieu pour l'élément du catalogue des prix. customProperties: type: object additionalProperties: type: string description: >- Une carte des noms de propriétés personnalisées et de leurs valeurs, permettant une personnalisation supplémentaire de l'élément du catalogue des prix. pricing: $ref: '#/components/schemas/PricingUpdateRequest' status: type: object properties: {} description: >- Un objet indiquant le statut actuel de l'élément du catalogue de prix. PriceBookItemResponse: required: - customProperties - id - productId type: object properties: archived: type: boolean description: Un booléen indiquant si l'élément du catalogue de prix est archivé. archivedAt: type: string description: >- La date et l'heure d'archivage de l'élément du catalogue des prix, au format ISO 8601. format: date-time billingFrequency: type: string description: "La fréquence de facturation de l’élément du catalogue des prix. Les valeurs valides incluent : «\_annuellement\_», «\_toutes les deux semaines\_», «\_mensuellement\_», «\_une seule fois\_», «\_tous les cinq ans\_», «\_tous les quatre ans\_», «\_tous les six mois\_», «\_tous les trois ans\_», «\_tous les deux ans\_», «\_trimestriellement\_» et «\_hebdomadairement\_»." enum: - ANNUALLY - BIWEEKLY - MONTHLY - PER_FIVE_YEARS - PER_FOUR_YEARS - PER_SIX_MONTHS - PER_THREE_YEARS - PER_TWO_YEARS - QUARTERLY - WEEKLY billingPeriod: type: string description: La période de facturation pour l'élément du catalogue des prix. costOfGoodsSold: type: string description: >- Le coût des marchandises vendues pour l'article du catalogue des prix. createdAt: type: string description: >- La date et l'heure de création de l'article du catalogue des prix, au format ISO 8601. format: date-time customProperties: type: object additionalProperties: type: string description: >- Mappage des noms de propriétés personnalisées à leurs valeurs pour l'article du catalogue des prix. description: type: string description: Description de l'article du catalogue des prix. id: type: string description: L'identifiant unique de l'article du catalogue des prix. images: type: string description: >- Une chaîne représentant les images associées à l'article du catalogue des prix. name: type: string description: Le nom de l'article du catalogue des prix. priceBookId: type: string description: L'identifiant unique du catalogue des prix contenant cet article. pricing: $ref: '#/components/schemas/Pricing' productClassification: type: string description: "La classification du produit. Les valeurs valides incluent «\_OFFRE GROUPÉE\_», «\_STANDALONE\_» et «\_VARIANT\_»." enum: - BUNDLE - STANDALONE - VARIANT productId: type: string description: >- L'identifiant unique du produit associé à l'article du catalogue des prix. productType: type: string description: "Le type de produit. Les valeurs valides incluent «\_INVENTORY\_», «\_NON_INVENTORY\_» et «\_SERVICE\_»." enum: - INVENTORY - NON_INVENTORY - SERVICE recurringBillingTerms: type: string description: "Les conditions de facturation récurrente pour l'article du catalogue des prix. Les valeurs valides incluent «\_AUTOMATICALLY_RENEW\_» et «\_FIXED\_»." enum: - AUTOMATICALLY_RENEW - FIXED sku: type: string description: >- Le numéro d'unité de gestion des stocks (UGS) de l'article du catalogue des prix. status: type: string description: "Le statut actuel de l'article du catalogue des prix. Les valeurs valides incluent «\_actif »\_ et «\_inactif\_»." enum: - active - inactive taxCategory: type: string description: La catégorie fiscale de l'article du catalogue des prix. updatedAt: type: string description: >- La date et l'heure de la dernière mise à jour de l'article du catalogue des prix, au format ISO 8601. format: date-time url: type: string description: Une URL associée à l'article du catalogue des prix. PricingUpdateRequest: required: - prices type: object properties: prices: type: array description: >- Un tableau d'objets PriceUpdateEntry, chacun représentant les détails de tarification d'un produit, y compris le code de devise et le montant. items: $ref: '#/components/schemas/PriceUpdateEntry' Pricing: required: - prices - pricingModel type: object properties: prices: type: array description: >- Un tableau d'entrées de prix, chacune détaillant le montant et la devise pour un niveau de tarification spécifique. items: $ref: '#/components/schemas/PriceEntry' pricingModel: type: string description: "Le type de modèle d\_e tarification appliqué, qui peut être l'un des suivants\_: «\_FORFAITAIRE\_», «\_DÉGRESSIF\_», «\_PAR PALIERS\_» ou «\_AU VOLUME\_»." enum: - FLAT - GRADUATED - STAIRSTEP - VOLUME Error: required: - category - correlationId - message type: object properties: category: type: string description: >- La catégorie d'erreur, représentée sous forme de chaine de caractères. context: type: object additionalProperties: type: array items: type: string description: >- Un objet fournissant un contexte sur la condition d'erreur. Il contient des propriétés supplémentaires, chacune étant un tableau de chaînes de caractères. example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Un identifiant unique pour la requête, représenté par une chaîne UUID. Incluez cette valeur dans tous les rapports d'erreur ou tickets d'assistance. format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: >- Un tableau fournissant des informations supplémentaires sur l'erreur, chaque élément étant un objet ErrorDetail. items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- Un objet qui mappe les noms de liens aux URI associées contenant la documentation sur l'erreur ou les étapes de correction recommandées. Chaque propriété est une chaîne de caractères. message: type: string description: >- Un message lisible par l'utilisateur décrivant l'erreur ainsi que les mesures correctives à prendre, le cas échéant. Il s'agit d'une chaîne de caractères. example: An error occurred subCategory: type: string description: >- Une catégorie spécifique qui contient des détails plus précis sur l'erreur, représentée sous forme de chaîne de caractères. description: >- Représente une réponse d'erreur renvoyée par l'API lorsqu'une opération échoue. Ce composant est utilisé dans divers points de terminaison pour fournir des informations détaillées sur l'erreur rencontrée. example: message: Invalid input (details will vary based on the error) correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf category: VALIDATION_ERROR links: knowledge-base: https://www.hubspot.com/products/service/knowledge-base PriceUpdateEntry: required: - currencyCode - price type: object properties: currencyCode: type: string description: Le code de devise du prix, représenté sous forme de chaîne. maxQuantity: type: integer description: >- La quantité maximale applicable pour ce prix, représentée sous forme de chaîne de caractères. format: int32 price: type: object properties: {} description: >- Un objet représentant les détails du prix pour l'entrée. La structure spécifique de cet objet n'est pas détaillée dans la spécification. PriceEntry: required: - currencyCode - price type: object properties: currencyCode: type: string description: Une chaîne représentant la devise dans laquelle le prix est exprimé. maxQuantity: type: integer description: >- Une chaîne spécifiant la quantité maximale pour laquelle cette entrée de prix est applicable. format: int32 price: type: number description: Un nombre indiquant le prix du produit ou du service. ErrorDetail: required: - message type: object properties: code: type: string description: >- Le code de statut associé au détail de l'erreur. Il s'agit d'une propriété de type chaîne de caractères. context: type: object additionalProperties: type: array items: type: string description: >- Contexte de la condition d'erreur, qui peut inclure des informations supplémentaires telles que des portées manquantes ou des noms de propriétés non valides. example: '{missingScopes=[scope1, scope2]}' in: type: string description: >- Le nom du champ ou du paramètre dans lequel l'erreur a été détectée. Il s'agit d'une propriété de type chaîne de caractères. message: type: string description: >- Un message lisible par l'utilisateur décrivant l'erreur ainsi que les mesures correctives à prendre, le cas échéant. Cette propriété est obligatoire. subCategory: type: string description: >- Une catégorie spécifique qui contient des détails plus précis sur l'erreur. Il s'agit d'une propriété de type chaîne de caractères. description: >- Représente des informations détaillées sur une erreur survenue dans l'API. Ce composant est utilisé pour fournir un contexte et des spécificités supplémentaires sur les erreurs, généralement dans le cadre d'une réponse d'erreur. responses: Error: description: An error occurred. content: '*/*': schema: $ref: '#/components/schemas/Error' ````