order.e2e-spec.ts 66 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803
  1. /* tslint:disable:no-non-null-assertion */
  2. import { pick } from '@vendure/common/lib/pick';
  3. import { manualFulfillmentHandler } from '@vendure/core';
  4. import {
  5. createErrorResultGuard,
  6. createTestEnvironment,
  7. ErrorResultGuard,
  8. SimpleGraphQLClient,
  9. } from '@vendure/testing';
  10. import gql from 'graphql-tag';
  11. import path from 'path';
  12. import { initialData } from '../../../e2e-common/e2e-initial-data';
  13. import { testConfig, TEST_SETUP_TIMEOUT_MS } from '../../../e2e-common/test-config';
  14. import {
  15. failsToSettlePaymentMethod,
  16. onTransitionSpy,
  17. singleStageRefundablePaymentMethod,
  18. twoStagePaymentMethod,
  19. } from './fixtures/test-payment-methods';
  20. import { FULFILLMENT_FRAGMENT } from './graphql/fragments';
  21. import {
  22. AddNoteToOrder,
  23. CanceledOrderFragment,
  24. CancelOrder,
  25. CreateFulfillment,
  26. DeleteOrderNote,
  27. ErrorCode,
  28. FulfillmentFragment,
  29. GetCustomerList,
  30. GetOrder,
  31. GetOrderFulfillmentItems,
  32. GetOrderFulfillments,
  33. GetOrderHistory,
  34. GetOrderList,
  35. GetOrderListFulfillments,
  36. GetOrderWithPayments,
  37. GetProductWithVariants,
  38. GetStockMovement,
  39. GlobalFlag,
  40. HistoryEntryType,
  41. OrderLineInput,
  42. PaymentFragment,
  43. RefundFragment,
  44. RefundOrder,
  45. SettlePayment,
  46. SettleRefund,
  47. SortOrder,
  48. StockMovementType,
  49. TransitFulfillment,
  50. UpdateOrderNote,
  51. UpdateProductVariants,
  52. } from './graphql/generated-e2e-admin-types';
  53. import {
  54. AddItemToOrder,
  55. DeletionResult,
  56. GetActiveOrder,
  57. GetOrderByCodeWithPayments,
  58. TestOrderFragmentFragment,
  59. UpdatedOrder,
  60. } from './graphql/generated-e2e-shop-types';
  61. import {
  62. CANCEL_ORDER,
  63. CREATE_FULFILLMENT,
  64. GET_CUSTOMER_LIST,
  65. GET_ORDER,
  66. GET_ORDERS_LIST,
  67. GET_ORDER_FULFILLMENTS,
  68. GET_PRODUCT_WITH_VARIANTS,
  69. GET_STOCK_MOVEMENT,
  70. SETTLE_PAYMENT,
  71. TRANSIT_FULFILLMENT,
  72. UPDATE_PRODUCT_VARIANTS,
  73. } from './graphql/shared-definitions';
  74. import {
  75. ADD_ITEM_TO_ORDER,
  76. GET_ACTIVE_ORDER,
  77. GET_ORDER_BY_CODE_WITH_PAYMENTS,
  78. } from './graphql/shop-definitions';
  79. import { assertThrowsWithMessage } from './utils/assert-throws-with-message';
  80. import { addPaymentToOrder, proceedToArrangingPayment, sortById } from './utils/test-order-utils';
  81. describe('Orders resolver', () => {
  82. const { server, adminClient, shopClient } = createTestEnvironment({
  83. ...testConfig,
  84. paymentOptions: {
  85. paymentMethodHandlers: [
  86. twoStagePaymentMethod,
  87. failsToSettlePaymentMethod,
  88. singleStageRefundablePaymentMethod,
  89. ],
  90. },
  91. });
  92. let customers: GetCustomerList.Items[];
  93. const password = 'test';
  94. const orderGuard: ErrorResultGuard<
  95. TestOrderFragmentFragment | CanceledOrderFragment
  96. > = createErrorResultGuard(input => !!input.lines);
  97. const paymentGuard: ErrorResultGuard<PaymentFragment> = createErrorResultGuard(input => !!input.state);
  98. const fulfillmentGuard: ErrorResultGuard<FulfillmentFragment> = createErrorResultGuard(
  99. input => !!input.method,
  100. );
  101. const refundGuard: ErrorResultGuard<RefundFragment> = createErrorResultGuard(input => !!input.items);
  102. beforeAll(async () => {
  103. await server.init({
  104. initialData,
  105. productsCsvPath: path.join(__dirname, 'fixtures/e2e-products-full.csv'),
  106. customerCount: 3,
  107. });
  108. await adminClient.asSuperAdmin();
  109. // Create a couple of orders to be queried
  110. const result = await adminClient.query<GetCustomerList.Query, GetCustomerList.Variables>(
  111. GET_CUSTOMER_LIST,
  112. {
  113. options: {
  114. take: 3,
  115. },
  116. },
  117. );
  118. customers = result.customers.items;
  119. await shopClient.asUserWithCredentials(customers[0].emailAddress, password);
  120. await shopClient.query<AddItemToOrder.Mutation, AddItemToOrder.Variables>(ADD_ITEM_TO_ORDER, {
  121. productVariantId: 'T_1',
  122. quantity: 1,
  123. });
  124. await shopClient.query<AddItemToOrder.Mutation, AddItemToOrder.Variables>(ADD_ITEM_TO_ORDER, {
  125. productVariantId: 'T_2',
  126. quantity: 1,
  127. });
  128. await shopClient.asUserWithCredentials(customers[1].emailAddress, password);
  129. await shopClient.query<AddItemToOrder.Mutation, AddItemToOrder.Variables>(ADD_ITEM_TO_ORDER, {
  130. productVariantId: 'T_2',
  131. quantity: 1,
  132. });
  133. await shopClient.query<AddItemToOrder.Mutation, AddItemToOrder.Variables>(ADD_ITEM_TO_ORDER, {
  134. productVariantId: 'T_3',
  135. quantity: 3,
  136. });
  137. }, TEST_SETUP_TIMEOUT_MS);
  138. afterAll(async () => {
  139. await server.destroy();
  140. });
  141. it('orders', async () => {
  142. const result = await adminClient.query<GetOrderList.Query>(GET_ORDERS_LIST);
  143. expect(result.orders.items.map(o => o.id)).toEqual(['T_1', 'T_2']);
  144. });
  145. it('order', async () => {
  146. const result = await adminClient.query<GetOrder.Query, GetOrder.Variables>(GET_ORDER, { id: 'T_2' });
  147. expect(result.order!.id).toBe('T_2');
  148. });
  149. it('order history initially contains Created -> AddingItems transition', async () => {
  150. const { order } = await adminClient.query<GetOrderHistory.Query, GetOrderHistory.Variables>(
  151. GET_ORDER_HISTORY,
  152. { id: 'T_1' },
  153. );
  154. expect(order!.history.totalItems).toBe(1);
  155. expect(order!.history.items.map(pick(['type', 'data']))).toEqual([
  156. {
  157. type: HistoryEntryType.ORDER_STATE_TRANSITION,
  158. data: {
  159. from: 'Created',
  160. to: 'AddingItems',
  161. },
  162. },
  163. ]);
  164. });
  165. describe('payments', () => {
  166. let firstOrderCode: string;
  167. let firstOrderId: string;
  168. it('settlePayment fails', async () => {
  169. await shopClient.asUserWithCredentials(customers[0].emailAddress, password);
  170. await proceedToArrangingPayment(shopClient);
  171. const order = await addPaymentToOrder(shopClient, failsToSettlePaymentMethod);
  172. orderGuard.assertSuccess(order);
  173. expect(order.state).toBe('PaymentAuthorized');
  174. const payment = order.payments![0];
  175. const { settlePayment } = await adminClient.query<
  176. SettlePayment.Mutation,
  177. SettlePayment.Variables
  178. >(SETTLE_PAYMENT, {
  179. id: payment.id,
  180. });
  181. paymentGuard.assertErrorResult(settlePayment);
  182. expect(settlePayment.message).toBe('Settling the payment failed');
  183. expect(settlePayment.errorCode).toBe(ErrorCode.SETTLE_PAYMENT_ERROR);
  184. expect((settlePayment as any).paymentErrorMessage).toBe('Something went horribly wrong');
  185. const result = await adminClient.query<GetOrder.Query, GetOrder.Variables>(GET_ORDER, {
  186. id: order.id,
  187. });
  188. expect(result.order!.state).toBe('PaymentAuthorized');
  189. firstOrderCode = order.code;
  190. firstOrderId = order.id;
  191. });
  192. it('public payment metadata available in Shop API', async () => {
  193. const { orderByCode } = await shopClient.query<
  194. GetOrderByCodeWithPayments.Query,
  195. GetOrderByCodeWithPayments.Variables
  196. >(GET_ORDER_BY_CODE_WITH_PAYMENTS, { code: firstOrderCode });
  197. expect(orderByCode?.payments?.[0].metadata).toEqual({
  198. public: {
  199. publicCreatePaymentData: 'public',
  200. publicSettlePaymentData: 'public',
  201. },
  202. });
  203. });
  204. it('public and private payment metadata available in Admin API', async () => {
  205. const { order } = await adminClient.query<
  206. GetOrderWithPayments.Query,
  207. GetOrderWithPayments.Variables
  208. >(GET_ORDER_WITH_PAYMENTS, { id: firstOrderId });
  209. expect(order?.payments?.[0].metadata).toEqual({
  210. privateCreatePaymentData: 'secret',
  211. privateSettlePaymentData: 'secret',
  212. public: {
  213. publicCreatePaymentData: 'public',
  214. publicSettlePaymentData: 'public',
  215. },
  216. });
  217. });
  218. it('settlePayment succeeds, onStateTransitionStart called', async () => {
  219. onTransitionSpy.mockClear();
  220. await shopClient.asUserWithCredentials(customers[1].emailAddress, password);
  221. await proceedToArrangingPayment(shopClient);
  222. const order = await addPaymentToOrder(shopClient, twoStagePaymentMethod);
  223. orderGuard.assertSuccess(order);
  224. expect(order.state).toBe('PaymentAuthorized');
  225. expect(onTransitionSpy).toHaveBeenCalledTimes(1);
  226. expect(onTransitionSpy.mock.calls[0][0]).toBe('Created');
  227. expect(onTransitionSpy.mock.calls[0][1]).toBe('Authorized');
  228. const payment = order.payments![0];
  229. const { settlePayment } = await adminClient.query<
  230. SettlePayment.Mutation,
  231. SettlePayment.Variables
  232. >(SETTLE_PAYMENT, {
  233. id: payment.id,
  234. });
  235. paymentGuard.assertSuccess(settlePayment);
  236. expect(settlePayment!.id).toBe(payment.id);
  237. expect(settlePayment!.state).toBe('Settled');
  238. // further metadata is combined into existing object
  239. expect(settlePayment!.metadata).toEqual({
  240. moreData: 42,
  241. public: {
  242. baz: 'quux',
  243. },
  244. });
  245. expect(onTransitionSpy).toHaveBeenCalledTimes(2);
  246. expect(onTransitionSpy.mock.calls[1][0]).toBe('Authorized');
  247. expect(onTransitionSpy.mock.calls[1][1]).toBe('Settled');
  248. const result = await adminClient.query<GetOrder.Query, GetOrder.Variables>(GET_ORDER, {
  249. id: order.id,
  250. });
  251. expect(result.order!.state).toBe('PaymentSettled');
  252. expect(result.order!.payments![0].state).toBe('Settled');
  253. });
  254. it('order history contains expected entries', async () => {
  255. const { order } = await adminClient.query<GetOrderHistory.Query, GetOrderHistory.Variables>(
  256. GET_ORDER_HISTORY,
  257. { id: 'T_2', options: { sort: { id: SortOrder.ASC } } },
  258. );
  259. expect(order!.history.items.map(pick(['type', 'data']))).toEqual([
  260. {
  261. type: HistoryEntryType.ORDER_STATE_TRANSITION,
  262. data: {
  263. from: 'Created',
  264. to: 'AddingItems',
  265. },
  266. },
  267. {
  268. type: HistoryEntryType.ORDER_STATE_TRANSITION,
  269. data: {
  270. from: 'AddingItems',
  271. to: 'ArrangingPayment',
  272. },
  273. },
  274. {
  275. type: HistoryEntryType.ORDER_PAYMENT_TRANSITION,
  276. data: {
  277. paymentId: 'T_2',
  278. from: 'Created',
  279. to: 'Authorized',
  280. },
  281. },
  282. {
  283. type: HistoryEntryType.ORDER_STATE_TRANSITION,
  284. data: {
  285. from: 'ArrangingPayment',
  286. to: 'PaymentAuthorized',
  287. },
  288. },
  289. {
  290. type: HistoryEntryType.ORDER_PAYMENT_TRANSITION,
  291. data: {
  292. paymentId: 'T_2',
  293. from: 'Authorized',
  294. to: 'Settled',
  295. },
  296. },
  297. {
  298. type: HistoryEntryType.ORDER_STATE_TRANSITION,
  299. data: {
  300. from: 'PaymentAuthorized',
  301. to: 'PaymentSettled',
  302. },
  303. },
  304. ]);
  305. });
  306. });
  307. describe('fulfillment', () => {
  308. const orderId = 'T_2';
  309. let f1Id: string;
  310. let f2Id: string;
  311. let f3Id: string;
  312. it('return error result if lines is empty', async () => {
  313. const { order } = await adminClient.query<GetOrder.Query, GetOrder.Variables>(GET_ORDER, {
  314. id: orderId,
  315. });
  316. expect(order!.state).toBe('PaymentSettled');
  317. const { addFulfillmentToOrder } = await adminClient.query<
  318. CreateFulfillment.Mutation,
  319. CreateFulfillment.Variables
  320. >(CREATE_FULFILLMENT, {
  321. input: {
  322. lines: [],
  323. handler: {
  324. code: manualFulfillmentHandler.code,
  325. arguments: [{ name: 'method', value: 'Test' }],
  326. },
  327. },
  328. });
  329. fulfillmentGuard.assertErrorResult(addFulfillmentToOrder);
  330. expect(addFulfillmentToOrder.message).toBe('At least one OrderLine must be specified');
  331. expect(addFulfillmentToOrder.errorCode).toBe(ErrorCode.EMPTY_ORDER_LINE_SELECTION_ERROR);
  332. });
  333. it('returns error result if all quantities are zero', async () => {
  334. const { order } = await adminClient.query<GetOrder.Query, GetOrder.Variables>(GET_ORDER, {
  335. id: orderId,
  336. });
  337. expect(order!.state).toBe('PaymentSettled');
  338. const { addFulfillmentToOrder } = await adminClient.query<
  339. CreateFulfillment.Mutation,
  340. CreateFulfillment.Variables
  341. >(CREATE_FULFILLMENT, {
  342. input: {
  343. lines: order!.lines.map(l => ({ orderLineId: l.id, quantity: 0 })),
  344. handler: {
  345. code: manualFulfillmentHandler.code,
  346. arguments: [{ name: 'method', value: 'Test' }],
  347. },
  348. },
  349. });
  350. fulfillmentGuard.assertErrorResult(addFulfillmentToOrder);
  351. expect(addFulfillmentToOrder.message).toBe('At least one OrderLine must be specified');
  352. expect(addFulfillmentToOrder.errorCode).toBe(ErrorCode.EMPTY_ORDER_LINE_SELECTION_ERROR);
  353. });
  354. it('creates the first fulfillment', async () => {
  355. const { order } = await adminClient.query<GetOrder.Query, GetOrder.Variables>(GET_ORDER, {
  356. id: orderId,
  357. });
  358. expect(order!.state).toBe('PaymentSettled');
  359. const lines = order!.lines;
  360. const { addFulfillmentToOrder } = await adminClient.query<
  361. CreateFulfillment.Mutation,
  362. CreateFulfillment.Variables
  363. >(CREATE_FULFILLMENT, {
  364. input: {
  365. lines: [{ orderLineId: lines[0].id, quantity: lines[0].quantity }],
  366. handler: {
  367. code: manualFulfillmentHandler.code,
  368. arguments: [
  369. { name: 'method', value: 'Test1' },
  370. { name: 'trackingCode', value: '111' },
  371. ],
  372. },
  373. },
  374. });
  375. fulfillmentGuard.assertSuccess(addFulfillmentToOrder);
  376. expect(addFulfillmentToOrder.id).toBe('T_1');
  377. expect(addFulfillmentToOrder.method).toBe('Test1');
  378. expect(addFulfillmentToOrder.trackingCode).toBe('111');
  379. expect(addFulfillmentToOrder.state).toBe('Pending');
  380. expect(addFulfillmentToOrder.orderItems).toEqual([{ id: lines[0].items[0].id }]);
  381. f1Id = addFulfillmentToOrder.id;
  382. const result = await adminClient.query<GetOrder.Query, GetOrder.Variables>(GET_ORDER, {
  383. id: orderId,
  384. });
  385. expect(result.order!.lines[0].items[0].fulfillment!.id).toBe(addFulfillmentToOrder!.id);
  386. expect(
  387. result.order!.lines[1].items.filter(
  388. i => i.fulfillment && i.fulfillment.id === addFulfillmentToOrder.id,
  389. ).length,
  390. ).toBe(0);
  391. expect(result.order!.lines[1].items.filter(i => i.fulfillment == null).length).toBe(3);
  392. });
  393. it('creates the second fulfillment', async () => {
  394. const lines = await getUnfulfilledOrderLineInput(adminClient, orderId);
  395. const { addFulfillmentToOrder } = await adminClient.query<
  396. CreateFulfillment.Mutation,
  397. CreateFulfillment.Variables
  398. >(CREATE_FULFILLMENT, {
  399. input: {
  400. lines,
  401. handler: {
  402. code: manualFulfillmentHandler.code,
  403. arguments: [
  404. { name: 'method', value: 'Test2' },
  405. { name: 'trackingCode', value: '222' },
  406. ],
  407. },
  408. },
  409. });
  410. fulfillmentGuard.assertSuccess(addFulfillmentToOrder);
  411. expect(addFulfillmentToOrder.id).toBe('T_2');
  412. expect(addFulfillmentToOrder.method).toBe('Test2');
  413. expect(addFulfillmentToOrder.trackingCode).toBe('222');
  414. expect(addFulfillmentToOrder.state).toBe('Pending');
  415. f2Id = addFulfillmentToOrder.id;
  416. });
  417. it('cancels second fulfillment', async () => {
  418. const { transitionFulfillmentToState } = await adminClient.query<
  419. TransitFulfillment.Mutation,
  420. TransitFulfillment.Variables
  421. >(TRANSIT_FULFILLMENT, {
  422. id: f2Id,
  423. state: 'Cancelled',
  424. });
  425. fulfillmentGuard.assertSuccess(transitionFulfillmentToState);
  426. expect(transitionFulfillmentToState.id).toBe('T_2');
  427. expect(transitionFulfillmentToState.state).toBe('Cancelled');
  428. });
  429. it('order.fulfillments still lists second (cancelled) fulfillment', async () => {
  430. const { order } = await adminClient.query<
  431. GetOrderFulfillments.Query,
  432. GetOrderFulfillments.Variables
  433. >(GET_ORDER_FULFILLMENTS, {
  434. id: orderId,
  435. });
  436. expect(order?.fulfillments?.map(pick(['id', 'state']))).toEqual([
  437. { id: f1Id, state: 'Pending' },
  438. { id: f2Id, state: 'Cancelled' },
  439. ]);
  440. });
  441. it('creates third fulfillment with same items from second fulfillment', async () => {
  442. const lines = await getUnfulfilledOrderLineInput(adminClient, orderId);
  443. const { addFulfillmentToOrder } = await adminClient.query<
  444. CreateFulfillment.Mutation,
  445. CreateFulfillment.Variables
  446. >(CREATE_FULFILLMENT, {
  447. input: {
  448. lines,
  449. handler: {
  450. code: manualFulfillmentHandler.code,
  451. arguments: [
  452. { name: 'method', value: 'Test3' },
  453. { name: 'trackingCode', value: '333' },
  454. ],
  455. },
  456. },
  457. });
  458. fulfillmentGuard.assertSuccess(addFulfillmentToOrder);
  459. expect(addFulfillmentToOrder.id).toBe('T_3');
  460. expect(addFulfillmentToOrder.method).toBe('Test3');
  461. expect(addFulfillmentToOrder.trackingCode).toBe('333');
  462. expect(addFulfillmentToOrder.state).toBe('Pending');
  463. f3Id = addFulfillmentToOrder.id;
  464. });
  465. it('returns error result if an OrderItem already part of a Fulfillment', async () => {
  466. const { order } = await adminClient.query<GetOrder.Query, GetOrder.Variables>(GET_ORDER, {
  467. id: orderId,
  468. });
  469. const { addFulfillmentToOrder } = await adminClient.query<
  470. CreateFulfillment.Mutation,
  471. CreateFulfillment.Variables
  472. >(CREATE_FULFILLMENT, {
  473. input: {
  474. lines: [
  475. {
  476. orderLineId: order!.lines[0].id,
  477. quantity: 1,
  478. },
  479. ],
  480. handler: {
  481. code: manualFulfillmentHandler.code,
  482. arguments: [{ name: 'method', value: 'Test' }],
  483. },
  484. },
  485. });
  486. fulfillmentGuard.assertErrorResult(addFulfillmentToOrder);
  487. expect(addFulfillmentToOrder.message).toBe(
  488. 'One or more OrderItems are already part of a Fulfillment',
  489. );
  490. expect(addFulfillmentToOrder.errorCode).toBe(ErrorCode.ITEMS_ALREADY_FULFILLED_ERROR);
  491. });
  492. it('transitions the first fulfillment from created to Shipped and automatically change the order state to PartiallyShipped', async () => {
  493. const { transitionFulfillmentToState } = await adminClient.query<
  494. TransitFulfillment.Mutation,
  495. TransitFulfillment.Variables
  496. >(TRANSIT_FULFILLMENT, {
  497. id: f1Id,
  498. state: 'Shipped',
  499. });
  500. fulfillmentGuard.assertSuccess(transitionFulfillmentToState);
  501. expect(transitionFulfillmentToState.id).toBe(f1Id);
  502. expect(transitionFulfillmentToState.state).toBe('Shipped');
  503. const { order } = await adminClient.query<GetOrder.Query, GetOrder.Variables>(GET_ORDER, {
  504. id: orderId,
  505. });
  506. expect(order?.state).toBe('PartiallyShipped');
  507. });
  508. it('transitions the third fulfillment from created to Shipped and automatically change the order state to Shipped', async () => {
  509. const { transitionFulfillmentToState } = await adminClient.query<
  510. TransitFulfillment.Mutation,
  511. TransitFulfillment.Variables
  512. >(TRANSIT_FULFILLMENT, {
  513. id: f3Id,
  514. state: 'Shipped',
  515. });
  516. fulfillmentGuard.assertSuccess(transitionFulfillmentToState);
  517. expect(transitionFulfillmentToState.id).toBe(f3Id);
  518. expect(transitionFulfillmentToState.state).toBe('Shipped');
  519. const { order } = await adminClient.query<GetOrder.Query, GetOrder.Variables>(GET_ORDER, {
  520. id: orderId,
  521. });
  522. expect(order?.state).toBe('Shipped');
  523. });
  524. it('transitions the first fulfillment from Shipped to Delivered and change the order state to PartiallyDelivered', async () => {
  525. const { transitionFulfillmentToState } = await adminClient.query<
  526. TransitFulfillment.Mutation,
  527. TransitFulfillment.Variables
  528. >(TRANSIT_FULFILLMENT, {
  529. id: f1Id,
  530. state: 'Delivered',
  531. });
  532. fulfillmentGuard.assertSuccess(transitionFulfillmentToState);
  533. expect(transitionFulfillmentToState.id).toBe(f1Id);
  534. expect(transitionFulfillmentToState.state).toBe('Delivered');
  535. const { order } = await adminClient.query<GetOrder.Query, GetOrder.Variables>(GET_ORDER, {
  536. id: orderId,
  537. });
  538. expect(order?.state).toBe('PartiallyDelivered');
  539. });
  540. it('transitions the third fulfillment from Shipped to Delivered and change the order state to Delivered', async () => {
  541. const { transitionFulfillmentToState } = await adminClient.query<
  542. TransitFulfillment.Mutation,
  543. TransitFulfillment.Variables
  544. >(TRANSIT_FULFILLMENT, {
  545. id: f3Id,
  546. state: 'Delivered',
  547. });
  548. fulfillmentGuard.assertSuccess(transitionFulfillmentToState);
  549. expect(transitionFulfillmentToState.id).toBe(f3Id);
  550. expect(transitionFulfillmentToState.state).toBe('Delivered');
  551. const { order } = await adminClient.query<GetOrder.Query, GetOrder.Variables>(GET_ORDER, {
  552. id: orderId,
  553. });
  554. expect(order?.state).toBe('Delivered');
  555. });
  556. it('order history contains expected entries', async () => {
  557. const { order } = await adminClient.query<GetOrderHistory.Query, GetOrderHistory.Variables>(
  558. GET_ORDER_HISTORY,
  559. {
  560. id: orderId,
  561. options: {
  562. skip: 6,
  563. },
  564. },
  565. );
  566. expect(order!.history.items.map(pick(['type', 'data']))).toEqual([
  567. {
  568. data: {
  569. fulfillmentId: f1Id,
  570. },
  571. type: HistoryEntryType.ORDER_FULFILLMENT,
  572. },
  573. {
  574. data: {
  575. from: 'Created',
  576. fulfillmentId: f1Id,
  577. to: 'Pending',
  578. },
  579. type: HistoryEntryType.ORDER_FULFILLMENT_TRANSITION,
  580. },
  581. {
  582. data: {
  583. fulfillmentId: f2Id,
  584. },
  585. type: HistoryEntryType.ORDER_FULFILLMENT,
  586. },
  587. {
  588. data: {
  589. from: 'Created',
  590. fulfillmentId: f2Id,
  591. to: 'Pending',
  592. },
  593. type: HistoryEntryType.ORDER_FULFILLMENT_TRANSITION,
  594. },
  595. {
  596. data: {
  597. from: 'Pending',
  598. fulfillmentId: f2Id,
  599. to: 'Cancelled',
  600. },
  601. type: HistoryEntryType.ORDER_FULFILLMENT_TRANSITION,
  602. },
  603. {
  604. data: {
  605. fulfillmentId: f3Id,
  606. },
  607. type: HistoryEntryType.ORDER_FULFILLMENT,
  608. },
  609. {
  610. data: {
  611. from: 'Created',
  612. fulfillmentId: f3Id,
  613. to: 'Pending',
  614. },
  615. type: HistoryEntryType.ORDER_FULFILLMENT_TRANSITION,
  616. },
  617. {
  618. data: {
  619. from: 'Pending',
  620. fulfillmentId: f1Id,
  621. to: 'Shipped',
  622. },
  623. type: HistoryEntryType.ORDER_FULFILLMENT_TRANSITION,
  624. },
  625. {
  626. data: {
  627. from: 'PaymentSettled',
  628. to: 'PartiallyShipped',
  629. },
  630. type: HistoryEntryType.ORDER_STATE_TRANSITION,
  631. },
  632. {
  633. data: {
  634. from: 'Pending',
  635. fulfillmentId: f3Id,
  636. to: 'Shipped',
  637. },
  638. type: HistoryEntryType.ORDER_FULFILLMENT_TRANSITION,
  639. },
  640. {
  641. data: {
  642. from: 'PartiallyShipped',
  643. to: 'Shipped',
  644. },
  645. type: HistoryEntryType.ORDER_STATE_TRANSITION,
  646. },
  647. {
  648. data: {
  649. from: 'Shipped',
  650. fulfillmentId: f1Id,
  651. to: 'Delivered',
  652. },
  653. type: HistoryEntryType.ORDER_FULFILLMENT_TRANSITION,
  654. },
  655. {
  656. data: {
  657. from: 'Shipped',
  658. to: 'PartiallyDelivered',
  659. },
  660. type: HistoryEntryType.ORDER_STATE_TRANSITION,
  661. },
  662. {
  663. data: {
  664. from: 'Shipped',
  665. fulfillmentId: f3Id,
  666. to: 'Delivered',
  667. },
  668. type: HistoryEntryType.ORDER_FULFILLMENT_TRANSITION,
  669. },
  670. {
  671. data: {
  672. from: 'PartiallyDelivered',
  673. to: 'Delivered',
  674. },
  675. type: HistoryEntryType.ORDER_STATE_TRANSITION,
  676. },
  677. ]);
  678. });
  679. it('order.fulfillments resolver for single order', async () => {
  680. const { order } = await adminClient.query<
  681. GetOrderFulfillments.Query,
  682. GetOrderFulfillments.Variables
  683. >(GET_ORDER_FULFILLMENTS, {
  684. id: orderId,
  685. });
  686. expect(order!.fulfillments?.sort(sortById)).toEqual([
  687. { id: f1Id, method: 'Test1', state: 'Delivered', nextStates: ['Cancelled'] },
  688. { id: f2Id, method: 'Test2', state: 'Cancelled', nextStates: [] },
  689. { id: f3Id, method: 'Test3', state: 'Delivered', nextStates: ['Cancelled'] },
  690. ]);
  691. });
  692. it('order.fulfillments resolver for order list', async () => {
  693. const { orders } = await adminClient.query<GetOrderListFulfillments.Query>(
  694. GET_ORDER_LIST_FULFILLMENTS,
  695. );
  696. expect(orders.items[0].fulfillments).toEqual([]);
  697. expect(orders.items[1].fulfillments).toEqual([
  698. { id: f1Id, method: 'Test1', state: 'Delivered', nextStates: ['Cancelled'] },
  699. { id: f2Id, method: 'Test2', state: 'Cancelled', nextStates: [] },
  700. { id: f3Id, method: 'Test3', state: 'Delivered', nextStates: ['Cancelled'] },
  701. ]);
  702. });
  703. it('order.fulfillments.orderItems resolver', async () => {
  704. const { order } = await adminClient.query<
  705. GetOrderFulfillmentItems.Query,
  706. GetOrderFulfillmentItems.Variables
  707. >(GET_ORDER_FULFILLMENT_ITEMS, {
  708. id: orderId,
  709. });
  710. expect(order!.fulfillments![0].orderItems).toEqual([{ id: 'T_3' }]);
  711. expect(order!.fulfillments![1].orderItems).toEqual([{ id: 'T_4' }, { id: 'T_5' }, { id: 'T_6' }]);
  712. expect(order!.fulfillments![2].orderItems).toEqual([{ id: 'T_4' }, { id: 'T_5' }, { id: 'T_6' }]);
  713. });
  714. });
  715. describe('cancellation by orderId', () => {
  716. it('cancel from AddingItems state', async () => {
  717. const testOrder = await createTestOrder(
  718. adminClient,
  719. shopClient,
  720. customers[0].emailAddress,
  721. password,
  722. );
  723. const { order } = await adminClient.query<GetOrder.Query, GetOrder.Variables>(GET_ORDER, {
  724. id: testOrder.orderId,
  725. });
  726. expect(order!.state).toBe('AddingItems');
  727. const { cancelOrder } = await adminClient.query<CancelOrder.Mutation, CancelOrder.Variables>(
  728. CANCEL_ORDER,
  729. {
  730. input: {
  731. orderId: testOrder.orderId,
  732. },
  733. },
  734. );
  735. const { order: order2 } = await adminClient.query<GetOrder.Query, GetOrder.Variables>(GET_ORDER, {
  736. id: testOrder.orderId,
  737. });
  738. expect(order2!.state).toBe('Cancelled');
  739. expect(order2!.active).toBe(false);
  740. await assertNoStockMovementsCreated(testOrder.product.id);
  741. });
  742. it('cancel from ArrangingPayment state', async () => {
  743. const testOrder = await createTestOrder(
  744. adminClient,
  745. shopClient,
  746. customers[0].emailAddress,
  747. password,
  748. );
  749. await proceedToArrangingPayment(shopClient);
  750. const { order } = await adminClient.query<GetOrder.Query, GetOrder.Variables>(GET_ORDER, {
  751. id: testOrder.orderId,
  752. });
  753. expect(order!.state).toBe('ArrangingPayment');
  754. await adminClient.query<CancelOrder.Mutation, CancelOrder.Variables>(CANCEL_ORDER, {
  755. input: {
  756. orderId: testOrder.orderId,
  757. },
  758. });
  759. const { order: order2 } = await adminClient.query<GetOrder.Query, GetOrder.Variables>(GET_ORDER, {
  760. id: testOrder.orderId,
  761. });
  762. expect(order2!.state).toBe('Cancelled');
  763. expect(order2!.active).toBe(false);
  764. await assertNoStockMovementsCreated(testOrder.product.id);
  765. });
  766. it('cancel from PaymentAuthorized state', async () => {
  767. const testOrder = await createTestOrder(
  768. adminClient,
  769. shopClient,
  770. customers[0].emailAddress,
  771. password,
  772. );
  773. await proceedToArrangingPayment(shopClient);
  774. const order = await addPaymentToOrder(shopClient, failsToSettlePaymentMethod);
  775. orderGuard.assertSuccess(order);
  776. expect(order.state).toBe('PaymentAuthorized');
  777. const result1 = await adminClient.query<GetStockMovement.Query, GetStockMovement.Variables>(
  778. GET_STOCK_MOVEMENT,
  779. {
  780. id: 'T_3',
  781. },
  782. );
  783. let variant1 = result1.product!.variants[0];
  784. expect(variant1.stockOnHand).toBe(100);
  785. expect(variant1.stockAllocated).toBe(2);
  786. expect(variant1.stockMovements.items.map(pick(['type', 'quantity']))).toEqual([
  787. { type: StockMovementType.ADJUSTMENT, quantity: 100 },
  788. { type: StockMovementType.ALLOCATION, quantity: 2 },
  789. ]);
  790. const { cancelOrder } = await adminClient.query<CancelOrder.Mutation, CancelOrder.Variables>(
  791. CANCEL_ORDER,
  792. {
  793. input: {
  794. orderId: testOrder.orderId,
  795. },
  796. },
  797. );
  798. orderGuard.assertSuccess(cancelOrder);
  799. expect(
  800. cancelOrder.lines.map(l =>
  801. l.items.map(pick(['id', 'cancelled'])).sort((a, b) => (a.id > b.id ? 1 : -1)),
  802. ),
  803. ).toEqual([
  804. [
  805. { id: 'T_11', cancelled: true },
  806. { id: 'T_12', cancelled: true },
  807. ],
  808. ]);
  809. const { order: order2 } = await adminClient.query<GetOrder.Query, GetOrder.Variables>(GET_ORDER, {
  810. id: testOrder.orderId,
  811. });
  812. expect(order2!.active).toBe(false);
  813. expect(order2!.state).toBe('Cancelled');
  814. const result2 = await adminClient.query<GetStockMovement.Query, GetStockMovement.Variables>(
  815. GET_STOCK_MOVEMENT,
  816. {
  817. id: 'T_3',
  818. },
  819. );
  820. variant1 = result2.product!.variants[0];
  821. expect(variant1.stockOnHand).toBe(100);
  822. expect(variant1.stockAllocated).toBe(0);
  823. expect(variant1.stockMovements.items.map(pick(['type', 'quantity']))).toEqual([
  824. { type: StockMovementType.ADJUSTMENT, quantity: 100 },
  825. { type: StockMovementType.ALLOCATION, quantity: 2 },
  826. { type: StockMovementType.RELEASE, quantity: 1 },
  827. { type: StockMovementType.RELEASE, quantity: 1 },
  828. ]);
  829. });
  830. async function assertNoStockMovementsCreated(productId: string) {
  831. const result = await adminClient.query<GetStockMovement.Query, GetStockMovement.Variables>(
  832. GET_STOCK_MOVEMENT,
  833. {
  834. id: productId,
  835. },
  836. );
  837. const variant2 = result.product!.variants[0];
  838. expect(variant2.stockOnHand).toBe(100);
  839. expect(variant2.stockMovements.items.map(pick(['type', 'quantity']))).toEqual([
  840. { type: StockMovementType.ADJUSTMENT, quantity: 100 },
  841. ]);
  842. }
  843. });
  844. describe('cancellation by OrderLine', () => {
  845. let orderId: string;
  846. let product: GetProductWithVariants.Product;
  847. let productVariantId: string;
  848. beforeAll(async () => {
  849. const result = await createTestOrder(
  850. adminClient,
  851. shopClient,
  852. customers[0].emailAddress,
  853. password,
  854. );
  855. orderId = result.orderId;
  856. product = result.product;
  857. productVariantId = result.productVariantId;
  858. });
  859. it('cannot cancel from AddingItems state', async () => {
  860. const { order } = await adminClient.query<GetOrder.Query, GetOrder.Variables>(GET_ORDER, {
  861. id: orderId,
  862. });
  863. expect(order!.state).toBe('AddingItems');
  864. const { cancelOrder } = await adminClient.query<CancelOrder.Mutation, CancelOrder.Variables>(
  865. CANCEL_ORDER,
  866. {
  867. input: {
  868. orderId,
  869. lines: order!.lines.map(l => ({ orderLineId: l.id, quantity: 1 })),
  870. },
  871. },
  872. );
  873. orderGuard.assertErrorResult(cancelOrder);
  874. expect(cancelOrder.message).toBe(
  875. 'Cannot cancel OrderLines from an Order in the "AddingItems" state',
  876. );
  877. expect(cancelOrder.errorCode).toBe(ErrorCode.CANCEL_ACTIVE_ORDER_ERROR);
  878. });
  879. it('cannot cancel from ArrangingPayment state', async () => {
  880. await proceedToArrangingPayment(shopClient);
  881. const { order } = await adminClient.query<GetOrder.Query, GetOrder.Variables>(GET_ORDER, {
  882. id: orderId,
  883. });
  884. expect(order!.state).toBe('ArrangingPayment');
  885. const { cancelOrder } = await adminClient.query<CancelOrder.Mutation, CancelOrder.Variables>(
  886. CANCEL_ORDER,
  887. {
  888. input: {
  889. orderId,
  890. lines: order!.lines.map(l => ({ orderLineId: l.id, quantity: 1 })),
  891. },
  892. },
  893. );
  894. orderGuard.assertErrorResult(cancelOrder);
  895. expect(cancelOrder.message).toBe(
  896. 'Cannot cancel OrderLines from an Order in the "ArrangingPayment" state',
  897. );
  898. expect(cancelOrder.errorCode).toBe(ErrorCode.CANCEL_ACTIVE_ORDER_ERROR);
  899. });
  900. it('returns error result if lines are empty', async () => {
  901. const order = await addPaymentToOrder(shopClient, twoStagePaymentMethod);
  902. orderGuard.assertSuccess(order);
  903. expect(order.state).toBe('PaymentAuthorized');
  904. const { cancelOrder } = await adminClient.query<CancelOrder.Mutation, CancelOrder.Variables>(
  905. CANCEL_ORDER,
  906. {
  907. input: {
  908. orderId,
  909. lines: [],
  910. },
  911. },
  912. );
  913. orderGuard.assertErrorResult(cancelOrder);
  914. expect(cancelOrder.message).toBe('At least one OrderLine must be specified');
  915. expect(cancelOrder.errorCode).toBe(ErrorCode.EMPTY_ORDER_LINE_SELECTION_ERROR);
  916. });
  917. it('returns error result if all quantities zero', async () => {
  918. const { order } = await adminClient.query<GetOrder.Query, GetOrder.Variables>(GET_ORDER, {
  919. id: orderId,
  920. });
  921. const { cancelOrder } = await adminClient.query<CancelOrder.Mutation, CancelOrder.Variables>(
  922. CANCEL_ORDER,
  923. {
  924. input: {
  925. orderId,
  926. lines: order!.lines.map(l => ({ orderLineId: l.id, quantity: 0 })),
  927. },
  928. },
  929. );
  930. orderGuard.assertErrorResult(cancelOrder);
  931. expect(cancelOrder.message).toBe('At least one OrderLine must be specified');
  932. expect(cancelOrder.errorCode).toBe(ErrorCode.EMPTY_ORDER_LINE_SELECTION_ERROR);
  933. });
  934. it('partial cancellation', async () => {
  935. const result1 = await adminClient.query<GetStockMovement.Query, GetStockMovement.Variables>(
  936. GET_STOCK_MOVEMENT,
  937. {
  938. id: product.id,
  939. },
  940. );
  941. const variant1 = result1.product!.variants[0];
  942. expect(variant1.stockOnHand).toBe(100);
  943. expect(variant1.stockAllocated).toBe(2);
  944. expect(variant1.stockMovements.items.map(pick(['type', 'quantity']))).toEqual([
  945. { type: StockMovementType.ADJUSTMENT, quantity: 100 },
  946. { type: StockMovementType.ALLOCATION, quantity: 2 },
  947. { type: StockMovementType.RELEASE, quantity: 1 },
  948. { type: StockMovementType.RELEASE, quantity: 1 },
  949. { type: StockMovementType.ALLOCATION, quantity: 2 },
  950. ]);
  951. const { order } = await adminClient.query<GetOrder.Query, GetOrder.Variables>(GET_ORDER, {
  952. id: orderId,
  953. });
  954. const { cancelOrder } = await adminClient.query<CancelOrder.Mutation, CancelOrder.Variables>(
  955. CANCEL_ORDER,
  956. {
  957. input: {
  958. orderId,
  959. lines: order!.lines.map(l => ({ orderLineId: l.id, quantity: 1 })),
  960. reason: 'cancel reason 1',
  961. },
  962. },
  963. );
  964. orderGuard.assertSuccess(cancelOrder);
  965. expect(cancelOrder.lines[0].quantity).toBe(1);
  966. expect(cancelOrder.lines[0].items.sort((a, b) => (a.id < b.id ? -1 : 1))).toEqual([
  967. { id: 'T_13', cancelled: true },
  968. { id: 'T_14', cancelled: false },
  969. ]);
  970. const { order: order2 } = await adminClient.query<GetOrder.Query, GetOrder.Variables>(GET_ORDER, {
  971. id: orderId,
  972. });
  973. expect(order2!.state).toBe('PaymentAuthorized');
  974. expect(order2!.lines[0].quantity).toBe(1);
  975. const result2 = await adminClient.query<GetStockMovement.Query, GetStockMovement.Variables>(
  976. GET_STOCK_MOVEMENT,
  977. {
  978. id: product.id,
  979. },
  980. );
  981. const variant2 = result2.product!.variants[0];
  982. expect(variant2.stockOnHand).toBe(100);
  983. expect(variant2.stockAllocated).toBe(1);
  984. expect(variant2.stockMovements.items.map(pick(['type', 'quantity']))).toEqual([
  985. { type: StockMovementType.ADJUSTMENT, quantity: 100 },
  986. { type: StockMovementType.ALLOCATION, quantity: 2 },
  987. { type: StockMovementType.RELEASE, quantity: 1 },
  988. { type: StockMovementType.RELEASE, quantity: 1 },
  989. { type: StockMovementType.ALLOCATION, quantity: 2 },
  990. { type: StockMovementType.RELEASE, quantity: 1 },
  991. ]);
  992. });
  993. it('returns error result if attempting to cancel already cancelled item', async () => {
  994. const { order } = await adminClient.query<GetOrder.Query, GetOrder.Variables>(GET_ORDER, {
  995. id: orderId,
  996. });
  997. const { cancelOrder } = await adminClient.query<CancelOrder.Mutation, CancelOrder.Variables>(
  998. CANCEL_ORDER,
  999. {
  1000. input: {
  1001. orderId,
  1002. lines: order!.lines.map(l => ({ orderLineId: l.id, quantity: 2 })),
  1003. },
  1004. },
  1005. );
  1006. orderGuard.assertErrorResult(cancelOrder);
  1007. expect(cancelOrder.message).toBe(
  1008. 'The specified quantity is greater than the available OrderItems',
  1009. );
  1010. expect(cancelOrder.errorCode).toBe(ErrorCode.QUANTITY_TOO_GREAT_ERROR);
  1011. });
  1012. it('complete cancellation', async () => {
  1013. const { order } = await adminClient.query<GetOrder.Query, GetOrder.Variables>(GET_ORDER, {
  1014. id: orderId,
  1015. });
  1016. await adminClient.query<CancelOrder.Mutation, CancelOrder.Variables>(CANCEL_ORDER, {
  1017. input: {
  1018. orderId,
  1019. lines: order!.lines.map(l => ({ orderLineId: l.id, quantity: 1 })),
  1020. reason: 'cancel reason 2',
  1021. },
  1022. });
  1023. const { order: order2 } = await adminClient.query<GetOrder.Query, GetOrder.Variables>(GET_ORDER, {
  1024. id: orderId,
  1025. });
  1026. expect(order2!.state).toBe('Cancelled');
  1027. const result = await adminClient.query<GetStockMovement.Query, GetStockMovement.Variables>(
  1028. GET_STOCK_MOVEMENT,
  1029. {
  1030. id: product.id,
  1031. },
  1032. );
  1033. const variant2 = result.product!.variants[0];
  1034. expect(variant2.stockOnHand).toBe(100);
  1035. expect(variant2.stockAllocated).toBe(0);
  1036. expect(variant2.stockMovements.items.map(pick(['type', 'quantity']))).toEqual([
  1037. { type: StockMovementType.ADJUSTMENT, quantity: 100 },
  1038. { type: StockMovementType.ALLOCATION, quantity: 2 },
  1039. { type: StockMovementType.RELEASE, quantity: 1 },
  1040. { type: StockMovementType.RELEASE, quantity: 1 },
  1041. { type: StockMovementType.ALLOCATION, quantity: 2 },
  1042. { type: StockMovementType.RELEASE, quantity: 1 },
  1043. { type: StockMovementType.RELEASE, quantity: 1 },
  1044. ]);
  1045. });
  1046. it('order history contains expected entries', async () => {
  1047. const { order } = await adminClient.query<GetOrderHistory.Query, GetOrderHistory.Variables>(
  1048. GET_ORDER_HISTORY,
  1049. {
  1050. id: orderId,
  1051. options: {
  1052. skip: 0,
  1053. },
  1054. },
  1055. );
  1056. expect(order!.history.items.map(pick(['type', 'data']))).toEqual([
  1057. {
  1058. type: HistoryEntryType.ORDER_STATE_TRANSITION,
  1059. data: {
  1060. from: 'Created',
  1061. to: 'AddingItems',
  1062. },
  1063. },
  1064. {
  1065. type: HistoryEntryType.ORDER_STATE_TRANSITION,
  1066. data: {
  1067. from: 'AddingItems',
  1068. to: 'ArrangingPayment',
  1069. },
  1070. },
  1071. {
  1072. type: HistoryEntryType.ORDER_PAYMENT_TRANSITION,
  1073. data: {
  1074. paymentId: 'T_4',
  1075. from: 'Created',
  1076. to: 'Authorized',
  1077. },
  1078. },
  1079. {
  1080. type: HistoryEntryType.ORDER_STATE_TRANSITION,
  1081. data: {
  1082. from: 'ArrangingPayment',
  1083. to: 'PaymentAuthorized',
  1084. },
  1085. },
  1086. {
  1087. type: HistoryEntryType.ORDER_CANCELLATION,
  1088. data: {
  1089. orderItemIds: ['T_13'],
  1090. reason: 'cancel reason 1',
  1091. },
  1092. },
  1093. {
  1094. type: HistoryEntryType.ORDER_CANCELLATION,
  1095. data: {
  1096. orderItemIds: ['T_14'],
  1097. reason: 'cancel reason 2',
  1098. },
  1099. },
  1100. {
  1101. type: HistoryEntryType.ORDER_STATE_TRANSITION,
  1102. data: {
  1103. from: 'PaymentAuthorized',
  1104. to: 'Cancelled',
  1105. },
  1106. },
  1107. ]);
  1108. });
  1109. });
  1110. describe('refunds', () => {
  1111. let orderId: string;
  1112. let product: GetProductWithVariants.Product;
  1113. let productVariantId: string;
  1114. let paymentId: string;
  1115. let refundId: string;
  1116. beforeAll(async () => {
  1117. const result = await createTestOrder(
  1118. adminClient,
  1119. shopClient,
  1120. customers[0].emailAddress,
  1121. password,
  1122. );
  1123. orderId = result.orderId;
  1124. product = result.product;
  1125. productVariantId = result.productVariantId;
  1126. });
  1127. it('cannot refund from PaymentAuthorized state', async () => {
  1128. await proceedToArrangingPayment(shopClient);
  1129. const order = await addPaymentToOrder(shopClient, twoStagePaymentMethod);
  1130. orderGuard.assertSuccess(order);
  1131. expect(order.state).toBe('PaymentAuthorized');
  1132. paymentId = order.payments![0].id;
  1133. const { refundOrder } = await adminClient.query<RefundOrder.Mutation, RefundOrder.Variables>(
  1134. REFUND_ORDER,
  1135. {
  1136. input: {
  1137. lines: order.lines.map(l => ({ orderLineId: l.id, quantity: 1 })),
  1138. shipping: 0,
  1139. adjustment: 0,
  1140. paymentId,
  1141. },
  1142. },
  1143. );
  1144. refundGuard.assertErrorResult(refundOrder);
  1145. expect(refundOrder.message).toBe('Cannot refund an Order in the "PaymentAuthorized" state');
  1146. expect(refundOrder.errorCode).toBe(ErrorCode.REFUND_ORDER_STATE_ERROR);
  1147. });
  1148. it('returns error result if no lines and no shipping', async () => {
  1149. const { order } = await adminClient.query<GetOrder.Query, GetOrder.Variables>(GET_ORDER, {
  1150. id: orderId,
  1151. });
  1152. const { settlePayment } = await adminClient.query<
  1153. SettlePayment.Mutation,
  1154. SettlePayment.Variables
  1155. >(SETTLE_PAYMENT, {
  1156. id: order!.payments![0].id,
  1157. });
  1158. paymentGuard.assertSuccess(settlePayment);
  1159. expect(settlePayment!.state).toBe('Settled');
  1160. const { refundOrder } = await adminClient.query<RefundOrder.Mutation, RefundOrder.Variables>(
  1161. REFUND_ORDER,
  1162. {
  1163. input: {
  1164. lines: order!.lines.map(l => ({ orderLineId: l.id, quantity: 0 })),
  1165. shipping: 0,
  1166. adjustment: 0,
  1167. paymentId,
  1168. },
  1169. },
  1170. );
  1171. refundGuard.assertErrorResult(refundOrder);
  1172. expect(refundOrder.message).toBe('Nothing to refund');
  1173. expect(refundOrder.errorCode).toBe(ErrorCode.NOTHING_TO_REFUND_ERROR);
  1174. });
  1175. it(
  1176. 'throws if paymentId not valid',
  1177. assertThrowsWithMessage(async () => {
  1178. const { order } = await adminClient.query<GetOrder.Query, GetOrder.Variables>(GET_ORDER, {
  1179. id: orderId,
  1180. });
  1181. const { refundOrder } = await adminClient.query<RefundOrder.Mutation, RefundOrder.Variables>(
  1182. REFUND_ORDER,
  1183. {
  1184. input: {
  1185. lines: [],
  1186. shipping: 100,
  1187. adjustment: 0,
  1188. paymentId: 'T_999',
  1189. },
  1190. },
  1191. );
  1192. }, `No Payment with the id '999' could be found`),
  1193. );
  1194. it('returns error result if payment and order lines do not belong to the same Order', async () => {
  1195. const { order } = await adminClient.query<GetOrder.Query, GetOrder.Variables>(GET_ORDER, {
  1196. id: orderId,
  1197. });
  1198. const { refundOrder } = await adminClient.query<RefundOrder.Mutation, RefundOrder.Variables>(
  1199. REFUND_ORDER,
  1200. {
  1201. input: {
  1202. lines: order!.lines.map(l => ({ orderLineId: l.id, quantity: l.quantity })),
  1203. shipping: 100,
  1204. adjustment: 0,
  1205. paymentId: 'T_1',
  1206. },
  1207. },
  1208. );
  1209. refundGuard.assertErrorResult(refundOrder);
  1210. expect(refundOrder.message).toBe('The Payment and OrderLines do not belong to the same Order');
  1211. expect(refundOrder.errorCode).toBe(ErrorCode.PAYMENT_ORDER_MISMATCH_ERROR);
  1212. });
  1213. it('creates a Refund to be manually settled', async () => {
  1214. const { order } = await adminClient.query<GetOrder.Query, GetOrder.Variables>(GET_ORDER, {
  1215. id: orderId,
  1216. });
  1217. const { refundOrder } = await adminClient.query<RefundOrder.Mutation, RefundOrder.Variables>(
  1218. REFUND_ORDER,
  1219. {
  1220. input: {
  1221. lines: order!.lines.map(l => ({ orderLineId: l.id, quantity: l.quantity })),
  1222. shipping: order!.shipping,
  1223. adjustment: 0,
  1224. reason: 'foo',
  1225. paymentId,
  1226. },
  1227. },
  1228. );
  1229. refundGuard.assertSuccess(refundOrder);
  1230. expect(refundOrder.shipping).toBe(order!.shipping);
  1231. expect(refundOrder.items).toBe(order!.subTotalWithTax);
  1232. expect(refundOrder.total).toBe(order!.totalWithTax);
  1233. expect(refundOrder.transactionId).toBe(null);
  1234. expect(refundOrder.state).toBe('Pending');
  1235. refundId = refundOrder.id;
  1236. });
  1237. it('returns error result if attempting to refund the same item more than once', async () => {
  1238. const { order } = await adminClient.query<GetOrder.Query, GetOrder.Variables>(GET_ORDER, {
  1239. id: orderId,
  1240. });
  1241. const { refundOrder } = await adminClient.query<RefundOrder.Mutation, RefundOrder.Variables>(
  1242. REFUND_ORDER,
  1243. {
  1244. input: {
  1245. lines: order!.lines.map(l => ({ orderLineId: l.id, quantity: l.quantity })),
  1246. shipping: order!.shipping,
  1247. adjustment: 0,
  1248. paymentId,
  1249. },
  1250. },
  1251. );
  1252. refundGuard.assertErrorResult(refundOrder);
  1253. expect(refundOrder.message).toBe('Cannot refund an OrderItem which has already been refunded');
  1254. expect(refundOrder.errorCode).toBe(ErrorCode.ALREADY_REFUNDED_ERROR);
  1255. });
  1256. it('manually settle a Refund', async () => {
  1257. const { settleRefund } = await adminClient.query<SettleRefund.Mutation, SettleRefund.Variables>(
  1258. SETTLE_REFUND,
  1259. {
  1260. input: {
  1261. id: refundId,
  1262. transactionId: 'aaabbb',
  1263. },
  1264. },
  1265. );
  1266. refundGuard.assertSuccess(settleRefund);
  1267. expect(settleRefund.state).toBe('Settled');
  1268. expect(settleRefund.transactionId).toBe('aaabbb');
  1269. });
  1270. it('order history contains expected entries', async () => {
  1271. const { order } = await adminClient.query<GetOrderHistory.Query, GetOrderHistory.Variables>(
  1272. GET_ORDER_HISTORY,
  1273. {
  1274. id: orderId,
  1275. options: {
  1276. skip: 0,
  1277. },
  1278. },
  1279. );
  1280. expect(order!.history.items.sort(sortById).map(pick(['type', 'data']))).toEqual([
  1281. {
  1282. type: HistoryEntryType.ORDER_STATE_TRANSITION,
  1283. data: {
  1284. from: 'Created',
  1285. to: 'AddingItems',
  1286. },
  1287. },
  1288. {
  1289. type: HistoryEntryType.ORDER_STATE_TRANSITION,
  1290. data: {
  1291. from: 'AddingItems',
  1292. to: 'ArrangingPayment',
  1293. },
  1294. },
  1295. {
  1296. type: HistoryEntryType.ORDER_PAYMENT_TRANSITION,
  1297. data: {
  1298. paymentId: 'T_5',
  1299. from: 'Created',
  1300. to: 'Authorized',
  1301. },
  1302. },
  1303. {
  1304. type: HistoryEntryType.ORDER_STATE_TRANSITION,
  1305. data: {
  1306. from: 'ArrangingPayment',
  1307. to: 'PaymentAuthorized',
  1308. },
  1309. },
  1310. {
  1311. type: HistoryEntryType.ORDER_PAYMENT_TRANSITION,
  1312. data: {
  1313. paymentId: 'T_5',
  1314. from: 'Authorized',
  1315. to: 'Settled',
  1316. },
  1317. },
  1318. {
  1319. type: HistoryEntryType.ORDER_STATE_TRANSITION,
  1320. data: {
  1321. from: 'PaymentAuthorized',
  1322. to: 'PaymentSettled',
  1323. },
  1324. },
  1325. {
  1326. type: HistoryEntryType.ORDER_REFUND_TRANSITION,
  1327. data: {
  1328. refundId: 'T_1',
  1329. reason: 'foo',
  1330. from: 'Pending',
  1331. to: 'Settled',
  1332. },
  1333. },
  1334. ]);
  1335. });
  1336. });
  1337. describe('order notes', () => {
  1338. let orderId: string;
  1339. let firstNoteId: string;
  1340. beforeAll(async () => {
  1341. const result = await createTestOrder(
  1342. adminClient,
  1343. shopClient,
  1344. customers[2].emailAddress,
  1345. password,
  1346. );
  1347. orderId = result.orderId;
  1348. });
  1349. it('private note', async () => {
  1350. const { addNoteToOrder } = await adminClient.query<
  1351. AddNoteToOrder.Mutation,
  1352. AddNoteToOrder.Variables
  1353. >(ADD_NOTE_TO_ORDER, {
  1354. input: {
  1355. id: orderId,
  1356. note: 'A private note',
  1357. isPublic: false,
  1358. },
  1359. });
  1360. expect(addNoteToOrder.id).toBe(orderId);
  1361. const { order } = await adminClient.query<GetOrderHistory.Query, GetOrderHistory.Variables>(
  1362. GET_ORDER_HISTORY,
  1363. {
  1364. id: orderId,
  1365. options: {
  1366. skip: 1,
  1367. },
  1368. },
  1369. );
  1370. expect(order!.history.items.map(pick(['type', 'data']))).toEqual([
  1371. {
  1372. type: HistoryEntryType.ORDER_NOTE,
  1373. data: {
  1374. note: 'A private note',
  1375. },
  1376. },
  1377. ]);
  1378. firstNoteId = order!.history.items[0].id;
  1379. const { activeOrder } = await shopClient.query<GetActiveOrder.Query>(GET_ACTIVE_ORDER);
  1380. expect(activeOrder!.history.items.map(pick(['type']))).toEqual([
  1381. { type: HistoryEntryType.ORDER_STATE_TRANSITION },
  1382. ]);
  1383. });
  1384. it('public note', async () => {
  1385. const { addNoteToOrder } = await adminClient.query<
  1386. AddNoteToOrder.Mutation,
  1387. AddNoteToOrder.Variables
  1388. >(ADD_NOTE_TO_ORDER, {
  1389. input: {
  1390. id: orderId,
  1391. note: 'A public note',
  1392. isPublic: true,
  1393. },
  1394. });
  1395. expect(addNoteToOrder.id).toBe(orderId);
  1396. const { order } = await adminClient.query<GetOrderHistory.Query, GetOrderHistory.Variables>(
  1397. GET_ORDER_HISTORY,
  1398. {
  1399. id: orderId,
  1400. options: {
  1401. skip: 2,
  1402. },
  1403. },
  1404. );
  1405. expect(order!.history.items.map(pick(['type', 'data']))).toEqual([
  1406. {
  1407. type: HistoryEntryType.ORDER_NOTE,
  1408. data: {
  1409. note: 'A public note',
  1410. },
  1411. },
  1412. ]);
  1413. const { activeOrder } = await shopClient.query<GetActiveOrder.Query>(GET_ACTIVE_ORDER);
  1414. expect(activeOrder!.history.items.map(pick(['type', 'data']))).toEqual([
  1415. {
  1416. type: HistoryEntryType.ORDER_STATE_TRANSITION,
  1417. data: {
  1418. from: 'Created',
  1419. to: 'AddingItems',
  1420. },
  1421. },
  1422. {
  1423. type: HistoryEntryType.ORDER_NOTE,
  1424. data: {
  1425. note: 'A public note',
  1426. },
  1427. },
  1428. ]);
  1429. });
  1430. it('update note', async () => {
  1431. const { updateOrderNote } = await adminClient.query<
  1432. UpdateOrderNote.Mutation,
  1433. UpdateOrderNote.Variables
  1434. >(UPDATE_ORDER_NOTE, {
  1435. input: {
  1436. noteId: firstNoteId,
  1437. note: 'An updated note',
  1438. },
  1439. });
  1440. expect(updateOrderNote.data).toEqual({
  1441. note: 'An updated note',
  1442. });
  1443. });
  1444. it('delete note', async () => {
  1445. const { order: before } = await adminClient.query<
  1446. GetOrderHistory.Query,
  1447. GetOrderHistory.Variables
  1448. >(GET_ORDER_HISTORY, { id: orderId });
  1449. expect(before?.history.totalItems).toBe(3);
  1450. const { deleteOrderNote } = await adminClient.query<
  1451. DeleteOrderNote.Mutation,
  1452. DeleteOrderNote.Variables
  1453. >(DELETE_ORDER_NOTE, {
  1454. id: firstNoteId,
  1455. });
  1456. expect(deleteOrderNote.result).toBe(DeletionResult.DELETED);
  1457. const { order: after } = await adminClient.query<
  1458. GetOrderHistory.Query,
  1459. GetOrderHistory.Variables
  1460. >(GET_ORDER_HISTORY, { id: orderId });
  1461. expect(after?.history.totalItems).toBe(2);
  1462. });
  1463. });
  1464. });
  1465. async function createTestOrder(
  1466. adminClient: SimpleGraphQLClient,
  1467. shopClient: SimpleGraphQLClient,
  1468. emailAddress: string,
  1469. password: string,
  1470. ): Promise<{
  1471. orderId: string;
  1472. product: GetProductWithVariants.Product;
  1473. productVariantId: string;
  1474. }> {
  1475. const result = await adminClient.query<GetProductWithVariants.Query, GetProductWithVariants.Variables>(
  1476. GET_PRODUCT_WITH_VARIANTS,
  1477. {
  1478. id: 'T_3',
  1479. },
  1480. );
  1481. const product = result.product!;
  1482. const productVariantId = product.variants[0].id;
  1483. // Set the ProductVariant to trackInventory
  1484. const { updateProductVariants } = await adminClient.query<
  1485. UpdateProductVariants.Mutation,
  1486. UpdateProductVariants.Variables
  1487. >(UPDATE_PRODUCT_VARIANTS, {
  1488. input: [
  1489. {
  1490. id: productVariantId,
  1491. trackInventory: GlobalFlag.TRUE,
  1492. },
  1493. ],
  1494. });
  1495. // Add the ProductVariant to the Order
  1496. await shopClient.asUserWithCredentials(emailAddress, password);
  1497. const { addItemToOrder } = await shopClient.query<AddItemToOrder.Mutation, AddItemToOrder.Variables>(
  1498. ADD_ITEM_TO_ORDER,
  1499. {
  1500. productVariantId,
  1501. quantity: 2,
  1502. },
  1503. );
  1504. const orderId = (addItemToOrder as UpdatedOrder.Fragment).id;
  1505. return { product, productVariantId, orderId };
  1506. }
  1507. async function getUnfulfilledOrderLineInput(
  1508. client: SimpleGraphQLClient,
  1509. id: string,
  1510. ): Promise<OrderLineInput[]> {
  1511. const { order } = await client.query<GetOrder.Query, GetOrder.Variables>(GET_ORDER, {
  1512. id,
  1513. });
  1514. const unfulfilledItems =
  1515. order?.lines.filter(l => {
  1516. const items = l.items.filter(i => i.fulfillment === null);
  1517. return items.length > 0 ? true : false;
  1518. }) || [];
  1519. return unfulfilledItems.map(l => ({
  1520. orderLineId: l.id,
  1521. quantity: l.items.length,
  1522. }));
  1523. }
  1524. export const GET_ORDER_LIST_FULFILLMENTS = gql`
  1525. query GetOrderListFulfillments {
  1526. orders {
  1527. items {
  1528. id
  1529. state
  1530. fulfillments {
  1531. id
  1532. state
  1533. nextStates
  1534. method
  1535. }
  1536. }
  1537. }
  1538. }
  1539. `;
  1540. export const GET_ORDER_FULFILLMENT_ITEMS = gql`
  1541. query GetOrderFulfillmentItems($id: ID!) {
  1542. order(id: $id) {
  1543. id
  1544. state
  1545. fulfillments {
  1546. ...Fulfillment
  1547. }
  1548. }
  1549. }
  1550. ${FULFILLMENT_FRAGMENT}
  1551. `;
  1552. const REFUND_FRAGMENT = gql`
  1553. fragment Refund on Refund {
  1554. id
  1555. state
  1556. items
  1557. transactionId
  1558. shipping
  1559. total
  1560. metadata
  1561. }
  1562. `;
  1563. export const REFUND_ORDER = gql`
  1564. mutation RefundOrder($input: RefundOrderInput!) {
  1565. refundOrder(input: $input) {
  1566. ...Refund
  1567. ... on ErrorResult {
  1568. errorCode
  1569. message
  1570. }
  1571. }
  1572. }
  1573. ${REFUND_FRAGMENT}
  1574. `;
  1575. export const SETTLE_REFUND = gql`
  1576. mutation SettleRefund($input: SettleRefundInput!) {
  1577. settleRefund(input: $input) {
  1578. ...Refund
  1579. ... on ErrorResult {
  1580. errorCode
  1581. message
  1582. }
  1583. }
  1584. }
  1585. ${REFUND_FRAGMENT}
  1586. `;
  1587. export const GET_ORDER_HISTORY = gql`
  1588. query GetOrderHistory($id: ID!, $options: HistoryEntryListOptions) {
  1589. order(id: $id) {
  1590. id
  1591. history(options: $options) {
  1592. totalItems
  1593. items {
  1594. id
  1595. type
  1596. administrator {
  1597. id
  1598. }
  1599. data
  1600. }
  1601. }
  1602. }
  1603. }
  1604. `;
  1605. export const ADD_NOTE_TO_ORDER = gql`
  1606. mutation AddNoteToOrder($input: AddNoteToOrderInput!) {
  1607. addNoteToOrder(input: $input) {
  1608. id
  1609. }
  1610. }
  1611. `;
  1612. export const UPDATE_ORDER_NOTE = gql`
  1613. mutation UpdateOrderNote($input: UpdateOrderNoteInput!) {
  1614. updateOrderNote(input: $input) {
  1615. id
  1616. data
  1617. isPublic
  1618. }
  1619. }
  1620. `;
  1621. export const DELETE_ORDER_NOTE = gql`
  1622. mutation DeleteOrderNote($id: ID!) {
  1623. deleteOrderNote(id: $id) {
  1624. result
  1625. message
  1626. }
  1627. }
  1628. `;
  1629. const GET_ORDER_WITH_PAYMENTS = gql`
  1630. query GetOrderWithPayments($id: ID!) {
  1631. order(id: $id) {
  1632. id
  1633. payments {
  1634. id
  1635. errorMessage
  1636. metadata
  1637. }
  1638. }
  1639. }
  1640. `;