> ## Documentation Index
> Fetch the complete documentation index at: https://bmpdocs.moneyp.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# 36 - Salvar Proposta Garantia Bem

Por meio deste endpoint o parceiro inclui mais de um Bem do tipo móvel ou imóvel, como garantia para o valor financiado.

## Tabela de códigos auxuliares

<Expandable title="Tabelas">
  <Expandable title="Tabela TipoContaBancaria">
    | ID | Descrição      |
    | -- | -------------- |
    | 1  | Poupança       |
    | 2  | Conta Corrente |
  </Expandable>

  <Expandable title=" TipoVeículo">
    | ID | Descrição    |
    | -- | ------------ |
    | 1  | Particular   |
    | 2  | Comercial    |
    | 3  | Oficial      |
    | 4  | Diplomático  |
    | 5  | Especial     |
    | 6  | Colecionador |
  </Expandable>

  <Expandable title="Tabela TipoRestrição">
    | ID | Descrição                        |
    | -- | -------------------------------- |
    | 1  | Arredondamento mercantil/leasing |
    | 2  | Reserva e domínio/outros         |
    | 3  | Alienação fiduciária             |
    | 4  | Penhor                           |
  </Expandable>

  <Expandable title="Tabela TipoChassi">
    | ID | Descrição |
    | -- | --------- |
    | 1  | Remarcado |
    | 2  | Normal    |
  </Expandable>

  <Expandable title="Tabela SituaçãoGravame">
    | ID | Descrição                                     |
    | -- | --------------------------------------------- |
    | 2  | Significa que existe alguma pendência gravame |
  </Expandable>

  <Expandable title="Tabela OrigemGravame">
    | ID | Descrição |
    | -- | --------- |
    | 1  | Interno   |
    | 2  | Externo   |
    | 3  | Ambos     |
  </Expandable>

  ***
</Expandable>


## OpenAPI

````yaml post /Proposta/SalvarPropostaGarantiaBem
openapi: 3.0.1
info:
  title: BMPDigitalCore.ApiExterna.Proposta.API
  version: '1.0'
servers:
  - url: https://api.bmpdigital.moneyp.dev.br
security:
  - Bearer: []
paths:
  /Proposta/SalvarPropostaGarantiaBem:
    post:
      tags:
        - Proposta
      parameters:
        - name: IdempotencyKey
          in: header
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateUpdatePropostaGarantiaBemCommand'
          text/json:
            schema:
              $ref: '#/components/schemas/CreateUpdatePropostaGarantiaBemCommand'
          application/*+json:
            schema:
              $ref: '#/components/schemas/CreateUpdatePropostaGarantiaBemCommand'
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/CreateUpdateMultiResponse'
            application/json:
              schema:
                $ref: '#/components/schemas/CreateUpdateMultiResponse'
            text/json:
              schema:
                $ref: '#/components/schemas/CreateUpdateMultiResponse'
        '400':
          description: Bad Request
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ResponseBase'
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseBase'
            text/json:
              schema:
                $ref: '#/components/schemas/ResponseBase'
components:
  schemas:
    CreateUpdatePropostaGarantiaBemCommand:
      type: object
      properties:
        dto:
          $ref: '#/components/schemas/PropostaGarantiaBemDTO'
        parametros:
          type: array
          items:
            $ref: '#/components/schemas/ParametroDTO'
          nullable: true
      additionalProperties: false
    CreateUpdateMultiResponse:
      type: object
      properties:
        msg:
          type: string
          nullable: true
        result:
          type: boolean
          writeOnly: true
        hasError:
          type: boolean
        messages:
          type: array
          items:
            $ref: '#/components/schemas/Message'
          nullable: true
        results:
          type: array
          items:
            $ref: '#/components/schemas/CreateUpdateResponse'
          nullable: true
      additionalProperties: false
    ResponseBase:
      type: object
      properties:
        msg:
          type: string
          nullable: true
        result:
          type: boolean
          writeOnly: true
        hasError:
          type: boolean
        messages:
          type: array
          items:
            $ref: '#/components/schemas/Message'
          nullable: true
      additionalProperties: false
    PropostaGarantiaBemDTO:
      required:
        - codigoProposta
        - grupo
        - subgrupo
      type: object
      properties:
        codigo:
          type: string
          description: Identificador único do bem de garantia da proposta.
          format: uuid
        codigoProposta:
          type: string
          description: Identificador único da proposta.
          format: uuid
        codigoIdentificador:
          type: string
          description: Código identificador do bem.
          nullable: true
        nomeProprietario:
          maxLength: 60
          minLength: 1
          type: string
          description: Nome do proprietário do bem.
          nullable: true
        documentoFederalProprietario:
          maxLength: 20
          minLength: 1
          type: string
          description: Documento federal (CPF/CNPJ) do proprietário do bem.
          nullable: true
        grupo:
          maximum: 9999
          minimum: 1
          type: integer
          description: Grupo ao qual o bem pertence.
          format: int32
        subgrupo:
          maximum: 9999
          minimum: 1
          type: integer
          description: Subgrupo ao qual o bem pertence.
          format: int32
        descricaoSubgrupo:
          maxLength: 254
          minLength: 1
          type: string
          description: Descrição do subgrupo.
          nullable: true
        vlrTotal:
          maximum: 99999999.9
          minimum: 1
          type: number
          description: Valor total do bem.
          format: double
          nullable: true
        descricao:
          maxLength: 254
          minLength: 1
          type: string
          description: Descrição detalhada do bem.
          nullable: true
        propostaGarantiaBemFinan:
          $ref: '#/components/schemas/PropostaGarantiaBemFinanDTO'
        propostaGarantiaBemImovel:
          $ref: '#/components/schemas/PropostaGarantiaBemImovelDTO'
        propostaGarantiaBemMovel:
          $ref: '#/components/schemas/PropostaGarantiaBemMovelDTO'
        propostaGarantiaBemVeiculo:
          $ref: '#/components/schemas/PropostaGarantiaBemVeiculoDTO'
        propostaGarantiaBemRural:
          $ref: '#/components/schemas/PropostaGarantiaBemRuralDTO'
      additionalProperties: false
    ParametroDTO:
      type: object
      properties:
        nome:
          type: string
          description: Refere-se ao nome do parâmetro.
          nullable: true
        valor:
          type: string
          description: Refere-se ao valor do parâmetro.
          nullable: true
      additionalProperties: false
    Message:
      type: object
      properties:
        messageType:
          $ref: '#/components/schemas/ErrorType'
        code:
          type: string
          nullable: true
        context:
          type: string
          nullable: true
        description:
          type: string
          nullable: true
        field:
          type: string
          nullable: true
      additionalProperties: false
    CreateUpdateResponse:
      type: object
      properties:
        msg:
          type: string
          nullable: true
        result:
          type: boolean
          writeOnly: true
        hasError:
          type: boolean
        messages:
          type: array
          items:
            $ref: '#/components/schemas/Message'
          nullable: true
        codigo:
          type: string
          format: uuid
        numero:
          type: integer
          format: int64
      additionalProperties: false
    PropostaGarantiaBemFinanDTO:
      required:
        - nroBanco
        - tipoConta
      type: object
      properties:
        codigo:
          type: string
          description: Identificador único do bem de garantia da proposta.
          format: uuid
        numeroEC:
          maxLength: 50
          minLength: 1
          type: string
          description: Código de estabelecimento para recebíveis de cartão.
          nullable: true
        seuNumero:
          maxLength: 20
          minLength: 1
          type: string
          description: Número de controle do parceiro.
          nullable: true
        dtPrimVencDuplic:
          type: string
          description: Data do primeiro vencimento da duplicata.
          format: date-time
          nullable: true
        dtUltVencDuplic:
          type: string
          description: Data do último vencimento da duplicata.
          format: date-time
          nullable: true
        razaoSocial:
          maxLength: 60
          minLength: 1
          type: string
          description: Razão Social da empresa.
          nullable: true
        cnpj:
          maxLength: 20
          minLength: 1
          type: string
          description: CNPJ da empresa.
          nullable: true
        percCotasGarantia:
          maximum: 99999999.9
          minimum: 0
          type: number
          description: Percentual de cotas da garantia.
          format: double
          nullable: true
        vlrCapitalSocial:
          maximum: 99999999.9
          minimum: 0
          type: number
          description: Valor do Capital Social.
          format: double
          nullable: true
        nomeFundo:
          maxLength: 60
          minLength: 1
          type: string
          description: Nome do fundo.
          nullable: true
        cnpjFundo:
          maxLength: 20
          minLength: 1
          type: string
          description: CNPJ do fundo.
          nullable: true
        qtdeCotasFundo:
          maximum: 99999999.9
          minimum: 0
          type: number
          description: Quantidade de cotas do fundo.
          format: double
          nullable: true
        qtdeCotasGarantiaFundo:
          maximum: 99999999.9
          minimum: 0
          type: number
          description: Quantidade de cotas do fundo de garantia.
          format: double
          nullable: true
        vlrCotasFundo:
          maximum: 99999999.9
          minimum: 0
          type: number
          description: Valor das cotas do fundo.
          format: double
          nullable: true
        dtTravaCarencia:
          type: string
          description: Data de carência da trava.
          format: date-time
          nullable: true
        nomeLocador:
          maxLength: 60
          minLength: 1
          type: string
          description: Nome do locador.
          nullable: true
        documentoFederalLocador:
          maxLength: 20
          minLength: 1
          type: string
          description: Documento federal do locador.
          nullable: true
        nomeLocatario:
          maxLength: 60
          minLength: 1
          type: string
          description: Nome do locatário.
          nullable: true
        documentoFederalLocatario:
          maxLength: 20
          minLength: 1
          type: string
          description: Documento federal do locatário.
          nullable: true
        dtInicioLocacao:
          type: string
          description: Data de início da locação.
          format: date-time
          nullable: true
        dtTerminoLocacao:
          type: string
          description: Data de término da locação.
          format: date-time
          nullable: true
        moedaVirtual:
          type: boolean
          description: Indica se o bem é moeda virtual.
          nullable: true
        nroBanco:
          maxLength: 5
          minLength: 1
          type: string
          description: Número do banco.
          nullable: true
        tipoConta:
          maximum: 9999
          minimum: 0
          type: integer
          description: Tipo de conta.
          format: int32
          nullable: true
        agencia:
          maxLength: 10
          minLength: 1
          type: string
          description: Agência.
          nullable: true
        agenciaDig:
          maxLength: 1
          minLength: 1
          type: string
          description: Dígito da agência.
          nullable: true
        conta:
          maxLength: 20
          minLength: 1
          type: string
          description: Conta.
          nullable: true
        contaDig:
          maxLength: 1
          minLength: 1
          type: string
          description: Dígito da conta.
          nullable: true
        titularidade:
          maxLength: 60
          minLength: 1
          type: string
          description: Indica o titular da cota.
          nullable: true
        propostaGarantiaBemFinanCartao:
          type: array
          items:
            $ref: '#/components/schemas/PropostaGarantiaBemFinanCartaoDTO'
          nullable: true
        propostaGarantiaBemFinanSocio:
          type: array
          items:
            $ref: '#/components/schemas/PropostaGarantiaBemFinanSocioDTO'
          nullable: true
      additionalProperties: false
    PropostaGarantiaBemImovelDTO:
      type: object
      properties:
        codigo:
          type: string
          description: Identificador único do documento do bem de garantia da proposta.
          format: uuid
        cep:
          maxLength: 8
          minLength: 1
          type: string
          description: Código de Endereçamento Postal.
          nullable: true
        logradouro:
          maxLength: 100
          minLength: 1
          type: string
          description: Nome do logradouro.
          nullable: true
        nroLogradouro:
          maxLength: 15
          minLength: 1
          type: string
          description: Número do logradouro.
          nullable: true
        bairro:
          maxLength: 50
          minLength: 1
          type: string
          description: Bairro.
          nullable: true
        complemento:
          maxLength: 50
          minLength: 1
          type: string
          description: Complemento.
          nullable: true
        cidade:
          maxLength: 40
          minLength: 1
          type: string
          description: Cidade.
          nullable: true
        uf:
          maxLength: 2
          minLength: 1
          type: string
          description: Unidade federal (UF).
          nullable: true
        possuiRegistroCartorio:
          type: boolean
          description: Informa se possui registro em cartório.
          nullable: true
        nomeCartorio:
          maxLength: 60
          minLength: 1
          type: string
          description: Nome do cartório.
          nullable: true
        nroMatricula:
          maxLength: 20
          minLength: 1
          type: string
          description: Número de matrícula.
          nullable: true
        nroCIBNirf:
          maxLength: 20
          minLength: 1
          type: string
          description: >-
            Número referente ao antigo número de cadastro de imóvel rural
            (NIRF), atual CIB (Cadastro Imobiliário Brasileiro).
          nullable: true
        nroCEICNO:
          maxLength: 20
          minLength: 1
          type: string
          description: >-
            Número referente ao antigo Cadastro Específico do INSS (CEI), atual
            Cadastro Nacional de Obras (CNO).
          nullable: true
        qtdArea:
          maximum: 99999999.9
          minimum: 1
          type: number
          description: Medida da área do imóvel.
          format: double
          nullable: true
        unidMedidaArea:
          maxLength: 10
          minLength: 1
          type: string
          description: Unidade de medida da área.
          nullable: true
      additionalProperties: false
    PropostaGarantiaBemMovelDTO:
      type: object
      properties:
        codigo:
          type: string
          description: Identificador único do documento do bem de garantia da proposta.
          format: uuid
        nroRegistro:
          maxLength: 60
          minLength: 1
          type: string
          description: Número de registro
          nullable: true
        localizacaoPais:
          maxLength: 50
          minLength: 1
          type: string
          description: País de localização do móvel
          nullable: true
        nroSerie:
          maxLength: 30
          minLength: 1
          type: string
          description: Número de série do móvel
          nullable: true
        nroNotaFiscal:
          maxLength: 30
          minLength: 1
          type: string
          description: Número da nota fiscal
          nullable: true
        chaveNFe:
          maxLength: 50
          minLength: 1
          type: string
          description: Chave referente à Nota Fiscal Eletrônica.
          nullable: true
        marca:
          maxLength: 100
          minLength: 1
          type: string
          description: Marca do móvel
          nullable: true
        modelo:
          maxLength: 100
          minLength: 1
          type: string
          description: Modelo do móvel
          nullable: true
      additionalProperties: false
    PropostaGarantiaBemVeiculoDTO:
      type: object
      properties:
        codigo:
          type: string
          description: Identificador único do documento do bem de garantia da proposta.
          format: uuid
        placa:
          maxLength: 10
          minLength: 1
          type: string
          description: Placa do veículo
          nullable: true
        marca:
          maxLength: 30
          minLength: 1
          type: string
          description: Marca do veículo
          nullable: true
        modelo:
          maxLength: 30
          minLength: 1
          type: string
          description: Modelo de fabricação
          nullable: true
        versaoModelo:
          maxLength: 50
          minLength: 1
          type: string
          description: Versão do modelo do veículo
          nullable: true
        anoFab:
          maximum: 9999
          minimum: 1
          type: integer
          description: Ano de fabricação
          format: int32
          nullable: true
        anoMod:
          maximum: 9999
          minimum: 1
          type: integer
          description: Ano do modelo do veículo
          format: int32
          nullable: true
        cor:
          maxLength: 30
          minLength: 1
          type: string
          description: Cor do veículo
          nullable: true
        chassi:
          maxLength: 50
          minLength: 1
          type: string
          description: Número do chassi
          nullable: true
        renavam:
          maxLength: 30
          minLength: 1
          type: string
          description: Número do renavam
          nullable: true
        financiado:
          type: boolean
          description: Indica se o veículo é financiado.
          nullable: true
        saldoFinanciamento:
          maximum: 99999999.9
          minimum: 1
          type: number
          description: Valor atual de saldo do financiamento.
          format: double
          nullable: true
        tipoPlaca:
          maximum: 9999
          minimum: 1
          type: integer
          description: Tipo de placa
          format: int32
          nullable: true
        tipoVeiculo:
          maximum: 9999
          minimum: 1
          type: integer
          description: Tipo de veículo
          format: int32
          nullable: true
        ufPlaca:
          maxLength: 2
          minLength: 1
          type: string
          description: Unidade federal da placa
          nullable: true
        ufLicenciamento:
          maxLength: 2
          minLength: 1
          type: string
          description: Unidade federal do licenciamento
          nullable: true
        vlrFipe:
          maximum: 99999999.9
          minimum: 1
          type: number
          description: Valor da Fundação Instituto de Pesquisas Econômicas - Fipe.
          format: double
          nullable: true
        vlrVeiculo:
          maximum: 99999999.99
          minimum: 0
          type: number
          description: Valor do veiculo.
          format: double
          nullable: true
        periodoFipe:
          maxLength: 7
          minLength: 1
          type: string
          description: Período da Fundação Instituto de Pesquisas Econômicas - Fipe.
          nullable: true
        zeroKM:
          type: boolean
          description: Indica se o veículo possui zero quilômetros rodados.
          nullable: true
        frota:
          type: boolean
          description: Indica se o veículo pertence a uma frota.
          nullable: true
        tipoChassi:
          maximum: 9999
          minimum: 1
          type: integer
          description: Tipo de chassi
          format: int32
          nullable: true
        tipoRestricaoGravame:
          maximum: 9999
          minimum: 1
          type: integer
          description: Tipo de restrição do Gravame.
          format: int32
          nullable: true
        dtRestricaoGravame:
          type: string
          description: Data de restrição do Gravame.
          format: date-time
          nullable: true
        codigoFipe:
          maxLength: 30
          minLength: 1
          type: string
          description: Código da Fundação Instituto de Pesquisas Econômicas - Fipe.
          nullable: true
        km:
          maximum: 9999
          minimum: 1
          type: integer
          description: Valor da quilometragem do veículo.
          format: int32
          nullable: true
      additionalProperties: false
    PropostaGarantiaBemRuralDTO:
      type: object
      properties:
        codigo:
          type: string
          format: uuid
        indicaProcessoGarantia:
          type: string
          nullable: true
        propostaGarantiaBemRuralProduto:
          type: array
          items:
            $ref: '#/components/schemas/PropostaGarantiaBemRuralProdutoDTO'
          nullable: true
        propostaGarantiaBemRuralLocal:
          type: array
          items:
            $ref: '#/components/schemas/PropostaGarantiaBemRuralLocalDTO'
          nullable: true
      additionalProperties: false
    ErrorType:
      enum:
        - 1
        - 2
        - 3
      type: integer
      format: int32
    PropostaGarantiaBemFinanCartaoDTO:
      type: object
      properties:
        codigo:
          type: string
          description: Identificador único do bem de garantia da proposta.
          format: uuid
        credenciadora:
          maxLength: 60
          minLength: 1
          type: string
          description: Identificador da credenciadora do cartão.
          nullable: true
        subCredenciadora:
          maxLength: 60
          minLength: 1
          type: string
          description: >-
            Identificador da subcredenciadora do cartão, que age como
            intermediária entre a credenciadora e o estabelecimento.
          nullable: true
        arranjo:
          maxLength: 60
          minLength: 1
          type: string
          description: Identificador do arranjo do cartão.
          nullable: true
        percArranjo:
          maximum: 99999999.9
          minimum: 0
          type: number
          description: Percentual do arranjo do cartão.
          format: double
          nullable: true
      additionalProperties: false
    PropostaGarantiaBemFinanSocioDTO:
      type: object
      properties:
        codigo:
          type: string
          description: Identificador único do bem de garantia da proposta.
          format: uuid
        documentoFederal:
          maxLength: 20
          minLength: 1
          type: string
          description: Documento federal do sócio.
          nullable: true
        nome:
          maxLength: 60
          minLength: 1
          type: string
          description: Nome do sócio.
          nullable: true
        qtdeCotas:
          maximum: 99999999.9
          minimum: 0
          type: number
          description: Quantidade de cotas do sócio.
          format: double
          nullable: true
        vlrCotas:
          maximum: 99999999.9
          minimum: 0
          type: number
          description: Valor das cotas do sócio.
          format: double
          nullable: true
        percCotas:
          maximum: 99999999.9
          minimum: 0
          type: number
          description: Percentual de cotas do sócio.
          format: double
          nullable: true
      additionalProperties: false
    PropostaGarantiaBemRuralProdutoDTO:
      type: object
      properties:
        codigo:
          type: string
          format: uuid
        codigoProduto:
          type: string
          nullable: true
        classeProduto:
          type: string
          nullable: true
        safraProduto:
          type: string
          nullable: true
        caracteristicaProduto:
          type: string
          nullable: true
        quantidadeProduto:
          type: integer
          format: int32
          nullable: true
        statusProduto:
          type: integer
          format: int32
        tipoProducao:
          type: integer
          format: int32
      additionalProperties: false
    PropostaGarantiaBemRuralLocalDTO:
      type: object
      properties:
        codigo:
          type: string
          format: uuid
        descricaoLocal:
          type: string
          nullable: true
        cartorio:
          type: string
          nullable: true
        matriculaImovel:
          type: string
          nullable: true
        municipio:
          type: string
          nullable: true
        uf:
          type: string
          nullable: true
        cep:
          type: string
          nullable: true
        logradouro:
          type: string
          nullable: true
        nroLogradouro:
          type: string
          nullable: true
        bairro:
          type: string
          nullable: true
        complemento:
          type: string
          nullable: true
      additionalProperties: false
  securitySchemes:
    Bearer:
      type: apiKey
      description: Informe o token
      name: Authorization
      in: header

````