---
title: "Offer proposal has been accepted."
method: POST
path: "/offers/proposal"
tags: ["offer"]
---

# Offer proposal has been accepted.

`POST /offers/proposal`

Offer proposal has been accepted by customer.

## Headers

- `X-Company-Id` string, required
- `X-Application-Id` string, required
- `X-User-Id` string, required
- `X-Susep-Code` string, required
- `X-Sucursal-Code` string, required
- `X-Trace-Id` string, required
- `X-Track-Id` string
- `companyId` number, required
- `Content-Type` string, required

## Request body

- ProposalRequest — Proposed Offer Request
  - `prospect` Prospect — Person Entity
    - `name` string — Name
    - `socialName` string — Name
    - `occupationClassificationCode` integer — Occupation ClassificationCode
    - `salaryRangeCode` integer — salary Range Code
    - `isAwareName` boolean — is Aware Name * true * false
    - `isAwareAddress` boolean — is Aware Address * true * false
    - `isPoliticallyExposedPerson` boolean — is Aware Address * true * false
    - `birthday` string, date — YYYY-MM-DD
    - `gender` '1' | '2' — Person Gender: * `1` - Male * `2` - Female
    - `documents` Document[] — Document Identification (CPF, RG, CNPJ, RNE)
      - `documentType` DocumentType
        - `description` string
        - `id` integer
      - `number` string
    - `contacts` Contact[] — contacts (e-mail e phones)
      - `data` string — Value Data of Contact, Ex: email, cellphone...
      - `isAllowCampaing` boolean — Marketing campaigns allowed
      - `isInspectionAccountable` true | false — is Inspection Accountable * true * false
      - `responsibleName` string — Responsible name
      - `type` ContactType — Contact type definitions
        - `id` 1 | 2 | 3 | 4 — 1 - Home Phone, 2 - Company Phone, 3 - CellPhone, 4 - Email
        - `description` string
    - `address` Address[] — Addresss (Payment, home, business, etc)
      - `street` string
      - `complement` string
      - `city` City — city name
        - `name` string — city name
        - `state` State — State
          - `code` string — state abbreviation
      - `referencePoint` string
      - `postalCode` string
    - `complementaryData` ComplementaryData — Complementary Data
      - `customer` Customer — Abstraction for every party (Customer, Counterpart, Broker, etc)
        - `isPoliticallyExposedPerson` boolean — is the customer a politically exposed person?
        - `netPromoterScore` integer — Customer's net promoter score, to represent how satisfied he/she is with company's services
        - `marketingScore` string — Customer internal score for marketing usage, in segmenting for product offers, etc
        - `customershipEffectiveDate` string, date — The date this person became a customer, the format YYYY-MM-DD. Ex.: 2018-11-14
        - `occupationClassification` string — Occupation Classification Code, as defined by local regulators (In Brazil, CBO is used)
        - `bankAccountTypeCode` integer — Bank account type code
      - `customerAttorneys` CustomerAttorneys[]
        - `cpf` string — The issuer Date of document
        - `name` string — The issuer name of document
      - `customerAdministrators` CustomerAdministrators[]
        - `cpf` string — The issuer Date of document
        - `name` string — The issuer name of document
      - `customerControllers` CustomerControllers[]
        - `cpf` string — The issuer Date of document
        - `name` string — The issuer name of document
  - `businessItem` BusinessItem — Business Item Offer.
    - `offerId` number, required
    - `insurance` InsuranceBusinessItem — Insurace Component of Offer Item
      - `brokers` Broker[], required
        - `id` number — Broker id
        - `code` string — Broker Code
        - `type` BrokerType — Broker Type
          - `description` string — Description type
        - `name` string — Broker name
        - `sucursalCode` string — Sucursal Code
        - `susepCode` string — Susep Code
        - `documents` Documents — Broker document
          - `type` Type — Type Document
            - `id` number — Document type ID
            - `description` string — Document description
          - `number` string — CNPJ
      - `welcomeKitSentTo` DomainData — Data of Domain structure
        - `id` integer — Id of Data
        - `code` string — Code of Data
        - `description` string — Description of Data
      - `properties` PropertiertApplication[]
        - `address` Address — Address of the risk location.
          - `street` string
          - `complement` string
          - `city` City — city name
            - `name` string — city name
            - `state` State — State
              - …
          - `referencePoint` string
          - `postalCode` string
        - `beneficiary` Beneficiary
          - `name` string
          - `socialName` string
          - `documents` BeneficiaryDocument[]
            - `number` string
            - `type` DocumentType
              - …
          - `assetGrant` number
          - `value` BeneficiaryValue
            - `amount` number, double
      - `installments` Installments, required — Instalments of Proposed Offer
        - `sequenceGroup` number — Id of Instalment
        - `bankData` BankData — Bank Entity
          - `bankBranch` BankBranch — Branch Entity
            - `branchCode` string — branch Code of Bank
            - `branchDigit` string — branch Digit Code of Bank
          - `bankCode` string — Bank Code of Federation
          - `checkingAccount` string — Account Number of Bank
          - `checkingAccountDigit` string — Account Digiti Number of Bank
          - `document` DocumentBankData[]
            - `mainName` string — The main name of document
            - `number` string, required — Document Data of person
            - `type` DocumentType, required
              - …
        - `installmentDueDate` string, date — Payment due date, use format [yyyy-MM-dd]

## Response `200`

Sucesso

- object[]
  - `demonstrative` Demonstrative
    - `statementNum` integer
    - `paymentDate` string
    - `policy` Policy — Policy Entity
      - `code` string — Code policy
      - `congenerCode` string — Congener code policy
      - `endDate` string — End date policy
    - `commissionValue` Amount — Informations of Amount
      - `amount` number — Description about amount
      - `amountFormatted` string — Amount Formatted
      - `currency` string — Amount Currency
    - `advanceValue` Amount — Informations of Amount
      - `amount` number — Description about amount
      - `amountFormatted` string — Amount Formatted
      - `currency` string — Amount Currency
    - `reductionValue` Amount — Informations of Amount
      - `amount` number — Description about amount
      - `amountFormatted` string — Amount Formatted
      - `currency` string — Amount Currency
    - `grossValue` Amount — Informations of Amount
      - `amount` number — Description about amount
      - `amountFormatted` string — Amount Formatted
      - `currency` string — Amount Currency
    - `difference` Amount — Informations of Amount
      - `amount` number — Description about amount
      - `amountFormatted` string — Amount Formatted
      - `currency` string — Amount Currency
    - `netValue` Amount — Informations of Amount
      - `amount` number — Description about amount
      - `amountFormatted` string — Amount Formatted
      - `currency` string — Amount Currency
    - `comissions` Comission
      - `document` Document
        - `documentType` DocumentType
          - `description` string
          - `id` integer
        - `number` string
      - `portfolio` Portifolio — Entity for our Product Portfolio
        - `id` integer — ID of Portifolio
        - `compositionCode` string — Code of Portifolio: 431 - HDI Perfil; 005 - Residencial
        - `name` string — Name of Portifolio
      - `company` Company — Company entity
        - `id` integer — ID of company
        - `code` '01' | '03' | '04' — Code of company: 01 - HDI; 04 - SantanderAuto
        - `name` string — Name of company
      - `customer` Customer — Abstraction for every party (Customer, Counterpart, Broker, etc)
        - `isPoliticallyExposedPerson` boolean — is the customer a politically exposed person?
        - `netPromoterScore` integer — Customer's net promoter score, to represent how satisfied he/she is with company's services
        - `marketingScore` string — Customer internal score for marketing usage, in segmenting for product offers, etc
        - `customershipEffectiveDate` string, date — The date this person became a customer, the format YYYY-MM-DD. Ex.: 2018-11-14
        - `occupationClassification` string — Occupation Classification Code, as defined by local regulators (In Brazil, CBO is used)
        - `bankAccountTypeCode` integer — Bank account type code
      - `product` Product — Product Entity
        - `id` integer — Product Id
        - `code` string — Product Code
        - `name` string — Name of Product
      - `statementNumber` integer
      - `paymentDate` string
      - `branchCode` string
      - `endorsementSequence` string
      - `premiumValue` string
      - `commissionPercentage` string
  - `total` object
    - `commissionValue` Amount — Informations of Amount
      - `amount` number — Description about amount
      - `amountFormatted` string — Amount Formatted
      - `currency` string — Amount Currency
    - `advanceValue` Amount — Informations of Amount
      - `amount` number — Description about amount
      - `amountFormatted` string — Amount Formatted
      - `currency` string — Amount Currency
    - `deductionAmount` Amount — Informations of Amount
      - `amount` number — Description about amount
      - `amountFormatted` string — Amount Formatted
      - `currency` string — Amount Currency
    - `grossValue` Amount — Informations of Amount
      - `amount` number — Description about amount
      - `amountFormatted` string — Amount Formatted
      - `currency` string — Amount Currency
    - `differenceValue` Amount — Informations of Amount
      - `amount` number — Description about amount
      - `amountFormatted` string — Amount Formatted
      - `currency` string — Amount Currency
    - `netValue` Amount — Informations of Amount
      - `amount` number — Description about amount
      - `amountFormatted` string — Amount Formatted
      - `currency` string — Amount Currency

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Data not found
- `405` — Data input not supplied or invalid
- `453` — Business Exception
- `500` — Exception

---

[API](https://skmtc.dev/hdi/apis/api-authentication-and-authorization.md) · [All operations](https://skmtc.dev/hdi/apis/api-authentication-and-authorization/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hdi/api-authentication-and-authorization/revisions/216d39155ad4/schema)
