> ## Documentation Index > Fetch the complete documentation index at: https://br.developers.hubspot.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Update contract > Atualize um contrato existente na sua conta HubSpot usando o ID de contrato especificado. Esta operação permite modificar detalhes de um contrato, como suas propriedades e itens de linha associados. Certifique-se de que o ID do contrato seja válido e corresponda a um contrato existente. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2027-03-beta/commerce-contracts-v2027-03-beta.json PATCH /commerce/contracts/2027-03-beta/contracts/{contractId} openapi: 3.0.1 info: title: Commerce Contracts description: Basepom for all HubSpot Projects version: 2027-03-beta 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: Changes paths: /commerce/contracts/2027-03-beta/contracts/{contractId}: patch: tags: - Basic summary: Atualizar contrato description: >- Atualize um contrato existente na sua conta HubSpot usando o ID de contrato especificado. Esta operação permite modificar detalhes de um contrato, como suas propriedades e itens de linha associados. Certifique-se de que o ID do contrato seja válido e corresponda a um contrato existente. operationId: patch-/commerce/contracts/2027-03-beta/contracts/{contractId} parameters: - name: contractId in: path description: O identificador exclusivo do contrato a ser atualizado. required: true style: simple explode: false schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/ContractEditRequest' required: true responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/ContractResponse' default: $ref: '#/components/responses/Error' description: '' security: [] components: schemas: ContractEditRequest: required: - automatedTaxesEnabled - billingAddress - billingCompanyId - billingContactId - billingStartDateOverride - dealId - externalPaymentMethodReferenceId - locale - name - netPaymentTerms - ownerId - poNumber - sellerCompanyAddress - sellerCompanyDomain - sellerCompanyName - sellerEmail - sellerFirstName - sellerLastName - sellerPhone type: object properties: addressTypesToCollect: type: array description: >- Uma matriz de strings que indicam os tipos de endereços a serem coletados, como "BILLING_ADDRESS" ou "SHIPPING_ADDRESS". items: type: string enum: - BILLING_ADDRESS - SHIPPING_ADDRESS allowedPaymentMethods: type: array description: >- Uma matriz de strings que especifica os métodos de pagamento permitidos, que podem incluir "CREDIT_OR_DEBIT_CARD", "ACH", "SEPA", "BACS", "PADS", "AFFIRM" e "KLARNA". items: type: string enum: - CREDIT_OR_DEBIT_CARD - ACH - SEPA - BACS - PADS - AFFIRM - KLARNA automatedTaxesEnabled: type: object properties: {} description: >- Um objeto que indica se os impostos automatizados estão habilitados para o contrato. billingAddress: type: object properties: {} description: >- Um objeto que representa o endereço de cobrança associado ao contrato. billingCompanyId: type: object properties: {} description: >- Um objeto que representa o ID da empresa de cobrança associada ao contrato. billingContactId: type: object properties: {} description: >- Um objeto que representa o ID do contato de cobrança associado ao contrato. billingStartDateOverride: type: object properties: {} description: >- Um objeto que representa a substituição da data de início da cobrança. customProperties: type: object additionalProperties: type: string description: >- Um objeto que contém um mapa de nomes de propriedades personalizadas para seus valores, representados como strings. dealId: type: object properties: {} description: Um objeto que representa o ID do negócio associado ao contrato. externalPaymentMethodReferenceId: type: object properties: {} description: >- Um objeto que representa o ID de referência externa para o método de pagamento. locale: type: object properties: {} description: >- Um objeto que representa as configurações de localidade para o contrato. name: type: object properties: {} description: Um objeto que representa o nome do contrato. netPaymentTerms: type: object properties: {} description: >- Um objeto que indica os termos de pagamento líquidos para o contrato. ownerId: type: object properties: {} description: Um objeto que representa o ID do proprietário do contrato. poNumber: type: object properties: {} description: >- Um objeto que representa o número do pedido de compra para o contrato. sellerCompanyAddress: type: object properties: {} description: Um objeto que representa o endereço da empresa do vendedor. sellerCompanyDomain: type: object properties: {} description: Um objeto que representa o domínio da empresa do vendedor. sellerCompanyName: type: object properties: {} description: Um objeto que representa o nome da empresa do vendedor. sellerEmail: type: object properties: {} description: Um objeto que representa o endereço de e-mail do vendedor. sellerFirstName: type: object properties: {} description: Um objeto que representa o primeiro nome do vendedor. sellerLastName: type: object properties: {} description: Um objeto que representa o sobrenome do vendedor. sellerPhone: type: object properties: {} description: Um objeto que representa o número de telefone do vendedor. ContractResponse: required: - addressTypesToCollect - allowedPaymentMethods - automatedTaxesEnabled - customProperties - hubspotBillingEnabled - id - lineItems - paymentEnabled - status - storePaymentMethodAtCheckout type: object properties: addressTypesToCollect: type: array description: >- Uma matriz que indica os tipos de endereços a serem coletados. Os valores válidos incluem "BILLING_ADDRESS" e "SHIPPING_ADDRESS". items: type: string enum: - BILLING_ADDRESS - SHIPPING_ADDRESS allTransactionsFeeName: type: string description: Nome da taxa aplicada a todas as transações. allTransactionsFeePercentage: type: number description: A porcentagem da taxa aplicada a todas as transações. allowedPaymentMethods: type: array description: >- Uma matriz de métodos de pagamento permitidos. Os valores válidos incluem "CREDIT_OR_DEBIT_CARD", "ACH", "SEPA", "BACS", "PADS", "AFFIRM" e "KLARNA". items: type: string enum: - CREDIT_OR_DEBIT_CARD - ACH - SEPA - BACS - PADS - AFFIRM - KLARNA annualContractValue: type: number description: O valor anual do contrato. automatedTaxesEnabled: type: boolean description: Indica se os impostos automatizados estão ativados para o contrato. billingAddress: $ref: '#/components/schemas/Address' billingCompanyId: type: string description: >- O identificador exclusivo da empresa de cobrança associada ao contrato. billingContactId: type: string description: >- Identificador exclusivo do contato de cobrança associado ao contrato. billingStartDateOverride: type: string description: >- A data para substituir a data de início da cobrança, no formato ISO 8601. format: date businessUnitId: type: string description: >- O identificador exclusivo da unidade de negócio associada ao contrato. cardFeeName: type: string description: O nome da taxa aplicada às transações com cartão. cardFeePercentage: type: number description: A porcentagem da taxa aplicada a transações com cartão. collectionProcess: type: string description: >- O processo de cobrança de pagamentos. Os valores válidos incluem "MANUAL_PAYMENTS" e "AUTOMATIC_PAYMENTS". enum: - AUTOMATIC_PAYMENTS - MANUAL_PAYMENTS contractEffectiveDate: type: string description: A data em que o contrato entra em vigor, no formato ISO 8601. format: date contractSourceId: type: string description: O identificador exclusivo da origem do contrato. createdAt: type: string description: A data e a hora em que o contrato foi criado, no formato ISO 8601. format: date-time currencyCode: type: string description: >- O código da moeda associado ao contrato, representado como uma string. currentAnnualRecurringRevenue: type: number description: A receita recorrente anual atual do contrato. currentMonthlyRecurringRevenue: type: number description: A receita mensal recorrente atual do contrato. customProperties: type: object additionalProperties: type: string description: Um mapa de nomes de propriedades personalizadas para seus valores. dealId: type: string description: O identificador exclusivo do negócio associado ao contrato. directDebitFeeName: type: string description: O nome da taxa aplicada a transações de débito direto. directDebitFeePercentage: type: number description: A porcentagem da taxa aplicada a transações de débito direto. discountCode: type: string description: O código de desconto aplicado ao contrato. endDate: type: string description: A data de término do contrato, no formato ISO 8601. format: date externalPaymentMethodReferenceId: type: string description: O ID de referência externa para o método de pagamento. hubspotBillingEnabled: type: boolean description: Indica se a cobrança da HubSpot está ativada para o contrato. id: type: string description: O identificador exclusivo do contrato. language: type: string description: O idioma associado ao contrato. lineItems: type: array description: Uma lista de itens de linha incluídos no contrato. items: $ref: '#/components/schemas/LineItem' locale: type: string description: O local associado ao contrato. name: type: string description: O nome do contrato. netPaymentTerms: type: integer description: >- Os termos de pagamento líquidos do contrato, representados como um número inteiro. format: int32 paymentEnabled: type: boolean description: Indica se o pagamento está habilitado para o contrato. paymentMethod: type: string description: O método de pagamento usado no contrato. poNumber: type: string description: O número do pedido de compra associado ao contrato. preTerminationContractValue: type: number description: O valor do contrato antes da rescisão. renewalContractId: type: string description: O identificador exclusivo do contrato de renovação. renewalDate: type: string description: A data em que o contrato será renovado, no formato ISO 8601. format: date sellerCompanyAddress: $ref: '#/components/schemas/Address' sellerCompanyName: type: string description: O nome da empresa do vendedor. sellerEmail: type: string description: O endereço de e-mail do vendedor. sellerFirstName: type: string description: O nome do vendedor. sellerLastName: type: string description: O sobrenome do vendedor. sellerPhoneNumber: type: string description: O número de telefone do vendedor. startDate: type: string description: A data de início do contrato, no formato ISO 8601. format: date status: type: string description: >- O status atual do contrato. Os valores válidos incluem "DRAFT", "ACTIVE", "PAUSED", "COMPLETED" e "TERMINATED". enum: - ACTIVE - COMPLETED - DRAFT - PAUSED - TERMINATED storePaymentMethodAtCheckout: type: boolean description: Indica se o método de pagamento deve ser armazenado no checkout. terminationDate: type: string description: A data de rescisão do contrato, no formato ISO 8601. format: date totalBilledAmount: type: number description: O valor total faturado no contrato. totalBilledAmountPreTax: type: number description: O valor total faturado no contrato antes dos impostos. totalCollectedFees: type: number description: O valor total das taxas cobradas sob o contrato. totalCollectedTaxes: type: number description: O valor total dos impostos recolhidos sob o contrato. totalContractValue: type: number description: O valor total do contrato. totalPaidAmount: type: number description: O valor total pago no contrato. updatedAt: type: string description: >- A data e a hora da última atualização do contrato, no formato ISO 8601. format: date-time Address: type: object properties: address: type: string description: >- O endereço principal. É uma string que representa o detalhe principal da localização. address2: type: string description: >- Uma linha de endereço adicional. Esta é uma string usada para detalhes de localização complementares. city: type: string description: A cidade onde o endereço está localizado. É uma string. country: type: string description: >- O país do endereço. Esta é uma string que indica a nação associada ao endereço. countryCode: type: string description: >- O código que representa o país do endereço. É uma string, geralmente seguindo os padrões internacionais de código de país. state: type: string description: >- O estado ou a região do endereço. Esta é uma string que especifica a subdivisão dentro do país. zip: type: string description: >- O código postal do endereço. É uma string usada para fins de entrega de correspondência. LineItem: required: - id - name - pricing - quantity type: object properties: acv: type: number description: O valor do contrato anual para este item de linha. Um número. allowBuyerSelectedQuantity: type: boolean description: >- Indica se o comprador pode selecionar a quantidade deste item de linha. Um valor booleano. amount: type: number description: >- O valor total para este item de linha, calculado como preço multiplicado pela quantidade. Um número. archived: type: boolean description: Indica se este item de linha está arquivado. Um valor booleano. archivedAt: type: string description: >- A data e a hora em que este item de linha foi arquivado, no formato ISO 8601. format: date-time arr: type: number description: A receita recorrente anual para este item de linha. Um número. billingCycleAnchorDate: type: string description: >- A data de referência para o ciclo de cobrança, no formato de data ISO 8601. format: date billingPeriodEndDate: type: string description: >- A data de término do período de cobrança, no formato de data ISO 8601. format: date billingPeriodStartDate: type: string description: >- A data de início do período de cobrança, no formato de data ISO 8601. format: date billingStartDelayDays: type: integer description: O atraso em dias antes do início da cobrança. Um número inteiro. format: int32 billingStartDelayMonths: type: integer description: O atraso em meses antes do início da cobrança. Um número inteiro. format: int32 billingStartDelayType: type: string description: >- O tipo de atraso antes do início da cobrança. Os valores válidos incluem 'HS_BILLING_START_DELAY_DAYS', 'HS_BILLING_START_DELAY_MONTHS' e 'HS_RECURRING_BILLING_START_DATE'. enum: - HS_BILLING_START_DELAY_DAYS - HS_BILLING_START_DELAY_MONTHS - HS_RECURRING_BILLING_START_DATE buyerSelectedQuantityMax: type: number description: >- A quantidade máxima que o comprador pode selecionar para este item de linha. Um número. buyerSelectedQuantityMin: type: number description: >- A quantidade mínima que o comprador pode selecionar para este item de linha. Um número. createdAt: type: string description: >- A data e hora em que este item de linha foi criado, no formato ISO 8601. format: date-time description: type: string description: Uma descrição de texto do item de linha. discount: type: number description: O desconto aplicado a este item de linha. Um número. discountPercentage: type: number description: A porcentagem de desconto aplicada a este item de linha. Um número. effectiveUnitPrice: type: number description: O preço efetivo por unidade após os descontos. Um número. externalId: type: string description: Um identificador externo para este item de linha. id: type: string description: O identificador exclusivo para este item de linha. images: type: string description: Um URL ou referência a imagens associadas a este item de linha. isEditablePrice: type: boolean description: Indica se o preço deste item de linha é editável. Um valor booleano. isOptional: type: boolean description: Indica se este item de linha é opcional. Um valor booleano. isParent: type: boolean description: Indica se este item de linha é um item principal. Um valor booleano. lineItemCurrencyCode: type: string description: >- O código da moeda para este item de linha, seguindo o formato ISO 4217. mrr: type: number description: A receita mensal recorrente para este item de linha. Um número. name: type: string description: O nome do item de linha. parentLineItemId: type: string description: O identificador exclusivo do item de linha principal, se aplicável. positionOnQuote: type: integer description: A posição deste item de linha em um orçamento. Um número inteiro. format: int32 postTaxAmount: type: number description: O valor total após a aplicação do imposto. Um número. preDiscountAmount: type: number description: O valor antes da aplicação de quaisquer descontos. É um número. price: type: number description: O preço de uma unidade do item de linha. Um número. priceBookId: type: string description: >- O identificador exclusivo para o catálogo de preços associado a este item de linha. pricing: $ref: '#/components/schemas/Pricing' pricingModel: type: string description: >- O modelo de precificação usado para este item de linha. Os valores válidos incluem 'FLAT', 'GRADUATED', 'STAIRSTEP' e 'VOLUME'. enum: - FLAT - GRADUATED - STAIRSTEP - VOLUME productId: type: string description: O identificador exclusivo do produto associado a este item de linha. productType: type: string description: O tipo de produto para este item de linha. quantity: type: number description: A quantidade do item de linha. Um número. rampKey: type: string description: >- Um identificador exclusivo para a progressão de preços associada a este item de linha. recurringBillingDayOfMonth: type: integer description: O dia do mês em que ocorre a cobrança recorrente. Um número inteiro. format: int32 recurringBillingEndDate: type: string description: >- A data de término da cobrança recorrente, no formato de data ISO 8601. format: date recurringBillingFrequency: type: string description: >- A frequência de cobrança recorrente para este item de linha. Os valores válidos incluem 'ANNUALLY', 'BIWEEKLY', 'MONTHLY', 'PER_FIVE_YEARS', 'PER_FOUR_YEARS', 'PER_SIX_MONTHS', 'PER_THREE_YEARS', 'PER_TWO_YEARS', 'QUARTERLY' e 'WEEKLY'. enum: - ANNUALLY - BIWEEKLY - MONTHLY - PER_FIVE_YEARS - PER_FOUR_YEARS - PER_SIX_MONTHS - PER_THREE_YEARS - PER_TWO_YEARS - QUARTERLY - WEEKLY recurringBillingNumberOfPayments: type: integer description: O número de pagamentos para cobrança recorrente. Um número inteiro. format: int32 recurringBillingPeriod: type: string description: O período para cobrança recorrente. recurringBillingStartDate: type: string description: >- A data de início da cobrança recorrente, no formato de data ISO 8601. format: date recurringBillingTerms: type: string description: >- Os termos de cobrança recorrente. Os valores válidos incluem "AUTOMATICALLY_RENEW" e "FIXED". enum: - AUTOMATICALLY_RENEW - FIXED richTextDescription: type: string description: Uma descrição detalhada do item de linha. sku: type: string description: A unidade de manutenção de estoque (SKU) para este item de linha. tax: type: number description: A alíquota de imposto aplicada a este item de linha. Um número. taxAmount: type: number description: O valor total do imposto para este item de linha. Um número. taxCategory: type: string description: A categoria de imposto deste item de linha. taxRateGroupId: type: string description: >- O identificador exclusivo para o grupo de alíquotas de impostos associado a este item de linha. tcv: type: number description: O valor total do contrato para este item de linha. Um número. termInMonths: type: integer description: O período em meses para este item de linha. Um número inteiro. format: int32 tierAmount: type: number description: O valor para a categoria de preço atual. Um número. totalDiscount: type: number description: O valor total do desconto para este item de linha. Um número. updatedAt: type: string description: >- A data e a hora da última atualização deste item de linha, no formato ISO 8601. format: date-time variantId: type: string description: >- O identificador exclusivo para a variante do produto associada a este item de linha. Error: required: - category - correlationId - message type: object properties: category: type: string description: A categoria de erro. context: type: object additionalProperties: type: array items: type: string description: >- Contexto sobre a condição de erro, fornecido como um objeto com propriedades adicionais que são matrizes de strings. example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- O identificador exclusivo da solicitação. Inclua este valor em relatórios de erro ou tickets de suporte. Ele é formatado como um UUID. format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: >- Mais informações sobre o erro, representadas como uma matriz de objetos ErrorDetail. items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- Um mapa de nomes de links para URIs associados que contêm documentação sobre o erro ou etapas de correção recomendadas. message: type: string description: >- Uma mensagem legível por humanos que descreve o erro, juntamente com as etapas de correção, quando apropriado. example: An error occurred subCategory: type: string description: >- Uma categoria específica que contém detalhes mais específicos sobre o erro. Esta é uma propriedade de string. description: >- Representa uma resposta de erro retornada pela API quando uma operação falha. Este componente é usado em vários endpoints para fornecer informações detalhadas sobre o erro encontrado. 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 Pricing: required: - prices - pricingModel type: object properties: prices: type: array description: >- Uma matriz de entradas de preço, cada uma especificando um código de moeda e o preço correspondente para o item de linha. items: $ref: '#/components/schemas/PriceEntry' pricingModel: type: string description: >- O modelo usado para determinar os preços. Os valores válidos incluem "FLAT", "GRADUATED", "STAIRSTEP" e "VOLUME". enum: - FLAT - GRADUATED - STAIRSTEP - VOLUME ErrorDetail: required: - message type: object properties: code: type: string description: >- O código de status associado ao detalhe do erro, representado como uma string. context: type: object additionalProperties: type: array items: type: string description: >- Contexto sobre a condição de erro, representado como um objeto em que cada chave é uma string e cada valor é uma matriz de strings. Isso fornece informações adicionais sobre o erro. example: '{missingScopes=[scope1, scope2]}' in: type: string description: >- O nome do campo ou parâmetro em que o erro foi encontrado. Este é um campo de string opcional. message: type: string description: >- Uma mensagem legível por humanos que descreve o erro, juntamente com as etapas de correção, quando apropriado. Este é um campo obrigatório e é do tipo string. subCategory: type: string description: >- Uma categoria específica que contém detalhes mais específicos sobre o erro, fornecida como uma string. description: >- Representa informações detalhadas sobre um erro ocorrido na API. Este componente é usado para fornecer contexto e detalhes adicionais sobre os erros, geralmente como parte de uma resposta de erro. PriceEntry: required: - currencyCode - price type: object properties: currencyCode: type: string description: A moeda em que o preço é denominado, representada como uma string. maxQuantity: type: integer description: >- A quantidade máxima para a qual este preço é aplicável, representada como um número inteiro. format: int32 price: type: number description: >- O custo do produto ou serviço na moeda especificada, representado como um número. responses: Error: description: An error occurred. content: '*/*': schema: $ref: '#/components/schemas/Error' ````