> ## 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 AP Vendor

> ## Overview

A vendor is an entity a company purchases products or services from, resulting in invoices and payments. In CMiC, vendors are managed under a Business Partner record, which can represent either a vendor or a customer. A vendor record is typically created alongside the Business Partner to store vendor-specific details.This endpoint allows you to create, update, and query vendor records in CMiC.

## Notes

Before creating a vendor using **apvendor**, a **Business Partner** record must already exist in CMiC. To create one, use the [Business Partners API](https://developers.cmicglobal.com/apidocs/create-a-business-partner).

## UI Navigation

Financials > Accounts Payable > Setup > Maintain Vendors

## Reference Article

[Maintain Business Partners](https://docs.cmicglobal.com/portal/Content/E_Reference_Material/AP_-_Accounts_Payable/Reference/Maintain_BP/Maintain_BP.htm)

[Maintain Vendors](https://docs.cmicglobal.com/portal/Content/E_Reference_Material/AP_-_Accounts_Payable/Reference/Maintain_Vendors/Maintain_Vendors_Screen.htm)

## apvendor Attributes (required)

| CMiC UI Fieldname | Object | Name | Description | Type | Data Length | Example |
| --- | --- | --- | --- | --- | --- | --- |
| Vendor Company Code | apvendor | BpvenCompCode | This is the company the vendor belongs.  This must be a VALID CMiC Company Code that has already be setup in Accounts Payable. | string | 8 | 001 |
| Business Partner Code | apvendor | BpvenBpCode | This is the Business Partner the vendor was created from. This must be a VALID CMiC Business Partner, and pre-exist before creating the vendor record. | string | 8 | BNSRIG |
| Vendor Terms Code | apvendor | BpvenTermCode | Payment terms determine the default due date, discount date, percent, and retainage percent used during invoice entry. This field defaults from the AP Control file, but can be changed as required. This must be a VALID CMiC payment Terms Code for the company entered in ‘BpvenCompCode’. | string | 6 | NET30 |
| Vendor Special Terms and Conditions | apvendor | BpvenSpecialTermsFlag | Check this box to indicate that special contract terms and conditions are associated with the vendor. | string | 1 | Y/N |
| Vendor Currency Code | apvendor | BpvenCurrCode | This is the vendor currency code. When a vendor is created, the system creates the vendor with the same currency as the company. If the currency is changed, the system will verify that the cash account matches the currency code. When the accounts do not match, the currency of the cash account will have to be changed. | string | 3 | USD |
| Vendor Check Merge Flag | apvendor | BpvenCheckMergeFlag | This flag allows this vendor to merge payments with another company. It is the same vendor for check printing | string | 1 | Y/N |
| Vendor Department Code | apvendor | BpvenApDeptCode | Enter the department and account number to be used by the Accounts Payable system for automatic General Ledger distributions for this vendor. | string | 6 | 00 |
| Vendor Account Code | apvendor | BpvenApAccCode | Enter the department and account number to be used by the Accounts Payable system for automatic General Ledger distributions for this vendor. | string | 16 | 21011 |
| Vendor Cash Department Code | apvendor | BpvenCashDeptCode | Enter the department and account number to be used by the Accounts Payable system for automatic General Ledger distributions affecting the cash account for this vendor. This is the bank account from which payments to the vendor will be made. | string | 6 | 00 |
| Vendor Cash Account Code | apvendor | BpvenCashAccCode | Enter the department and account number to be used by the Accounts Payable system for automatic General Ledger distributions affecting the cash account for this vendor. This is the bank account from which payments to the vendor will be made. | string | 16 | 10001 |
| Vendor Expense Department Code | apvendor | BpvenExpDeptCode | This is the default department for vouchers charged directly to the GL for this vendor.  This must be a VALID CMiC department code. | string | 6 | 00 |
| Vendor Expense Account Code | apvendor | BpvenExpAccCode | This is the default expense account for this vendor that will be used by the system if the voucher being entered is a direct GL expense type of voucher.  This must be a VALID CMiC account. | string | 16 | 79010 |
| Vendor Prepaid expenses Department Code | apvendor | BpvenPpeDeptCode | Enter the department and account number to be used by the Accounts Payable system for automatic General Ledger distributions that affect the expense for this vendor. | string | 6 | 00 |
| Vendor Prepaid expenses Account Code | apvendor | BpvenPpeAccCode | Enter the department and account number to be used by the Accounts Payable system for automatic General Ledger distributions that affect the expense for this vendor. | string | 16 | 21013 |
| Vendor Discount Department Code | apvendor | BpvenDiscDeptCode | This is the department code that any discounts taken with this vendor will be captured.  This must be a VALID CMiC department code. The department and account number are used by the Accounts Payable system for automatic General Ledger distributions of discounts for this vendor. | string | 6 | 00 |
| Vendor Discount Account Code | apvendor | BpvenDiscAccCode | This is the account where discounts taken with this vendor will be recorded.  This must be a VALID CMiC account. The department and account number are used by the Accounts Payable system for automatic General Ledger distributions of discounts for this vendor. | string | 16 | 79020 |
| Vendor Retainage Department Code | apvendor | BpvenHldbkDeptCode | This is the default department that will be used to record retainage held for the vendor.  This must be a VALID CMiC department code. The department and account number to be used by the Accounts Payable module for automatic General Ledger distributions of retainage for this vendor. | string | 6 | 00 |
| Vendor Retainage Account Code | apvendor | BpvenHldbkAccCode | This is the account that will be used to record retainage held by this vendor.  This must be a VALID CMiC Account. The department and account number to be used by the Accounts Payable module for automatic General Ledger distributions of retainage for this vendor. | string | 16 | 21012 |


## OpenAPI

````json POST /ap-rest-api/rest/1/apvendor
{
  "openapi": "3.0.0",
  "info": {
    "title": "API Catalog",
    "description": "",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://mobtest.cmiccloudr12.com/cmictestrti",
      "description": "CMIC API Server"
    }
  ],
  "security": [
    {
      "cmicBasicAuth": []
    }
  ],
  "tags": [
    {
      "name": "Highlights"
    },
    {
      "name": "Asset Management | Equipment"
    },
    {
      "name": "Asset  Management | Fixed Assets"
    },
    {
      "name": "Asset Management | Purchase Order"
    },
    {
      "name": "Asset Management | Inventory"
    },
    {
      "name": "Asset Management | Requisition"
    },
    {
      "name": "Asset Management | Purchase Change Order"
    },
    {
      "name": "Bim Model"
    },
    {
      "name": "Bim Model Revision"
    },
    {
      "name": "Bim Tag Model"
    },
    {
      "name": "Bim Tags"
    },
    {
      "name": "Bim FileUpload Jersey"
    },
    {
      "name": "Core System | Business Partners"
    },
    {
      "name": "Core System | Business Partner Addresses"
    },
    {
      "name": "Core System | Bank"
    },
    {
      "name": "Core System | Currency"
    },
    {
      "name": "Core System | Exchange Rates"
    },
    {
      "name": "Core System | Global  Table Text Codes"
    },
    {
      "name": "Core System | Global Table  Regions"
    },
    {
      "name": "Core System | Terms"
    },
    {
      "name": "Core System | System Contact"
    },
    {
      "name": "Core System | Weight Measures"
    },
    {
      "name": "Core System | Field User Defined Classifiers"
    },
    {
      "name": "Core System | User Defined Classifiers by Object"
    },
    {
      "name": "Core System | User Extension Definitions by Object"
    },
    {
      "name": "Core System | User Extention Field Data Value"
    },
    {
      "name": "Core System | User Extension Values by Object"
    },
    {
      "name": "Core System | User System Role"
    },
    {
      "name": "Core System | User Project Role"
    },
    {
      "name": "Core System | Documents by Object"
    },
    {
      "name": "Core System | Audit Status Log by Object"
    },
    {
      "name": "Core System | Licensed Users"
    },
    {
      "name": "Core System | Company Access"
    },
    {
      "name": "Core System |  Copy User Settings"
    },
    {
      "name": "Core System | User Maintenance"
    },
    {
      "name": "Core System | User Roles"
    },
    {
      "name": "Core System | Security Groups"
    },
    {
      "name": "Core System | Job/Project Security"
    },
    {
      "name": "Core System | Weight Measure with Conversions Code"
    },
    {
      "name": "Core System | Weight Measure Conversions Code"
    },
    {
      "name": "Core System | User-defined-fields"
    },
    {
      "name": "Core System | User-extension"
    },
    {
      "name": "ECM and Workflow | Image Manager"
    },
    {
      "name": "Financials | General Ledger"
    },
    {
      "name": "Financials | Accounts Payable"
    },
    {
      "name": "Financials | Accounts Receivable"
    },
    {
      "name": "Preventative Maintenance | Issue Work Orders"
    },
    {
      "name": "Preventative Maintenance | Issue Work Items"
    },
    {
      "name": "Preventative Maintenance | Issue Work Budgets"
    },
    {
      "name": "Preventative Maintenance | Issue Priorities"
    },
    {
      "name": "Preventative Maintenance | Issue Status"
    },
    {
      "name": "Preventative Maintenance | Issue Types"
    },
    {
      "name": "Preventative Maintenance | Accumulative Equipment"
    },
    {
      "name": "Preventative Maintenance | Work Orders"
    },
    {
      "name": "Preventative Maintenance | Work Items"
    },
    {
      "name": "Preventative Maintenance | Work Budgets"
    },
    {
      "name": "Preventative Maintenance | Priorities"
    },
    {
      "name": "Preventative Maintenance | Tasks"
    },
    {
      "name": "HCM | UKG Pay Deductions"
    },
    {
      "name": "HCM | UKG Pay Earnings"
    },
    {
      "name": "HCM | UKG Pay Headers"
    },
    {
      "name": "HCM | UKG Pay Taxes"
    },
    {
      "name": "HCM | Payroll Geographical States"
    },
    {
      "name": "HCM | Payroll Trades"
    },
    {
      "name": "HCM | Payroll Union"
    },
    {
      "name": "HCM | Payroll Pay Runs"
    },
    {
      "name": "HCM | Payroll Pay Groups"
    },
    {
      "name": "HCM | Payroll Tax"
    },
    {
      "name": "HCM | Payroll Worker Compensation"
    },
    {
      "name": "HCM | Payroll Work Locations"
    },
    {
      "name": "HCM | Payroll Trade Pay Rates"
    },
    {
      "name": "HCM | Payroll Union Pay Rates"
    },
    {
      "name": "HCM | Payroll Job Pay Rates"
    },
    {
      "name": "HCM | Payroll Master Benefits"
    },
    {
      "name": "HCM | Payroll Master Deductions"
    },
    {
      "name": "HCM | Payroll Ben/Ded/Leave Base Codes"
    },
    {
      "name": "HCM | Payroll Ben/Ded Plans"
    },
    {
      "name": "HCM | Payroll Ben/Ded Plan Options"
    },
    {
      "name": "HCM | Payroll Company Benefits"
    },
    {
      "name": "HCM | Payroll Company Deductions"
    },
    {
      "name": "HCM | Payroll Vertex Geographic Locations"
    },
    {
      "name": "HCM | Payroll Checks"
    },
    {
      "name": "HCM | Payroll Timesheets"
    },
    {
      "name": "HCM | Employee"
    },
    {
      "name": "HCM | Employee (Minimum payload)"
    },
    {
      "name": "HCM | Employee History"
    },
    {
      "name": "HCM | Tax Exemptions"
    },
    {
      "name": "HCM | Employee Tax Overrides"
    },
    {
      "name": "HCM | Employee Pay Splits"
    },
    {
      "name": "HCM | Employee Benefits"
    },
    {
      "name": "HCM | Employee Clock In and Out"
    },
    {
      "name": "HCM | Employee Deductions"
    },
    {
      "name": "HCM | Employee Leaves"
    },
    {
      "name": "HCM | Employee Leave History"
    },
    {
      "name": "HCM | Employee Hour Types"
    },
    {
      "name": "HCM | Employee Pay History"
    },
    {
      "name": "HCM | Employee Work Statuses"
    },
    {
      "name": "HCM | Employee Security Group"
    },
    {
      "name": "HCM | Crewtime Crew"
    },
    {
      "name": "HCM | Crewtime Employee Timesheet"
    },
    {
      "name": "HCM | Crewtime Equipment Timesheet"
    },
    {
      "name": "HCM | Crew Maintenance Activity Assignment"
    },
    {
      "name": "HCM | Crew Maintenance Member Assignment"
    },
    {
      "name": "HCM | Crew Maintenance Member Trade and Union Assignment"
    },
    {
      "name": "HCM | Crew Maintenance Equipment Assignment"
    },
    {
      "name": "HCM | Crew Maintenance Equipment Detail Assignment"
    },
    {
      "name": "HCM | HR Requisitions"
    },
    {
      "name": "HCM | HR Relations"
    },
    {
      "name": "HCM | HR Employee Skills"
    },
    {
      "name": "HCM | HR Incident"
    },
    {
      "name": "HCM | HR Employee Relatives / Dependents"
    },
    {
      "name": "HCM | HR Employee Positions"
    },
    {
      "name": "HCM | HR Applicants"
    },
    {
      "name": "HCM | HR Applications"
    },
    {
      "name": "HCM | Vertex Location City"
    },
    {
      "name": "HCM | HR Application History"
    },
    {
      "name": "HCM | HR Dependent Benefits"
    },
    {
      "name": "HCM | HR Dependent Deductions"
    },
    {
      "name": "HCM | HR Employee Elected Plans"
    },
    {
      "name": "HCM | HR Employee Training Certifications"
    },
    {
      "name": "HCM | HR Trainings"
    },
    {
      "name": "HCM | E-Timesheets"
    },
    {
      "name": "HCM | System Contacts"
    },
    {
      "name": "HCM | System User Payroll Security Group"
    },
    {
      "name": "HCM | Payroll Timesheet Posting"
    },
    {
      "name": "HCM | CrewTimesheet Posting"
    },
    {
      "name": "HCM | HR Positions Master"
    },
    {
      "name": "HCM | Payroll Pay Periods"
    },
    {
      "name": "HCM | Payroll Rate Codes"
    },
    {
      "name": "HCM | Payroll Overhead Codes and Rates"
    },
    {
      "name": "HCM | Payroll Assigned Overhead to Jobs"
    },
    {
      "name": "Materials  Management | Material Sale Orders"
    },
    {
      "name": "Materials  Management | Material Sale Orders Details"
    },
    {
      "name": "Materials  Management | Truck Rate Detail"
    },
    {
      "name": "Opportunity Management | Competitors"
    },
    {
      "name": "Opportunity Management | Opportunities"
    },
    {
      "name": "Opportunity Management | Revenue Details"
    },
    {
      "name": "Opportunity Management | Opportunity History"
    },
    {
      "name": "Opportunity Management | Organization"
    },
    {
      "name": "Project Controls | Job Billing"
    },
    {
      "name": "Project Controls | Job Cost"
    },
    {
      "name": "Project Controls | PCI Details"
    },
    {
      "name": "Project Controls | Unposted PCI Details"
    },
    {
      "name": "Project Controls | PCI Headers"
    },
    {
      "name": "Project Controls | Owner Change Orders"
    },
    {
      "name": "Project Controls | CM Statuses"
    },
    {
      "name": "Project Controls | CM Types"
    },
    {
      "name": "Project Controls | CM Vendor Details"
    },
    {
      "name": "Project Controls | Post PCI"
    },
    {
      "name": "Project Management | Uploading Documents"
    },
    {
      "name": "Project Management | Downloading Documents"
    },
    {
      "name": "Project Management | Foreign Bid Item Imports"
    },
    {
      "name": "Project Management | Communications"
    },
    {
      "name": "Project Management | Daily Journals"
    },
    {
      "name": "Project Management | Communications Types"
    },
    {
      "name": "Project Management | Daily Journal Daily Work Plans"
    },
    {
      "name": "Project Management | Daily Journal Field Forces"
    },
    {
      "name": "Project Management | Daily Journal Labour"
    },
    {
      "name": "Project Management | Daily Journal Materials"
    },
    {
      "name": "Project Management | Daily Journal Owner Equipment"
    },
    {
      "name": "Project Management | Daily Journal Quality Control"
    },
    {
      "name": "Project Management | Daily Journal Tasks"
    },
    {
      "name": "Project Management | Daily Journal Trade Equipment"
    },
    {
      "name": "Project Management | Daily Journal Transactions"
    },
    {
      "name": "Project Management | Daily Journal User Defined Data"
    },
    {
      "name": "Project Management | Daily Journal Visitors"
    },
    {
      "name": "Project Management | Daily Journal Bill Details"
    },
    {
      "name": "Project Management | Field Work Directives"
    },
    {
      "name": "Project Management | Contract Types"
    },
    {
      "name": "Project Management | Company Contacts"
    },
    {
      "name": "Project Management | Distribution BCC"
    },
    {
      "name": "Project Management | Distribution CC"
    },
    {
      "name": "Project Management | Field Work Directive Statuses"
    },
    {
      "name": "Project Management | Issues"
    },
    {
      "name": "Project Management | Key Players"
    },
    {
      "name": "Project Management | Meetings"
    },
    {
      "name": "Project Management | Meeting Attendees"
    },
    {
      "name": "Project Management | Meeting Item Statuses"
    },
    {
      "name": "Project Management | Meeting Tracks"
    },
    {
      "name": "Project Management | Notes"
    },
    {
      "name": "Project Management | Projects"
    },
    {
      "name": "Project Management | Project Items"
    },
    {
      "name": "Project Management | Project Item Phase Segment Sums"
    },
    {
      "name": "Project Management | Project Partners"
    },
    {
      "name": "Project Management | Notices"
    },
    {
      "name": "Project Management | Notice Statuses"
    },
    {
      "name": "Project Management | Owner JS Query"
    },
    {
      "name": "Project Management | PCI Real Locations"
    },
    {
      "name": "Project Management | Project Contacts"
    },
    {
      "name": "Project Management | RFIs (Requests for Information)"
    },
    {
      "name": "Project Management | RFI Statuses"
    },
    {
      "name": "Project Management | Submittal Packages"
    },
    {
      "name": "Project Management | Submittal Package Details"
    },
    {
      "name": "Project Management | Submittal Package Status"
    },
    {
      "name": "Project Management | Submittals"
    },
    {
      "name": "Project Management | Submittal Status"
    },
    {
      "name": "Project Management | Transmittals"
    },
    {
      "name": "Project Management | Subcontract Headers"
    },
    {
      "name": "Project Management | Subcontract Schedules"
    },
    {
      "name": "Project Management | Subcontract Sechedule Phase Segment Sums"
    },
    {
      "name": "Project Management | User Roles"
    },
    {
      "name": "Project Management | Punchlists"
    },
    {
      "name": "Project Management | Punchlist Details"
    },
    {
      "name": "Project Management | Punchlist Statuses"
    },
    {
      "name": "Project Management | Meeting Items"
    },
    {
      "name": "Project Management | Self Perform Vendor"
    },
    {
      "name": "Project Management | Submittal Types"
    },
    {
      "name": "Project Management | Assign contact and partner to project"
    },
    {
      "name": "Project Management | Subcontract Prequal"
    },
    {
      "name": "Project Management | Bid Item Package"
    }
  ],
  "paths": {
    "/ap-rest-api/rest/1/apvendor": {
      "post": {
        "tags": [
          "Financials | Accounts Payable"
        ],
        "summary": "Create a AP Vendor",
        "description": "## Overview\n\nA vendor is an entity a company purchases products or services from, resulting in invoices and payments. In CMiC, vendors are managed under a Business Partner record, which can represent either a vendor or a customer. A vendor record is typically created alongside the Business Partner to store vendor-specific details.This endpoint allows you to create, update, and query vendor records in CMiC.\n\n## Notes\n\nBefore creating a vendor using **apvendor**, a **Business Partner** record must already exist in CMiC. To create one, use the [Business Partners API](https://developers.cmicglobal.com/apidocs/create-a-business-partner).\n\n## UI Navigation\n\nFinancials > Accounts Payable > Setup > Maintain Vendors\n\n## Reference Article\n\n[Maintain Business Partners](https://docs.cmicglobal.com/portal/Content/E_Reference_Material/AP_-_Accounts_Payable/Reference/Maintain_BP/Maintain_BP.htm)\n\n[Maintain Vendors](https://docs.cmicglobal.com/portal/Content/E_Reference_Material/AP_-_Accounts_Payable/Reference/Maintain_Vendors/Maintain_Vendors_Screen.htm)\n\n## apvendor Attributes (required)\n\n| CMiC UI Fieldname | Object | Name | Description | Type | Data Length | Example |\n| --- | --- | --- | --- | --- | --- | --- |\n| Vendor Company Code | apvendor | BpvenCompCode | This is the company the vendor belongs.  This must be a VALID CMiC Company Code that has already be setup in Accounts Payable. | string | 8 | 001 |\n| Business Partner Code | apvendor | BpvenBpCode | This is the Business Partner the vendor was created from. This must be a VALID CMiC Business Partner, and pre-exist before creating the vendor record. | string | 8 | BNSRIG |\n| Vendor Terms Code | apvendor | BpvenTermCode | Payment terms determine the default due date, discount date, percent, and retainage percent used during invoice entry. This field defaults from the AP Control file, but can be changed as required. This must be a VALID CMiC payment Terms Code for the company entered in ‘BpvenCompCode’. | string | 6 | NET30 |\n| Vendor Special Terms and Conditions | apvendor | BpvenSpecialTermsFlag | Check this box to indicate that special contract terms and conditions are associated with the vendor. | string | 1 | Y/N |\n| Vendor Currency Code | apvendor | BpvenCurrCode | This is the vendor currency code. When a vendor is created, the system creates the vendor with the same currency as the company. If the currency is changed, the system will verify that the cash account matches the currency code. When the accounts do not match, the currency of the cash account will have to be changed. | string | 3 | USD |\n| Vendor Check Merge Flag | apvendor | BpvenCheckMergeFlag | This flag allows this vendor to merge payments with another company. It is the same vendor for check printing | string | 1 | Y/N |\n| Vendor Department Code | apvendor | BpvenApDeptCode | Enter the department and account number to be used by the Accounts Payable system for automatic General Ledger distributions for this vendor. | string | 6 | 00 |\n| Vendor Account Code | apvendor | BpvenApAccCode | Enter the department and account number to be used by the Accounts Payable system for automatic General Ledger distributions for this vendor. | string | 16 | 21011 |\n| Vendor Cash Department Code | apvendor | BpvenCashDeptCode | Enter the department and account number to be used by the Accounts Payable system for automatic General Ledger distributions affecting the cash account for this vendor. This is the bank account from which payments to the vendor will be made. | string | 6 | 00 |\n| Vendor Cash Account Code | apvendor | BpvenCashAccCode | Enter the department and account number to be used by the Accounts Payable system for automatic General Ledger distributions affecting the cash account for this vendor. This is the bank account from which payments to the vendor will be made. | string | 16 | 10001 |\n| Vendor Expense Department Code | apvendor | BpvenExpDeptCode | This is the default department for vouchers charged directly to the GL for this vendor.  This must be a VALID CMiC department code. | string | 6 | 00 |\n| Vendor Expense Account Code | apvendor | BpvenExpAccCode | This is the default expense account for this vendor that will be used by the system if the voucher being entered is a direct GL expense type of voucher.  This must be a VALID CMiC account. | string | 16 | 79010 |\n| Vendor Prepaid expenses Department Code | apvendor | BpvenPpeDeptCode | Enter the department and account number to be used by the Accounts Payable system for automatic General Ledger distributions that affect the expense for this vendor. | string | 6 | 00 |\n| Vendor Prepaid expenses Account Code | apvendor | BpvenPpeAccCode | Enter the department and account number to be used by the Accounts Payable system for automatic General Ledger distributions that affect the expense for this vendor. | string | 16 | 21013 |\n| Vendor Discount Department Code | apvendor | BpvenDiscDeptCode | This is the department code that any discounts taken with this vendor will be captured.  This must be a VALID CMiC department code. The department and account number are used by the Accounts Payable system for automatic General Ledger distributions of discounts for this vendor. | string | 6 | 00 |\n| Vendor Discount Account Code | apvendor | BpvenDiscAccCode | This is the account where discounts taken with this vendor will be recorded.  This must be a VALID CMiC account. The department and account number are used by the Accounts Payable system for automatic General Ledger distributions of discounts for this vendor. | string | 16 | 79020 |\n| Vendor Retainage Department Code | apvendor | BpvenHldbkDeptCode | This is the default department that will be used to record retainage held for the vendor.  This must be a VALID CMiC department code. The department and account number to be used by the Accounts Payable module for automatic General Ledger distributions of retainage for this vendor. | string | 6 | 00 |\n| Vendor Retainage Account Code | apvendor | BpvenHldbkAccCode | This is the account that will be used to record retainage held by this vendor.  This must be a VALID CMiC Account. The department and account number to be used by the Accounts Payable module for automatic General Ledger distributions of retainage for this vendor. | string | 16 | 21012 |\n",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "example": {
                  "BpvenCompCode": "MAIC",
                  "BpvenBpCode": "BP0022",
                  "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": ""
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "Content-Type",
            "in": "header",
            "schema": {
              "type": "string"
            },
            "example": "application/vnd.oracle.adf.resourceitem+json"
          }
        ],
        "responses": {
          "201": {
            "description": "Created",
            "headers": {
              "Content-Type": {
                "schema": {
                  "type": "string",
                  "example": "application/vnd.oracle.adf.resourceitem+json"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "examples": {
                  "example-0": {
                    "summary": "Successful Response",
                    "value": {
                      "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"
                        }
                      ]
                    }
                  },
                  "example-1": {
                    "summary": "Successful Response",
                    "value": {
                      "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"
                        }
                      ]
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "cmicBasicAuth": {
        "type": "http",
        "scheme": "basic",
        "description": "Basic authentication"
      }
    }
  }
}
````