LineItemInterface.php 6.34 KB
Newer Older
Ketan's avatar
Ketan committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282
<?php

/**
 * @copyright  Vertex. All rights reserved.  https://www.vertexinc.com/
 * @author     Mediotype Development         <diveinto@mediotype.com>
 */

namespace Vertex\Data;

/**
 * Represents a Line Item for a Quote or Invoice
 *
 * @api
 */
interface LineItemInterface
{
    /**
     * Retrieve the commodity code
     *
     * @return string
     */
    public function getCommodityCode();

    /**
     * Retrieve the commodity code type
     *
     * @return string
     */
    public function getCommodityCodeType();

    /**
     * Retrieve the Customer
     *
     * @return CustomerInterface|null
     */
    public function getCustomer();

    /**
     * Retrieve the Delivery Term
     *
     * An identifier that determines the vendor or customer jurisdiction in which the title transfer of a supply takes
     * place. This is also known as Shipping Terms. Delivery Terms information could be critical to determine the place
     * of supply, for example, in distance selling.
     *
     * @return string|null
     */
    public function getDeliveryTerm();

    /**
     * Retrieve the actual price of the line item
     *
     * This field serves as a combination of unit price and quantity
     *
     * @return float|null
     */
    public function getExtendedPrice();

    /**
     * Retrieve any flexible fields attached to the LineItem
     *
     * @return FlexibleFieldInterface[]
     */
    public function getFlexibleFields();

    /**
     * Retrieve the identifier for the line item
     *
     * Used for synchronization purposes with the host system
     *
     * @return int|null
     */
    public function getLineItemId();

    /**
     * Retrieve the location code
     *
     * A string used for tax return filing in jurisdictions that require taxes to be filed for individual retail
     * locations
     *
     * @return string|null
     */
    public function getLocationCode();

    /**
     * Retrieve the Tax Class the product is a part of
     *
     * @return string|null
     */
    public function getProductClass();

    /**
     * Retrieve the code representing the product
     *
     * Typically a SKU
     *
     * @return string|null
     */
    public function getProductCode();

    /**
     * Retrieve the quantity of the product for the line item
     *
     * @return float|null
     */
    public function getQuantity();

    /**
     * Retrieve the Seller
     *
     * @return SellerInterface|null
     */
    public function getSeller();

    /**
     * Retrieve all Taxes on the line item
     *
     * @return TaxInterface[]
     */
    public function getTaxes();

    /**
     * Retrieve the Total Tax charged for the line item
     *
     * @return float|null
     */
    public function getTotalTax();

    /**
     * Retrieve the price per quantity
     *
     * @return float|null
     */
    public function getUnitPrice();

    /**
     * Retrieve if the tax is included
     *
     * @return bool|null
     */
    public function isTaxIncluded();

    /**
     * Set the commodity code
     *
     * @param string $code
     * @return LineItemInterface
     */
    public function setCommodityCode($code);

    /**
     * Set the commodity code type
     *
     * @param string $type
     * @return LineItemInterface
     */
    public function setCommodityCodeType($type);

    /**
     * Set the Customer
     *
     * @param CustomerInterface $customer
     * @return LineItemInterface
     */
    public function setCustomer(CustomerInterface $customer);

    /**
     * Set the Delivery Term
     *
     * An identifier that determines the vendor or customer jurisdiction in which the title transfer of a supply takes
     * place. This is also known as Shipping Terms. Delivery Terms information could be critical to determine the place
     * of supply, for example, in distance selling.
     *
     * @param string $deliveryTerm
     * @return LineItemInterface
     */
    public function setDeliveryTerm($deliveryTerm);

    /**
     * Set the actual price of the line item
     *
     * This field serves as a combination of unit price and quantity
     *
     * @param float $extendedPrice
     * @return LineItemInterface
     */
    public function setExtendedPrice($extendedPrice);

    /**
     * Attach flexible fields to the LineItem
     *
     * @param FlexibleFieldInterface[] $fields
     * @return LineItemInterface
     */
    public function setFlexibleFields(array $fields);

    /**
     * Set the identifier for the line item
     *
     * Used for synchronization purposes with the host system
     *
     * @param string $lineItemId
     * @return LineItemInterface
     */
    public function setLineItemId($lineItemId);

    /**
     * Set the location code
     *
     * A string used for tax return filing in jurisdictions that require taxes to be filed for individual retail
     * locations
     *
     * @param string $locationCode
     * @return LineItemInterface
     */
    public function setLocationCode($locationCode);

    /**
     * Set the Tax Class the product is a part of
     *
     * @param string $productClass
     * @return LineItemInterface
     */
    public function setProductClass($productClass);

    /**
     * Set the code representing the product
     *
     * Typically a SKU
     *
     * @param string $productCode
     * @return LineItemInterface
     */
    public function setProductCode($productCode);

    /**
     * Set the quantity of the product for the line item
     *
     * @param float $quantity
     * @return LineItemInterface
     */
    public function setQuantity($quantity);

    /**
     * Set the Seller
     *
     * @param SellerInterface $seller
     * @return LineItemInterface
     */
    public function setSeller(SellerInterface $seller);

    /**
     * Set if tax is included
     *
     * @param bool
     * @return LineItemInterface
     */
    public function setTaxIncluded($isIncluded);

    /**
     * Set the Taxes on the line item
     *
     * @param TaxInterface[] $taxes
     * @return LineItemInterface
     */
    public function setTaxes(array $taxes);

    /**
     * Set the total tax charged for the line item
     *
     * @param float $totalTax
     * @return LineItemInterface
     */
    public function setTotalTax($totalTax);

    /**
     * Set the price per quantity
     *
     * @param float $unitPrice
     * @return LineItemInterface
     */
    public function setUnitPrice($unitPrice);
}