LinkingService provides operations for managing links.
Companies participating on the exchange can create business relationships with each other to either sell or have access to additional sources of inventory. In order for companies to do business together, create a link.
Each company creates a business profile that includes information about their business, and optionally, a buyer and/or seller profile to let others on the exchange understand the kind of inventory they want to buy or sell. Once this information is available on the exchange, companies can evaluate each other's profile information and, if a company is interested in establishing a business relationship with another company to buy or sell inventory, the company proposes a link (and, optionally, a deal).
A link proposal contains general company information such as the company name, contact, and payment terms. The link proposal can include guaranteed deal and/or a non-guaranteed deal to buy and sell inventory to another company.
- In a guaranteed deal, a seller wants to sell inventory at a fixed price for a specific period of time.
- In a non-guaranteed deal, a buyer bids on available inventory. The order is served if the buyer's bid was selected.
When a company requests a link with another company, the company that receives the link proposal can approve or reject the link proposal in its entirety, or make changes to the link proposal and/or the deals in the link proposal. Once a link proposal has been modified, the link proposal returns to the company that originated the request. When a company approves a link proposal, the two companies establish a business relationship and become linked companies.
LinkingService provides operations for retrieving, proposing, and approving links to:
To retrieve the business profile for an account, use the getBusinessProfileByAccountID operation. To retrieve the buyer profile for an account, use the getBuyerPofileByAccountID operation. To retrieve the seller profile for an account, use the getSellerProfileByAccountID operation.
Link proposals include information to help companies establish business relationships to buy and sell inventory on the exchange. Review a company’s profile, then create a link proposal with (optional) guaranteed and non-guaranteed deals to define your inventory preferences.
Both companies review and modify the link proposal until it is satisfactory to both, and then it gets approved by both companies.
Note: The link and deals in a proposal are only a request to establish a business relationship between two companies. Deals must be approved before an order can be booked on a partner’s inventory.
Once a link proposal is in place, a business relationship is established and the companies can sell and buy inventory from each other.
Note: The actual pricing of inventory occurs when an order is created.
To propose a link to a buyer, use the proposeBuyerLink operation. To propose a link to a seller, use the proposeSellerLink operation. You can create a link proposal without deal information, but you won’t be able to book or accept any order until a deal is active. To attach a guaranteed or non-guaranteed deal to a link (if you did not include a deal in your initial link proposal), use the addGuaranteedDealToLink or addNonGuaranteedDealToLink operation respectively.
To retrieve a link, use the getLink operation and to retrieve links, use the getLinks operation.
To retrieve the status of your links with all companies in the exchange, use the getAllCompanyLinks operation. This operation will return a list of companies in the exchange and the status of your links with them (if any). To retrieve the status of your link with a company (specified by the ID of the company's accout), use the getCompanyLinkByAccountID operation.
To retrieve the list of links awaiting your approval, use the getLinksPendingMyApproval operation. To retrieve the list of links that you proposed and are in pending state awaiting the partner's approval, use the getLinksPendingPartnerApproval operation.
To retrieve all your links, use the getMyLinks operation. To retrieve a list of your active links, use the getMyActiveLinks operation and to retrieve all your denied links, use the getMyDeniedLinks operation.
To approve a link, use the manageLink operation and to approve a list of links, use the manageLinks operation.
An agency manages a list of client networks under an agency contract. The agency contract allows an agency user to access the client's account. The agency user, accessing the client's account, is assigned specific roles (see UserService) in each client network and participates in the exchange on behalf of the client.
To retrieve an agency contract, use the getAgencyContract operation and to retrieve a list of agency contracts, use the getAgencyContracts operation.
To retrieve the agency contracts associated with a link, use the getAgencyContractsByLinkID operation.
To retrieve a list of your agency contracts, use the getMyAgencyContracts operation.