Create a AP Vendor
    • 12 Feb 2025
    • 4 Minutes to read
    • Dark
      Light

    Create a AP Vendor

    • Dark
      Light

    Article summary

    Post
    /ap-rest-api/rest/1/apvendor

    Create Vendors

    UI Location: Financials - Accounts Payable - Setup - Maintain Vendors

    Security
    HTTP
    Type basic

    Basic authentication

    Header parameters
    Content-Type
    string
    Exampleapplication/vnd.oracle.adf.resourceitem+json
    Body parameters
    object
    Example{ "BpvenCompCode": "001", "BpvenBpCode": "BP0023", "BpvenCheckMergeFlag": "N", "BpvenSpecialTermsFlag": "N", "BpvenTermCode": "NET30", "BpvenCurrCode": "CAD", "BpvenApDeptCode": "00", "BpvenApAccCode": "21015", "BpvenCashDeptCode": "00", "BpvenCashAccCode": "10101", "BpvenExpDeptCode": "00", "BpvenExpAccCode": "50050", "BpvenPpeDeptCode": "00", "BpvenPpeAccCode": "21018", "BpvenDiscDeptCode": "00", "BpvenDiscAccCode": "79020", "BpvenHldbkDeptCode": "00", "BpvenHldbkAccCode": "21017", "BpvenVUuid": "" }
    BpvenDiscAccCode
    string Required

    Vendor Discount Account Code

    Max length16
    BpvenHldbkDeptCode
    string Required

    Retainage Department Code

    Max length6
    BpvenCashAccCode
    string Required

    Vendor GL Bank Account Code

    Max length16
    BpvenPpeDeptCode
    string Required

    Pre-paid Deposit Deptartment Code

    Max length6
    BpvenTermCode
    string Required

    Vendor Terms Code

    💻 UI Fieldname: Terms

    Max length6
    BpvenCheckMergeFlag
    string Required

    Allow this vendor to merge payments with another company same vendor for check printing Y/N

    Max length1
    BpvenCurrCode
    string Required

    Vendor Currency Code

    Max length3
    BpvenExpAccCode
    string Required

    Vendor Expense Account Code

    Max length16
    BpvenPpeAccCode
    string Required

    Pre Paid Deposit Account Code

    Max length16
    BpvenHldbkAccCode
    string Required

    Retainage Account Code

    Max length16
    BpvenApDeptCode
    string Required

    Accounts Payable Department Code

    Max length6
    BpvenDiscDeptCode
    string Required

    Vendor Discount Department Code

    Max length6
    BpvenSpecialTermsFlag
    string Required

    special terms and conditions exists for the vendor y/n

    💻 UI Fieldname: Special Terms and Conditions

    Max length1
    BpvenApAccCode
    string Required

    Accounts Payable Control Account

    Max length16
    BpvenCashDeptCode
    string Required

    Vendor GL Bank Department Code

    Max length6
    BpvenCompCode
    string Required

    Vendor Company Code

    Max length8
    BpvenVUuid
    string Required

    Leave Blank

    Max length64
    BpvenBpCode
    string Required

    Vendor Code

    Max length8
    BpvenExpDeptCode
    string Required

    Vendor Expense Department Code

    Max length6
    BpvenOrdCountry
    string

    Order Country Name

    Max length30
    BpvenPrefCode
    string

    Vendor Preference Code

    💻 UI Fieldname: Preference

    Max length1
    BpvenIuCreateDate
    string
    Bpven1099Name
    string

    Vendor 1099 Name

    Max length30
    BpvenTax1Code
    string

    Tax 1 code

    Max length11
    BpvenEmpNo
    string

    Employee Number For Vendor

    Max length30
    Bpven5018RepFlag
    string

    💻 UI Fieldname: Report T5018

    Max length1
    BpvenDiscreteChqFlag
    string

    Vendor Discrete Check Flag

    Max length1
    BpvenIbanNum
    string

    IBAN - International Bank Account Number

    Max length36
    BpvenAltAddName
    string
    Max length30
    BpvenDistTypeCode
    string

    Vendor Usual Distributuion Type (G, J, E)

    Max length1
    BpvenWebSite
    string

    Web site of the vendor

    💻 UI Fieldname: Web Site

    Max length200
    BpvenPrefName
    string

    Vendor Preference Name

    Max length30
    BpvenBankCode
    string

    Vendor Bank Code

    Max length9
    BpvenTax2Code
    string

    Tax 2 Code

    Max length11
    BpvenOrdPhone
    string

    Order Phone Number

    Max length20
    BpvenIuUpdateDate
    string
    BpvenCompName
    string

    Vendor Company Name

    Max length30
    BpvenClassCode
    string

    Vendor Class Code

    💻 UI Fieldname: Class

    Max length4
    BpvenTermName
    string

    Vendor Terms Name

    Max length30
    BpvenTax3Code
    string

    Tax 3 Code

    Max length11
    BpvenActiveFlag
    string

    Is the vendor active Y/N

    💻 UI Fieldname: Active

    Max length1
    BpvenOrdContactName
    string

    Order Contact Name

    Max length30
    BpvenBpName
    string

    Vendor Name

    Max length50
    BpvenDefaultPayCode
    string

    Default Payment Code

    Max length1
    BpvenBuyCode
    string

    ?

    Max length30
    BpvenBankAccNum3
    string

    Vendor Bank Suffix

    Max length12
    BpvenBankAccNum2
    string

    Vendor Bank Account Number

    Max length35
    BpvenOrdAdd3
    string

    Order Address Line 3

    Max length40
    BpvenOrdAdd2
    string

    Order Address Line 2

    Max length40
    BpvenTax4Code
    string

    Tax 4 Code

    Max length11
    BpvenOrdAdd1
    string

    Order Address Line 1

    Max length40
    BpvenPaymodeId
    string

    BOA Paymode ID. Will Be Used In BOA Paymode ACH File

    Max length30
    BpvenTaxlic1
    string

    Tax 1 License Number

    Max length20
    BpvenUseApctrlComplFlag
    string
    Max length1
    BpvenOrdPostalCode
    string

    Order Zip/Postal Code

    Max length13
    BpvenTaxlic3
    string

    Tax 3 License Number

    Max length20
    BpvenTaxlic2
    string

    Tax 2 License Number

    Max length20
    BpvenTax5Code
    string

    Tax 5 Code

    Max length11
    BpvenClassName
    string

    Vendor Class Name

    Max length30
    BpvenAltAddCode
    string
    Max length5
    BpvenPayEmail
    string

    Payment Email Address

    💻 UI Fieldname: E-mail

    Max length80
    BpvenPayPostalCode
    string

    Payment Zip/Postal Code

    💻 UI Fieldname: Zip/Postal Code

    Max length13
    BpvenStatusCode
    string

    Vendor Status - H Hold Payment T Terms

    Max length1
    BpvenTaxlic5
    string

    Tax 5 License Number

    Max length20
    BpvenTaxlic4
    string

    Tax 4 License Number

    Max length20
    BpvenOrdEmail
    string

    Order Email Address

    Max length80
    BpvenEftPaymentType
    string

    EFT Payment Type

    Max length2
    BpvenPayPhone
    string

    Payment Phone Number

    💻 UI Fieldname: Phone

    Max length20
    BpvenPrenoteFlag
    string

    Prenote Flag.

    Max length1
    BpvenOneTimeFlag
    string

    One-time vendor

    Max length1
    BpvenAllowTranFlag
    string

    Allow Transactions against this vendor Y/N

    Max length1
    BpvenPrefContactMth
    string

    Preferred Method For Sending Direct Deposit Stubs For Vendor

    Max length30
    BpvenShpinstDesc
    string

    Not Used

    💻 UI Fieldname: Vendor Notes

    Max length2000
    BpvenEftEmail
    string

    eft email address

    Max length80
    BpvenEftFlag
    string

    Vendor EFT Flag Y/N

    Max length1
    BpvenBankAccNum1
    string

    Vendor Bank Transit Number

    Max length9
    BpvenOrdRegionCode
    string

    Order State/Province Code

    Max length3
    BpvenPayRegionCode
    string

    Payment State/Region Code

    💻 UI Fieldname: State/Province

    Max length3
    BpvenPayFax
    string

    Payment Fax Number

    💻 UI Fieldname: Fax

    Max length20
    Bpven1099Code
    string

    Vendor 1099 Code

    💻 UI Fieldname: 1099

    Max length1
    BpvenTppayCode
    string

    Third Party Payment Code

    Max length2
    BpvenPayCountry
    string

    Payment Country Name

    💻 UI Fieldname: Country

    Max length30
    BpvenOrdFax
    string

    Order Fax Number

    Max length20
    BpvenInvSerCode
    string

    Default Invoice Series Code

    Max length4
    BpvenPayAdd1
    string

    Payment Address Line 1

    💻 UI Fieldname: Street

    Max length40
    BpvenPayContactName
    string

    Payment Contact Name

    💻 UI Fieldname: Attention

    Max length30
    BpvenHldbkPc
    number

    Retainage Percent (overrides Terms Codes)

    Max length7
    BpvenSwiftBicCode
    string

    Swift BIC Code

    Max length11
    BpvenPayRegionName
    string

    Payment State/Region Name

    Max length30
    BpvenPayAdd2
    string

    Payment Address LIne 2

    💻 UI Fieldname: Suite

    Max length40
    BpvenPayAdd3
    string

    Payment Address Line 3

    💻 UI Fieldname: City

    Max length40
    Responses
    201

    Created

    Headers
    Content-Type
    string
    Exampleapplication/vnd.oracle.adf.resourceitem+json
    {
      "BpvenCompCode": "001",
      "BpvenCompName": null,
      "BpvenBpCode": "BP0023",
      "BpvenBpName": null,
      "BpvenPayAdd1": null,
      "BpvenPayAdd2": null,
      "BpvenPayAdd3": null,
      "BpvenPayRegionCode": null,
      "BpvenPayRegionName": null,
      "BpvenPayCountry": null,
      "BpvenPayPostalCode": null,
      "BpvenPayContactName": null,
      "BpvenPayPhone": null,
      "BpvenPayFax": null,
      "BpvenPayEmail": null,
      "BpvenWebSite": null,
      "BpvenBuyCode": null,
      "BpvenClassCode": null,
      "BpvenClassName": null,
      "BpvenStatusCode": null,
      "BpvenPrefCode": null,
      "BpvenPrefName": null,
      "BpvenTermCode": "NET30",
      "BpvenTermName": null,
      "Bpven1099Code": null,
      "Bpven1099Name": null,
      "BpvenAltAddCode": null,
      "BpvenAltAddName": null,
      "BpvenShpinstDesc": null,
      "BpvenActiveFlag": null,
      "Bpven5018RepFlag": null,
      "BpvenOneTimeFlag": null,
      "BpvenUseApctrlComplFlag": null,
      "BpvenSpecialTermsFlag": "N",
      "BpvenOrdAdd1": null,
      "BpvenOrdAdd2": null,
      "BpvenOrdAdd3": null,
      "BpvenOrdRegionCode": null,
      "BpvenOrdCountry": null,
      "BpvenOrdPostalCode": null,
      "BpvenOrdContactName": null,
      "BpvenOrdPhone": null,
      "BpvenOrdFax": null,
      "BpvenOrdEmail": null,
      "BpvenCurrCode": "CAD",
      "BpvenInvSerCode": null,
      "BpvenDistTypeCode": null,
      "BpvenHldbkPc": null,
      "BpvenAllowTranFlag": null,
      "BpvenCheckMergeFlag": "N",
      "BpvenDiscreteChqFlag": null,
      "BpvenPrenoteFlag": null,
      "BpvenTppayCode": null,
      "BpvenDefaultPayCode": null,
      "BpvenEftFlag": null,
      "BpvenEftEmail": null,
      "BpvenPrefContactMth": null,
      "BpvenEmpNo": null,
      "BpvenBankCode": null,
      "BpvenBankAccNum1": null,
      "BpvenBankAccNum2": null,
      "BpvenBankAccNum3": null,
      "BpvenPaymodeId": null,
      "BpvenIbanNum": null,
      "BpvenSwiftBicCode": null,
      "BpvenApDeptCode": "00",
      "BpvenApAccCode": "21015",
      "BpvenCashDeptCode": "00",
      "BpvenCashAccCode": "10101",
      "BpvenExpDeptCode": "00",
      "BpvenExpAccCode": "50050",
      "BpvenPpeDeptCode": "00",
      "BpvenPpeAccCode": "21018",
      "BpvenDiscDeptCode": "00",
      "BpvenDiscAccCode": "79020",
      "BpvenHldbkDeptCode": "00",
      "BpvenHldbkAccCode": "21017",
      "BpvenTax1Code": null,
      "BpvenTaxlic1": null,
      "BpvenTax2Code": null,
      "BpvenTaxlic2": null,
      "BpvenTax3Code": null,
      "BpvenTaxlic3": null,
      "BpvenTax4Code": null,
      "BpvenTaxlic4": null,
      "BpvenTax5Code": null,
      "BpvenTaxlic5": null,
      "BpvenVUuid": "F30AAFAB16413578E05316821FAC8E9A",
      "BpvenIuCreateDate": null,
      "BpvenIuUpdateDate": null,
      "links": [
        {
          "rel": "self",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/ap-rest-api/rest/1/apvendor/F30AAFAB16413578E05316821FAC8E9A",
          "name": "apvendor",
          "kind": "item"
        },
        {
          "rel": "canonical",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/ap-rest-api/rest/1/apvendor/F30AAFAB16413578E05316821FAC8E9A",
          "name": "apvendor",
          "kind": "item"
        }
      ]
    }
    object