AIM Web Services

<back to all web services

SubmitPOSTransactionRequest

In development, not yet for public use.

The following routes are available for this service:
POST/api/SubmitPOSTransaction
"use strict";
export class BaseRequest {
    /** @param {{ApiKey?:string,OAuthToken?:string}} [init] */
    constructor(init) { Object.assign(this, init) }
    /**
     * @type {string}
     * @description This is your AIM API Key provided by Tri-Tech */
    ApiKey;
    /** @type {string} */
    OAuthToken;
}
export class BaseSecureRequest extends BaseRequest {
    /** @param {{Token?:string,DeviceId?:string,AppId?:string,ApiKey?:string,OAuthToken?:string}} [init] */
    constructor(init) { super(init); Object.assign(this, init) }
    /** @type {string} */
    Token;
    /** @type {string} */
    DeviceId;
    /** @type {string} */
    AppId;
}
export class BaseResponseResult {
    /** @param {{StatusCode?:string,Login?:string,ErrorCode?:string,ErrorDisplayText?:string,ErrorMessage?:string,DomainName?:string,IpAddress?:string}} [init] */
    constructor(init) { Object.assign(this, init) }
    /** @type {string} */
    StatusCode;
    /** @type {string} */
    Login;
    /** @type {string} */
    ErrorCode;
    /** @type {string} */
    ErrorDisplayText;
    /** @type {string} */
    ErrorMessage;
    /** @type {string} */
    DomainName;
    /** @type {string} */
    IpAddress;
}
export class BaseResponse {
    /** @param {{Status?:BaseResponseResult}} [init] */
    constructor(init) { Object.assign(this, init) }
    /** @type {BaseResponseResult} */
    Status;
}
export class ExceptionInfo {
    /** @param {{Barcode?:string,Description?:string,Base64Image?:string,Category?:number,SubCategory?:number}} [init] */
    constructor(init) { Object.assign(this, init) }
    /** @type {string} */
    Barcode;
    /** @type {string} */
    Description;
    /** @type {string} */
    Base64Image;
    /** @type {number} */
    Category;
    /** @type {?number} */
    SubCategory;
}
export class PosLineItem {
    /** @param {{SkuPk?:number,SasPk?:number,Sku?:string,Serial?:string,Quantity?:number,ExceptionInfo?:ExceptionInfo,Discount?:number,NicsCat?:number,NicsSub?:number,PriceOverride?:number,AllowPriceOverrideToIgnoreMinPrice?:boolean,Notes?:string}} [init] */
    constructor(init) { Object.assign(this, init) }
    /** @type {?number} */
    SkuPk;
    /** @type {?number} */
    SasPk;
    /** @type {string} */
    Sku;
    /** @type {string} */
    Serial;
    /** @type {number} */
    Quantity;
    /** @type {ExceptionInfo} */
    ExceptionInfo;
    /** @type {?number} */
    Discount;
    /** @type {?number} */
    NicsCat;
    /** @type {?number} */
    NicsSub;
    /** @type {?number} */
    PriceOverride;
    /** @type {boolean} */
    AllowPriceOverrideToIgnoreMinPrice;
    /** @type {string} */
    Notes;
}
export class PosResponseItem extends PosLineItem {
    /** @param {{PriceEach?:number,Price?:number,Discountable?:boolean,ErrorMessage?:string,SkuPk?:number,SasPk?:number,Sku?:string,Serial?:string,Quantity?:number,ExceptionInfo?:ExceptionInfo,Discount?:number,NicsCat?:number,NicsSub?:number,PriceOverride?:number,AllowPriceOverrideToIgnoreMinPrice?:boolean,Notes?:string}} [init] */
    constructor(init) { super(init); Object.assign(this, init) }
    /** @type {number} */
    PriceEach;
    /** @type {number} */
    Price;
    /** @type {boolean} */
    Discountable;
    /** @type {string} */
    ErrorMessage;
}
export class SubmitPOSTransactionResponse extends BaseResponse {
    /** @param {{RefNumber?:string,ErrorItems?:PosResponseItem[],Status?:BaseResponseResult}} [init] */
    constructor(init) { super(init); Object.assign(this, init) }
    /** @type {string} */
    RefNumber;
    /** @type {PosResponseItem[]} */
    ErrorItems;
}
export class SubmitPOSTransactionRequest extends BaseSecureRequest {
    /** @param {{Acct?:number,LocId?:number,TaxId?:number,Items?:PosLineItem[],TenderType?:string,OtherTenderCategory?:number,CardToken?:string,CardExpiration?:string,TokenPk?:number,SaveCard?:boolean,PONumber?:string,TransactionMode?:string,Deposit?:number,Notes?:string,OnlineContractRef?:string,ShipId?:number,CardTerminalId?:string,Token?:string,DeviceId?:string,AppId?:string,ApiKey?:string,OAuthToken?:string}} [init] */
    constructor(init) { super(init); Object.assign(this, init) }
    /** @type {?number} */
    Acct;
    /** @type {?number} */
    LocId;
    /** @type {?number} */
    TaxId;
    /** @type {PosLineItem[]} */
    Items;
    /**
     * @type {string}
     * @description Can be CARD, CARD_DEVICE, CASH, CHARGE, SUSPEND, ONFILE, or OTHER */
    TenderType;
    /**
     * @type {?number}
     * @description Only applicable for Tender Type of OTHER. Send the Payment Category # */
    OtherTenderCategory;
    /** @type {string} */
    CardToken;
    /** @type {string} */
    CardExpiration;
    /** @type {?number} */
    TokenPk;
    /** @type {boolean} */
    SaveCard;
    /** @type {string} */
    PONumber;
    /**
     * @type {string}
     * @description Can be INVOICE, PROPOSAL, APPROVAL, ORDER, or LOANER. Defaults to INVOICE is not sent. */
    TransactionMode;
    /**
     * @type {number}
     * @description Only valid for Approvals and Orders. */
    Deposit;
    /** @type {string} */
    Notes;
    /**
     * @type {string}
     * @description Do Not Send This Parameter */
    OnlineContractRef;
    /** @type {?number} */
    ShipId;
    /** @type {string} */
    CardTerminalId;
}

JavaScript SubmitPOSTransactionRequest DTOs

To override the Content-type in your clients, use the HTTP Accept Header, append the .json suffix or ?format=json

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /api/SubmitPOSTransaction HTTP/1.1 
Host: active-ewebservice.biz 
Accept: application/json
Content-Type: application/json
Content-Length: length

{"Acct":0,"LocId":0,"TaxId":0,"Items":[{"SkuPk":0,"SasPk":0,"Sku":"String","Serial":"String","Quantity":0,"ExceptionInfo":{"Barcode":"String","Description":"String","Base64Image":"String","Category":0,"SubCategory":0},"Discount":0,"NicsCat":0,"NicsSub":0,"PriceOverride":0,"AllowPriceOverrideToIgnoreMinPrice":false,"Notes":"String"}],"TenderType":"String","OtherTenderCategory":0,"CardToken":"String","CardExpiration":"String","TokenPk":0,"SaveCard":false,"PONumber":"String","TransactionMode":"String","Deposit":0,"Notes":"String","OnlineContractRef":"String","ShipId":0,"CardTerminalId":"String","Token":"String","DeviceId":"String","AppId":"String","ApiKey":"String","OAuthToken":"String"}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"RefNumber":"String","ErrorItems":[{"PriceEach":0,"Price":0,"Discountable":false,"ErrorMessage":"String","SkuPk":0,"SasPk":0,"Sku":"String","Serial":"String","Quantity":0,"ExceptionInfo":{"Barcode":"String","Description":"String","Base64Image":"String","Category":0,"SubCategory":0},"Discount":0,"NicsCat":0,"NicsSub":0,"PriceOverride":0,"AllowPriceOverrideToIgnoreMinPrice":false,"Notes":"String"}],"Status":{"StatusCode":"String","Login":"String","ErrorCode":"String","ErrorDisplayText":"String","ErrorMessage":"String","DomainName":"String","IpAddress":"String"}}