@dotdev/harmony-sdk 1.6.2 → 1.7.0

package/dist/HarmonyAPI.d.ts

@@ -23,6 +23,7 @@ export declare class HarmonyAPI {
     stockLevelLookup(params: StockLevelLookupQueryParams, sessionId: string): Promise<StockLevel[]>;
     stockLevelLookupByWarehouseQuickView(params: StockLevelLookupQueryParams, sessionId: string): Promise<StockLevel[]>;
     processSalesOrder(params: ProcessSaleOrderQueryParams, sessionId: string): Promise<boolean>;
+    processSalesOrderWithoutPayment(params: ProcessSaleOrderQueryParams, sessionId: string): Promise<boolean>;
     mapOrderPayloadToXml(params: ProcessSaleOrderQueryParams, sessionId: string): Promise<string>;
     processReturns(params: ProcessSaleOrderQueryParams, sessionId: string): Promise<boolean>;
     modifyExistingSalesOrder(params: ProcessSaleOrderQueryParams, sessionId: string): Promise<boolean>;

package/dist/HarmonyAPI.js

@@ -83,6 +83,9 @@ export class HarmonyAPI {
     async processSalesOrder(params, sessionId) {
         return await this.pointOfSaleModule.processSalesOrder(params, sessionId);
     }
+    async processSalesOrderWithoutPayment(params, sessionId) {
+        return await this.pointOfSaleModule.processSalesOrderWithoutPayment(params, sessionId);
+    }
     async mapOrderPayloadToXml(params, sessionId) {
         return await this.pointOfSaleModule.mapOrderPayloadToXml(params, sessionId);
     }

package/dist/modules/point-of-sale/mappings/process-sale-order.mapper.d.ts

@@ -1,5 +1,14 @@
-import { ProcessSaleOrderQueryDebtor, ProcessSaleOrderQueryExtra, ProcessSaleOrderQueryHeader, ProcessSaleOrderQueryParams, ProcessSaleOrderQueryStock } from "../types";
+import { ProcessSaleOrderQueryDebtor, ProcessSaleOrderQueryExtra, ProcessSaleOrderQueryHeader, ProcessSaleOrderQueryParams, ProcessSaleOrderQueryStock, ProcessSaleOrderWithoutPaymentQueryParams } from "../types";
 export declare function mapProcessSaleOrderQueryParams(params: ProcessSaleOrderQueryParams): string;
+export declare function mapProcessSaleOrderWithoutPaymentQueryParams(params: ProcessSaleOrderWithoutPaymentQueryParams): string;
+export declare function mapProcessSaleOrderBaseQueryParams(params: ProcessSaleOrderWithoutPaymentQueryParams): {
+    mode: import("../types").PosQueryMode | undefined;
+    audit_no: string;
+    export_no: string | undefined;
+    header: string;
+    extra: string;
+    stock: string[];
+};
 export declare function mapProcessSaleOrderQueryHeaders(params: ProcessSaleOrderQueryHeader): string;
 export declare function mapProcessSaleOrderQueryExtra(params: ProcessSaleOrderQueryExtra): string;
 export declare function mapProcessSaleOrderQueryStock(params: ProcessSaleOrderQueryStock): string;

package/dist/modules/point-of-sale/mappings/process-sale-order.mapper.js

@@ -2,15 +2,23 @@ import { Utils } from "../../../helpers";
 export function mapProcessSaleOrderQueryParams(params) {
     // XML body in JSON format, to be converted to XML string
     const body = {
+        ...mapProcessSaleOrderBaseQueryParams(params),
+        debtor: mapProcessSaleOrderQueryDebtor((params?.debtor ?? [])[0]),
+    };
+    return Utils.toXml(Utils.deleteEmptyProps(body));
+}
+export function mapProcessSaleOrderWithoutPaymentQueryParams(params) {
+    return Utils.toXml(Utils.deleteEmptyProps(mapProcessSaleOrderBaseQueryParams(params)));
+}
+export function mapProcessSaleOrderBaseQueryParams(params) {
+    return {
         mode: params?.mode,
         audit_no: params?.auditNo,
         export_no: params?.exportNo,
         header: mapProcessSaleOrderQueryHeaders(params?.header),
         extra: mapProcessSaleOrderQueryExtra(params?.extra),
         stock: params?.stock.map(mapProcessSaleOrderQueryStock),
-        debtor: mapProcessSaleOrderQueryDebtor((params?.debtor ?? [])[0]),
     };
-    return Utils.toXml(Utils.deleteEmptyProps(body));
 }
 export function mapProcessSaleOrderQueryHeaders(params) {
     // XML body in JSON format, to be converted to XML string

package/dist/modules/point-of-sale/point-of-sale.module.d.ts

@@ -1,5 +1,5 @@
 import { AxiosInstance } from "axios";
-import { ProcessSaleOrderQueryParams } from "./types";
+import { ProcessSaleOrderQueryParams, ProcessSaleOrderWithoutPaymentQueryParams } from "./types";
 export declare class PointOfSaleModule {
     private axiosInstance;
     private readonly SERVICE_URL;
@@ -22,6 +22,15 @@ export declare class PointOfSaleModule {
      * @param {string} sessionId
      */
     mapOrderPayloadToXml(params: ProcessSaleOrderQueryParams, sessionId: string): Promise<string>;
+    /**
+     * Function to call the ProcessSalesOrderWithoutPayment endpoint in Harmony Point Of Sale service
+     *
+     * @async
+     * @param {ProcessSaleOrderQueryParams} params
+     * @param {string} sessionId
+     * @returns {Promise<boolean>}
+     */
+    processSalesOrderWithoutPayment(params: ProcessSaleOrderWithoutPaymentQueryParams, sessionId: string): Promise<boolean>;
     /**
      * Function to call the ProcessReturns endpoint in Harmony Point Of Sale service
      *

package/dist/modules/point-of-sale/point-of-sale.module.js

@@ -1,6 +1,6 @@
 import { ApiHelper, Utils } from "../../helpers";
 import { ServiceAlias } from "../shared";
-import { mapProcessSaleOrderQueryDebtor, mapProcessSaleOrderQueryExtra, mapProcessSaleOrderQueryHeaders, mapProcessSaleOrderQueryParams, mapProcessSaleOrderQueryStock, } from "./mappings/process-sale-order.mapper";
+import { mapProcessSaleOrderQueryDebtor, mapProcessSaleOrderQueryExtra, mapProcessSaleOrderQueryHeaders, mapProcessSaleOrderQueryParams, mapProcessSaleOrderQueryStock, mapProcessSaleOrderWithoutPaymentQueryParams, } from "./mappings/process-sale-order.mapper";
 import { promisify } from "util";
 import { parseString } from "xml2js";
 const parseXml = promisify(parseString);
@@ -70,6 +70,24 @@ export class PointOfSaleModule {
         const parsedJson = await parseXml(fullXml);
         return Utils.objectToXml(parsedJson);
     }
+    /**
+     * Function to call the ProcessSalesOrderWithoutPayment endpoint in Harmony Point Of Sale service
+     *
+     * @async
+     * @param {ProcessSaleOrderQueryParams} params
+     * @param {string} sessionId
+     * @returns {Promise<boolean>}
+     */
+    async processSalesOrderWithoutPayment(params, sessionId) {
+        try {
+            const requestBody = mapProcessSaleOrderWithoutPaymentQueryParams(params);
+            const response = await ApiHelper.sendServiceRequest(this.SERVICE_URL, ["ProcessSalesOrderWithoutPayment", "Request"], sessionId, ServiceAlias.POINT_OF_SALE, this.axiosInstance, requestBody);
+            return Boolean(response?.result[0] ?? "false");
+        }
+        catch (error) {
+            throw await ApiHelper.parseError(error);
+        }
+    }
     /**
      * Function to call the ProcessReturns endpoint in Harmony Point Of Sale service
      *

package/dist/modules/point-of-sale/point-of-sale.module.spec.js

@@ -202,4 +202,165 @@ describe("PointOfSaleModule", () => {
         expect(Utils.removeEmptySpaces(actualPayload)).toEqual(Utils.removeEmptySpaces(expectedPayload));
         mAxios.post.mockClear();
     });
+    test("ProcessSaleOrderWithoutPayment should process the order correctly and return response", async () => {
+        const token = "test-token";
+        const ns = "S";
+        const expectedPayload = `
+			<${ns}:Envelope xmlns:${ns}="http://schemas.xmlsoap.org/soap/envelope/" xmlns:${ServiceAlias.POINT_OF_SALE}="http://${ServiceAlias.POINT_OF_SALE}.ws.fbsaust.com.au">
+			<${ns}:Header>
+					<${ServiceAlias.POINT_OF_SALE}:SessionId>${token}</${ServiceAlias.POINT_OF_SALE}:SessionId>
+			</${ns}:Header>
+			<${ns}:Body>
+					<${ServiceAlias.POINT_OF_SALE}:ProcessSalesOrderWithoutPaymentRequest >
+						<mode>U</mode>
+						<audit_no>106942</audit_no>
+						<header>
+										<order_no>W00106943</order_no>
+										<customer_order_no>W00106943</customer_order_no>
+										<transaction_date>02-06-2015</transaction_date>
+										<transaction_time_hour>11</transaction_time_hour>
+										<transaction_time_min>52</transaction_time_min>
+										<transaction_time_sec>0</transaction_time_sec>
+										<shop_debtor>ABC</shop_debtor>
+										<diary>0005353</diary>
+										<diary_name_1>AMMY</diary_name_1>
+										<diary_name_2>WHITE</diary_name_2>
+										<warehouse>WEB</warehouse>
+										<agent_zone_1>1111</agent_zone_1>
+										<terminal_id>online</terminal_id>
+										<user>WEB</user>
+										<order_lines>0</order_lines>
+										<order_deposit_total>119.95</order_deposit_total>
+										<order_version>0</order_version>
+										<originator_software>WEB</originator_software>
+										<account_sale_flag>Y</account_sale_flag>
+						</header>
+						<extra>
+										<delivery_address_1>37</delivery_address_1>
+										<delivery_address_2>HOTHAM ST</delivery_address_2>
+										<delivery_address_3>ST KILDA EAST</delivery_address_3>
+										<delivery_address_4>VIC</delivery_address_4>
+										<delivery_postcode>3111</delivery_postcode>
+										<delivery_instruction_1>Enter backdoor</delivery_instruction_1>
+										<delivery_instruction_2>Then frontdoor</delivery_instruction_2>
+										<carrier>APOST</carrier>
+										<email>test@example.com</email>
+										<telephone_home>0444888885</telephone_home>
+										<telephone_mobile>0444888884</telephone_mobile>
+										<telephone_work>0444888883</telephone_work>
+										<billing_surname>DOE</billing_surname>
+										<billing_first_name>JOHN</billing_first_name>
+										<billing_address_1>37</billing_address_1>
+										<billing_address_2>HOTHAM ST</billing_address_2>
+										<billing_address_3>ST KILDA EAST</billing_address_3>
+										<billing_address_4>VIC</billing_address_4>
+										<billing_postcode>3111</billing_postcode>
+										<billing_telephone_home>0444888888</billing_telephone_home>
+										<billing_telephone_mobile>0444888887</billing_telephone_mobile>
+										<billing_telephone_work>0444888886</billing_telephone_work>
+										<customised_info>CUSTOM</customised_info>
+						</extra>
+						<stock>
+										<stock>7281VL.100</stock>
+										<stock_description>3/4 SLV CROSS OVER DRESS W/ TUCKS</stock_description>
+										<size>S</size>
+										<qdp>0</qdp>
+										<pdp>2</pdp>
+										<invoice_qty>0</invoice_qty>
+										<order_qty>1</order_qty>
+										<discount_price>119.95</discount_price>
+										<line_tax>0</line_tax>
+										<discount_rate>30</discount_rate>
+										<discount_reason>210</discount_reason>
+										<current_rrp_inc>149.95</current_rrp_inc>
+						</stock>
+					</${ServiceAlias.POINT_OF_SALE}:ProcessSalesOrderWithoutPaymentRequest>
+			</${ns}:Body>
+ </${ns}:Envelope>
+		`;
+        const params = {
+            mode: PosQueryMode.UPDATE,
+            auditNo: "106942",
+            header: {
+                orderNo: "W00106943",
+                customerOrderNo: "W00106943",
+                transactionDate: "02-06-2015",
+                transactionTimeHour: 11,
+                transactionTimeMin: 52,
+                transactionTimeSec: 0,
+                shopDebtor: "ABC",
+                diary: "0005353",
+                diaryName1: "AMMY",
+                diaryName2: "WHITE",
+                warehouse: "WEB",
+                agentZone1: 1111,
+                terminalId: "online",
+                user: "WEB",
+                orderLines: 0,
+                orderDepositTotal: 119.95,
+                orderVersion: 0,
+                originatorSoftware: "WEB",
+                accountSaleFlag: AccountSaleFlag.YES,
+            },
+            stock: [
+                {
+                    stock: "7281VL.100",
+                    stockDescription: "3/4 SLV CROSS OVER DRESS W/ TUCKS",
+                    size: "S",
+                    qdp: 0,
+                    pdp: 2,
+                    invoiceQty: 0.0,
+                    orderQty: 1.0,
+                    discountPrice: 119.95,
+                    lineTax: 0.0,
+                    discountRate: 30.0,
+                    discountReason: "210",
+                    currentRrpInc: 149.95,
+                },
+            ],
+            extra: {
+                deliveryAddress1: "37",
+                deliveryAddress2: "HOTHAM ST",
+                deliveryAddress3: "ST KILDA EAST",
+                deliveryAddress4: "VIC",
+                deliveryPostcode: "3111",
+                deliveryInstruction1: "Enter backdoor",
+                deliveryInstruction2: "Then frontdoor",
+                telephoneHome: "0444888885",
+                telephoneMobile: "0444888884",
+                telephoneWork: "0444888883",
+                email: "test@example.com",
+                billingAddress1: "37",
+                billingAddress2: "HOTHAM ST",
+                billingAddress3: "ST KILDA EAST",
+                billingAddress4: "VIC",
+                billingPostcode: "3111",
+                billingFirstname: "JOHN",
+                billingSurname: "DOE",
+                billingTelephoneHome: "0444888888",
+                billingTelephoneMobile: "0444888887",
+                billingTelephoneWork: "0444888886",
+                carrier: "APOST",
+                customisedInfo: "CUSTOM",
+            },
+        };
+        const mockedResp = `
+		<?xml version='1.0' encoding='UTF-8'?>
+		<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
+			<S:Body><ns2:ProcessSalesOrderWithoutPaymentResponse xmlns:ns2="http://pos.ws.fbsaust.com.au">
+					<result>true</result>
+				</ns2:ProcessSalesOrderWithoutPaymentResponse></S:Body>
+		</S:Envelope>
+	`;
+        const expectedResult = true;
+        mAxios.post.mockResolvedValueOnce({ data: mockedResp });
+        const response = await posModule.processSalesOrderWithoutPayment(params, token);
+        // Test that expected response is correct
+        expect(typeof response).toEqual("boolean");
+        expect(response).toEqual(expectedResult);
+        const actualPayload = mAxios.post.mock.calls[0][1];
+        // Test that actual payload sent in the API matches expected payload
+        expect(Utils.removeEmptySpaces(actualPayload)).toEqual(Utils.removeEmptySpaces(expectedPayload));
+        mAxios.post.mockClear();
+    });
 });

package/dist/modules/point-of-sale/types/process-sale-order.interface.d.ts

@@ -1,10 +1,12 @@
 import { PosBaseQueryParams, PosQueryDebtor, PosQueryExtra, PosQueryHeader, PosQueryInvoice, PosQueryStock } from ".";
 import { BooleanResponse } from "../../shared";
-export interface ProcessSaleOrderQueryParams extends PosBaseQueryParams {
+export interface ProcessSaleOrderQueryParams extends ProcessSaleOrderWithoutPaymentQueryParams {
+    debtor: ProcessSaleOrderQueryDebtor[];
+}
+export interface ProcessSaleOrderWithoutPaymentQueryParams extends PosBaseQueryParams {
     header: ProcessSaleOrderQueryHeader;
     extra: ProcessSaleOrderQueryExtra;
     stock: ProcessSaleOrderQueryStock[];
-    debtor: ProcessSaleOrderQueryDebtor[];
 }
 export interface ProcessSaleOrderQueryHeader extends PosQueryHeader {
     invoiceNo?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dotdev/harmony-sdk",
-  "version": "1.6.2",
+  "version": "1.7.0",
   "description": "Harmony API SDK",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",