资产 - 信贷业务

---

创建 - 合同

Request

ENDPOINT

/trade_receivables/BASE_URL/assignment/EXTERNAL_ID/asset

MÉTODO

POST

Request Body

{
    "asset_type": "discounted_contract",
    "total_purchase_value": 1231.21,
    "discounted_credit_right": {
      "external_id": "mdf27za1-ra5f-46c0-a32f-fb909884dbb2",
      "originator_document_number": "46.282.154/0001-14",
      "face_value": 1231.21,
      "maturity_date": "2025-12-10",
      "installment_number": 1,
      "borrower": {
        "name": "Natália Nascimento",
        "document_number": "19.845.976/0001-93",
        "person_type": "natural_person",
        "email": "natália.nascimento@yopmail.com",
        "address": {
          "street": "Gilberto Sabino",
          "number": "215",
          "neighborhood": "Pinheiros",
          "city": "São Paulo",
          "postal_code": "05425-020",
          "uf": "SP",
          "country": "BRA"
        },
        "phone": {
          "area_code": "11",
          "number": "36360268"
        },
        "natural_person": {
          "mother_name": "Lívia Santos",
          "birthdate": "2001-01-05"
        }
      },
      "contract": {
        "number_of_installments": 5,
        "total_face_value": 1231.21,
        "number": "958431587",
        "issue_date": "2023-10-10"
      }
    }
}

定义

资产对象（Request Body）

字段	类型	描述	字符数
asset_type *	string	资产类型。	最多 50
total_purchase_value *	number	资产采购总价。即受让方实际支付的金额。	保留 2 位小数
discounted_credit_right *	object	参见 信用权利对象。	-

信用权利对象

字段	类型	描述	字符数
external_id *	string	集成合作伙伴系统中此批次的唯一标识键。	最多 50 个字符
originator_document_number *	string	促成此信贷业务的发起人/顾问的标识文件号。	格式化 CPF 或 CNPJ
maturity_date *	string	分期到期日。	格式化日期
order_number *	string	订单编号。	最多 45
face_value *	number	面值。	最多 8 位小数
borrower *	object	参见 借款人对象。	-
contract *	object	参见 合同对象。	-

借款人对象

字段	类型	描述	字符数
name *	string	借款人姓名。	最多 255
document_number *	string	借款人标识文件号。	CPF 或 CNPJ
person_type *	string	人员类型。参见 人员类型枚举值。	enumerator
email	string	借款人电子邮箱。	最多 255
address *	object	参见 地址对象。	-
phone	object	参见 电话对象。	-

人员类型枚举值

枚举值	描述
natural_person	自然人。参见 自然人对象。
legal_person	法人。参见 法人对象。

地址对象

字段	类型	描述	字符数
street *	string	如无完整信息，可将汇总信息填入此字段。	最多 255
number	string	门牌号。	最多 40
neighborhood	string	街区/社区。	最多 255
city	string	城市。	最多 255
uf	string	州/省。	2 个字符
complement	string	补充地址。	最多 255
postal_code *	string	邮政编码。	9 个字符
country	string	国家。	3 个字符

自然人对象

字段	类型	描述	字符数
birthdate	string	出生日期。	格式化日期
gender	string	参见 性别枚举值。	enumerator
mother_name	string	母亲姓名。	最多 255

性别枚举值

枚举值	描述
male	男性。
female	女性。

法人对象

字段	类型	描述	字符数
foundation_date	string	成立日期。	格式化日期
activity_code	string	经营活动代码。	-
annual_revenues	integer	年收入。	-
representatives	object	参见 法人对象。	enumerator

代表人对象

字段	类型	描述	字符数
name	string	代表人姓名。	最多 255
document_number	string	代表人标识文件号。	CPF 或 CNPJ
email	string	代表人电子邮箱。	最多 255
phone	object	参见 电话对象。	enumerator
address	object	参见 地址对象。	enumerator
person_type	string	参见 人员类型枚举值。	enumerator
representative_type	string	代表人类型。	最多 50

电话对象

字段	类型	描述	字符数
international_dial_code	string	国际区号。	最多 3
area_code	string	区号。	2 位数字
number	string	号码。	最多 10

合同对象

字段	类型	描述	字符数
number_of_installments *	integer	分期数量。	-
total_face_value *	number	合同面值。	保留 2 位小数
number *	string	合同编号。	最多 50
issue_date *	string	发行日期。	格式化日期

Response

STATUS

201

Response Body

{
    "asset_key": "41d6ff41-1dac-4df7-9e50-d15210ec57f3",
    "status": "pending_eligibility",
}