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,DeviceId?:string,AppId?:string}} [init] */
    constructor(init) { Object.assign(this, init) }
    /**
     * @type {string}
     * @description This is your AIM API Key provided by Tri-Tech */
    ApiKey;
    /**
     * @type {string}
     * @description The OAuthToken token return by AeServices30 */
    OAuthToken;
    /**
     * @type {string}
     * @description The Device ID of the Mobile Device. Not used for non-mobile devices. */
    DeviceId;
    /**
     * @type {string}
     * @description An identifier for your integration */
    AppId;
}
export class BaseSecureRequest extends BaseRequest {
    /** @param {{Token?:string,ApiKey?:string,OAuthToken?:string,DeviceId?:string,AppId?:string}} [init] */
    constructor(init) { super(init); Object.assign(this, init) }
    /**
     * @type {string}
     * @description The Login Token return by the Security API. Required for secured calls. */
    Token;
}
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,ApiKey?:string,OAuthToken?:string,DeviceId?:string,AppId?: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 .xml suffix or ?format=xml

HTTP + XML

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/xml
Content-Type: application/xml
Content-Length: length

<SubmitPOSTransactionRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/AIM.WebService">
  <ApiKey>String</ApiKey>
  <AppId>String</AppId>
  <DeviceId>String</DeviceId>
  <OAuthToken>String</OAuthToken>
  <Token>String</Token>
  <Acct>0</Acct>
  <CardExpiration>String</CardExpiration>
  <CardTerminalId>String</CardTerminalId>
  <CardToken>String</CardToken>
  <Deposit>0</Deposit>
  <Items xmlns:d2p1="http://schemas.datacontract.org/2004/07/AIM">
    <d2p1:PosLineItem>
      <d2p1:AllowPriceOverrideToIgnoreMinPrice>false</d2p1:AllowPriceOverrideToIgnoreMinPrice>
      <d2p1:Discount>0</d2p1:Discount>
      <d2p1:ExceptionInfo>
        <d2p1:Barcode>String</d2p1:Barcode>
        <d2p1:Base64Image>String</d2p1:Base64Image>
        <d2p1:Category>0</d2p1:Category>
        <d2p1:Description>String</d2p1:Description>
        <d2p1:SubCategory>0</d2p1:SubCategory>
      </d2p1:ExceptionInfo>
      <d2p1:NicsCat>0</d2p1:NicsCat>
      <d2p1:NicsSub>0</d2p1:NicsSub>
      <d2p1:Notes>String</d2p1:Notes>
      <d2p1:PriceOverride>0</d2p1:PriceOverride>
      <d2p1:Quantity>0</d2p1:Quantity>
      <d2p1:SasPk>0</d2p1:SasPk>
      <d2p1:Serial>String</d2p1:Serial>
      <d2p1:Sku>String</d2p1:Sku>
      <d2p1:SkuPk>0</d2p1:SkuPk>
    </d2p1:PosLineItem>
  </Items>
  <LocId>0</LocId>
  <Notes>String</Notes>
  <OnlineContractRef>String</OnlineContractRef>
  <OtherTenderCategory>0</OtherTenderCategory>
  <PONumber>String</PONumber>
  <SaveCard>false</SaveCard>
  <ShipId>0</ShipId>
  <TaxId>0</TaxId>
  <TenderType>String</TenderType>
  <TokenPk>0</TokenPk>
  <TransactionMode>String</TransactionMode>
</SubmitPOSTransactionRequest>

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<SubmitPOSTransactionResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/AIM.WebService">
  <Status>
    <DomainName>String</DomainName>
    <ErrorCode>String</ErrorCode>
    <ErrorDisplayText>String</ErrorDisplayText>
    <ErrorMessage>String</ErrorMessage>
    <IpAddress>String</IpAddress>
    <Login>String</Login>
    <StatusCode>String</StatusCode>
  </Status>
  <ErrorItems>
    <PosResponseItem>
      <AllowPriceOverrideToIgnoreMinPrice xmlns="http://schemas.datacontract.org/2004/07/AIM">false</AllowPriceOverrideToIgnoreMinPrice>
      <Discount xmlns="http://schemas.datacontract.org/2004/07/AIM">0</Discount>
      <ExceptionInfo xmlns="http://schemas.datacontract.org/2004/07/AIM">
        <Barcode>String</Barcode>
        <Base64Image>String</Base64Image>
        <Category>0</Category>
        <Description>String</Description>
        <SubCategory>0</SubCategory>
      </ExceptionInfo>
      <NicsCat xmlns="http://schemas.datacontract.org/2004/07/AIM">0</NicsCat>
      <NicsSub xmlns="http://schemas.datacontract.org/2004/07/AIM">0</NicsSub>
      <Notes xmlns="http://schemas.datacontract.org/2004/07/AIM">String</Notes>
      <PriceOverride xmlns="http://schemas.datacontract.org/2004/07/AIM">0</PriceOverride>
      <Quantity xmlns="http://schemas.datacontract.org/2004/07/AIM">0</Quantity>
      <SasPk xmlns="http://schemas.datacontract.org/2004/07/AIM">0</SasPk>
      <Serial xmlns="http://schemas.datacontract.org/2004/07/AIM">String</Serial>
      <Sku xmlns="http://schemas.datacontract.org/2004/07/AIM">String</Sku>
      <SkuPk xmlns="http://schemas.datacontract.org/2004/07/AIM">0</SkuPk>
      <Discountable>false</Discountable>
      <ErrorMessage>String</ErrorMessage>
      <Price>0</Price>
      <PriceEach>0</PriceEach>
    </PosResponseItem>
  </ErrorItems>
  <RefNumber>String</RefNumber>
</SubmitPOSTransactionResponse>