> ## 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. # Upsert deal splits > Crie ou substitua divisões para negócios com os IDs especificados. As porcentagens de divisão para cada negócio devem somar 1,0 (100%) e podem ter até 8 casas decimais. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/legacy/v3/crm-deal-splits-v3.json POST /crm/objects/v3/deals/splits/batch/upsert openapi: 3.0.1 info: title: CRM Deal Splits description: Basepom for all HubSpot Projects version: v3 x-hubspot-product-tier-requirements: marketing: FREE sales: ENTERPRISE service: FREE cms: FREE commerce: FREE crmHub: FREE dataHub: FREE x-hubspot-api-use-case: >- When two sales reps work together to close a deal, add a split to the deal to reflect that the credit and commission are being shared. x-hubspot-related-documentation: - name: Deal splits overview url: https://developers.hubspot.com/docs/guides/api/crm/objects/deal-splits x-hubspot-introduction: >- Use the deal splits API to split existing deals between owners when credit and/or commission are shared between them. servers: - url: https://api.hubapi.com security: [] tags: - name: Batch paths: /crm/objects/v3/deals/splits/batch/upsert: post: tags: - Batch summary: >- Crie ou substitua divisões para negócios com os IDs especificados. As porcentagens de divisão para cada negócio devem somar 1,0 (100%) e podem ter até 8 casas decimais. description: >- Crie ou substitua divisões para negócios com os IDs especificados. As porcentagens de divisão para cada negócio devem somar 1,0 (100%) e podem ter até 8 casas decimais. operationId: >- post-/crm/objects/v3/deals/splits/batch/upsert_/crm/objects/v3/deals/splits/batch/upsert parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/PublicDealSplitsBatchCreateRequest' required: true responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/BatchResponseDealToDealSplits' '207': description: multiple statuses content: application/json: schema: $ref: '#/components/schemas/BatchResponseDealToDealSplitsWithErrors' default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - crm.dealsplits.read_write components: schemas: PublicDealSplitsBatchCreateRequest: required: - inputs type: object properties: inputs: type: array description: Uma série de entradas de divisão de negócios items: $ref: '#/components/schemas/PublicDealSplitsCreateRequest' BatchResponseDealToDealSplits: required: - completedAt - results - startedAt - status type: object properties: completedAt: type: string description: >- A data e a hora em que a operação em lote foi concluída, em formato data-hora. format: date-time links: type: object additionalProperties: type: string description: >- Um mapa de nomes de links para URIs associados a recursos ou documentação adicionais. requestedAt: type: string description: >- A data e a hora em que a operação em lote foi solicitada, em formato data-hora. format: date-time results: type: array description: >- Uma série de objetos de divisão de negócio para negócio representando os resultados da operação em lote. items: $ref: '#/components/schemas/DealToDealSplits' startedAt: type: string description: >- A data e a hora em que a operação em lote foi iniciada, em formato data-hora. format: date-time status: type: string description: >- O status atual da operação em lote. Os valores possíveis são: CANCELADO, CONCLUÍDO, PENDENTE, PROCESSANDO. enum: - CANCELED - COMPLETE - PENDING - PROCESSING BatchResponseDealToDealSplitsWithErrors: required: - completedAt - results - startedAt - status type: object properties: completedAt: type: string description: >- A data e a hora em que a operação em lote foi concluída, em formato data-hora. format: date-time errors: type: array description: >- Uma série de objetos de erro detalhando os erros que ocorreram durante a operação em lote. items: $ref: '#/components/schemas/StandardError' links: type: object additionalProperties: type: string description: >- Um mapa de nomes de links para URIs associados a recursos ou documentação adicionais. numErrors: type: integer description: O número total de erros encontrados durante a operação em lote. format: int32 requestedAt: type: string description: >- A data e a hora em que a operação em lote foi solicitada, em formato data-hora. format: date-time results: type: array description: >- Uma série de objetos de divisão de negócio para negócio representando os resultados da operação em lote. items: $ref: '#/components/schemas/DealToDealSplits' startedAt: type: string description: >- A data e a hora em que a operação em lote foi iniciada, em formato data-hora. format: date-time status: type: string description: >- O status atual da operação em lote. Os valores possíveis são: CANCELADO, CONCLUÍDO, PENDENTE, PROCESSANDO. enum: - CANCELED - COMPLETE - PENDING - PROCESSING PublicDealSplitsCreateRequest: required: - id - splits type: object properties: id: type: integer description: O identificador exclusivo do negócio. format: int64 splits: type: array description: >- Uma série de entradas de divisão de negócios, cada uma contendo um ID de proprietário e uma porcentagem da divisão do negócio. items: $ref: '#/components/schemas/PublicDealSplitInput' DealToDealSplits: required: - id - splits type: object properties: id: type: string description: >- O identificador exclusivo do negócio associado às divisões de negócio. splits: type: array description: >- Uma série de objetos de divisão de negócios, cada uma representando uma parte do negócio atribuída a um proprietário. items: $ref: '#/components/schemas/SimplePublicObject' StandardError: required: - category - context - errors - links - message - status 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 do erro errors: type: array description: Os objetos de erro detalhados. items: $ref: '#/components/schemas/ErrorDetail' id: type: string description: O ID do erro 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 as etapas de correção recomendadas message: type: string description: A mensagem de erro status: type: string description: >- Uma mensagem legível por humanos que descreve o erro, juntamente com as etapas de correção, quando apropriado subCategory: type: object properties: {} description: >- Uma categoria específica que contém mais detalhes específicos sobre o erro description: >- Representa uma resposta de erro padrão na API do HubSpot, fornecendo informações detalhadas sobre um erro ocorrido durante uma solicitação de API. 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 do erro example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Um identificador exclusivo para a solicitação. Inclua este valor em relatórios de erro ou tickets de suporte format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: mais informações sobre o erro 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 as 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 mais detalhes específicos sobre o erro 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 PublicDealSplitInput: required: - ownerId - percentage type: object properties: ownerId: type: integer description: >- O identificador exclusivo do proprietário que receberá a divisão do negócio. format: int32 percentage: type: number description: >- A parte do negócio atribuída ao proprietário, expressa em percentagem. A percentagem total de todas as divisões em um negócio deve somar 1,0 (100%) e pode ter até 8 casas decimais. SimplePublicObject: required: - archived - createdAt - id - properties - updatedAt type: object properties: archived: type: boolean description: Se o objeto está arquivado ou não. archivedAt: type: string description: A data e hora em que o objeto foi arquivado, no formato ISO 8601. format: date-time createdAt: type: string description: A data e hora em que o objeto foi criado, no formato ISO 8601. format: date-time id: type: string description: O ID exclusivo do objeto. objectWriteTraceId: type: string description: >- Um identificador usado para rastrear a solicitação de gravação do objeto. Defina um ID exclusivo para cada operação de gravação; ele será retornado com quaisquer erros para que você possa identificar qual solicitação apresentou qual erro. properties: type: object additionalProperties: type: string description: Pares de chave-valor que representam as propriedades do objeto. propertiesWithHistory: type: object additionalProperties: type: array items: $ref: '#/components/schemas/ValueWithTimestamp' description: >- Pares de chave-valor que representam as propriedades do objeto junto com seu histórico, cada um com uma data/hora e informações de origem. updatedAt: type: string description: >- A data e hora em que o objeto foi atualizado pela última vez, no formato ISO 8601. format: date-time url: type: string description: O URL associado ao objeto. description: Um objeto público simples. ErrorDetail: required: - message type: object properties: code: type: string description: O código de status associado ao detalhe do erro context: type: object additionalProperties: type: array items: type: string description: Contexto sobre a condição do erro example: '{missingScopes=[scope1, scope2]}' in: type: string description: O nome do campo ou parâmetro no qual o erro foi encontrado. message: type: string description: >- Uma mensagem legível por humanos que descreve o erro, juntamente com as etapas de correção, quando apropriado subCategory: type: string description: >- Uma categoria específica que contém mais detalhes específicos sobre o erro 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. ValueWithTimestamp: required: - sourceType - timestamp - value type: object properties: sourceId: type: string description: Um identificador de string para a fonte específica do valor. sourceLabel: type: string description: Um rótulo legível por humanos. sourceType: type: string description: Uma string que indica o tipo de origem do valor. timestamp: type: string description: >- A data e hora em que a propriedade foi atualizada, no formato ISO 8601. format: date-time updatedByUserId: type: integer description: O ID do usuário que atualizou a propriedade pela última vez. format: int32 value: type: string description: O valor da propriedade. description: Modelo de propriedade que inclui data e hora. responses: Error: description: An error occurred. content: '*/*': schema: $ref: '#/components/schemas/Error' securitySchemes: oauth2: type: oauth2 flows: authorizationCode: authorizationUrl: https://app.hubspot.com/oauth/authorize tokenUrl: https://api.hubapi.com/oauth/v1/token scopes: crm.dealsplits.read_write: '' ````