OrderAddressInterface.php 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553
  1. <?php
  2. /**
  3. * Copyright © Magento, Inc. All rights reserved.
  4. * See COPYING.txt for license details.
  5. */
  6. namespace Magento\Sales\Api\Data;
  7. /**
  8. * Order address interface.
  9. *
  10. * An order is a document that a web store issues to a customer. Magento generates a sales order that lists the product
  11. * items, billing and shipping addresses, and shipping and payment methods. A corresponding external document, known as
  12. * a purchase order, is emailed to the customer.
  13. * @api
  14. * @since 100.0.2
  15. */
  16. interface OrderAddressInterface extends \Magento\Framework\Api\ExtensibleDataInterface
  17. {
  18. /**
  19. * Entity ID.
  20. */
  21. const ENTITY_ID = 'entity_id';
  22. /**
  23. * Parent ID.
  24. */
  25. const PARENT_ID = 'parent_id';
  26. /**
  27. * Customer address ID.
  28. */
  29. const CUSTOMER_ADDRESS_ID = 'customer_address_id';
  30. /**
  31. * Region ID.
  32. */
  33. const REGION_ID = 'region_id';
  34. /**
  35. * Region code.
  36. */
  37. const KEY_REGION_CODE = 'region_code';
  38. /**
  39. * Customer ID.
  40. */
  41. const CUSTOMER_ID = 'customer_id';
  42. /**
  43. * Fax.
  44. */
  45. const FAX = 'fax';
  46. /**
  47. * Region.
  48. */
  49. const REGION = 'region';
  50. /**
  51. * Postal code.
  52. */
  53. const POSTCODE = 'postcode';
  54. /**
  55. * Last name.
  56. */
  57. const LASTNAME = 'lastname';
  58. /**
  59. * Street.
  60. */
  61. const STREET = 'street';
  62. /**
  63. * City.
  64. */
  65. const CITY = 'city';
  66. /**
  67. * Email address.
  68. */
  69. const EMAIL = 'email';
  70. /**
  71. * Telephone number.
  72. */
  73. const TELEPHONE = 'telephone';
  74. /**
  75. * Country ID.
  76. */
  77. const COUNTRY_ID = 'country_id';
  78. /**
  79. * First name.
  80. */
  81. const FIRSTNAME = 'firstname';
  82. /**
  83. * Address type.
  84. */
  85. const ADDRESS_TYPE = 'address_type';
  86. /**
  87. * Prefix.
  88. */
  89. const PREFIX = 'prefix';
  90. /**
  91. * Middle name.
  92. */
  93. const MIDDLENAME = 'middlename';
  94. /**
  95. * Suffix.
  96. */
  97. const SUFFIX = 'suffix';
  98. /**
  99. * Company.
  100. */
  101. const COMPANY = 'company';
  102. /**
  103. * Value-added tax (VAT) ID.
  104. */
  105. const VAT_ID = 'vat_id';
  106. /**
  107. * VAT-is-valid flag.
  108. */
  109. const VAT_IS_VALID = 'vat_is_valid';
  110. /**
  111. * VAT request ID.
  112. */
  113. const VAT_REQUEST_ID = 'vat_request_id';
  114. /**
  115. * VAT request date.
  116. */
  117. const VAT_REQUEST_DATE = 'vat_request_date';
  118. /**
  119. * VAT-request-success flag.
  120. */
  121. const VAT_REQUEST_SUCCESS = 'vat_request_success';
  122. /**
  123. * Gets the address type for the order address.
  124. *
  125. * @return string Address type.
  126. */
  127. public function getAddressType();
  128. /**
  129. * Gets the city for the order address.
  130. *
  131. * @return string City.
  132. */
  133. public function getCity();
  134. /**
  135. * Gets the company for the order address.
  136. *
  137. * @return string|null Company.
  138. */
  139. public function getCompany();
  140. /**
  141. * Gets the country ID for the order address.
  142. *
  143. * @return string Country ID.
  144. */
  145. public function getCountryId();
  146. /**
  147. * Gets the country address ID for the order address.
  148. *
  149. * @return int|null Country address ID.
  150. */
  151. public function getCustomerAddressId();
  152. /**
  153. * Gets the customer ID for the order address.
  154. *
  155. * @return int|null Customer ID.
  156. */
  157. public function getCustomerId();
  158. /**
  159. * Gets the email address for the order address.
  160. *
  161. * @return string|null Email address.
  162. */
  163. public function getEmail();
  164. /**
  165. * Gets the ID for the order address.
  166. *
  167. * @return int|null Order address ID.
  168. */
  169. public function getEntityId();
  170. /**
  171. * Sets the ID for the order address.
  172. *
  173. * @param int $entityId
  174. * @return $this
  175. */
  176. public function setEntityId($entityId);
  177. /**
  178. * Gets the fax number for the order address.
  179. *
  180. * @return string|null Fax number.
  181. */
  182. public function getFax();
  183. /**
  184. * Gets the first name for the order address.
  185. *
  186. * @return string First name.
  187. */
  188. public function getFirstname();
  189. /**
  190. * Gets the last name for the order address.
  191. *
  192. * @return string Last name.
  193. */
  194. public function getLastname();
  195. /**
  196. * Gets the middle name for the order address.
  197. *
  198. * @return string|null Middle name.
  199. */
  200. public function getMiddlename();
  201. /**
  202. * Gets the parent ID for the order address.
  203. *
  204. * @return int|null Parent ID.
  205. */
  206. public function getParentId();
  207. /**
  208. * Gets the postal code for the order address.
  209. *
  210. * @return string Postal code.
  211. */
  212. public function getPostcode();
  213. /**
  214. * Gets the prefix for the order address.
  215. *
  216. * @return string|null Prefix.
  217. */
  218. public function getPrefix();
  219. /**
  220. * Gets the region for the order address.
  221. *
  222. * @return string|null Region.
  223. */
  224. public function getRegion();
  225. /**
  226. * Gets the region code for the order address
  227. *
  228. * @return string|null Region code.
  229. */
  230. public function getRegionCode();
  231. /**
  232. * Gets the region ID for the order address.
  233. *
  234. * @return int|null Region ID.
  235. */
  236. public function getRegionId();
  237. /**
  238. * Gets the street values, if any, for the order address.
  239. *
  240. * @return string[]|null Array of any street values. Otherwise, null.
  241. */
  242. public function getStreet();
  243. /**
  244. * Gets the suffix for the order address.
  245. *
  246. * @return string|null Suffix.
  247. */
  248. public function getSuffix();
  249. /**
  250. * Gets the telephone number for the order address.
  251. *
  252. * @return string Telephone number.
  253. */
  254. public function getTelephone();
  255. /**
  256. * Gets the VAT ID for the order address.
  257. *
  258. * @return string|null VAT ID.
  259. */
  260. public function getVatId();
  261. /**
  262. * Gets the VAT-is-valid flag value for the order address.
  263. *
  264. * @return int|null VAT-is-valid flag value.
  265. */
  266. public function getVatIsValid();
  267. /**
  268. * Gets the VAT request date for the order address.
  269. *
  270. * @return string|null VAT request date.
  271. */
  272. public function getVatRequestDate();
  273. /**
  274. * Gets the VAT request ID for the order address.
  275. *
  276. * @return string|null VAT request ID.
  277. */
  278. public function getVatRequestId();
  279. /**
  280. * Gets the VAT-request-success flag value for the order address.
  281. *
  282. * @return int|null VAT-request-success flag value.
  283. */
  284. public function getVatRequestSuccess();
  285. /**
  286. * Sets the parent ID for the order address.
  287. *
  288. * @param int $id
  289. * @return $this
  290. */
  291. public function setParentId($id);
  292. /**
  293. * Sets the country address ID for the order address.
  294. *
  295. * @param int $id
  296. * @return $this
  297. */
  298. public function setCustomerAddressId($id);
  299. /**
  300. * Sets the region ID for the order address.
  301. *
  302. * @param int $id
  303. * @return $this
  304. */
  305. public function setRegionId($id);
  306. /**
  307. * Sets the customer ID for the order address.
  308. *
  309. * @param int $id
  310. * @return $this
  311. */
  312. public function setCustomerId($id);
  313. /**
  314. * Sets the fax number for the order address.
  315. *
  316. * @param string $fax
  317. * @return $this
  318. */
  319. public function setFax($fax);
  320. /**
  321. * Sets the region for the order address.
  322. *
  323. * @param string $region
  324. * @return $this
  325. */
  326. public function setRegion($region);
  327. /**
  328. * Sets the postal code for the order address.
  329. *
  330. * @param string $postcode
  331. * @return $this
  332. */
  333. public function setPostcode($postcode);
  334. /**
  335. * Sets the last name for the order address.
  336. *
  337. * @param string $lastname
  338. * @return $this
  339. */
  340. public function setLastname($lastname);
  341. /**
  342. * Sets the street values, if any, for the order address.
  343. *
  344. * @param string|string[] $street
  345. * @return $this
  346. */
  347. public function setStreet($street);
  348. /**
  349. * Sets the city for the order address.
  350. *
  351. * @param string $city
  352. * @return $this
  353. */
  354. public function setCity($city);
  355. /**
  356. * Sets the email address for the order address.
  357. *
  358. * @param string $email
  359. * @return $this
  360. */
  361. public function setEmail($email);
  362. /**
  363. * Sets the telephone number for the order address.
  364. *
  365. * @param string $telephone
  366. * @return $this
  367. */
  368. public function setTelephone($telephone);
  369. /**
  370. * Sets the country ID for the order address.
  371. *
  372. * @param string $id
  373. * @return $this
  374. */
  375. public function setCountryId($id);
  376. /**
  377. * Sets the first name for the order address.
  378. *
  379. * @param string $firstname
  380. * @return $this
  381. */
  382. public function setFirstname($firstname);
  383. /**
  384. * Sets the address type for the order address.
  385. *
  386. * @param string $addressType
  387. * @return $this
  388. */
  389. public function setAddressType($addressType);
  390. /**
  391. * Sets the prefix for the order address.
  392. *
  393. * @param string $prefix
  394. * @return $this
  395. */
  396. public function setPrefix($prefix);
  397. /**
  398. * Sets the middle name for the order address.
  399. *
  400. * @param string $middlename
  401. * @return $this
  402. */
  403. public function setMiddlename($middlename);
  404. /**
  405. * Sets the suffix for the order address.
  406. *
  407. * @param string $suffix
  408. * @return $this
  409. */
  410. public function setSuffix($suffix);
  411. /**
  412. * Sets the company for the order address.
  413. *
  414. * @param string $company
  415. * @return $this
  416. */
  417. public function setCompany($company);
  418. /**
  419. * Sets the VAT ID for the order address.
  420. *
  421. * @param string $id
  422. * @return $this
  423. */
  424. public function setVatId($id);
  425. /**
  426. * Sets the VAT-is-valid flag value for the order address.
  427. *
  428. * @param int $vatIsValid
  429. * @return $this
  430. */
  431. public function setVatIsValid($vatIsValid);
  432. /**
  433. * Sets the VAT request ID for the order address.
  434. *
  435. * @param string $id
  436. * @return $this
  437. */
  438. public function setVatRequestId($id);
  439. /**
  440. * Set region code
  441. *
  442. * @param string $regionCode
  443. * @return $this
  444. */
  445. public function setRegionCode($regionCode);
  446. /**
  447. * Sets the VAT request date for the order address.
  448. *
  449. * @param string $vatRequestDate
  450. * @return $this
  451. */
  452. public function setVatRequestDate($vatRequestDate);
  453. /**
  454. * Sets the VAT-request-success flag value for the order address.
  455. *
  456. * @param int $vatRequestSuccess
  457. * @return $this
  458. */
  459. public function setVatRequestSuccess($vatRequestSuccess);
  460. /**
  461. * Retrieve existing extension attributes object or create a new one.
  462. *
  463. * @return \Magento\Sales\Api\Data\OrderAddressExtensionInterface|null
  464. */
  465. public function getExtensionAttributes();
  466. /**
  467. * Set an extension attributes object.
  468. *
  469. * @param \Magento\Sales\Api\Data\OrderAddressExtensionInterface $extensionAttributes
  470. * @return $this
  471. */
  472. public function setExtensionAttributes(\Magento\Sales\Api\Data\OrderAddressExtensionInterface $extensionAttributes);
  473. }