--- title: "Create a AR Customer" slug: "create-a-ar-customer" updated: 2026-05-26T12:53:14Z published: 2026-05-26T12:53:48Z canonical: "developers.cmicglobal.com/create-a-ar-customer" --- > ## Documentation Index > Fetch the complete documentation index at: https://developers.cmicglobal.com/llms.txt > Use this file to discover all available pages before exploring further. # Create a AR Customer Post/ar-rest-api/rest/1/arcustomer ## Create Customers UI Location: Financials - Accounts Recievable - Setup - Maintain Customers ### SecurityHTTPType basic Basic authentication Header parametersContent-TypestringExampleapplication/vnd.oracle.adf.resourceItem+json Body parametersobject Example{ "BpcustBpCode": "ALDO", "BpcustCompCode": "001", "BpcustBpCodeBf": "ALDOT", "BpcustCollCode": "ACCT", "BpcustTermCode": "NET30", "BpcustCurrCode": "USD", "BpcustChargeCode": "NA", "BpcustArDeptCode": "00", "BpcustArAccCode": "11011", "BpcustCashDeptCode": "00", "BpcustCashAccCode": "10001", "BpcustSalesDeptCode": "00", "BpcustSalesAccCode": "40001", "BpcustDiscDeptCode": "00", "BpcustDiscAccCode": "73003", "BpcustHldbkDeptCode": "00", "BpcustHldbkAccCode": "11012", "BpcustFrtDeptCode": "00", "BpcustFrtAccCode": "40020", "BpcustInsDeptCode": "00", "BpcustInsAccCode": "40020", "BpcustMiscDeptCode": "00", "BpcustMiscAccCode": "40020", "BpcustVUuid": "" }BpcustCollCodestring Required Collector Code 💻 UI Fieldname: *Collector Max length4 BpcustHldbkAccCodestring Required Retainage Account Code Max length16 BpcustFrtDeptCodestring Required Freight Charges Department Code Max length6 BpcustSalesAccCodestring Required Sales Account Code Max length16 BpcustTermCodestring Required Terms Code 💻 UI Fieldname: *Terms Max length6 BpcustCashDeptCodestring Required Bank Account Department Code Max length6 BpcustFrtAccCodestring Required Freight Charges Account Code Max length16 BpcustBpCodestring Required Business Partner Code Max length8 BpcustHldbkDeptCodestring Required Retainage Department Code Max length6 BpcustChargeCodestring Required Interest Charge Code Max length3 BpcustInsDeptCodestring Required Insurance Charges Department Code Max length6 BpcustMiscDeptCodestring Required Miscellaneous Charges Department Code Max length6 BpcustVUuidstring Required UNIQUE UUID of column Max length64 BpcustCompCodestring Required Company code Max length8 BpcustDiscDeptCodestring Required Discount Department Code Max length6 BpcustBpCodeBfstring Required Business Partner Code 💻 UI Fieldname: Customer Max length8 BpcustInsAccCodestring Required Insurance Charges Account Code Max length16 BpcustArAccCodestring Required Accounts Receivable Control Account Code Max length16 BpcustSalesDeptCodestring Required Sales Department Code Max length6 BpcustArDeptCodestring Required Accounts Receivable Department Code Max length6 BpcustCashAccCodestring Required Bank Account Code Max length16 BpcustMiscAccCodestring Required Misceallenous Charges Account Code Max length16 BpcustDiscAccCodestring Required Discount Account Code Max length16 BpcustCurrCodestring Required Currency Code Max length3 BpcustInsDeptNamestring Insurance Charges Department Name Max length30 BpcustJbBillTypeNamestring Default Job Billing Type Name Max length60 BpcustChargeNamestring Interest Charge Name Max length30 BpcustTax1Namestring Tax1 Name Max length30 BpcustShipRegionCodestring Shipping State/Province Code Max length3 BpcustBankNamestring Customer Bank Name (EFT) Max length30 BpcustDiscAccNamestring Discount Account Name Max length30 BpcustDeliveryDiscPcnumber Delivery Charge Discount Percentage Max length7 BpcustBpccCodestring Customer Credit Code Max length10 BpcustAvgDaysToPayInvnumber Average days to pay weighted by payed amount, for a customer based on his invoice payment history within the cut-off days viz. da.arctrl.arctrl_days_to_pay_cut_off_days. Max length6 BpcustShipFaxstring Shipping Fax Number Max length20 BpcustJbBillRateTableCodestring Default Job Billing Rate Code. Max length10 BpcustHldbkDeptNamestring Retainage Department Name Max length30 BpcustTax2Codestring Tax Code 2 Max length11 BpcustSalesDeptNamestring Sales Department Name Max length30 BpcustClassNamestring Class Name Max length30 BpcustShipCountrystring Shipping Country Name Max length30 BpcustIuUpdateDatestring Last Update Date BpcustStatementFlagstring Are Statements required for this customer Y/N Max length1 BpcustLastUpdateDatestring Last date record updated BpcustTranAllowFlagstring Allow transactions against this customer Y/N Max length1 BpcustDaysOutstInvPaidTtlnumber Not Used, You May Leave Blank Max length10 BpcustIuCreateDatestring Initial Create Date BpcustMiscDeptNamestring Miscellaneous Charges Department Name Max length30 BpcustFrtAccNamestring Freight Charges Account Name Max length30 BpcustJbInvFormatCodestring Default Job Billing Invoice Format Code. Max length4 BpcustCreditHoldFlagstring Reference column, update through Workflow process if aging > xx days then set to 'Y' Max length1 BpcustBankAccNum2string Customer Bank Account Number (EFT) Max length17 BpcustBillRegionCodestring Billing State/Province Code 💻 UI Fieldname: State Max length3 BpcustBankAccNum3string Customer Bank Suffix (EFT) Max length12 BpcustObjectOraseqnumber Oraseq Num for Notes Attachment by da.dbk_sys_info.oraseq BpcustMsPropagateCompFlagstring Material Sales Propagate Company Exist Flag, If Found (Y) Else (N) Max length1 BpcustShipContactNamestring Shipping Contact Name Max length30 BpcustShipEmailstring Shipping Email Address Max length80 BpcustShipAdd1string Shipping Address Line 1 Max length40 BpcustInsAccNamestring Insurance Charges Account Name Max length30 BpcustBankAccNum1string Customer Bank Transit Number (EFT) Max length9 BpcustShipAdd3string Shipping Address Line 3 Max length40 BpcustShipAdd2string Shippiing Address Line 2 Max length40 BpcustDunnFlagstring Are dunning letters to be send to the customer Y/N Max length1 BpcustJbInvFormatNamestring Default Job Billing Invoice Format Name Max length60 BpcustTax3Codestring Tac Code 3 Max length11 BpcustFullyPaidInvsnumber ? Max length10 BpcustShipRegionNamestring Region Name Max length30 BpcustJbretrNamestring Default Retainage Name Max length60 BpcustBillFaxstring Billling Fax Number 💻 UI Fieldname: Fax Max length20 BpcustArAccNamestring Accounts Receivable Control Account Name Max length30 BpcustActiveToDatestring Not Used BpcustJbMapNamestring Default Job Billing Map Name Max length60 BpcustCashAccNamestring Bank Account Name Max length30 BpcustCurrNamestring Currency Name Max length30 BpcustTax2Namestring Tax2 Name Max length30 BpcustMiscAccNamestring Misceallenous Charges Account Name Max length30 BpcustArDeptNamestring Accounts Receivable Department Name Max length30 BpcustActiveFlagstring Indicates if the customer is active - Valid values are 0,1 or null 💻 UI Fieldname: Active Flag Max length1 BpcustBillCountrystring Billing Country Name 💻 UI Fieldname: Country Max length30 BpcustDiscPcnumber Discount Percent (overrides Terms Code) Max length7 BpcustSalesmanCodestring Employee Code for the Salesman Max length16 BpIuCreateDatetimestring Initial Create Timestamp Max length6 BpcustClassCodestring Class code 💻 UI Fieldname: Class Max length4 BpcustFrtDeptNamestring Freight Charges Department Name Max length30 BpcustBillContactNamestring Billing Contact Name 💻 UI Fieldname: Attention Max length30 BpcustArStatementEmailFlagstring Ar statement Email Addresses Flag 💻 UI Fieldname: Email AR Statement Max length1 BpcustBankCodestring Customer Bank Code (EFT) Max length9 BpcustTruckerPayDiscPcnumber Trucker Pay Discount Percentage Max length7 BpcustJbBillTypeCodestring Default Job Billing Type Code. Max length4 BpcustArStatementEmailAddstring Ar statement Email Addresses string Max length4000 BpcustShipPhonestring Shipping Phone Number Max length20 BpcustBillPhonestring Billling Phone Number 💻 UI Fieldname: Phone Max length20 BpcustCrLimitAmtnumber Credit Limit Max length18 BpcustSalesAccNamestring Sales Account Name Max length30 BpcustTax1Codestring Tax Code 1 Max length11 BpcustCollNamestring Collector Name Max length30 BpcustBillAdd2string Billing Address Line 2 💻 UI Fieldname: Suite Max length40 BpcustBillAdd1string Billing Address Line 1 💻 UI Fieldname: Street Address Max length40 BpcustHldbkAccNamestring Retainage Account Name Max length30 BpcustBillAdd3string Billing Address Line 3 💻 UI Fieldname: City Max length40 BpcustIuCreateDatetimestring Initial Create Timestamp Max length6 BpcustBillPostalCodestring Billiing ZIP/Postal Code 💻 UI Fieldname: ZIP / Postal Code Max length12 BpcustActiveFromDatestring Not Used BpcustJbInvGroupCodestring Default Job Billing Invoice Link Code. Max length10 BpcustInvDeliqnumber ? Max length10 BpcustJbBillRateTableNamestring Default Job Billing Rate Name Max length60 BpcustJbretrCodestring Default Retainage Code. Max length10 BpcustCompNamestring Company Name Max length30 BpcustWebSitestring Web site of the customer 💻 UI Fieldname: Web Site Max length200 BpcustJbMapCodestring Default Job Billing Map Code. Max length10 BpcustLastUpdateUserstring Last user that updated record Max length30 BpcustShipPostalCodestring Shipping Zip/Postal Code Max length12 BpcustIuUpdateDatetimestring Last Update Timestamp Max length6 BpcustAllocApdiscJobFlagstring Allocate AP Discounts to Job Flag Y/N Max length1 BpcustBpNameBfstring Business Partner Name Max length50 BpcustDiscDeptNamestring Discount Department Name Max length30 BpcustBpccOraseqnumber Customer Credit Code Oraseq BpcustLastInvDatestring Not Used BpcustBillRegionNamestring Billing State/Province Name Max length30 BpcustTax3Namestring Tax3 Name Max length30 BpIuUpdateDatetimestring Last Update Timestamp Max length6 BpcustTermNamestring Terms Name Max length30 BpcustBpNamestring Business Partner Name Max length50 BpcustTaxedCodestring Is this customer tax exempt Y/N Max length1 BpcustBillEmailstring Billing Email Number 💻 UI Fieldname: E-mail Max length80 BpcustTenantIdstring Max length30 BpcustHldbkPcnumber Retainage Percent (overrides Terms Code) Max length7 BpcustCashDeptNamestring Bank Account Department Name Max length30 Responses201 Created HeadersContent-TypestringExampleapplication/vnd.oracle.adf.resourceitem+json example-0 Successful Response ```json { "BpIuCreateDatetime": null, "BpIuUpdateDatetime": null, "BpcustActiveFlag": null, "BpcustActiveFromDate": null, "BpcustActiveToDate": null, "BpcustAllocApdiscJobFlag": null, "BpcustArAccCode": "11011", "BpcustArAccName": null, "BpcustArDeptCode": "00", "BpcustArDeptName": null, "BpcustArStatementEmailAdd": null, "BpcustArStatementEmailFlag": null, "BpcustAvgDaysToPayInv": null, "BpcustBankAccNum1": null, "BpcustBankAccNum2": null, "BpcustBankAccNum3": null, "BpcustBankCode": null, "BpcustBankName": null, "BpcustBillAdd1": null, "BpcustBillAdd2": null, "BpcustBillAdd3": null, "BpcustBillContactName": null, "BpcustBillCountry": null, "BpcustBillEmail": null, "BpcustBillFax": null, "BpcustBillPhone": null, "BpcustBillPostalCode": null, "BpcustBillRegionCode": null, "BpcustBillRegionName": null, "BpcustBpCode": "ALDO", "BpcustBpCodeBf": "ALDOT", "BpcustBpName": null, "BpcustBpNameBf": null, "BpcustBpccCode": null, "BpcustBpccOraseq": null, "BpcustCashAccCode": "10001", "BpcustCashAccName": null, "BpcustCashDeptCode": "00", "BpcustCashDeptName": null, "BpcustChargeCode": "NA", "BpcustChargeName": null, "BpcustClassCode": null, "BpcustClassName": null, "BpcustCollCode": "ACCT", "BpcustCollName": null, "BpcustCompCode": "001", "BpcustCompName": null, "BpcustCrLimitAmt": null, "BpcustCurrCode": "USD", "BpcustCurrName": null, "BpcustDaysOutstInvPaidTtl": null, "BpcustDeliveryDiscPc": null, "BpcustDiscAccCode": "73003", "BpcustDiscAccName": null, "BpcustDiscDeptCode": "00", "BpcustDiscDeptName": null, "BpcustDiscPc": null, "BpcustDunnFlag": null, "BpcustFrtAccCode": "40020", "BpcustFrtAccName": null, "BpcustFrtDeptCode": "00", "BpcustFrtDeptName": null, "BpcustFullyPaidInvs": null, "BpcustHldbkAccCode": "11012", "BpcustHldbkAccName": null, "BpcustHldbkDeptCode": "00", "BpcustHldbkDeptName": null, "BpcustHldbkPc": null, "BpcustInsAccCode": "40020", "BpcustInsAccName": null, "BpcustInsDeptCode": "00", "BpcustInsDeptName": null, "BpcustInvDeliq": null, "BpcustIuCreateDate": null, "BpcustIuCreateDatetime": null, "BpcustIuUpdateDate": null, "BpcustIuUpdateDatetime": null, "BpcustJbBillRateTableCode": null, "BpcustJbBillRateTableName": null, "BpcustJbBillTypeCode": null, "BpcustJbBillTypeName": null, "BpcustJbInvFormatCode": null, "BpcustJbInvFormatName": null, "BpcustJbInvGroupCode": null, "BpcustJbMapCode": null, "BpcustJbMapName": null, "BpcustJbretrCode": null, "BpcustJbretrName": null, "BpcustLastInvDate": null, "BpcustLastUpdateDate": null, "BpcustMiscAccCode": "40020", "BpcustMiscAccName": null, "BpcustMiscDeptCode": "00", "BpcustMiscDeptName": null, "BpcustMsPropagateCompFlag": null, "BpcustObjectOraseq": null, "BpcustSalesAccCode": "40001", "BpcustSalesAccName": null, "BpcustSalesDeptCode": "00", "BpcustSalesDeptName": null, "BpcustSalesmanCode": null, "BpcustShipAdd1": null, "BpcustShipAdd2": null, "BpcustShipAdd3": null, "BpcustShipContactName": null, "BpcustShipCountry": null, "BpcustShipEmail": null, "BpcustShipFax": null, "BpcustShipPhone": null, "BpcustShipPostalCode": null, "BpcustShipRegionCode": null, "BpcustShipRegionName": null, "BpcustStatementFlag": null, "BpcustTax1Code": null, "BpcustTax1Name": null, "BpcustTax2Code": null, "BpcustTax2Name": null, "BpcustTax3Code": null, "BpcustTax3Name": null, "BpcustTaxedCode": null, "BpcustTermCode": "NET30", "BpcustTermName": null, "BpcustTranAllowFlag": null, "BpcustTruckerPayDiscPc": null, "BpcustVUuid": "F22A4B6D2DBE6D88E05316821FAC7B73", "BpcustWebSite": null, "links": [ { "rel": "self", "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/ar-rest-api/rest/1/arcustomer/F22A4B6D2DBE6D88E05316821FAC7B73", "name": "arcustomer", "kind": "item" }, { "rel": "canonical", "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/ar-rest-api/rest/1/arcustomer/F22A4B6D2DBE6D88E05316821FAC7B73", "name": "arcustomer", "kind": "item" } ] } ``` example-1 Successful Response ```json { "BpIuCreateDatetime": null, "BpIuUpdateDatetime": null, "BpcustActiveFlag": null, "BpcustActiveFromDate": null, "BpcustActiveToDate": null, "BpcustAllocApdiscJobFlag": null, "BpcustArAccCode": "11011", "BpcustArAccName": null, "BpcustArDeptCode": "00", "BpcustArDeptName": null, "BpcustArStatementEmailAdd": null, "BpcustArStatementEmailFlag": null, "BpcustAvgDaysToPayInv": null, "BpcustBankAccNum1": null, "BpcustBankAccNum2": null, "BpcustBankAccNum3": null, "BpcustBankCode": null, "BpcustBankName": null, "BpcustBillAdd1": null, "BpcustBillAdd2": null, "BpcustBillAdd3": null, "BpcustBillContactName": null, "BpcustBillCountry": null, "BpcustBillEmail": null, "BpcustBillFax": null, "BpcustBillPhone": null, "BpcustBillPostalCode": null, "BpcustBillRegionCode": null, "BpcustBillRegionName": null, "BpcustBpCode": "ALDO", "BpcustBpCodeBf": "ALDOT", "BpcustBpName": null, "BpcustBpNameBf": null, "BpcustBpccCode": null, "BpcustBpccOraseq": null, "BpcustCashAccCode": "10001", "BpcustCashAccName": null, "BpcustCashDeptCode": "00", "BpcustCashDeptName": null, "BpcustChargeCode": "NA", "BpcustChargeName": null, "BpcustClassCode": null, "BpcustClassName": null, "BpcustCollCode": "ACCT", "BpcustCollName": null, "BpcustCompCode": "001", "BpcustCompName": null, "BpcustCrLimitAmt": null, "BpcustCurrCode": "USD", "BpcustCurrName": null, "BpcustDaysOutstInvPaidTtl": null, "BpcustDeliveryDiscPc": null, "BpcustDiscAccCode": "73003", "BpcustDiscAccName": null, "BpcustDiscDeptCode": "00", "BpcustDiscDeptName": null, "BpcustDiscPc": null, "BpcustDunnFlag": null, "BpcustFrtAccCode": "40020", "BpcustFrtAccName": null, "BpcustFrtDeptCode": "00", "BpcustFrtDeptName": null, "BpcustFullyPaidInvs": null, "BpcustHldbkAccCode": "11012", "BpcustHldbkAccName": null, "BpcustHldbkDeptCode": "00", "BpcustHldbkDeptName": null, "BpcustHldbkPc": null, "BpcustInsAccCode": "40020", "BpcustInsAccName": null, "BpcustInsDeptCode": "00", "BpcustInsDeptName": null, "BpcustInvDeliq": null, "BpcustIuCreateDate": null, "BpcustIuCreateDatetime": null, "BpcustIuUpdateDate": null, "BpcustIuUpdateDatetime": null, "BpcustJbBillRateTableCode": null, "BpcustJbBillRateTableName": null, "BpcustJbBillTypeCode": null, "BpcustJbBillTypeName": null, "BpcustJbInvFormatCode": null, "BpcustJbInvFormatName": null, "BpcustJbInvGroupCode": null, "BpcustJbMapCode": null, "BpcustJbMapName": null, "BpcustJbretrCode": null, "BpcustJbretrName": null, "BpcustLastInvDate": null, "BpcustLastUpdateDate": null, "BpcustMiscAccCode": "40020", "BpcustMiscAccName": null, "BpcustMiscDeptCode": "00", "BpcustMiscDeptName": null, "BpcustMsPropagateCompFlag": null, "BpcustObjectOraseq": null, "BpcustSalesAccCode": "40001", "BpcustSalesAccName": null, "BpcustSalesDeptCode": "00", "BpcustSalesDeptName": null, "BpcustSalesmanCode": null, "BpcustShipAdd1": null, "BpcustShipAdd2": null, "BpcustShipAdd3": null, "BpcustShipContactName": null, "BpcustShipCountry": null, "BpcustShipEmail": null, "BpcustShipFax": null, "BpcustShipPhone": null, "BpcustShipPostalCode": null, "BpcustShipRegionCode": null, "BpcustShipRegionName": null, "BpcustStatementFlag": null, "BpcustTax1Code": null, "BpcustTax1Name": null, "BpcustTax2Code": null, "BpcustTax2Name": null, "BpcustTax3Code": null, "BpcustTax3Name": null, "BpcustTaxedCode": null, "BpcustTermCode": "NET30", "BpcustTermName": null, "BpcustTranAllowFlag": null, "BpcustTruckerPayDiscPc": null, "BpcustVUuid": "F22A4B6D2DBE6D88E05316821FAC7B73", "BpcustWebSite": null, "links": [ { "rel": "self", "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/ar-rest-api/rest/1/arcustomer/F22A4B6D2DBE6D88E05316821FAC7B73", "name": "arcustomer", "kind": "item" }, { "rel": "canonical", "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/ar-rest-api/rest/1/arcustomer/F22A4B6D2DBE6D88E05316821FAC7B73", "name": "arcustomer", "kind": "item" } ] } ``` object