Common Format

7 min

product common format the common format for each product is as follows true 166 unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type the common format example { "code" 200, "message" "ok", "requestid" "112334", "productname" "pf categorized checking l2", "productversion" "v1", "productreportid" "4b2c1648 231f 11eb 97c4 f45c899f4587", "productreporttime" "2019 12 23t06 10 43", "enquirycpf" "25872252137", "links" \[ "link and its corresponding consent list data will be here" ], "product" { "product data will be here, this example is pf categorized checking l2" }, "externalinfo" { "externalinfos list data will be here" } } the links array example \[ { "linkid" "gpukxrcju05j4k", "institutionid" "033", "consents" \[ { "consentid" "f55c899f 11eb 231f 97c4 4b2c16484587", "permissions" { "registration all" { "permisiongranted"\ true, "accountids" \[ "123456" ] } } }, { "consentid" "b45c899f 11eb 231f 97c4 4b2c16484589", "permissions" { "accounts all" { "permisiongranted"\ true, "accountids" \[ "234567" ] } } } ] }, { "linkid" "0pukxrcju05j4k", "institutionid" "031", "consents" \[ { "consentid" "f55c899f 11eb 231f 97c4 4b2c16484587", "permissions" { "credit cards all" { "permisiongranted"\ true, "accountids" \[ "123456" ] } } } ] } ] product reports are divided into institution level and user level institutional level product report by default, the shared data is obtained through the permissions in the most recent consent and a report is generated based on it; user level product report by default, the shared data is obtained through the most widely permission in consent( scope all consentid in multiple apps under the same partner), and a report is generated based on it; the above default rules do not include situations where you actively request specific linkid or consentid reports through apis the product object example the specific product data structure can be found in the open finance data and open data sections later in this section pf categorized checking l2 example \[ { "brandname" "organização a", "companycnpj" "21128159000166", "type" "conta deposito a vista", "compecode" "001", "branchcode" "6272", "number" "94088392", "checkdigit" "4", "civilname" "mike", "subtype" "individual", "currency" "brl", "balances" { "availableamount" { "amount" "1000 0400", "currency" "brl" }, "blockedamount" { "amount" "1000 0400", "currency" "brl" } }, "transactions" \[ { "transactionid" "txprmu9uqtromwhzv2xsu1fuazjsmdl", "completedauthorisedpaymenttype" "transacao efetivada", "creditdebittype" "debito", "transactionname" "transfcwar5txhcx5i9idbhml8082n8neo30m6lnng7anayijyrm00zbzpu8", "type" "pix", "transactionamount" { "amount" "1000 0400", "currency" "brl" }, "transactiondate" "2021 01 07", "transactiondatetime" "2016 01 29t12 29 03 374z", "partiecnpjcpf" "43908445778", "partiepersontype" "pessoa natural", "partiecompecode" "001", "partiebranchcode" "6272", "partienumber" "67890854360", "partiecheckdigit" "4", "posttransactionbalance" "10", "category" "renda", "subcategory" "renda ativa" } ] } ] in order to accurately express the meaning of different products, different product keys are different it is recommended to define different structures according to different products during the development process the externalinfo object example this object only exists in the case of a docid\ qz1htubte2jspyqb0b82x if you request a report through the request product api, this object will not exist because in user level reports, the system update data based on the most extensive permissions consent, and it is no longer important which linkid created that permission you can associate through requestid { "mytraceid" "yourtraceid 1", "myuuid" "youruuid 1" } complete example { "code" 200, "message" "ok", "requestid" "112334", "productname" "pf categorized checking l2", "productversion" "v1", "productreportid" "4b2c1648 231f 11eb 97c4 f45c899f4587", "productreporttime" "2019 12 23t06 10 43", "enquirycpf" "25872252137", "links" \[ { "linkid" "gpukxrcju05j4k", "institutionid" "033", "consents" \[ { "consentid" "f55c899f 11eb 231f 97c4 4b2c16484587", "permissions" { "registration all" { "permisiongranted"\ true, "accountids" \[ "123456" ] } } }, { "consentid" "b45c899f 11eb 231f 97c4 4b2c16484589", "permissions" { "accounts all" { "permisiongranted"\ true, "accountids" \[ "234567" ] } } } ] }, { "linkid" "0pukxrcju05j4k", "institutionid" "031", "consents" \[ { "consentid" "f55c899f 11eb 231f 97c4 4b2c16484587", "permissions" { "credit cards all" { "permisiongranted"\ true, "accountids" \[ "123456" ] } } } ] } ], "product" { }, "externalinfo" { "mytraceid" "yourtraceid 1", "myuuid" "youruuid 1" } }