PayTraq - A Cloud-based Business Suite - more than just online accounting

PayTraq REST API

Current Version: v1.6 Beta
Last Updated: 10 November, 2016

Overview

The PayTraq API is a RESTful web service that is available over HTTPS by using the following endpoint: https://go.paytraq.com/api/

To getting started primary user needs to obtain new API credentials for a company profile. API credentials consisted of API Key/Token pair should be used in every API call for authentication and authorization purposes.

Existing API credentials can be regenerated at any time that will prevent API access by using the previous Key/Token pair.
API Access can be blocked at any time by deleting current active credentials.

The transmission of all API requests and responses needs to be made over HTTPS
There are two type of requests: GET and POST
GET requests are usually used to read the data, POST request are used to add and update the data.
All POST requests should be made in XML format with "Content-Type: text/xml" header.
All success responses are also given in XML format.

Examples
GET
curl -v -X GET https://go.paytraq.com/api/{APICall}?APIToken={APIToken}&APIKey={APIKey} \
-H "Content-Type:text/xml" \
POST
curl -v https://go.paytraq.com/api/{APICall}?APIToken={APIToken}&APIKey={APIKey} \
-H "Content-Type:text/xml" \
-d "{RequestBody}"

List of Return Codes and Statuses

Code Status Definition
200 OK The request has succeeded.
400 Bad Request The request could not be understood by the server due to malformed syntax, invalid values or validation issues.
401 Unauthorized API credentials have not been provided or company license key is not valid.
403 Forbidden Request is not permitted and has been forbidden by the server due to incorrect data, validation issues or authorization failure.
404 Not Found The server has not found anything matching the Request-URI.
500 Internal Server Error The server encountered an unexpected condition which prevented it from fulfilling the request.
501 Not Implemented The method called has not been implemented yet.
503 Service Unavailable The server is currently unable to handle the request due to maintenance of the server. This is a temporary condition which will be alleviated after some delay.

Every successful request should always return HTTP 200 OK code.

API Conventions

  • Decimal values should be passed with dot separator e.g. 10.90
  • Dates should be passed in the following format YYYY-MM-DD e.g. 2014-01-30
  • Boolean values should be false or true, 0 or 1 is not permitted.

Optional Parameters

GET requests that are used to retrieve the list of objects can contain some optional parameters:
  • Pagination
    By default only the first 100 records are returned.
    To utilise paging, append a page parameter to the URL e.g. &page=0.
    If there are 100 records in the response you will need to check if there is any more data by fetching the next page e.g. &page=1 and continuing this process until no more results are returned.
    Note: Page values start with 0.
  • Filtering
    A filter can be applied to the results by appending a query parameter to the URL e.g. &query=John
    Possible values depend on request and retrieved object types.
    Example:
    List of clients or suppliers can be filtered by name or email.
    List of products or services - by name, SKU or barcode.
    List of documents - by document number or contact name.
    No filters are applied by default.
  • Date Range
    Lists of documents and journals can be filtered by dates by appending the following parameters to the URL:
    - date_from, e.g. &date_from=2014-12-01
    - date_till, e.g. &date_till=2014-12-31

API Calls

Clients

Get Client List

Request

GET https://go.paytraq.com/api/clients?APIToken={APIToken}&APIKey={APIKey}

Result list is sorted by client name in ascending order.
Optional parameters are available. Results can be filtered by client name or email.

Response


<Clients>
   <Client>
      <ClientID></ClientID>
      <Name />
      <Email />
      <Type></Type>
      <Status></Status>
      <RegNumber />
      <VatNumber />
      <LegalAddress>
         <Address />
         <Zip />
         <Country></Country>
      </LegalAddress>
      <Phone />
      <ClientGroup>
         <GroupID />
         <GroupName />
      </ClientGroup>
   </Client>
   ...
</Clients>
   

Tag Description
<ClientID> Unique system identifier for client
<Type> Possible values:
  • 1 - Individual
  • 2 - Corporate
<Status> Possible values:
  • 1 - Prospective
  • 2 - Active
  • 3 - Inactive
<Country> 2-letter ISO country code
<GroupID> Unique system identifier for client group. See Get Client Groups

Back to Clients

Get Client

Request

GET https://go.paytraq.com/api/client/{ClientID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
ClientID Unique system identifier for client
Response


<Client>
   <ClientID></ClientID>
   <Name />
   <Email />
   <Type></Type>
   <Status></Status>
   <RegNumber />
   <VatNumber />
   <LegalAddress>
      <Address />
      <Zip />
      <Country></Country>
   </LegalAddress>
   <Phone />
   <ClientGroup>
      <GroupID />
      <GroupName />
   </ClientGroup>
   <FinancialData>
      <ContractNumber />
      <CreditLimit></CreditLimit>
      <Deposit></Deposit>
      <Discount></Discount>
      <PayTerm>
         <PayTermType></PayTermType>
         <PayTermDays></PayTermDays>
      </PayTerm>
      <TaxKeys>
         <Products>
            <TaxKeyID />
            <TaxKeyName />
         </Products>
         <Services>
            <TaxKeyID />
            <TaxKeyName />
         </Services>
      </TaxKeys>
      <Warehouse>
         <WrhID />
         <WrhName />
      </Warehouse>
      <PriceGroup>
         <PriceGroupID />
         <PriceGroupName />
      </PriceGroup>
   </FinancialData>
</Client>
   

Tag Description
<ClientID> Unique system identifier for client
<Type> Possible values:
  • 1 - Individual
  • 2 - Corporate
<Status> Possible values:
  • 1 - Prospective
  • 2 - Active
  • 3 - Inactive
<Country> 2-letter ISO country code
<GroupID> Unique system identifier for client group. See Get Client Groups
<PayTermType> Possible values:
  • 1 - Due days
  • 2 - EOM+
  • 3 - Cash on delivery
  • 4 - Open date of payment
<PayTermDays> Number of days. Can be used only with <PayTermType> values 1 and 2
<TaxKeyID> Unique system identifier for tax key. See Get Tax Key
<WrhID> Unique system identifier for warehouse. See Get Warehouse
<PriceGroupID> Unique system identifier for price group. See Get Price Group

Back to Clients

Add Client

Request

POST https://go.paytraq.com/api/client?APIToken={APIToken}&APIKey={APIKey}


<Client>
   <Name />
   <Email />
   <Type />
   <Status />
   <RegNumber />
   <VatNumber />
   <LegalAddress>
      <Address />
      <Zip />
      <Country />
   </LegalAddress>
   <Phone />
   <ClientGroup>
      <GroupID />
   </ClientGroup>
</Client>
   

Only <Name> is required.
For tags description please refer to Get Client request.

Response


<Response>
   <ClientID></ClientID>
</Response>
   

Tag Description
<ClientID> Unique system identifier for client

Back to Clients

Update Client (General Data)

Request

POST https://go.paytraq.com/api/client/{ClientID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
ClientID Unique system identifier for client


<Client>
   <Name />
   <Email />
   <Type />
   <Status />
   <RegNumber />
   <VatNumber />
   <LegalAddress>
      <Address />
      <Zip />
      <Country />
   </LegalAddress>
   <Phone />
   <ClientGroup>
      <GroupID />
   </ClientGroup>
</Client>
   

No tags are required.
For tags description please refer to Get Client request.

Response


<Response>
   <ClientID></ClientID>
</Response>
   

Tag Description
<ClientID> Unique system identifier for client

Back to Clients

Update Client (Financial Data)

Request

POST https://go.paytraq.com/api/client/financialData/{ClientID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
ClientID Unique system identifier for client


<Client>
   <FinancialData>
      <ContractNumber />
      <CreditLimit></CreditLimit>
      <Deposit></Deposit>
      <Discount></Discount>
      <PayTerm>
         <PayTermType></PayTermType>
         <PayTermDays></PayTermDays>
      </PayTerm>
      <TaxKeys>
         <Products>
            <TaxKeyID />
         </Products>
         <Services>
            <TaxKeyID />
         </Services>
      </TaxKeys>
      <Warehouse>
         <WrhID />
      </Warehouse>
      <PriceGroup>
         <PriceGroupID />
      </PriceGroup>
   </FinancialData>
</Client>
   

No tags are required.
For tags description please refer to Get Client request.

Response


<Response>
   <ClientID></ClientID>
</Response>
   

Tag Description
<ClientID> Unique system identifier for client

Back to Clients

Get Client Shipping Address List

Request

GET https://go.paytraq.com/api/client/shippingAddresses/{ClientID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
ClientID Unique system identifier for client
Response


<ShippingAddresses>
   <ShippingAddress>
      <AddressID></AddressID>
      <ShipTo></ShipTo>
      <Address></Address>
      <Zip></Zip>
      <Country></Country>
      <IsDefault></IsDefault>
   </ShippingAddress>
</ShippingAddresses>
   

Tag Description
<AddressID> Unique system identifier for shipping address
<Country> 2-letter ISO country code
<IsDefault> Boolean value (false | true)

Back to Clients

Get Client Shipping Address

Request

GET https://go.paytraq.com/api/client/shippingAddress/{ClientID}/{AddressID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
ClientID Unique system identifier for client
AddressID Unique system identifier for shipping address
Response


<ShippingAddress>
   <AddressID></AddressID>
   <ShipTo></ShipTo>
   <Address></Address>
   <Zip></Zip>
   <Country></Country>
   <IsDefault></IsDefault>
</ShippingAddress>
   

Tag Description
<AddressID> Unique system identifier for shipping address
<Country> 2-letter ISO country code
<IsDefault> Boolean value (false | true)

Back to Clients

Add Client Shipping Address

Request

POST https://go.paytraq.com/api/client/shippingAddress/{ClientID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
ClientID Unique system identifier for client


<ShippingAddress>
   <ShipTo></ShipTo>
   <Address></Address>
   <Zip></Zip>
   <Country></Country>
   <IsDefault></IsDefault>
</ShippingAddress>
   

For tags description please refer to Get Client Shipping Address request

Response


<Response>
   <AddressID></AddressID>
</Response>
   

Tag Description
<AddressID> Unique system identifier for shipping address

Back to Clients

Update Client Shipping Address

Request

POST https://go.paytraq.com/api/client/shippingAddress/{ClientID}/{AddressID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
ClientID Unique system identifier for client
AddressID Unique system identifier for shipping address


<ShippingAddress>
   <ShipTo></ShipTo>
   <Address></Address>
   <Zip></Zip>
   <Country></Country>
   <IsDefault></IsDefault>
</ShippingAddress>
   

No tags are required.
For tags description please refer to Get Client Shipping Address request.

Response


<Response>
   <AddressID></AddressID>
</Response>
   

Tag Description
<AddressID> Unique system identifier for shipping address

Back to Clients

Get Client Groups

Request

GET https://go.paytraq.com/api/clientGroups?APIToken={APIToken}&APIKey={APIKey}

Response


<ClientGroups>
   <ClientGroup>
      <GroupID></GroupID>
      <GroupName></GroupName>
   </ClientGroup>
   ...
</ClientGroups>
   

Tag Description
<GroupID> Unique system identifier for client group

Back to Clients

Get Default Client Group

Request

GET https://go.paytraq.com/api/clientGroupDefaultId?APIToken={APIToken}&APIKey={APIKey}

Response


<ClientGroup>
   <GroupID></GroupID>
</ClientGroup>
   

Tag Description
<GroupID> Unique system identifier for client group.
If no default group is found then <GroupID>0</GroupID> will be returned

Back to Clients

Request

GET https://go.paytraq.com/api/clientLink/{ClientID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
ClientID Unique system identifier for client
Response


<Client>
   <BillingSummaryLink>
      <URL></URL>
   </BillingSummaryLink>
</Client>
   

Back to Clients

Get Client Outstanding Balances

Request

GET https://go.paytraq.com/api/client/outstanding/{ClientID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
ClientID Unique system identifier for client
Response


<Client>
  <BillingSummary>
    <Currency></Currency>
    <AmountDue></AmountDue>
    <AmountOverDue></AmountOverDue>
      <Sales>
        <Sale>
          <Header>
            <Document>
              <DocumentID></DocumentID>
              <DocumentDate></DocumentDate>
              <DocumentRef></DocumentRef>
              <DocumentType><DocumentType>
              <DocumentStatus></DocumentStatus>
            </Document>>
          </Header>
          <SaleType></SaleType>
          <Total></Total>
          <DateDue></DateDue>
          <AmountDue></AmountDue>
        </Sale>
      </Sales>
  </BillingSummary>
</Client>
   

Tag Description
<Currency> 3-letter currency code
<DocumentID> Unique system identifier for sales document
<DocumentRef> Document number
<DocumentStatus> Possible values:
  • wait_payment - Waiting for Payment
  • part_paid - Partially Paid
<SaleType> Possible values:
  • sales_invoice - Invoice
  • sales_receipt - Receipt
  • credit_note - Credit Note/Refund

Back to Clients

Suppliers

Get Supplier List

Request

GET https://go.paytraq.com/api/suppliers?APIToken={APIToken}&APIKey={APIKey}

Result list is sorted by supplier name in ascending order.
Optional parameters are available. Results can be filtered by supplier name or email.

Response


<Suppliers>
   <Supplier>
      <SupplierID></SupplierID>
      <Name />
      <Email />
      <Type></Type>
      <Status></Status>
      <RegNumber />
      <VatNumber />
      <LegalAddress>
         <Address />
         <Zip />
         <Country></Country>
      </LegalAddress>
      <Phone />
      <SupplierGroup>
         <GroupID />
         <GroupName />
      </SupplierGroup>
   </Supplier>
   ...
</Suppliers>
   

Tag Description
<SupplierID> Unique system identifier for supplier
<Type> Possible values:
  • 1 - Individual
  • 2 - Corporate
<Status> Possible values:
  • 2 - Active
  • 3 - Inactive
<Country> 2-letter ISO country code
<GroupID> Unique system identifier for supplier group. See Get Supplier Groups

Back to Suppliers

Get Supplier

Request

GET https://go.paytraq.com/api/supplier/{SupplierID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
SupplierID Unique system identifier for supplier
Response


<Supplier>
   <SupplierID></SupplierID>
   <Name />
   <Email />
   <Type></Type>
   <Status></Status>
   <RegNumber />
   <VatNumber />
   <LegalAddress>
      <Address />
      <Zip />
      <Country></Country>
   </LegalAddress>
   <Phone />
   <SupplierGroup>
      <GroupID />
      <GroupName />
   </SupplierGroup>
   <FinancialData>
      <ContractNumber />
      <CreditLimit></CreditLimit>
      <Deposit></Deposit>
      <Discount></Discount>
      <PayTerm>
         <PayTermType></PayTermType>
         <PayTermDays></PayTermDays>
      </PayTerm>
      <TaxKeys>
         <Products>
            <TaxKeyID />
            <TaxKeyName />
         </Products>
         <Services>
            <TaxKeyID />
            <TaxKeyName />
         </Services>
      </TaxKeys>
      <Warehouse>
         <WrhID />
         <WrhName />
      </Warehouse>
   </FinancialData>
</Supplier>
   

Tag Description
<SupplierID> Unique system identifier for supplier
<Type> Possible values:
  • 1 - Individual
  • 2 - Corporate
<Status> Possible values:
  • 2 - Active
  • 3 - Inactive
<Country> 2-letter ISO country code
<GroupID> Unique system identifier for supplier group. See Get Supplier Groups
<PayTermType> Possible values:
  • 1 - Due days
  • 2 - EOM+
  • 3 - Cash on delivery
  • 4 - Open date of payment
<PayTermDays> Number of days. Can be used only with <PayTermType> values 1 and 2
<TaxKeyID> Unique system identifier for tax key. See Get Tax Key
<WrhID> Unique system identifier for warehouse. See Get Warehouse

Back to Suppliers

Add Supplier

Request

POST https://go.paytraq.com/api/supplier?APIToken={APIToken}&APIKey={APIKey}


<Supplier>
   <Name />
   <Email />
   <Type />
   <Status />
   <RegNumber />
   <VatNumber />
   <LegalAddress>
      <Address />
      <Zip />
      <Country />
   </LegalAddress>
   <Phone />
   <SupplierGroup>
      <GroupID />
   </SupplierGroup>
</Supplier>
   

Only <Name> is required.
For tags description please refer to Get Supplier request

Response


<Response>
   <SupplierID></SupplierID>
</Response>
   

Tag Description
<SupplierID> Unique system identifier for supplier

Back to Suppliers

Update Supplier (General Data)

Request

POST https://go.paytraq.com/api/supplier/{SupplierID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
SupplierID Unique system identifier for supplier


<Supplier>
   <Name />
   <Email />
   <Type />
   <Status />
   <RegNumber />
   <VatNumber />
   <LegalAddress>
      <Address />
      <Zip />
      <Country />
   </LegalAddress>
   <Phone />
   <SupplierGroup>
      <GroupID />
   </SupplierGroup>
</Supplier>
   

No tags are required.
For tags description please refer to Get Supplier request.

Response


<Response>
   <SupplierID></SupplierID>
</Response>
   

Tag Description
<SupplierID> Unique system identifier for supplier

Back to Suppliers

Update Supplier (Financial Data)

Request

POST https://go.paytraq.com/api/supplier/financialData/{SupplierID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
SupplierID Unique system identifier for supplier


<Supplier>
   <FinancialData>
      <ContractNumber />
      <CreditLimit></CreditLimit>
      <Deposit></Deposit>
      <Discount></Discount>
      <PayTerm>
         <PayTermType></PayTermType>
         <PayTermDays></PayTermDays>
      </PayTerm>
      <TaxKeys>
         <Products>
            <TaxKeyID />
         </Products>
         <Services>
            <TaxKeyID />
         </Services>
      </TaxKeys>
      <Warehouse>
         <WrhID />
      </Warehouse>
   </FinancialData>
</Supplier>
   

No tags are required.
For tags description please refer to Get Supplier request.

Response


<Response>
   <SupplierID></SupplierID>
</Response>
   

Tag Description
<SupplierID> Unique system identifier for supplier

Back to Suppliers

Get Supplier Shipping Address List

Request

GET https://go.paytraq.com/api/supplier/shippingAddresses/{SupplierID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
SupplierID Unique system identifier for supplier
Response


<ShippingAddresses>
   <ShippingAddress>
      <AddressID></AddressID>
      <ShipTo></ShipTo>
      <Address></Address>
      <Zip></Zip>
      <Country></Country>
      <IsDefault></IsDefault>
   </ShippingAddress>
</ShippingAddresses>
   

Tag Description
<AddressID> Unique system identifier for shipping address
<Country> 2-letter ISO country code
<IsDefault> Boolean value (false | true)

Back to Suppliers

Get Supplier Shipping Address

Request

GET https://go.paytraq.com/api/supplier/shippingAddress/{SupplierID}/{AddressID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
SupplierID Unique system identifier for supplier
AddressID Unique system identifier for shipping address
Response


<ShippingAddress>
   <AddressID></AddressID>
   <ShipTo></ShipTo>
   <Address></Address>
   <Zip></Zip>
   <Country></Country>
   <IsDefault></IsDefault>
</ShippingAddress>
   

Tag Description
<AddressID> Unique system identifier for shipping address
<Country> 2-letter ISO country code
<IsDefault> Boolean value (false | true)

Back to Suppliers

Add Supplier Shipping Address

Request

POST https://go.paytraq.com/api/supplier/shippingAddress/{SupplierID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
SupplierID Unique system identifier for supplier


<ShippingAddress>
   <ShipTo></ShipTo>
   <Address></Address>
   <Zip></Zip>
   <Country></Country>
   <IsDefault></IsDefault>
</ShippingAddress>
   

For tags description please refer to Get Supplier Shipping Address request

Response


<Response>
   <AddressID></AddressID>
</Response>
   

Tag Description
<AddressID> Unique system identifier for shipping address

Back to Suppliers

Update Supplier Shipping Address

Request

POST https://go.paytraq.com/api/supplier/shippingAddress/{SupplierID}/{AddressID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
SupplierID Unique system identifier for supplier
AddressID Unique system identifier for shipping address


<ShippingAddress>
   <ShipTo></ShipTo>
   <Address></Address>
   <Zip></Zip>
   <Country></Country>
   <IsDefault></IsDefault>
</ShippingAddress>
   

No tags are required.
For tags description please refer to Get Supplier Shipping Address request.

Response


<Response>
   <AddressID></AddressID>
</Response>
   

Tag Description
<AddressID> Unique system identifier for shipping address

Back to Suppliers

Get Supplier Groups

Request

GET https://go.paytraq.com/api/supplierGroups?APIToken={APIToken}&APIKey={APIKey}

Response


<SupplierGroups>
   <SupplierGroup>
      <GroupID></GroupID>
      <GroupName></GroupName>
   </SupplierGroup>
   ...
</SupplierGroups>
   

Tag Description
<GroupID> Unique system identifier for supplier group

Back to Suppliers

Get Default Supplier Group

Request

GET https://go.paytraq.com/api/supplierGroupDefaultId?APIToken={APIToken}&APIKey={APIKey}

Response


<SupplierGroup>
   <GroupID></GroupID>
</SupplierGroup>
   

Tag Description
<GroupID> Unique system identifier for supplier group.
If no default group is found then <GroupID>0</GroupID> will be returned

Back to Suppliers

Employees

Get Employee List

Request

GET https://go.paytraq.com/api/employees?APIToken={APIToken}&APIKey={APIKey}

Result list is sorted by employee name in ascending order.
Optional parameters are available. Results can be filtered by employee name or email.

Response


<Employees>
   <Employee>
      <EmployeeID></EmployeeID>
      <Name />
      <Email />
      <Status></Status>
      <ContractNumber />
      <RegNumber />
      <LegalAddress>
         <Address />
         <Zip />
         <Country></Country>
      </LegalAddress>
      <Phone />
      <EmployeeGroup>
         <GroupID />
         <GroupName />
      </EmployeeGroup>
   </Employee>
   ...
</Employees>
   

Tag Description
<EmployeeID> Unique system identifier for employee
<Status> Possible values:
  • 2 - Active
  • 3 - Inactive
<Country> 2-letter ISO country code
<GroupID> Unique system identifier for employee group. See Get Employee Groups

Back to Employees

Get Employee

Request

GET https://go.paytraq.com/api/employee/{EmployeeID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
EmployeeID Unique system identifier for employee
Response


<Employee>
   <EmployeeID></EmployeeID>
   <Name />
   <Email />
   <Status></Status>
   <ContractNumber />
   <RegNumber />
   <LegalAddress>
      <Address />
      <Zip />
      <Country></Country>
   </LegalAddress>
   <Phone />
   <EmployeeGroup>
      <GroupID />
      <GroupName />
   </EmployeeGroup>
</Employee>
   

Tag Description
<EmployeeID> Unique system identifier for employee
<Status> Possible values:
  • 2 - Active
  • 3 - Inactive
<Country> 2-letter ISO country code
<GroupID> Unique system identifier for employee group. See Get Employee Groups

Back to Employees

Add Employee

Request

POST https://go.paytraq.com/api/employee?APIToken={APIToken}&APIKey={APIKey}


<Employee>
   <Name />
   <Email />
   <Status />
   <ContractNumber />
   <RegNumber  />
   <LegalAddress>
      <Address />
      <Zip />
      <Country />
   </LegalAddress>
   <Phone />
   <EmployeeGroup>
      <GroupID />
   </EmployeeGroup>
</Employee>
   

Only <Name> is required.
For tags description please refer to Get Employee request.

Response


<Response>
   <EmployeeID></EmployeeID>
</Response>
   

Tag Description
<EmployeeID> Unique system identifier for employee

Back to Employees

Update Employee (General Data)

Request

POST https://go.paytraq.com/api/employee/{EmployeeID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
EmployeeID Unique system identifier for employee


<Employee>
   <Name />
   <Email />
   <Type />
   <Status />
   <ContractNumber />
   <RegNumber />
   <LegalAddress>
      <Address />
      <Zip />
      <Country />
   </LegalAddress>
   <Phone />
   <EmployeeGroup>
      <GroupID />
   </EmployeeGroup>
</Employee>
   

No tags are required.
For tags description please refer to Get Employee request.

Response


<Response>
   <EmployeeID></EmployeeID>
</Response>
   

Tag Description
<EmployeeID> Unique system identifier for employee

Back to Employees

Get Employee Groups

Request

GET https://go.paytraq.com/api/employeeGroups?APIToken={APIToken}&APIKey={APIKey}

Response


<EmployeeGroups>
   <EmployeeGroup>
      <GroupID></GroupID>
      <GroupName></GroupName>
   </EmployeeGroup>
   ...
</EmployeeGroups>
   

Tag Description
<GroupID> Unique system identifier for employee group

Back to Employees

Get Default Employee Group

Request

GET https://go.paytraq.com/api/employeeGroupDefaultId?APIToken={APIToken}&APIKey={APIKey}

Response


<EmployeeGroup>
   <GroupID></GroupID>
</EmployeeGroup>
   

Tag Description
<GroupID> Unique system identifier for employee group.
If no default group is found then <GroupID>0</GroupID> will be returned

Back to Employees

Items

Get Product List

Request

GET https://go.paytraq.com/api/products?APIToken={APIToken}&APIKey={APIKey}

Result list is sorted by product name in ascending order.
Optional parameters are available. Results can be filtered by product name, SKU or barcode.

Additional optional parameters are available for this request:
GET https://go.paytraq.com/api/products?...&WarehouseID=0&PriceGroupID=0
WarehouseID - Unique system identifier for warehouse. See Get Warehouse
PriceGroupID - Unique system identifier for price group. See Get Price Group

Response


<Products>
   <Product>
      <ItemID></ItemID>
      <Name></Name>
      <Code></Code>
      <Unit>
         <UnitID></UnitID>
         <UnitName></UnitName>
      </Unit>
      <Description />
      <HasImage />
      <MappingValue />
      <OtherLanguageName />
      <Status></Status>
      <Type></Type>
      <BarCode />
      <Weight></Weight>
      <OrderLeadTime></OrderLeadTime>
      <Cost />
      <StandardCost />
      <Group>
         <GroupID />
         <GroupName />
      </Group>
      <HasLots></HasLots>
      <TaxKeys>
         <SalesTaxKeyID></SalesTaxKeyID>
         <SalesTaxKeyName></SalesTaxKeyName>
         <PurchasesTaxKeyID />
         <PurchasesTaxKeyName />
      </TaxKeys>
      <Inventory>
         <Qty></Qty>
      </Inventory>
      <Price>
         <GrossAmount></GrossAmount>
         <TaxRate></TaxRate>
         <Currency></Currency>
         <Discount></Discount>
      </Price>
   </Product>
   ...
</Products>
   

Tag Description
<ItemID> Unique system identifier for product
<Code> Product code (SKU)
<UnitID> Unique system identifier for unit of measure. See Get Unit
<Status> Possible values:
  • 1 - Active
  • 2 - Discontinued
<Type> Possible values:
  • 1 - Stockable
  • 2 - Consumable
  • 3 - Fixed asset
<GroupID> Unique system identifier for product group. See Get Product Groups
<HasLots> Boolean value (false | true)
<SalesTaxKeyID> Unique system identifier for tax key on sales. See Get Tax Key
<PurchasesTaxKeyID> Unique system identifier for tax key on purchases. See Get Tax Key
<Qty> Quantity available. If the param WarehouseID is passed in the request then quantity is returned for the given warehouse otherwise total available on all warehouses is returned. See Get Warehouse
<GrossAmount> Gross price (tax incl.). If the param PriceGroupID is passed in the request then price is returned for the given price group otherwise the default price group is taken into account. See Get Price Group
<TaxRate> Tax rate
<Discount> Promo discount in %

Back to Items

Get Product

Request

GET https://go.paytraq.com/api/product/{ItemID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
ItemID Unique system identifier for product
Response


<Product>
   <ItemID></ItemID>
   <Name></Name>
   <Code></Code>
   <Unit>
      <UnitID></UnitID>
      <UnitName></UnitName>
   </Unit>
   <Description />
   <HasImage />
   <MappingValue />
   <OtherLanguageName />
   <Status></Status>
   <Type></Type>
   <BarCode />
   <Weight></Weight>
   <OrderLeadTime></OrderLeadTime>
   <Cost />
   <StandardCost />
   <Group>
      <GroupID />
      <GroupName />
   </Group>
   <HasLots></HasLots>
   <TaxKeys>
      <SalesTaxKeyID></SalesTaxKeyID>
      <SalesTaxKeyName></SalesTaxKeyName>
      <PurchasesTaxKeyID />
      <PurchasesTaxKeyName />
   </TaxKeys>
   <Prices>
      <Price>
         <PriceGroup>
            <PriceGroupID></PriceGroupID>
            <PriceGroupName></PriceGroupName>
            <IncludeTax></IncludeTax>
         </PriceGroup>
         <IsDefault></IsDefault>
         <Amount></Amount>
         <Currency></Currency>
      </Price>
      ...
   </Prices>
   <Accounts>
      <COGAccountID />
      <IncomeAccountID />
      <FixedAssetAccountID />
   </Accounts>
</Product>
   

Tag Description
<ItemID> Unique system identifier for product
<Code> Product code (SKU)
<UnitID> Unique system identifier for unit of measure. See Get Unit
<Status> Possible values:
  • 1 - Active
  • 2 - Discontinued
<Type> Possible values:
  • 1 - Stockable
  • 2 - Consumable
  • 3 - Fixed asset
<GroupID> Unique system identifier for product group. See Get Product Groups
<HasLots> Boolean value (false | true)
<SalesTaxKeyID> Unique system identifier for tax key on sales. See Get Tax Key
<PurchasesTaxKeyID> Unique system identifier for tax key on purchases. See Get Tax Key
<PriceGroupID> Unique system identifier for price group. See Get Price Group
<IsDefault> Boolean value (false | true)
<IncludeTax> Boolean value (false | true)
Shows that amounts are tax inclusive
<COGAccountID> Unique system identifier for cost of goods account. See Get Account
<IncomeAccountID> Unique system identifier for income account. See Get Account
<FixedAssetAccountID> Unique system identifier for fixed asset account. See Get Account

Back to Items

Get Product By Code (SKU)

Request

GET https://go.paytraq.com/api/productByCode/{Code}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
Code Product code (SKU)
Response

Please refer to Get Product request

Back to Items

Get Product Image

Request

GET https://go.paytraq.com/api/productImage/{ItemID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
ItemID Unique system identifier for product
Response

Image (JPEG/PNG)

Back to Items

Get Product Price List

Request

GET https://go.paytraq.com/api/productPriceList/{PriceGroupID}?APIToken={APIToken}&APIKey={APIKey}

Result list is sorted by product name in ascending order.
Optional parameters are available. Results can be filtered by product name, SKU or barcode.

Parameter Description
PriceGroupID Unique system identifier for price group. See Get Price Group.
If 0 then the default price group will be applied.
TaxRate An explicit tax rate can be optionally applied to the request:
GET https://go.paytraq.com/api/productPriceList/{PriceGroupID}/{TaxRate}?...
Tax rate to be applied.
If 0 then no tax will be applied.
If {TaxRate} is not provided then the default tax rate of each product will be applied.
Response


<Products>
   <Product>
      <ItemID></ItemID>
      <Name></Name>
      <Code></Code>
      <Price>
         <PriceExclTax></PriceExclTax>
         <PriceIncTax></PriceIncTax>
         <Tax></Tax>
         <TaxRate></TaxRate>
         <Currency></Currency>
      </Price>
   </Product>
   ...
</Products>
   

Tag Description
<ItemID> Unique system identifier for product. See Get Product request.
<Code> Product code (SKU)
<PriceExclTax> Price excluding tax
<PriceIncTax> Price including tax
<Tax> Tax value

Back to Items

Add Product

Request

POST https://go.paytraq.com/api/product?APIToken={APIToken}&APIKey={APIKey}


<Product>
   <Name></Name>
   <Code></Code>
   <Unit>
      <UnitID></UnitID>
   </Unit>
   <Description />
   <MappingValue />
   <OtherLanguageName />
   <Status></Status>
   <Type></Type>
   <BarCode />
   <Weight></Weight>
   <OrderLeadTime></OrderLeadTime>
   <StandardCost />
   <Group>
      <GroupID />
   </Group>
   <HasLots></HasLots>
   <TaxKeys>
      <SalesTaxKeyID></SalesTaxKeyID>
      <PurchasesTaxKeyID />
   </TaxKeys>
</Product>
   

Only <Name> is required.
For tags description please refer to Get Product request.

Response


<Response>
   <ItemID></ItemID>
</Response>
   

Tag Description
<ItemID> Unique system identifier for product

Back to Items

Update Product

Request

POST https://go.paytraq.com/api/product/{ItemID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
ItemID Unique system identifier for product


<Product>
   <Name></Name>
   <Code></Code>
   <Unit>
      <UnitID></UnitID>
   </Unit>
   <Description />
   <MappingValue />
   <OtherLanguageName />
   <Status></Status>
   <Type></Type>
   <BarCode />
   <Weight></Weight>
   <OrderLeadTime></OrderLeadTime>
   <StandardCost />
   <Group>
      <GroupID />
   </Group>
   <HasLots></HasLots>
   <TaxKeys>
      <SalesTaxKeyID></SalesTaxKeyID>
      <PurchasesTaxKeyID />
   </TaxKeys>
</Product>
   

No tags are required.
For tags description please refer to Get Product request.

Response


<Response>
   <ItemID></ItemID>
</Response>
   

Tag Description
<ItemID> Unique system identifier for product

Back to Items

Add/Update Product Price

Request

POST https://go.paytraq.com/api/productPrice/{ItemID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
ItemID Unique system identifier for product


<Price>
      <PriceGroup>
            <PriceGroupID></PriceGroupID>
      </PriceGroup>
      <IsDefault></IsDefault>
      <Amount></Amount>
      <Currency></Currency>
</Price>
   

For tags description please refer to Get Product request

Response


<Response>
   <ItemID></ItemID>
</Response>
   

Tag Description
<ItemID> Unique system identifier for product

Back to Items

Get Product Groups

Request

GET https://go.paytraq.com/api/productGroups?APIToken={APIToken}&APIKey={APIKey}

Response


<Groups>
   <Group>
      <GroupID></GroupID>
      <GroupName></GroupName>
   </Group>
   ...
</Groups>
   

Tag Description
<GroupID> Unique system identifier for product group

Back to Items

Get Default Product Group

Request

GET https://go.paytraq.com/api/productGroupDefaultId?APIToken={APIToken}&APIKey={APIKey}

Response


<Group>
   <GroupID></GroupID>
</Group>
   

Tag Description
<GroupID> Unique system identifier for product group.
If no default group is found then <GroupID>0</GroupID> will be returned

Back to Items

Get Lot List

Request

GET https://go.paytraq.com/api/lots?APIToken={APIToken}&APIKey={APIKey}

Result list is sorted by lot number in ascending order.
Optional parameters are available. Results can be filtered by product name, SKU or lot number.

Additional optional parameters are available for this request:
GET https://go.paytraq.com/api/products?...&WarehouseID=0
WarehouseID - Unique system identifier for warehouse. See Get Warehouse

Response


<Lots>
  <Lot>
    <Product>
      <ItemID></ItemID>
      <Name></Name>
      <Code></Code>
    </Product>
    <LotID></LotID>
    <LotNumber></LotNumber>
    <ExpiryDate></ExpiryDate>
    <Description></Description>
    <IsInactive></IsInactive>
    <Inventory>
      <Qty></Qty>
    </Inventory>
  </Lot>
</Lots> 
   

Tag Description
<ItemID> Unique system identifier for product
<Code> Product code (SKU)
<LotID> Unique system identifier for lot. See Get Lot
<IsInactive> Boolean value (false | true)

Back to Items

Get Lot List By Product

Request

GET https://go.paytraq.com/api/product/lots/{ItemID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
ItemID Unique system identifier for product

Result list is sorted by lot number in ascending order.
Optional parameters are available. Results can be filtered by lot number.

Additional optional parameters are available for this request:
GET https://go.paytraq.com/api/products?...&WarehouseID=0
WarehouseID - Unique system identifier for warehouse. See Get Warehouse

Response


<Lots>
  <Lot>
    <Product>
      <ItemID></ItemID>
      <Name></Name>
      <Code></Code>
    </Product>
    <LotID></LotID>
    <LotNumber></LotNumber>
    <ExpiryDate></ExpiryDate>
    <Description></Description>
    <IsInactive></IsInactive>
    <Inventory>
      <Qty></Qty>
    </Inventory>
  </Lot>
</Lots>
   

Tag Description
<ItemID> Unique system identifier for product
<Code> Product code (SKU)
<LotID> Unique system identifier for lot. See Get Lot
<IsInactive> Boolean value (false | true)

Back to Items

Get Lot

Request

GET https://go.paytraq.com/api/lot/{LotID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
LotID Unique system identifier for lot
Response


<Lot>
  <Product>
    <ItemID></ItemID>
    <Name></Name>
    <Code></Code>
  </Product>
  <LotID></LotID>
  <LotNumber></LotNumber>
  <ExpiryDate></ExpiryDate>
  <Description></Description>
  <IsInactive></IsInactive>
</Lot>
   

Tag Description
<ItemID> Unique system identifier for product
<Code> Product code (SKU)
<LotID> Unique system identifier for lot. See Get Lot
<IsInactive> Boolean value (false | true)

Back to Items

Get Lot By Number

Request

GET https://go.paytraq.com/api/lotByNumber/{ItemID}/{LotNumber}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
ItemID Unique system identifier for product
LotNumber Lot number
Response


<Lot>
  <Product>
    <ItemID></ItemID>
    <Name></Name>
    <Code></Code>
  </Product>
  <LotID></LotID>
  <LotNumber></LotNumber>
  <ExpiryDate></ExpiryDate>
  <Description></Description>
  <IsInactive></IsInactive>
</Lot>
   

Tag Description
<ItemID> Unique system identifier for product
<Code> Product code (SKU)
<LotID> Unique system identifier for lot. See Get Lot
<IsInactive> Boolean value (false | true)

Back to Items

Add Lot

Request

POST https://go.paytraq.com/api/product/lot/{ItemID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
ItemID Unique system identifier for product


<Lot>
  <LotNumber></LotNumber>
  <ExpiryDate></ExpiryDate>
</Lot>
   

Only <LotNumber> is required.
For tags description please refer to Get Lot request.

Response


<Response>
  <LotID></LotID>
</Response>
   

Tag Description
<LotID> Unique system identifier for lot

Back to Items

Update Lot

Request

POST https://go.paytraq.com/api/lot/{LotID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
LotID Unique system identifier for lot


<Lot>
  <LotNumber></LotNumber>
  <ExpiryDate></ExpiryDate>
  <Description></Description>
  <IsInactive></IsInactive>
</Lot>
   

No tags are required.
For tags description please refer to Get Lot request.

Response


<Response>
   <LotID></LotID>
</Response>
   

Tag Description
<LotID> Unique system identifier for lot

Back to Items

Get Service List

Request

GET https://go.paytraq.com/api/services?APIToken={APIToken}&APIKey={APIKey}

Result list is sorted by service name in ascending order.
Optional parameters are available. Results can be filtered by service name or code.

Response


<Services>
   <Service>
      <ItemID></ItemID>
      <Name></Name>
      <Code></Code>
      <Unit>
         <UnitID></UnitID>
         <UnitName></UnitName>
      </Unit>
      <Description />
      <OtherLanguageName />
      <Status></Status>
      <Group>
         <GroupID />
         <GroupName />
      </Group>
      <TaxKeys>
         <SalesTaxKeyID></SalesTaxKeyID>
         <SalesTaxKeyName></SalesTaxKeyName>
      </TaxKeys>
   </Service>
   ...
</Services>
   

Tag Description
<ItemID> Unique system identifier for service
<Code> Service code
<UnitID> Unique system identifier for unit of measure. See Get Unit
<Status> Possible values:
  • 1 - Active
  • 2 - Discontinued
<GroupID> Unique system identifier for service group. See Get Service Groups
<SalesTaxKeyID> Unique system identifier for tax key on sales. See Get Tax Key

Back to Items

Get Service

Request

GET https://go.paytraq.com/api/service/{ItemID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
ItemID Unique system identifier for service
Response


<Service>
   <ItemID></ItemID>
   <Name></Name>
   <Code></Code>
   <Unit>
      <UnitID></UnitID>
      <UnitName></UnitName>
   </Unit>
   <Description />
   <OtherLanguageName />
   <Status></Status>
   <Group>
      <GroupID />
      <GroupName />
   </Group>
   <TaxKeys>
      <SalesTaxKeyID></SalesTaxKeyID>
      <SalesTaxKeyName></SalesTaxKeyName>
   </TaxKeys>
   <Prices>
      <Price>
         <PriceGroup>
            <PriceGroupID></PriceGroupID>
            <PriceGroupName></PriceGroupName>
            <IncludeTax></IncludeTax>
         </PriceGroup>
         <IsDefault></IsDefault>
         <Amount></Amount>
         <Currency></Currency>
      </Price>
      ...
   </Prices>
   <Accounts>
      <IncomeAccountID />
   </Accounts>
</Service>
   

Tag Description
<ItemID> Unique system identifier for service
<Code> Service code
<UnitID> Unique system identifier for unit of measure
<Status> Possible values:
  • 1 - Active
  • 2 - Discontinued
<GroupID> Unique system identifier for service group. See Get Service Groups
<SalesTaxKeyID> Unique system identifier for tax key on sales. See Get Tax Key
<PriceGroupID> Unique system identifier for price group. See Get Price Group
<IsDefault> Boolean value (false | true)
<IncludeTax> Boolean value (false | true)
Shows that amounts are tax inclusive
<IncomeAccountID> Unique system identifier for income account. See Get Account

Back to Items

Get Service By Code

Request

GET https://go.paytraq.com/api/serviceByCode/{Code}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
Code Service code
Response

Please refer to Get Service request

Back to Items

Get Service Price List

Request

GET https://go.paytraq.com/api/servicePriceList/{PriceGroupID}?APIToken={APIToken}&APIKey={APIKey}

Result list is sorted by service name in ascending order.
Optional parameters are available. Results can be filtered by service name or code.

Parameter Description
PriceGroupID Unique system identifier for price group. See Get Price Group.
If 0 then the default price group will be applied.
TaxRate An explicit tax rate can be optionally applied to the request:
GET https://go.paytraq.com/api/servicePriceList/{PriceGroupID}/{TaxRate}?...
Tax rate to be applied.
If 0 then no tax will be applied.
If {TaxRate} is not provided then the default tax rate of each service will be applied.
Response


<Services>
   <Service>
      <ItemID></ItemID>
      <Name></Name>
      <Code></Code>
      <Price>
         <PriceExclTax></PriceExclTax>
         <PriceIncTax></PriceIncTax>
         <Tax></Tax>
         <TaxRate></TaxRate>
         <Currency></Currency>
      </Price>
   </Service>
   ...
</Services>
   

Tag Description
<ItemID> Unique system identifier for service. See Get Service request.
<Code> Service code
<PriceExclTax> Price excluding tax
<PriceIncTax> Price including tax
<Tax> Tax value

Back to Items

Add Service

Request

POST https://go.paytraq.com/api/service?APIToken={APIToken}&APIKey={APIKey}


<Service>
   <Name></Name>
   <Code></Code>
   <Unit>
      <UnitID></UnitID>
   </Unit>
   <Description />
   <OtherLanguageName />
   <Status></Status>
   <Group>
      <GroupID />
   </Group>
   <TaxKeys>
      <SalesTaxKeyID></SalesTaxKeyID>
   </TaxKeys>
</Service>
   

Only <Name> is required.
For tags description please refer to Get Service request.

Response


<Response>
   <ItemID></ItemID>
</Response>
   

Tag Description
<ItemID> Unique system identifier for service

Back to Items

Update Service

Request

POST https://go.paytraq.com/api/service/{ItemID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
ItemID Unique system identifier for service


<Service>
   <Name></Name>
   <Code></Code>
   <Unit>
      <UnitID></UnitID>
   </Unit>
   <Description />
   <OtherLanguageName />
   <Status></Status>
   <Group>
      <GroupID />
   </Group>
   <TaxKeys>
      <SalesTaxKeyID></SalesTaxKeyID>
   </TaxKeys>
</Service>
   

No tags are required.
For tags description please refer to Get Service request.

Response


<Response>
   <ItemID></ItemID>
</Response>
   

Tag Description
<ItemID> Unique system identifier for service

Back to Items

Add/Update Service Price

Request

POST https://go.paytraq.com/api/servicePrice/{ItemID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
ItemID Unique system identifier for service


<Price>
      <PriceGroup>
            <PriceGroupID></PriceGroupID>
      </PriceGroup>
      <IsDefault></IsDefault>
      <Amount></Amount>
      <Currency></Currency>
</Price>
   

For tags description please refer to Get Service request

Response


<Response>
   <ItemID></ItemID>
</Response>
   

Tag Description
<ItemID> Unique system identifier for service

Back to Items

Get Service Groups

Request

GET https://go.paytraq.com/api/serviceGroups?APIToken={APIToken}&APIKey={APIKey}

Response


<Groups>
   <Group>
      <GroupID></GroupID>
      <GroupName></GroupName>
   </Group>
   ...
</Groups>
   

Tag Description
<GroupID> Unique system identifier for service group

Back to Items

Get Default Service Group

Request

GET https://go.paytraq.com/api/serviceGroupDefaultId?APIToken={APIToken}&APIKey={APIKey}

Response


<Group>
   <GroupID></GroupID>
</Group>
   

Tag Description
<GroupID> Unique system identifier for service group.
If no default group is found then <GroupID>0</GroupID> will be returned

Back to Items

Warehousing

Get Warehouse List

Request

GET https://go.paytraq.com/api/warehouses?APIToken={APIToken}&APIKey={APIKey}

Result list is sorted by warehouse name in ascending order.
Optional parameters are available. Results can be filtered by warehouse name or code.

Response


<Warehouses>
   <Warehouse>
      <WarehouseID></WarehouseID>
      <Code />
      <Name></Name>
      <Type></Type>
      <LoadingArea>
         <LoadingAreaID />
         <LoadingAreaName />
      </LoadingArea>
      <PriceMarkup></PriceMarkup>
      <IsDefault></IsDefault>
      <IsInactive></IsInactive>
      <NegativeStockEnabled></NegativeStockEnabled>
      <Account>
         <AccountID />
         <AccountName />
      </Account>
   </Warehouse>
   ...
</Warehouses>
   

Tag Description
<WarehouseID> Unique system identifier for warehouse
<Type> Possible values:
  • 1 - Retail
  • 2 - Wholesale
<LoadingAreaID> Unique system identifier for loading area. See Get Loading Area
<IsDefault> Boolean value (false | true)
<IsInactive> Boolean value (false | true)
<NegativeStockEnabled> Boolean value (false | true)
<AccountID> Unique system identifier for inventory account. See Get Account

Back to Warehousing

Get Warehouse

Request

GET https://go.paytraq.com/api/warehouse/{WarehouseID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
WarehouseID Unique system identifier for warehouse
Response


<Warehouse>
   <WarehouseID></WarehouseID>
   <Code />
   <Name></Name>
   <Type></Type>
   <LoadingArea>
      <LoadingAreaID />
      <LoadingAreaName />
   </LoadingArea>
   <PriceMarkup></PriceMarkup>
   <IsDefault></IsDefault>
   <IsInactive></IsInactive>
   <NegativeStockEnabled></NegativeStockEnabled>
   <Account>
      <AccountID />
      <AccountName />
   </Account>
</Warehouse>
   

Tag Description
<WarehouseID> Unique system identifier for warehouse
<Type> Possible values:
  • 1 - Retail
  • 2 - Wholesale
<LoadingAreaID> Unique system identifier for loading area. See Get Loading Area
<IsDefault> Boolean value (false | true)
<IsInactive> Boolean value (false | true)
<NegativeStockEnabled> Boolean value (false | true)
<AccountID> Unique system identifier for inventory account. See Get Account

Back to Warehousing

Get Loading Area List

Request

GET https://go.paytraq.com/api/loadingAreas?APIToken={APIToken}&APIKey={APIKey}

Response


<LoadingAreas>
   <LoadingArea>
      <LoadingAreaID></LoadingAreaID>
      <LoadingAreaName></LoadingAreaName>
      <LoadingAreaAddress>
         <Address></Address>
         <Zip></Zip>
         <Country></Country>
      </LoadingAreaAddress>
      <IsDefault>false</IsDefault>
      <IsInactive>false</IsInactive>
   </LoadingArea>
</LoadingAreas>
   

Tag Description
<LoadingAreaID> Unique system identifier for loading area
<Country> 2-letter ISO country code
<IsDefault> Boolean value (false | true)
<IsInactive> Boolean value (false | true)

Back to Warehousing

Get Loading Area

Request

GET https://go.paytraq.com/api/loadingArea/{LoadingAreaID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
LoadingAreaID Unique system identifier for loading area
Response


<LoadingArea>
   <LoadingAreaID></LoadingAreaID>
   <LoadingAreaName></LoadingAreaName>
   <LoadingAreaAddress>
      <Address></Address>
      <Zip></Zip>
      <Country></Country>
   </LoadingAreaAddress>
   <IsDefault></IsDefault>
   <IsInactive></IsInactive>
</LoadingArea>
   

Tag Description
<LoadingAreaID> Unique system identifier for loading area
<Country> 2-letter ISO country code
<IsDefault> Boolean value (false | true)
<IsInactive> Boolean value (false | true)

Back to Warehousing

Get Default Loading Area

Request

GET https://go.paytraq.com/api/loadingAreaDefaultId?APIToken={APIToken}&APIKey={APIKey}

Response


<LoadingArea>
   <LoadingAreaID></LoadingAreaID>
</LoadingArea>
   

Tag Description
<LoadingAreaID> Unique system identifier for loading area.
If no default value is found then <LoadingAreaID>0</LoadingAreaID> will be returned

Back to Warehousing

Get Shipper List

Request

GET https://go.paytraq.com/api/shippers?APIToken={APIToken}&APIKey={APIKey}

Response


<Shippers>
   <Shipper>
      <ShipperID></ShipperID>
      <ShipperName></ShipperName>
      <ShipperRegNumber></ShipperRegNumber>
      <ShipperVehicle></ShipperVehicle>
      <ShipperDriver></ShipperDriver>
      <IsDefault></IsDefault>
      <IsInactive></IsInactive>
   </Shipper>
  ...
</Shippers>
   

Tag Description
<ShipperID> Unique system identifier for shipper
<IsDefault> Boolean value (false | true)
<IsInactive> Boolean value (false | true)

Back to Warehousing

Get Shipper

Request

GET https://go.paytraq.com/api/shipper/{ShipperID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
ShipperID Unique system identifier for shipper
Response


<Shipper>
   <ShipperID></ShipperID>
   <ShipperName></ShipperName>
   <ShipperRegNumber></ShipperRegNumber>
   <ShipperVehicle></ShipperVehicle>
   <ShipperDriver></ShipperDriver>
   <IsDefault></IsDefault>
   <IsInactive></IsInactive>
</Shipper>
   

Tag Description
<ShipperID> Unique system identifier for shipper
<IsDefault> Boolean value (false | true)
<IsInactive> Boolean value (false | true)

Back to Warehousing

Add Shipper

Request

POST https://go.paytraq.com/api/shipper?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
ShipperID Unique system identifier for shipper


<Shipper>
   <ShipperName></ShipperName>
   <ShipperRegNumber></ShipperRegNumber>
   <ShipperVehicle></ShipperVehicle>
   <ShipperDriver></ShipperDriver>
   <IsDefault></IsDefault>
   <IsInactive></IsInactive>
</Shipper>
   

Only <ShipperName> is required.
For tags description please refer to Get Shipper request.

Response


<Response>
   <ShipperID></ShipperID>
</Response>
   

Tag Description
<ShipperID> Unique system identifier for shipper

Back to Warehousing

Update Shipper

Request

POST https://go.paytraq.com/api/shipper/{ShipperID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
ShipperID Unique system identifier for shipper


<Shipper>
   <ShipperName></ShipperName>
   <ShipperRegNumber></ShipperRegNumber>
   <ShipperVehicle></ShipperVehicle>
   <ShipperDriver></ShipperDriver>
   <IsDefault></IsDefault>
   <IsInactive></IsInactive>
</Shipper>
   

No tags are required.
For tags description please refer to Get Shipper request.

Response


<Response>
   <ShipperID></ShipperID>
</Response>
   

Tag Description
<ShipperID> Unique system identifier for shipper

Back to Warehousing

Get Current Inventory

Request

GET https://go.paytraq.com/api/currentInventory/{WarehouseID}?APIToken={APIToken}&APIKey={APIKey}

Result list is sorted by product name, code, lot, warehouse name in ascending order.
Pagination optional parameter is available. Results can not be filtered.

Parameter Description
WarehouseID Unique system identifier for warehouse
Response


<Inventory>
   <LineItem>
      <ItemID></ItemID>
      <ItemCode></ItemCode>
      <ItemName></ItemName>
      <ItemBarCode />
      <ItemDescription />
      <LotID />
      <LotNumber />
      <WarehouseID></WarehouseID>
      <WarehouseName></WarehouseName>
      <Qty></Qty>
      <UnitCost />
   </LineItem>
   ...
</Inventory>
   

Tag Description
<ItemID> Unique system identifier for product. See Get Product
<ItemCode> Product code (SKU)
<LotID> Unique system identifier for lot
<WarehouseID> Unique system identifier for warehouse. See Get Warehouse
<Qty> Product quantity

Back to Warehousing

Get Product Inventory

Request

GET https://go.paytraq.com/api/productInventory/{ItemID}?APIToken={APIToken}&APIKey={APIKey}

Result list is sorted by product name, code, lot, warehouse name in ascending order.
Pagination optional parameter is available. Results can not be filtered.

Parameter Description
ItemID Unique system identifier for product
Response


<Inventory>
   <LineItem>
      <ItemID></ItemID>
      <ItemCode></ItemCode>
      <ItemName></ItemName>
      <ItemBarCode />
      <ItemDescription />
      <LotID />
      <LotNumber />
      <WarehouseID></WarehouseID>
      <WarehouseName></WarehouseName>
      <Qty></Qty>
      <UnitCost />
   </LineItem>
   ...
</Inventory>
   

Tag Description
<ItemID> Unique system identifier for product. See Get Product
<ItemCode> Product code (SKU)
<LotID> Unique system identifier for lot
<WarehouseID> Unique system identifier for warehouse. See Get Warehouse
<Qty> Product quantity

Back to Warehousing

Sales

Get Sales Document List

Request

GET https://go.paytraq.com/api/sales?APIToken={APIToken}&APIKey={APIKey}

Result list is sorted by document date in descending order.
Optional parameters are available. Results can be filtered by client name or document number.
Document date range filter can be applied.

Response


<Sales>
   <Sale>
      <Header>
         <Document>
            <DocumentID></DocumentID>
            <DocumentDate></DocumentDate>
            <DocumentRef></DocumentRef>
            <DocumentType></DocumentType>
            <DocumentStatus></DocumentStatus>
            <Client>
               <ClientID></ClientID>
               <ClientName></ClientName>
            </Client>
         </Document>
         <SaleType></SaleType>
         <Operation></Operation>
         <Total></Total>
         <AmountDue></AmountDue>
         <DueNoticeEnabled></DueNoticeEnabled>
         <Currency></Currency>
         <BalanceCurrency></BalanceCurrency>
         <CurrencyRate></CurrencyRate>
         <TaxBasis></TaxBasis>
         <IncludeTax></IncludeTax>
         <UseOverpayment></UseOverpayment>
         <DateDue></DateDue>
         <DateApproved></DateApproved>
         <Discount></Discount>
         <Deposit></Deposit>
         <Comment></Comment>
         <Signature></Signature>
         <InvoicePeriod>
            <PeriodType></PeriodType>
            <PeriodStart />
            <PeriodEnd />
         </InvoicePeriod>
         <PayTerm>
            <PayTermType></PayTermType>
            <PayTermDays />
         </PayTerm>
         <PaymentMethod></PaymentMethod>
         <AccountID></AccountID>
         <ShippingData>
            <ShippingType></ShippingType>
            <Warehouse>
               <WarehouseID></WarehouseID>
               <WarehouseName></WarehouseName>
            </Warehouse>
            <LoadingArea>
               <LoadingAreaID></LoadingAreaID>
               <LoadingAreaName></LoadingAreaName>
               <LoadingAreaAddress>
                  <Address></Address>
                  <Zip></Zip>
                  <Country></Country>
               </LoadingAreaAddress>
            </LoadingArea>
            <Shipper>
               <ShipperID></ShipperID>
               <ShipperName></ShipperName>
               <ShipperRegNumber></ShipperRegNumber>
               <ShipperVehicle></ShipperVehicle>
               <ShipperDriver></ShipperDriver>
            </Shipper>
            <ShippingAddress>
               <AddressID></AddressID>
               <ShipTo></ShipTo>
               <Address></Address>
               <Zip></Zip>
               <Country></Country>
            </ShippingAddress>
         </ShippingData>
      </Header>
   </Sale>
  ...
</Sales>
   

Tag Description
<DocumentID> Unique system identifier for sales document
<DocumentRef> Document number
<DocumentStatus> Possible values:
  • draft - Draft
  • wait_approve - Waiting for Approval
  • wait_payment - Waiting for Payment
  • part_paid - Partially Paid
  • paid - Paid
  • voided - Voided/Canceled
  • reversed - Reversed
  • done - Done
  • approved - Approved
  • in_process - In Progress
<ClientID> Unique system identifier for client. See Get Client
<SaleType> Possible values:
  • sales_order - Sales Order
  • sales_proforma - Proforma Invoice
  • sales_invoice - Invoice
  • sales_receipt - Receipt
  • sales_estimate - Quote/Estimate
  • credit_note - Credit Note/Refund
<Operation> Possible values:
  • sell_goods - Selling Goods
  • sell_services - Selling Services
  • other_income - Other Income
<Currency> 3-letter currency code
<TaxBasis> Possible values:
  • 1 - Accrual
  • 2 - Cash
<DueNoticeEnabled> Boolean value (false | true)
<IncludeTax> Boolean value (false | true)
Shows that amounts are tax inclusive
<UseOverpayment> Boolean value (false | true)
<Signature> Possible values:
  • 0 - None
  • 1 - Electronic
  • 2 - To be signed by sender
  • 3 - To be signed by recipient
  • 4 - To be signed by both sender and recipient
  • 5 - Scanned signature
<PeriodType> Possible values:
  • 0 - Not Defined
  • 1 - Current Month
  • 2 - Previous Month
  • 3 - Next Month
  • 9 - Other
<PayTermType> Possible values:
  • 0 - Other date
  • 1 - Due days
  • 2 - EOM+
  • 3 - Cash on delivery
  • 4 - Open date of payment
<PayTermDays> Number of days. Can be used only with <PayTermType> values 1 and 2
<PaymentMethod> Possible values:
  • 0 - Not Defined
  • 1 - Bank
  • 2 - Cash
  • 3 - Card
  • 4 - Prepayment
  • 5 - Offsetting
  • 6 - Factoring
<AccountID> Unique system identifier for accounts receivable. See Get Account
<ShippingType> Possible values:
  • 0 - Not Defined
  • 1 - Supply of goods
  • 2 - Movement of goods
  • 3 - Product returns
<WarehouseID> Unique system identifier for warehouse. See Get Warehouse
<LoadingAreaID> Unique system identifier for loading area. See Get Loading Area
<ShipperID> Unique system identifier for shipper. See Get Shipper
<AddressID> Unique system identifier for shipping address. See Get Client Shipping Address

Back to Sales

Get Sales Document

Request

GET https://go.paytraq.com/api/sale/{DocumentID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
DocumentID Unique system identifier for sales document
Response


<Sale>
   <Header>
      <Document>
         <DocumentID></DocumentID>
         <DocumentDate></DocumentDate>
         <DocumentRef></DocumentRef>
         <DocumentType></DocumentType>
         <DocumentStatus></DocumentStatus>
         <Client>
            <ClientID></ClientID>
            <ClientName></ClientName>
         </Client>
      </Document>
      <SaleType></SaleType>
      <Operation></Operation>
      <Total></Total>
      <AmountDue></AmountDue>
      <DueNoticeEnabled></DueNoticeEnabled>
      <Currency></Currency>
      <BalanceCurrency></BalanceCurrency>
      <CurrencyRate></CurrencyRate>
      <TaxBasis></TaxBasis>
      <IncludeTax></IncludeTax>
      <UseOverpayment></UseOverpayment>
      <DateDue></DateDue>
      <DateApproved></DateApproved>
      <Discount></Discount>
      <Deposit />
      <Comment />
      <Signature></Signature>
      <InvoicePeriod>
         <PeriodType></PeriodType>
         <PeriodStart />
         <PeriodEnd />
      </InvoicePeriod>
      <PayTerm>
         <PayTermType></PayTermType>
         <PayTermDays></PayTermDays>
      </PayTerm>
      <PaymentMethod></PaymentMethod>
      <AccountID></AccountID>
      <ShippingData>
         <ShippingType></ShippingType>
         <Warehouse>
            <WarehouseID></WarehouseID>
            <WarehouseName></WarehouseName>
         </Warehouse>
         <LoadingArea>
            <LoadingAreaID></LoadingAreaID>
            <LoadingAreaName></LoadingAreaName>
            <LoadingAreaAddress>
               <Address></Address>
               <Zip></Zip>
               <Country></Country>
            </LoadingAreaAddress>
         </LoadingArea>
         <Shipper>
            <ShipperID></ShipperID>
            <ShipperName></ShipperName>
            <ShipperRegNumber />
            <ShipperVehicle />
            <ShipperDriver />
         </Shipper>
         <ShippingAddress>
            <AddressID></AddressID>
            <ShipTo></ShipTo>
            <Address></Address>
            <Zip></Zip>
            <Country></Country>
         </ShippingAddress>
      </ShippingData>
   </Header>
   <LineItems>
      <LineItem>
         <Account>
            <AccountID></AccountID>
            <AccountCode></AccountCode>
            <AccountName></AccountName>
         </Account>
         <Item>
            <ItemID></ItemID>
            <ItemCode />
            <ItemName></ItemName>
         </Item>
         <ItemLot>
            <LotID></LotID>
            <LotNumber></LotNumber>
         </ItemLot>
         <Description></Description>
         <Qty></Qty>
         <Price></Price>
         <LineDiscount></LineDiscount>
         <LineTotal></LineTotal>
         <Unit>
            <UnitID></UnitID>
            <UnitName></UnitName>
         </Unit>
         <TaxKey>
            <TaxKeyID></TaxKeyID>
            <TaxKeyName></TaxKeyName>
         </TaxKey>
      </LineItem>
      ...
   </LineItems>
   <Adjustments>
      <Adjustment>
         <Account>
            <AccountID></AccountID>
            <AccountCode></AccountCode>
            <AccountName></AccountName>
         </Account>
         <Amount></Amount>
         <Description />
         <TypeID></TypeID>
         <PctOrAmount></PctOrAmount>
         <TaxKey>
            <TaxKeyID></TaxKeyID>
            <TaxKeyName></TaxKeyName>
         </TaxKey>
      </Adjustment>
      ...
   </Adjustments>
   <ShippingCharge>
      <Account>
         <AccountID></AccountID>
         <AccountCode></AccountCode>
         <AccountName></AccountName>
      </Account>
      <Amount></Amount>
      <TaxKey>
         <TaxKeyID></TaxKeyID>
         <TaxKeyName></TaxKeyName>
      </TaxKey>
   </ShippingCharge>
   <Taxes>
      <Tax>
         <TaxKey>
            <TaxKeyID></TaxKeyID>
            <TaxKeyName></TaxKeyName>
         </TaxKey>
         <TaxName></TaxName>
         <GrossAmount></GrossAmount>
         <NetAmount></NetAmount>
         <TaxAmount></TaxAmount>
         <Account>
            <AccountID></AccountID>
            <AccountName></AccountName>
         </Account>
      </Tax>
   </Taxes>
   <Totals>
      <GrossAmount></GrossAmount>
      <NetAmount></NetAmount>
      <Qty></Qty>
   </Totals>
</Sale>
   

Tag Description
<DocumentID> Unique system identifier for sales document
<DocumentRef> Document number
<DocumentStatus> Possible values:
  • draft - Draft
  • wait_approve - Waiting for Approval
  • wait_payment - Waiting for Payment
  • part_paid - Partially Paid
  • paid - Paid
  • voided - Voided/Canceled
  • reversed - Reversed
  • done - Done
  • approved - Approved
  • in_process - In Progress
<ClientID> Unique system identifier for client. See Get Client
<SaleType> Possible values:
  • sales_order - Sales Order
  • sales_proforma - Proforma Invoice
  • sales_invoice - Invoice
  • sales_receipt - Receipt
  • sales_estimate - Quote/Estimate
  • credit_note - Credit Note/Refund
<Operation> Possible values:
  • sell_goods - Selling Goods
  • sell_services - Selling Services
  • other_income - Other Income
<Currency> 3-letter currency code
<TaxBasis> Possible values:
  • 1 - Accrual
  • 2 - Cash
<DueNoticeEnabled> Boolean value (false | true)
<IncludeTax> Boolean value (false | true)
Shows that amounts are tax inclusive
<UseOverpayment> Boolean value (false | true)
<Signature> Possible values:
  • 0 - None
  • 1 - Electronic
  • 2 - To be signed by sender
  • 3 - To be signed by recipient
  • 4 - To be signed by both sender and recipient
  • 5 - Scanned signature
<PeriodType> Possible values:
  • 0 - Not Defined
  • 1 - Current Month
  • 2 - Previous Month
  • 3 - Next Month
  • 9 - Other
<PayTermType> Possible values:
  • 0 - Other date
  • 1 - Due days
  • 2 - EOM+
  • 3 - Cash on delivery
  • 4 - Open date of payment
<PayTermDays> Number of days. Can be used only with <PayTermType> values 1 and 2
<PaymentMethod> Possible values:
  • 0 - Not Defined
  • 1 - Bank
  • 2 - Cash
  • 3 - Card
  • 4 - Prepayment
  • 5 - Offsetting
  • 6 - Factoring
<AccountID> Unique system identifier for account. See Get Account
<ShippingType> Possible values:
  • 0 - Not Defined
  • 1 - Supply of goods
  • 2 - Movement of goods
  • 3 - Product returns
<WarehouseID> Unique system identifier for warehouse. See Get Warehouse
<LoadingAreaID> Unique system identifier for loading area. See Get Loading Area
<ShipperID> Unique system identifier for shipper. See Get Shipper
<AddressID> Unique system identifier for shipping address. See Get Client Shipping Address
<ItemID> Unique system identifier for product or service. See Get Product or See Get Service
<ItemCode> Product SKU or service code. See Get Product By Code or See Get Service By Code
<LotID> Unique system identifier for lot
<UnitID> Unique system identifier for unit of measure. See Get Unit
<TaxKeyID> Unique system identifier for tax key. See Get Tax Key
<TypeID> Possible values:
  • charge - Charge
  • discount - Discount
<PctOrAmount> Possible values:
  • pct - Percent
  • amount - Amount

Back to Sales

Add Sales Document

Request

POST https://go.paytraq.com/api/sale?APIToken={APIToken}&APIKey={APIKey}


<Sale>
   <Header>
      <Document>
         <DocumentDate></DocumentDate>
         <DocumentRef></DocumentRef>
         <Client>
            <ClientID></ClientID>
            <ClientName></ClientName>
         </Client>
      </Document>
      <SaleType></SaleType>
      <Operation></Operation>
      <DueNoticeEnabled></DueNoticeEnabled>
      <Currency></Currency>
      <TaxBasis></TaxBasis>
      <IncludeTax></IncludeTax>
      <UseOverpayment></UseOverpayment>
      <DateDue></DateDue>
      <Deposit />
      <Comment />
      <Signature></Signature>
      <InvoicePeriod>
         <PeriodType></PeriodType>
         <PeriodStart />
         <PeriodEnd />
      </InvoicePeriod>
      <PayTerm>
         <PayTermType></PayTermType>
         <PayTermDays></PayTermDays>
      </PayTerm>
      <PaymentMethod></PaymentMethod>
      <ShippingData>
         <ShippingType></ShippingType>
         <Warehouse>
            <WarehouseID></WarehouseID>
         </Warehouse>
         <LoadingArea>
            <LoadingAreaID></LoadingAreaID>
         </LoadingArea>
         <Shipper>
            <ShipperID></ShipperID>
         </Shipper>
         <ShippingAddress>
            <AddressID></AddressID>
         </ShippingAddress>
      </ShippingData>
   </Header>
   <LineItems>
      <LineItem>
         <Account>
            <AccountID></AccountID>
         </Account>
         <Item>
            <ItemID></ItemID>
         </Item>
         <ItemLot>
            <LotID></LotID>
         </ItemLot>
         <Description></Description>
         <Qty></Qty>
         <Price></Price>
         <LineDiscount></LineDiscount>
         <LineTotal></LineTotal>
         <Unit>
            <UnitID></UnitID>
         </Unit>
         <TaxKey>
            <TaxKeyID></TaxKeyID>
         </TaxKey>
      </LineItem>
      ...
   </LineItems>
   <Adjustments>
      <Adjustment>
         <Account>
            <AccountID></AccountID>
         </Account>
         <Amount></Amount>
         <Description />
         <TypeID></TypeID>
         <PctOrAmount></PctOrAmount>
         <TaxKey>
            <TaxKeyID></TaxKeyID>
         </TaxKey>
      </Adjustment>
      ...
   </Adjustments>
   <ShippingCharge>
      <Account>
         <AccountID></AccountID>
      </Account>
      <Amount></Amount>
      <TaxKey>
         <TaxKeyID></TaxKeyID>
      </TaxKey>
   </ShippingCharge>
</Sale>
   

Only <SaleType> and <Operation> are required.
To add a client <ClientID /> OR <ClientName /> should be provided.
For tags description please refer to Get Sale Document.

Response


<Response>
   <DocumentID></DocumentID>
</Response>
   

Tag Description
<DocumentID> Unique system identifier for sales document

Back to Sales

Update Sales Document

Request

POST https://go.paytraq.com/api/sale/{DocumentID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
DocumentID Unique system identifier for sales document


<Sale>
   <Header>
      <Document>
         <DocumentDate></DocumentDate>
         <DocumentRef></DocumentRef>
         <Client>
            <ClientID></ClientID>
         </Client>
      </Document>
      <DueNoticeEnabled></DueNoticeEnabled>
      <Currency></Currency>
      <TaxBasis></TaxBasis>
      <IncludeTax></IncludeTax>
      <UseOverpayment></UseOverpayment>
      <DateDue></DateDue>
      <Deposit />
      <Comment />
      <Signature></Signature>
      <InvoicePeriod>
         <PeriodType></PeriodType>
         <PeriodStart />
         <PeriodEnd />
      </InvoicePeriod>
      <PayTerm>
         <PayTermType></PayTermType>
         <PayTermDays></PayTermDays>
      </PayTerm>
      <PaymentMethod></PaymentMethod>
      <ShippingData>
         <ShippingType></ShippingType>
         <Warehouse>
            <WarehouseID></WarehouseID>
         </Warehouse>
         <LoadingArea>
            <LoadingAreaID></LoadingAreaID>
         </LoadingArea>
         <Shipper>
            <ShipperID></ShipperID>
         </Shipper>
         <ShippingAddress>
            <AddressID></AddressID>
         </ShippingAddress>
      </ShippingData>
   </Header>
   <LineItems>
      <LineItem>
         <Account>
            <AccountID></AccountID>
         </Account>
         <Item>
            <ItemID></ItemID>
         </Item>
         <ItemLot>
            <LotID></LotID>
         </ItemLot>
         <Description></Description>
         <Qty></Qty>
         <Price></Price>
         <LineDiscount></LineDiscount>
         <LineTotal></LineTotal>
         <Unit>
            <UnitID></UnitID>
         </Unit>
         <TaxKey>
            <TaxKeyID></TaxKeyID>
         </TaxKey>
      </LineItem>
      ...
   </LineItems>
   <Adjustments>
      <Adjustment>
         <Account>
            <AccountID></AccountID>
         </Account>
         <Amount></Amount>
         <Description />
         <TypeID></TypeID>
         <PctOrAmount></PctOrAmount>
         <TaxKey>
            <TaxKeyID></TaxKeyID>
         </TaxKey>
      </Adjustment>
      ...
   </Adjustments>
   <ShippingCharge>
      <Account>
         <AccountID></AccountID>
      </Account>
      <Amount></Amount>
      <TaxKey>
         <TaxKeyID></TaxKeyID>
      </TaxKey>
   </ShippingCharge>
</Sale>
   

Only documents with status Draft can be updated.
No tags are required.
For tags description please refer to Get Sale Document.

Response


<Response>
   <DocumentID></DocumentID>
</Response>
   

Tag Description
<DocumentID> Unique system identifier for sales document

Back to Sales

Post Sales Document

Request

GET https://go.paytraq.com/api/salePost/{DocumentID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
DocumentID Unique system identifier for sales document

Only documents with status Draft can be posted.

Response


<Response>
   <DocumentID></DocumentID>
</Response>
   

Tag Description
<DocumentID> Unique system identifier for sales document

Back to Sales

Add Direct Payment to Sales Document

Request

POST https://go.paytraq.com/api/salePayment/{DocumentID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
DocumentID Unique system identifier for sales document


<DirectPayment>
   <MoneyAccountID></MoneyAccountID>
   <PaymentAmount></PaymentAmount>
   <PaymentDate></PaymentDate>
   <Narration></Narration>
   <BankCharge></BankCharge>
</DirectPayment>
   

Tag Description
<MoneyAccountID> Unique system identifier for bank or cash account. See Get Bank Accounts and Get Cash Accounts

Only documents with status Waiting for Payment or Partially Paid can be paid.
<MoneyAccountID> should be in the same currency as sales document.
<Narration> is not required.
<BankCharge> is optional.

Response


<Response>
   <DocumentID></DocumentID>
   <AmountDue></AmountDue>
</Response>
   

Tag Description
<DocumentID> Unique system identifier for payment document. See Get Payment
Is not available for <MoneyAccountID> with Merchant and Credit Card account types

Back to Sales

Get Sales Document in PDF

Request

GET https://go.paytraq.com/api/salePDF/{DocumentID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
DocumentID Unique system identifier for sales document
Response

PDF (MIME type - application/pdf)

Back to Sales

Request

GET https://go.paytraq.com/api/saleLink/{DocumentID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
DocumentID Unique system identifier for sales document
Response


<Sale>
   <DocumentLink>
      <URL></URL>
   </DocumentLink>
</Sale>
   

Back to Sales

Purchases

Get Purchase Document List

Request

GET https://go.paytraq.com/api/purchases?APIToken={APIToken}&APIKey={APIKey}

Result list is sorted by document date in descending order.
Optional parameters are available. Results can be filtered by supplier name or document number.
Document date range filter can be applied.

Response


<Purchases>
   <Purchase>
      <Header>
         <Document>
            <DocumentID></DocumentID>
            <DocumentDate></DocumentDate>
            <DocumentRef></DocumentRef>
            <DocumentType></DocumentType>
            <DocumentStatus></DocumentStatus>
            <Supplier>
               <SupplierID></SupplierID>
               <SupplierName></SupplierName>
            </Supplier>
         </Document>
         <PurchaseType></PurchaseType>
         <Operation></Operation>
         <Total></Total>
         <AmountDue></AmountDue>
         <Currency></Currency>
         <BalanceCurrency></BalanceCurrency>
         <CurrencyRate></CurrencyRate>
         <TaxBasis></TaxBasis>
         <IncludeTax></IncludeTax>
         <DateDue></DateDue>
         <DateApproved></DateApproved>
         <Discount></Discount>
         <Deposit></Deposit>
         <Comment></Comment>
         <PayTerm>
            <PayTermType></PayTermType>
            <PayTermDays />
         </PayTerm>
         <PaymentMethod></PaymentMethod>
         <AccountID></AccountID>
         <ShippingData>
            <ShippingType></ShippingType>
            <Warehouse>
               <WarehouseID></WarehouseID>
               <WarehouseName></WarehouseName>
            </Warehouse>
            <LoadingArea>
               <LoadingAreaID></LoadingAreaID>
               <LoadingAreaName></LoadingAreaName>
               <LoadingAreaAddress>
                  <Address></Address>
                  <Zip></Zip>
                  <Country></Country>
               </LoadingAreaAddress>
            </LoadingArea>
            <Shipper>
               <ShipperID></ShipperID>
               <ShipperName></ShipperName>
               <ShipperRegNumber></ShipperRegNumber>
               <ShipperVehicle></ShipperVehicle>
               <ShipperDriver></ShipperDriver>
            </Shipper>
            <ShippingAddress>
               <AddressID></AddressID>
               <ShipTo></ShipTo>
               <Address></Address>
               <Zip></Zip>
               <Country></Country>
            </ShippingAddress>
         </ShippingData>
      </Header>
   </Purchase>
  ...
</Purchases>
   

Tag Description
<DocumentID> Unique system identifier for purchase document
<DocumentRef> Document number
<DocumentStatus> Possible values:
  • draft - Draft
  • wait_approve - Waiting for Approval
  • wait_payment - Waiting for Payment
  • part_paid - Partially Paid
  • paid - Paid
  • voided - Voided/Canceled
  • reversed - Reversed
  • done - Done
  • approved - Approved
  • in_process - In Progress
<SupplierID> Unique system identifier for supplier. See Get Supplier
<PurchaseType> Possible values:
  • purchase_order - Purchase Order
  • purchase_proforma - Proforma Invoice
  • purchase_invoice - Invoice
  • purchase_receipt - Receipt
  • purchase_voucher - Purchase Voucher
  • debit_note - Credit Note/Refund
<Operation> Possible values:
  • purchase_goods - Purchasing Goods
  • purchase_services - Purchasing Services
  • other_expenses - Other Expenses
<Currency> 3-letter currency code
<TaxBasis> Possible values:
  • 1 - Accrual
  • 2 - Cash
<IncludeTax> Boolean value (false | true)
Shows that amounts are tax inclusive
<PayTermType> Possible values:
  • 0 - Other date
  • 1 - Due days
  • 2 - EOM+
  • 3 - Cash on delivery
  • 4 - Open date of payment
<PayTermDays> Number of days. Can be used only with <PayTermType> values 1 and 2
<PaymentMethod> Possible values:
  • 0 - Not Defined
  • 1 - Bank
  • 2 - Cash
  • 3 - Card
  • 4 - Prepayment
  • 5 - Offsetting
  • 6 - Factoring
<AccountID> Unique system identifier for accounts payable. See Get Account
<ShippingType> Possible values:
  • 0 - Not Defined
  • 1 - Supply of goods
  • 2 - Movement of goods
  • 3 - Product returns
<WarehouseID> Unique system identifier for warehouse. See Get Warehouse
<LoadingAreaID> Unique system identifier for loading area. See Get Loading Area
<ShipperID> Unique system identifier for shipper. See Get Shipper
<AddressID> Unique system identifier for shipping address. See Get Supplier Shipping Address

Back to Purchases

Get Purchase Document

Request

GET https://go.paytraq.com/api/purchase/{DocumentID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
DocumentID Unique system identifier for purchase document
Response


<Purchase>
   <Header>
      <Document>
         <DocumentID></DocumentID>
         <DocumentDate></DocumentDate>
         <DocumentRef></DocumentRef>
         <DocumentType></DocumentType>
         <DocumentStatus></DocumentStatus>
         <Supplier>
            <SupplierID></SupplierID>
            <SupplierName></SupplierName>
         </Supplier>
      </Document>
      <PurchaseType></PurchaseType>
      <Operation></Operation>
      <Total></Total>
      <AmountDue></AmountDue>
      <Currency></Currency>
      <BalanceCurrency></BalanceCurrency>
      <CurrencyRate></CurrencyRate>
      <TaxBasis></TaxBasis>
      <IncludeTax></IncludeTax>
      <DateDue></DateDue>
      <DateApproved></DateApproved>
      <Discount></Discount>
      <Deposit />
      <Comment />
      <PayTerm>
         <PayTermType></PayTermType>
         <PayTermDays></PayTermDays>
      </PayTerm>
      <PaymentMethod></PaymentMethod>
      <AccountID></AccountID>
      <ShippingData>
         <ShippingType></ShippingType>
         <Warehouse>
            <WarehouseID></WarehouseID>
            <WarehouseName></WarehouseName>
         </Warehouse>
         <LoadingArea>
            <LoadingAreaID></LoadingAreaID>
            <LoadingAreaName></LoadingAreaName>
            <LoadingAreaAddress>
               <Address></Address>
               <Zip></Zip>
               <Country></Country>
            </LoadingAreaAddress>
         </LoadingArea>
         <Shipper>
            <ShipperID></ShipperID>
            <ShipperName></ShipperName>
            <ShipperRegNumber />
            <ShipperVehicle />
            <ShipperDriver />
         </Shipper>
         <ShippingAddress>
            <AddressID></AddressID>
            <ShipTo></ShipTo>
            <Address></Address>
            <Zip></Zip>
            <Country></Country>
         </ShippingAddress>
      </ShippingData>
   </Header>
   <LineItems>
      <LineItem>
         <Account>
            <AccountID></AccountID>
            <AccountCode></AccountCode>
            <AccountName></AccountName>
         </Account>
         <Item>
            <ItemID></ItemID>
            <ItemCode />
            <ItemName></ItemName>
         </Item>
         <ItemLot>
            <LotID></LotID>
            <LotNumber></LotNumber>
         </ItemLot>
         <Description></Description>
         <Qty></Qty>
         <Price></Price>
         <LineDiscount></LineDiscount>
         <LineTotal></LineTotal>
         <Unit>
            <UnitID></UnitID>
            <UnitName></UnitName>
         </Unit>
         <TaxKey>
            <TaxKeyID></TaxKeyID>
            <TaxKeyName></TaxKeyName>
         </TaxKey>
      </LineItem>
      ...
   </LineItems>
   <Adjustments>
      <Adjustment>
         <Account>
            <AccountID></AccountID>
            <AccountCode></AccountCode>
            <AccountName></AccountName>
         </Account>
         <Amount></Amount>
         <Description />
         <TypeID></TypeID>
         <PctOrAmount></PctOrAmount>
         <TaxKey>
            <TaxKeyID></TaxKeyID>
            <TaxKeyName></TaxKeyName>
         </TaxKey>
      </Adjustment>
      ...
   </Adjustments>
   <ShippingCharge>
      <Account>
         <AccountID></AccountID>
         <AccountCode></AccountCode>
         <AccountName></AccountName>
      </Account>
      <Amount></Amount>
      <TaxKey>
         <TaxKeyID></TaxKeyID>
         <TaxKeyName></TaxKeyName>
      </TaxKey>
   </ShippingCharge>
   <Taxes>
      <Tax>
         <TaxKey>
            <TaxKeyID></TaxKeyID>
            <TaxKeyName></TaxKeyName>
         </TaxKey>
         <TaxName></TaxName>
         <GrossAmount></GrossAmount>
         <NetAmount></NetAmount>
         <TaxAmount></TaxAmount>
         <Account>
            <AccountID></AccountID>
            <AccountName></AccountName>
         </Account>
      </Tax>
   </Taxes>
   <Totals>
      <GrossAmount></GrossAmount>
      <NetAmount></NetAmount>
      <Qty></Qty>
   </Totals>
</Purchase>
   

Tag Description
<DocumentID> Unique system identifier for purchase document
<DocumentRef> Document number
<DocumentStatus> Possible values:
  • draft - Draft
  • wait_approve - Waiting for Approval
  • wait_payment - Waiting for Payment
  • part_paid - Partially Paid
  • paid - Paid
  • voided - Voided/Canceled
  • reversed - Reversed
  • done - Done
  • approved - Approved
  • in_process - In Progress
<SupplierID> Unique system identifier for supplier. See Get Supplier
<PurchaseType> Possible values:
  • purchase_order - Purchase Order
  • purchase_proforma - Proforma Invoice
  • purchase_invoice - Invoice
  • purchase_receipt - Receipt
  • purchase_voucher - Purchase Voucher
  • debit_note - Credit Note/Refund
<Operation> Possible values:
  • purchase_goods - Purchasing Goods
  • purchase_services - Purchasing Services
  • other_expenses - Other Expenses
<Currency> 3-letter currency code
<TaxBasis> Possible values:
  • 1 - Accrual
  • 2 - Cash
<IncludeTax> Boolean value (false | true)
Shows that amounts are tax inclusive
<PayTermType> Possible values:
  • 0 - Other date
  • 1 - Due days
  • 2 - EOM+
  • 3 - Cash on delivery
  • 4 - Open date of payment
<PayTermDays> Number of days. Can be used only with <PayTermType> values 1 and 2
<PaymentMethod> Possible values:
  • 0 - Not Defined
  • 1 - Bank
  • 2 - Cash
  • 3 - Card
  • 4 - Prepayment
  • 5 - Offsetting
  • 6 - Factoring
<AccountID> Unique system identifier for account. See Get Account
<ShippingType> Possible values:
  • 0 - Not Defined
  • 1 - Supply of goods
  • 2 - Movement of goods
  • 3 - Product returns
<WarehouseID> Unique system identifier for warehouse. See Get Warehouse
<LoadingAreaID> Unique system identifier for loading area. See Get Loading Area
<ShipperID> Unique system identifier for shipper. See Get Shipper
<AddressID> Unique system identifier for shipping address. See Get Supplier Shipping Address
<ItemID> Unique system identifier for product. See Get Product
<ItemCode> Product SKU. See Get Product By Code
<LotID> Unique system identifier for lot
<UnitID> Unique system identifier for unit of measure. See Get Unit
<TaxKeyID> Unique system identifier for tax key. See Get Tax Key
<TypeID> Possible values:
  • charge - Charge
  • discount - Discount
<PctOrAmount> Possible values:
  • pct - Percent
  • amount - Amount

Back to Purchases

Add Purchase Document

Request

POST https://go.paytraq.com/api/purchase?APIToken={APIToken}&APIKey={APIKey}


<Purchase>
   <Header>
      <Document>
         <DocumentDate></DocumentDate>
         <DocumentRef></DocumentRef>
         <Supplier>
            <SupplierID></SupplierID>
            <SupplierName></SupplierName>
         </Supplier>
      </Document>
      <PurchaseType></PurchaseType>
      <Operation></Operation>
      <Currency></Currency>
      <TaxBasis></TaxBasis>
      <IncludeTax></IncludeTax>
      <DateDue></DateDue>
      <Deposit />
      <Comment />
      <PayTerm>
         <PayTermType></PayTermType>
         <PayTermDays></PayTermDays>
      </PayTerm>
      <PaymentMethod></PaymentMethod>
      <ShippingData>
         <ShippingType></ShippingType>
         <Warehouse>
            <WarehouseID></WarehouseID>
         </Warehouse>
         <LoadingArea>
            <LoadingAreaID></LoadingAreaID>
         </LoadingArea>
         <Shipper>
            <ShipperID></ShipperID>
         </Shipper>
         <ShippingAddress>
            <AddressID></AddressID>
         </ShippingAddress>
      </ShippingData>
   </Header>
   <LineItems>
      <LineItem>
         <Account>
            <AccountID></AccountID>
         </Account>
         <Item>
            <ItemID></ItemID>
         </Item>
         <ItemLot>
            <LotID></LotID>
         </ItemLot>
         <Description></Description>
         <Qty></Qty>
         <Price></Price>
         <LineDiscount></LineDiscount>
         <LineTotal></LineTotal>
         <Unit>
            <UnitID></UnitID>
         </Unit>
         <TaxKey>
            <TaxKeyID></TaxKeyID>
         </TaxKey>
      </LineItem>
      ...
   </LineItems>
   <Adjustments>
      <Adjustment>
         <Account>
            <AccountID></AccountID>
         </Account>
         <Amount></Amount>
         <Description />
         <TypeID></TypeID>
         <PctOrAmount></PctOrAmount>
         <TaxKey>
            <TaxKeyID></TaxKeyID>
         </TaxKey>
      </Adjustment>
      ...
   </Adjustments>
   <ShippingCharge>
      <Account>
         <AccountID></AccountID>
      </Account>
      <Amount></Amount>
      <TaxKey>
         <TaxKeyID></TaxKeyID>
      </TaxKey>
   </ShippingCharge>
</Purchase>
   

Only <PurchaseType> and <Operation> are required.
To add a supplier <SupplierID /> OR <SupplierName /> should be provided.
For tags description please refer to Get Purchase Document
.

Response


<Response>
   <DocumentID></DocumentID>
</Response>
   

Tag Description
<DocumentID> Unique system identifier for purchase document

Back to Purchases

Update Purchase Document

Request

POST https://go.paytraq.com/api/purchase/{DocumentID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
DocumentID Unique system identifier for purchase document


<Purchase>
   <Header>
      <Document>
         <DocumentDate></DocumentDate>
         <DocumentRef></DocumentRef>
         <Supplier>
            <SupplierID></SupplierID>
         </Supplier>
      </Document>
      <PurchaseType></PurchaseType>
      <Operation></Operation>
      <Currency></Currency>
      <TaxBasis></TaxBasis>
      <IncludeTax></IncludeTax>
      <DateDue></DateDue>
      <Deposit />
      <Comment />
      <PayTerm>
         <PayTermType></PayTermType>
         <PayTermDays></PayTermDays>
      </PayTerm>
      <PaymentMethod></PaymentMethod>
      <ShippingData>
         <ShippingType></ShippingType>
         <Warehouse>
            <WarehouseID></WarehouseID>
         </Warehouse>
         <LoadingArea>
            <LoadingAreaID></LoadingAreaID>
         </LoadingArea>
         <Shipper>
            <ShipperID></ShipperID>
         </Shipper>
         <ShippingAddress>
            <AddressID></AddressID>
         </ShippingAddress>
      </ShippingData>
   </Header>
   <LineItems>
      <LineItem>
         <Account>
            <AccountID></AccountID>
         </Account>
         <Item>
            <ItemID></ItemID>
         </Item>
         <ItemLot>
            <LotID></LotID>
         </ItemLot>
         <Description></Description>
         <Qty></Qty>
         <Price></Price>
         <LineDiscount></LineDiscount>
         <LineTotal></LineTotal>
         <Unit>
            <UnitID></UnitID>
         </Unit>
         <TaxKey>
            <TaxKeyID></TaxKeyID>
         </TaxKey>
      </LineItem>
      ...
   </LineItems>
   <Adjustments>
      <Adjustment>
         <Account>
            <AccountID></AccountID>
         </Account>
         <Amount></Amount>
         <Description />
         <TypeID></TypeID>
         <PctOrAmount></PctOrAmount>
         <TaxKey>
            <TaxKeyID></TaxKeyID>
         </TaxKey>
      </Adjustment>
      ...
   </Adjustments>
   <ShippingCharge>
      <Account>
         <AccountID></AccountID>
      </Account>
      <Amount></Amount>
      <TaxKey>
         <TaxKeyID></TaxKeyID>
      </TaxKey>
   </ShippingCharge>
</Purchase>
   

Only documents with status Draft can be updated.
No tags are required.
For tags description please refer to Get Purchase Document.

Response


<Response>
   <DocumentID></DocumentID>
</Response>
   

Tag Description
<DocumentID> Unique system identifier for purchase document

Back to Purchases

Post Purchase Document

Request

GET https://go.paytraq.com/api/purchasePost/{DocumentID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
DocumentID Unique system identifier for purchase document

Only documents with status Draft can be posted.

Response


<Response>
   <DocumentID></DocumentID>
</Response>
   

Tag Description
<DocumentID> Unique system identifier for purchase document

Back to Purchases

Add Direct Payment to Purchase Document

Request

POST https://go.paytraq.com/api/purchasePayment/{DocumentID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
DocumentID Unique system identifier for purchase document


<DirectPayment>
   <MoneyAccountID></MoneyAccountID>
   <PaymentAmount></PaymentAmount>
   <PaymentDate></PaymentDate>
   <Narration></Narration>
   <BankCharge></BankCharge>
</DirectPayment>
   

Tag Description
<MoneyAccountID> Unique system identifier for bank or cash account. See Get Bank Accounts and Get Cash Accounts

Only documents with status Waiting for Payment or Partially Paid can be paid.
<MoneyAccountID> should be in the same currency as purchase document.
<Narration> is not required.
<BankCharge> is optional.

Response


<Response>
   <DocumentID></DocumentID>
   <AmountDue></AmountDue>
</Response>
   

Tag Description
<DocumentID> Unique system identifier for payment document. See Get Payment
Is not available for <MoneyAccountID> with Merchant and Credit Card account types

Back to Purchases

Get Expense Claims

Request

GET https://go.paytraq.com/api/expenseClaims?APIToken={APIToken}&APIKey={APIKey}

Result list is sorted by document date in descending order.
Optional parameters are available. Results can be filtered by employee name or document number.
Document date range filter can be applied.

Response


<ExpenseClaims>
   <ExpenseClaim>
      <Header>
         <Document>
            <DocumentID></DocumentID>
            <DocumentDate></DocumentDate>
            <DocumentRef></DocumentRef>
            <DocumentType></DocumentType>
            <DocumentStatus></DocumentStatus>
            <Employee>
               <EmployeeID></EmployeeID>
               <EmployeeName></EmployeeName>
            </Employee>
         </Document>
         <Total></Total>
         <AmountDue></AmountDue>
         <Currency></Currency>
         <BalanceCurrency></BalanceCurrency>
         <CurrencyRate></CurrencyRate>
         <TaxBasis></TaxBasis>
         <IncludeTax></IncludeTax>
         <UsePrepayment></UsePrepayment>
         <DateDue></DateDue>
         <Comment />
         <PayTerm>
            <PayTermType></PayTermType>
            <PayTermDays />
         </PayTerm>
         <AccountID></AccountID>
      </Header>
   </ExpenseClaim>
   ...
</ExpenseClaims>
   

Tag Description
<DocumentID> Unique system identifier for expepse claim
<DocumentRef> Document number
<DocumentStatus> Possible values:
  • draft - Draft
  • wait_approve - Waiting for Approval
  • wait_payment - Waiting for Payment
  • part_paid - Partially Paid
  • paid - Paid
  • voided - Voided/Canceled
  • reversed - Reversed
  • done - Done
  • approved - Approved
  • in_process - In Progress
<EmployeeID> Unique system identifier for employee. See Get Employee
<Currency> 3-letter currency code
<TaxBasis> Possible values:
  • 1 - Accrual
  • 2 - Cash
<IncludeTax> Boolean value (false | true)
Shows that amounts are tax inclusive
<UsePrepayment> Boolean value (false | true)
<AccountID> Unique system identifier for accounts payable. See Get Account

Back to Purchases

Get Expense Claim

Request

GET https://go.paytraq.com/api/expenseClaim/{DocumentID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
DocumentID Unique system identifier for expense claim
Response


<ExpenseClaim>
   <Header>
      <Document>
         <DocumentID></DocumentID>
         <DocumentDate></DocumentDate>
         <DocumentRef></DocumentRef>
         <DocumentType></DocumentType>
         <DocumentStatus></DocumentStatus>
         <Employee>
            <EmployeeID></EmployeeID>
            <EmployeeName></EmployeeName>
         </Employee>
      </Document>
      <Total></Total>
      <AmountDue></AmountDue>
      <Currency></Currency>
      <BalanceCurrency></BalanceCurrency>
      <CurrencyRate></CurrencyRate>
      <TaxBasis></TaxBasis>
      <IncludeTax></IncludeTax>
      <UsePrepayment></UsePrepayment>
      <DateDue></DateDue>
      <Comment />
      <PayTerm>
         <PayTermType></PayTermType>
         <PayTermDays />
      </PayTerm>
      <AccountID></AccountID>
   </Header>
   <Expenses>
      <Expense>
         <Account>
            <AccountID></AccountID>
            <AccountCode></AccountCode>
            <AccountName></AccountName>
         </Account>
         <Supplier>
            <SupplierID></SupplierID>
            <SupplierName></SupplierName>
         </Supplier>
         <ReceiptDate></ReceiptDate>
         <ReceiptRef></ReceiptRef>
         <Description></Description>
         <Amount></Amount>
         <TaxKey>
            <TaxKeyID></TaxKeyID>
            <TaxKeyName></TaxKeyName>
         </TaxKey>
      </Expense>
      ...
   </Expenses>
   <Taxes>
      <Tax>
         <TaxKey>
            <TaxKeyID></TaxKeyID>
            <TaxKeyName></TaxKeyName>
         </TaxKey>
         <TaxName></TaxName>
         <GrossAmount></GrossAmount>
         <NetAmount></NetAmount>
         <TaxAmount></TaxAmount>
         <Account>
            <AccountID></AccountID>
            <AccountName></AccountName>
         </Account>
      </Tax>
   </Taxes>
   <Totals>
      <GrossAmount></GrossAmount>
      <NetAmount></NetAmount>
   </Totals>
</ExpenseClaim>
   

Tag Description
<DocumentID> Unique system identifier for expepse claim
<DocumentRef> Document number
<DocumentStatus> Possible values:
  • draft - Draft
  • wait_approve - Waiting for Approval
  • wait_payment - Waiting for Payment
  • part_paid - Partially Paid
  • paid - Paid
  • voided - Voided/Canceled
  • reversed - Reversed
  • done - Done
  • approved - Approved
  • in_process - In Progress
<EmployeeID> Unique system identifier for employee. See Get Employee
<Currency> 3-letter currency code
<TaxBasis> Possible values:
  • 1 - Accrual
  • 2 - Cash
<IncludeTax> Boolean value (false | true)
Shows that amounts are tax inclusive
<UsePrepayment> Boolean value (false | true)
<PayTermType> Possible values:
  • 0 - Other date
  • 1 - Due days
  • 2 - EOM+
<PayTermDays> Number of days. Can be used only with <PayTermType> values 1 and 2
<AccountID> Unique system identifier for account. See Get Account
<SupplierID> Unique system identifier for supplier. See Get Supplier
<ReceiptRef> Receipt number
<TaxKeyID> Unique system identifier for tax key. See Get Tax Key

Back to Purchases

Add Expense Claim

Request

POST https://go.paytraq.com/api/expenseClaim?APIToken={APIToken}&APIKey={APIKey}


<ExpenseClaim>
   <Header>
      <Document>
         <DocumentDate></DocumentDate>
         <DocumentRef></DocumentRef>
         <Employee>
            <EmployeeID></EmployeeID>
            <EmployeeName></EmployeeName>
         </Employee>
      </Document>
      <Currency></Currency>
      <UsePrepayment></UsePrepayment>
      <DateDue></DateDue>
      <Comment />
      <PayTerm>
         <PayTermType></PayTermType>
         <PayTermDays />
      </PayTerm>
   </Header>
   <Expenses>
      <Expense>
         <Account>
            <AccountID></AccountID>
         </Account>
         <Supplier>
            <SupplierID></SupplierID>
            <SupplierName></SupplierName>
         </Supplier>
         <ReceiptDate></ReceiptDate>
         <ReceiptRef></ReceiptRef>
         <Description></Description>
         <Amount></Amount>
         <TaxKey>
            <TaxKeyID></TaxKeyID>
         </TaxKey>
      </Expense>
      ...
   </Expenses>
</ExpenseClaim>
   

No tags are required.
To add an employee <EmployeeID /> OR <EmployeeName /> should be provided.
To add a supplier <SupplierID /> OR <SupplierName /> should be provided.
For tags description please refer to Get Expense Claim.

Response


<Response>
   <DocumentID></DocumentID>
</Response>
   

Tag Description
<DocumentID> Unique system identifier for purchase document

Back to Purchases

Update Expense Claim

Request

POST https://go.paytraq.com/api/expenseClaim/{DocumentID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
DocumentID Unique system identifier for expense claim


<ExpenseClaim>
   <Header>
      <Document>
         <DocumentDate></DocumentDate>
         <DocumentRef></DocumentRef>
         <Employee>
            <EmployeeID></EmployeeID>
         </Employee>
      </Document>
      <Currency></Currency>
      <UsePrepayment></UsePrepayment>
      <DateDue></DateDue>
      <Comment />
      <PayTerm>
         <PayTermType></PayTermType>
         <PayTermDays />
      </PayTerm>
   </Header>
   <Expenses>
      <Expense>
         <Account>
            <AccountID></AccountID>
         </Account>
         <Supplier>
            <SupplierID></SupplierID>
            <SupplierName></SupplierName>
         </Supplier>
         <ReceiptDate></ReceiptDate>
         <ReceiptRef></ReceiptRef>
         <Description></Description>
         <Amount></Amount>
         <TaxKey>
            <TaxKeyID></TaxKeyID>
         </TaxKey>
      </Expense>
      ...
   </Expenses>
</ExpenseClaim>
   

Only documents with status Draft or Waiting for Approval can be updated.
No tags are required.
To add a supplier <SupplierID /> OR <SupplierName /> should be provided.
For tags description please refer to Get Expense Claim.

Response


<Response>
   <DocumentID></DocumentID>
</Response>
   

Tag Description
<DocumentID> Unique system identifier for expense claim

Back to Purchases

Post Expense Claim

Request

GET https://go.paytraq.com/api/expenseClaimPost/{DocumentID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
DocumentID Unique system identifier for expense claim

Only documents with status Waiting for Approval can be posted.

Response


<Response>
   <DocumentID></DocumentID>
</Response>
   

Tag Description
<DocumentID> Unique system identifier for expense claim

Back to Purchases

Add Direct Payment to Expense Claim

Request

POST https://go.paytraq.com/api/expenseClaimPayment/{DocumentID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
DocumentID Unique system identifier for expense claim


<DirectPayment>
   <MoneyAccountID></MoneyAccountID>
   <PaymentAmount></PaymentAmount>
   <PaymentDate></PaymentDate>
   <Narration></Narration>
</DirectPayment>
   

Tag Description
<MoneyAccountID> Unique system identifier for bank or cash account. See Get Bank Accounts and Get Cash Accounts

Only documents with status Waiting for Payment or Partially Paid can be paid.
<MoneyAccountID> should be in the same currency as expense claim.
<Narration> is not required.

Response


<Response>
   <DocumentID></DocumentID>
   <AmountDue></AmountDue>
</Response>
   

Tag Description
<DocumentID> Unique system identifier for payment document. See Get Payment
Is not available for <MoneyAccountID> with Merchant and Credit Card account types

Back to Purchases

Inventory Moves

Get Inventory Movements

Request

GET https://go.paytraq.com/api/inventoryMovements?APIToken={APIToken}&APIKey={APIKey}

Result list is sorted by document date in descending order.
Optional parameters are available. Results can be filtered by document number or by source or destination name.
Document date range filter can be applied.

Response


<InventoryMovements>
   <InventoryMovement>
      <Header>
         <Document>
            <DocumentID></DocumentID>
            <DocumentDate></DocumentDate>
            <DocumentRef></DocumentRef>
            <DocumentType></DocumentType>
            <DocumentStatus></DocumentStatus>
            <BusinessPartner>
               <BusinessPartnerID></BusinessPartnerID>
               <BusinessPartnerName></BusinessPartnerName>
            </BusinessPartner>
         </Document>
         <MovementType></MovementType>
         <Operation></Operation>
         <Direction></Direction>
         <Sender>
            <WarehouseID></WarehouseID>
            <WarehouseName></WarehouseName>
         </Sender>
         <Receiver>
            <WarehouseID></WarehouseID>
            <WarehouseName></WarehouseName>
         </Receiver>
         <Warehouse>
            <WarehouseID></WarehouseID>
            <WarehouseName></WarehouseName>
         </Warehouse>
      </Header>
   </InventoryMovement>
   ...
</InventoryMovements>
   

Tag Description
<DocumentID> Unique system identifier for inventory document
<DocumentRef> Document number
<DocumentType> Possible values:
  • out_shipment - Outgoing Shipment
  • in_shipment - Incoming Shipment
  • inventory - Inventory Adjustment
<DocumentStatus> Possible values:
  • wait_approve - Waiting for Approval
  • wait_invoice - Waiting for Invoice
  • wait_refund - Waiting for Refund
  • wait_delivery - Waiting for Delivery
  • in_transit - In Transit
  • issued_client - Issued to Client
  • wait_return - Waiting for Return
  • done - Done
  • in_production - In Production
  • in_process - In Progress
<BusinessPartnerID> Unique system identifier for client or supplier. See Get Client or Get Supplier
<MovementType> Possible values:
  • shipment - Shipment
  • adjustment - Inventory Adjustment
<Operation> Possible values:
  • sales_invoice - Sales Invoice
  • purchase_invoice - Putchase Invoice
  • sales_return - Sales Return/Credit Note
  • purchase_return - Purchase Return/Credit Note
  • internal - Internal Shipment
  • external - External Shipment
  • receipt - Inventory Receipt
  • write_off - Intentory Write-off
  • inventory - Physical Inventory
  • revaluation - Revaluation
  • order - Production Order
<Direction> Possible values:
  • out - Outgoing
  • in - Incoming
  • in/out - Incoming/Outgoing
<WarehouseID> Unique system identifier for warehouse. See Get Warehouse

Back to Inventory Moves

Get Inventory Movement

Request

GET https://go.paytraq.com/api/inventoryMovement/{DocumentID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
DocumentID Unique system identifier for inventory document
Response


<InventoryMovement>
   <Header>
      <Document>
         <DocumentID></DocumentID>
         <DocumentDate></DocumentDate>
         <DocumentRef></DocumentRef>
         <DocumentType></DocumentType>
         <DocumentStatus></DocumentStatus>
         <BusinessPartner>
            <BusinessPartnerID></BusinessPartnerID>
            <BusinessPartnerName></BusinessPartnerName>
         </BusinessPartner>
      </Document>
      <MovementType></MovementType>
      <Operation></Operation>
      <Direction></Direction>
      <Sender>
         <WarehouseID></WarehouseID>
         <WarehouseName></WarehouseName>
      </Sender>
      <Receiver>
         <WarehouseID></WarehouseID>
         <WarehouseName></WarehouseName>
      </Receiver>
      <Warehouse>
         <WarehouseID></WarehouseID>
         <WarehouseName></WarehouseName>
      </Warehouse>
      <ShippingData>
         <LoadingArea>
            <LoadingAreaID></LoadingAreaID>
            <LoadingAreaName></LoadingAreaName>
            <LoadingAreaAddress>
               <Address></Address>
               <Zip></Zip>
               <Country></Country>
            </LoadingAreaAddress>
         </LoadingArea>
         <Shipper>
            <ShipperID></ShipperID>
            <ShipperName></ShipperName>
            <ShipperRegNumber />
            <ShipperVehicle />
            <ShipperDriver />
         </Shipper>
         <ShippingAddress>
            <AddressID></AddressID>
            <ShipTo></ShipTo>
            <Address></Address>
            <Zip></Zip>
            <Country></Country>
         </ShippingAddress>
      </ShippingData>
      <Comment />
      <Invoice>
         <DocumentLink>
            <DocumentID></DocumentID>
            <DocumentDate></DocumentDate>
            <DocumentRef></DocumentRef>
            <DocumentType></DocumentType>
         </DocumentLink>
      </Invoice>
      <InitShipment />
   </Header>
   <MovementLines>
      <MovementLine>
         <Item>
            <ItemID></ItemID>
            <ItemCode />
            <ItemName></ItemName>
         </Item>
         <ItemLot>
            <LotID></LotID>
            <LotNumber></LotNumber>
         </ItemLot>
         <Qty></Qty>
         <UnitCost />
         <Unit>
            <UnitID></UnitID>
            <UnitName></UnitName>
         </Unit>
         <Direction></Direction>
         <Status></Status>
         <ActualQty />
         <InitQty />
      </MovementLine>
   </MovementLines>
   <Totals>
      <TotalCost></TotalCost>
      <Qty></Qty>
   </Totals>
</InventoryMovement>
   

Tag Description
<DocumentID> Unique system identifier for document
<DocumentRef> Document number
<DocumentType> Possible values:
  • out_shipment - Outgoing Shipment
  • in_shipment - Incoming Shipment
  • inventory - Inventory Adjustment
<DocumentStatus> Possible values:
  • wait_approve - Waiting for Approval
  • wait_invoice - Waiting for Invoice
  • wait_refund - Waiting for Refund
  • wait_delivery - Waiting for Delivery
  • in_transit - In Transit
  • issued_client - Issued to Client
  • wait_return - Waiting for Return
  • done - Done
  • in_production - In Production
  • in_process - In Progress
<BusinessPartnerID> Unique system identifier for client or supplier. See Get Client or Get Supplier
<MovementType> Possible values:
  • shipment - Shipment
  • adjustment - Inventory Adjustment
<Operation> Possible values:
  • sales_invoice - Sales Invoice
  • purchase_invoice - Putchase Invoice
  • sales_return - Sales Return/Credit Note
  • purchase_return - Purchase Return/Credit Note
  • internal - Internal Shipment
  • external - External Shipment
  • receipt - Inventory Receipt
  • write_off - Intentory Write-off
  • inventory - Physical Inventory
  • revaluation - Revaluation
  • order - Production Order
<Direction> Possible values:
  • out - Outgoing
  • in - Incoming
  • in/out - Incoming/Outgoing
<WarehouseID> Unique system identifier for warehouse. See Get Warehouse
<ItemID> Unique system identifier for product. See Get Product
<ItemCode> Product SKU. See Get Product By Code
<LotID> Unique system identifier for lot
<UnitID> Unique system identifier for unit of measure. See Get Unit

Back to Inventory Moves

Add Inventory Movement

Request

POST https://go.paytraq.com/api/inventoryMovement?APIToken={APIToken}&APIKey={APIKey}

This API call is not implemented yet

Response


    501 Not Implemented (This call is not implemented yet)
   

Back to Inventory Moves

Update Inventory Movement

Request

POST https://go.paytraq.com/api/inventoryMovement/{DocumentID}?APIToken={APIToken}&APIKey={APIKey}

This API call is not implemented yet

Response


    501 Not Implemented (This call is not implemented yet)
   

Back to Inventory Moves

Post Inventory Movement

Request

GET https://go.paytraq.com/api/inventoryMovementPost/{DocumentID}?APIToken={APIToken}&APIKey={APIKey}

This API call is not implemented yet

Response


    501 Not Implemented (This call is not implemented yet)
   

Back to Inventory Moves

Payments

Get Payments

Request

GET https://go.paytraq.com/api/payments?APIToken={APIToken}&APIKey={APIKey}

Result list is sorted by document date in descending order.
Optional parameters are available. Results can be filtered by document number or business partner name.
Payment date range filter can be applied.

Response


<Payments>
   <Payment>
      <Header>
         <Document>
            <DocumentID></DocumentID>
            <DocumentDate></DocumentDate>
            <DocumentRef></DocumentRef>
            <DocumentType></DocumentType>
            <DocumentStatus></DocumentStatus>
            <BusinessPartner>
               <BusinessPartnerID></BusinessPartnerID>
               <BusinessPartnerName></BusinessPartnerName>
               <BankInfo>
                  <BankAccount></BankAccount>
                  <BankName></BankName>
                  <BankCode></BankCode>
               </BankInfo>
            </BusinessPartner>
         </Document>
         <PaymentType></PaymentType>
         <Operation></Operation>
         <PaymentAmount></PaymentAmount>
         <BalanceAmount><lt;/BalanceAmount>
         <PaymentCurrency></PaymentCurrency>
         <BalanceCurrency></BalanceCurrency>
         <CurrencyRate></CurrencyRate>
         <MoneyAccount>
            <MoneyAccountID></MoneyAccountID>
            <MoneyAccountName></MoneyAccountName>
            <MoneyAccountCurrency></MoneyAccountCurrency>
            <GLAccount>
               <AccountID></AccountID>
               <AccountCode />
               <AccountName>Bank</AccountName>
            </GLAccount>
            <Type></Type>
            <BankAccountNumber />
            <BankName />
            <BankCode />
         </MoneyAccount>
         <IsBankCharge></IsBankCharge>
         <IsTransfer></IsTransfer>
         <Narration></Narration>
      </Header>
   </Payment>
   ...
</Payments>
   

Tag Description
<DocumentID> Unique system identifier for payment document
<DocumentRef> Document number
<DocumentStatus> Possible values:
  • draft - Draft
  • done - Done
<BusinessPartnerID> Unique system identifier for client, supplier or employee. See Get Client, Get Supplier or Get Employee
<PaymentType> Possible values:
  • bank_in - Incoming Bank Payment
  • bank_out - Outgoing Bank Payment
  • cash_in - Incoming Cash Payment
  • cash_out - Outgoing Cash Payment
  • cash_dr_voucher - Cash Debit Voucher
  • cash_cr_voucher- Cash Credit Voucher
<Operation> Possible values:
  • out - Outgoing
  • in - Incoming
<PaymentCurrency> 3-letter currency code
<MoneyAccountID> Unique system identifier for bank or cash account. See Get Bank Accounts and Get Cash Accounts
<Type> Possible values:
  • bank - Bank Account
  • card - Credit Card
  • merchant - Merchant Account
  • paypal - PayPal Account
  • cashbook - Cashbook
  • pos - Point of Sale / Cash Account
  • other - Other Money Account
<IsBankCharge> Boolean value (false | true)
<IsTransfer> Boolean value (false | true)

Back to Payments

Get Payment

Request

GET https://go.paytraq.com/api/payment/{DocumentID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
DocumentID Unique system identifier for payment document
Response


<Payment>
   <Header>
      <Document>
         <DocumentID></DocumentID>
         <DocumentDate></DocumentDate>
         <DocumentRef></DocumentRef>
         <DocumentType></DocumentType>
         <DocumentStatus></DocumentStatus>
         <BusinessPartner>
            <BusinessPartnerID></BusinessPartnerID>
            <BusinessPartnerName></BusinessPartnerName>
            <BankInfo>
               <BankAccount></BankAccount>
               <BankName></BankName>
               <BankCode></BankCode>
            </BankInfo>
         </BusinessPartner>
      </Document>
      <PaymentType></PaymentType>
      <Operation></Operation>
      <PaymentAmount></PaymentAmount>
      <BalanceAmount></BalanceAmount>
      <PaymentCurrency></PaymentCurrency>
      <BalanceCurrency></BalanceCurrency>
      <CurrencyRate></CurrencyRate>
      <MoneyAccount>
         <MoneyAccountID></MoneyAccountID>
         <MoneyAccountName></MoneyAccountName>
         <MoneyAccountCurrency></MoneyAccountCurrency>
         <GLAccount>
            <AccountID></AccountID>
            <AccountCode />
            <AccountName></AccountName>
         </GLAccount>
         <Type></Type>
         <BankAccountNumber />
         <BankName />
         <BankCode />
      </MoneyAccount>
      <IsBankCharge></IsBankCharge>
      <IsTransfer></IsTransfer>
      <Narration></Narration>
   </Header>
   <PaymentLines>
      <PaymentLine>
         <Account>
            <AccountID></AccountID>
            <AccountCode></AccountCode>
            <AccountName></AccountName>
         </Account>
         <PaymentAmount></PaymentAmount>
         <BalanceAmount></BalanceAmount>
         <PaymentCurrency></PaymentCurrency>
         <BalanceCurrency></BalanceCurrency>
         <Description></Description>
         <DocumentLink>
            <DocumentID></DocumentID>
            <DocumentDate></DocumentDate>
            <DocumentRef></DocumentRef>
            <DocumentType></DocumentType>
         </DocumentLink>
      </PaymentLine>
      ...
   </PaymentLines>
</Payment>
   

Tag Description
<DocumentID> Unique system identifier for document
<DocumentRef> Document number
<DocumentStatus> Possible values:
  • draft - Draft
  • done - Done
<BusinessPartnerID> Unique system identifier for client, supplier or employee. See Get Client, Get Supplier or Get Employee
<PaymentType> Possible values:
  • bank_in - Incoming Bank Payment
  • bank_out - Outgoing Bank Payment
  • cash_in - Incoming Cash Payment
  • cash_out - Outgoing Cash Payment
  • cash_dr_voucher - Cash Debit Voucher
  • cash_cr_voucher- Cash Credit Voucher
<Operation> Possible values:
  • out - Outgoing
  • in - Incoming
<PaymentCurrency> 3-letter currency code
<MoneyAccountID> Unique system identifier for bank or cash account. See Get Bank Accounts and Get Cash Accounts
<Type> Possible values:
  • bank - Bank Account
  • card - Credit Card
  • merchant - Merchant Account
  • paypal - PayPal Account
  • cashbook - Cashbook
  • pos - Point of Sale / Cash Account
  • other - Other Money Account
<IsBankCharge> Boolean value (false | true)
<IsTransfer> Boolean value (false | true)
<AccountID> Unique system identifier for account. See Get Account

Back to Payments

Add Payment

Request

POST https://go.paytraq.com/api/payment?APIToken={APIToken}&APIKey={APIKey}

This API call is not implemented yet

Response


    501 Not Implemented (This call is not implemented yet)
   

Back to Payments

Update Payment

Request

POST https://go.paytraq.com/api/payment/{DocumentID}?APIToken={APIToken}&APIKey={APIKey}

This API call is not implemented yet

Response


    501 Not Implemented (This call is not implemented yet)
   

Back to Payments

Post Payment

Request

GET https://go.paytraq.com/api/paymentPost/{DocumentID}?APIToken={APIToken}&APIKey={APIKey}

This API call is not implemented yet

Response


    501 Not Implemented (This call is not implemented yet)
   

Back to Payments

Accounting

Get Tax Keys

Request

GET https://go.paytraq.com/api/taxKeys?APIToken={APIToken}&APIKey={APIKey}

Response


<TaxKeys>
   <TaxKey>
      <TaxKeyID></TaxKeyID>
      <Name></Name>
      <TaxName />
      <EffectiveRate></EffectiveRate>
      <IsDefault></IsDefault>
      <TaxGroup>
         <TaxGroupID></TaxGroupID>
         <TaxGroupName></TaxGroupName>
         <IsInput></IsInput>
         <IsOutput></IsOutput>
         <IsECSales></IsECSales>
         <IsECPurchases></IsECPurchases>
         <IsImport></IsImport>
      </TaxGroup>
      <Description />
      <IsInactive></IsInactive>
   </TaxKey>
   ...
</TaxKeys>
   

Tag Description
<TaxKeyID> Unique system identifier for tax key
<EffectiveRate> Effective Tax Rate
<IsDefault> Boolean value (false | true)
<TaxGroupID> Unique system identifier for tax group
<IsInput> Boolean value (false | true)
<IsOutput> Boolean value (false | true)
<IsECSales> Boolean value (false | true)
<IsECPurchases> Boolean value (false | true)
<IsImport> Boolean value (false | true)
<IsInactive> Boolean value (false | true)

Back to Accounting

Get Tax Key

Request

GET https://go.paytraq.com/api/taxKey/{TaxKeyID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
TaxKeyID Unique system identifier for tax key
Response


<TaxKey>
   <TaxKeyID></TaxKeyID>
   <Name></Name>
   <TaxName />
   <EffectiveRate></EffectiveRate>
   <IsDefault></IsDefault>
   <TaxGroup>
      <TaxGroupID></TaxGroupID>
      <TaxGroupName></TaxGroupName>
      <IsInput></IsInput>
      <IsOutput></IsOutput>
      <IsECSales></IsECSales>
      <IsECPurchases></IsECPurchases>
      <IsImport></IsImport>
   </TaxGroup>
   <Description />
   <IsInactive></IsInactive>
   <Rates>
      <Rate>
         <RateID></RateID>
         <TaxName></TaxName>
         <TaxRate></TaxRate>
         <IsReverseTax></IsReverseTax>
         <SysTaxName></SysTaxName>
         <TaxAccountID></TaxAccountID>
         <TaxHoldAccountID></TaxHoldAccountID>
         <TaxExpenseAccountID />
      </Rate>
   </Rates>
</TaxKey>
   

Tag Description
<TaxKeyID> Unique system identifier for tax key
<EffectiveRate> Effective Tax Rate
<IsDefault> Boolean value (false | true)
<TaxGroupID> Unique system identifier for tax group
<IsInput> Boolean value (false | true)
<IsOutput> Boolean value (false | true)
<IsECSales> Boolean value (false | true)
<IsECPurchases> Boolean value (false | true)
<IsImport> Boolean value (false | true)
<IsInactive> Boolean value (false | true)
<IsReverseTax> Boolean value (false | true)
<TaxAccountID> Unique system identifier for tax payable account. See Get Account
<TaxHoldAccountID> Unique system identifier for tax holding account. See Get Account

Back to Accounting

Get Accounts

Request

GET https://go.paytraq.com/api/accounts?APIToken={APIToken}&APIKey={APIKey}

Result list is sorted by account code and account name in ascending order.
Query optional parameter is available. Results can be filtered by account code or account name. Pagination is not needed.

Response


<Accounts>
   <Account>
      <AccountID></AccountID>
      <Code></Code>
      <Name></Name>
      <Alias></Alias>
      <AccountGroup>
         <AccountGroupID></AccountGroupID>
         <AccountGroupType></AccountGroupType>
         <AccountGroupBalanceType></AccountGroupBalanceType>
         <AccountGroupBalanceSubType></AccountGroupBalanceSubType>
      </AccountGroup>
      <AccountType></AccountType>
      <IsInactive></IsInactive>
   </Account>
   ...
</Accounts>
   

Tag Description
<AccountID> Unique system identifier for account
<Code> Account Code
<AccountGroupID> Unique system identifier for account group
<AccountGroupBalanceType> Possible values:
  • A - Assets
  • L - Liabilities
  • N - Nominal
<AccountType> Possible values:
  • DR - Debit
  • CR - Credit
<IsInactive> Boolean value (false | true)

Back to Accounting

Get Account

Request

GET https://go.paytraq.com/api/account/{AccountID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
AccountID Unique system identifier for account
Response


<Account>
   <AccountID></AccountID>
   <Code></Code>
   <Name></Name>
   <Alias></Alias>
   <AccountGroup>
      <AccountGroupID></AccountGroupID>
      <AccountGroupType></AccountGroupType>
      <AccountGroupBalanceType></AccountGroupBalanceType>
      <AccountGroupBalanceSubType></AccountGroupBalanceSubType>
   </AccountGroup>
   <AccountType></AccountType>
   <IsInactive></IsInactive>
</Account>
   

Tag Description
<AccountID> Unique system identifier for account
<Code> Account Code
<AccountGroupID> Unique system identifier for account group
<AccountGroupBalanceType> Possible values:
  • A - Assets
  • L - Liabilities
  • N - Nominal
<AccountType> Possible values:
  • DR - Debit
  • CR - Credit
<IsInactive> Boolean value (false | true)

Back to Accounting

Get Account By Code

Request

GET https://go.paytraq.com/api/accountByCode/{Code}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
Code Account Code
Response


<Account>
   <AccountID></AccountID>
   <Code></Code>
   <Name></Name>
   <Alias></Alias>
   <AccountGroup>
      <AccountGroupID></AccountGroupID>
      <AccountGroupType></AccountGroupType>
      <AccountGroupBalanceType></AccountGroupBalanceType>
      <AccountGroupBalanceSubType></AccountGroupBalanceSubType>
   </AccountGroup>
   <AccountType></AccountType>
   <IsInactive></IsInactive>
</Account>
   

Tag Description
<AccountID> Unique system identifier for account
<Code> Account Code
<AccountGroupID> Unique system identifier for account group
<AccountGroupBalanceType> Possible values:
  • A - Assets
  • L - Liabilities
  • N - Nominal
<AccountType> Possible values:
  • DR - Debit
  • CR - Credit
<IsInactive> Boolean value (false | true)

Back to Accounting

Get Bank Accounts

Request

GET https://go.paytraq.com/api/bankAccounts?APIToken={APIToken}&APIKey={APIKey}

Response


<BankAccounts>
   <BankAccount>
      <BankAccountID></BankAccountID>
      <Name></Name>
      <Currency></Currency>
      <GLAccount>
         <AccountID></AccountID>
         <AccountCode />
         <AccountName></AccountName>
      </GLAccount>
      <Type></Type>
      <BankAccountNumber />
      <BankName />
      <BankCode />
      <IsInactive></IsInactive>
      <IsDefault></IsDefault>
      <Balance></Balance>
   </BankAccount>
   ...
</BankAccounts>
   

Tag Description
<BankAccountID> Unique system identifier for money account
<Currency> 3-letter currency code
<AccountID> Unique system identifier for account. See Get Account
<Type> Possible values:
  • bank - Bank Account
  • card - Credit Card
  • merchant - Merchant Account
  • paypal - PayPal Account
  • other - Other Money Account
<IsInactive> Boolean value (false | true)
<IsDefault> Boolean value (false | true)

Back to Accounting

Get Cash Accounts

Request

GET https://go.paytraq.com/api/cashAccounts?APIToken={APIToken}&APIKey={APIKey}

Response


<CashAccounts>
   <CashAccount>
      <CashAccountID></CashAccountID>
      <Name></Name>
      <Currency></Currency>
      <GLAccount>
         <AccountID></AccountID>
         <AccountCode />
         <AccountName></AccountName>
      </GLAccount>
      <Type></Type>
      <IsInactive></IsInactive>
      <IsDefault></IsDefault>
      <Balance />
   </CashAccount>
   ...
</CashAccounts>
   

Tag Description
<CashAccountID> Unique system identifier for money account
<Currency> 3-letter currency code
<AccountID> Unique system identifier for account. See Get Account
<Type> Possible values:
  • cashbook - Cashbook
  • pos - Point of Sale / Cash Account
  • other - Other Money Account
<IsInactive> Boolean value (false | true)
<IsDefault> Boolean value (false | true)

Back to Accounting

Get Trial Balance

Request

GET https://go.paytraq.com/api/trialBalance?APIToken={APIToken}&APIKey={APIKey}

Response


<TrialBalance>
   <Account>
      <GLAccount>
         <AccountID></AccountID>
         <Code />
         <Name></Name>
      </GLAccount>
      <DR></DR>
      <CR></CR>
      <Balance></Balance>
   </Account>
</TrialBalance>
   

Tag Description
<AccountID> Unique system identifier for account. See Get Account
<Code> Account Code

Back to Accounting

Get Journal Types

Request

GET https://go.paytraq.com/api/journalTypes?APIToken={APIToken}&APIKey={APIKey}

Response


<JournalTypes>
   <JournalType>
      <JournalTypeID></JournalTypeID>
      <JournalTypeName></JournalTypeName>
      <Narration></Narration>
      <SysCode></SysCode>
      <IsInactive></IsInactive>
      <IsDefault></IsDefault>
      <IsSystem></IsSystem>
   </JournalType>
   ...
</JournalTypes>
   

Tag Description
<JournalTypeID> Unique system identifier for journal type
<IsInactive> Boolean value (false | true)
<IsDefault> Boolean value (false | true)
<IsSystem> Boolean value (false | true)

Back to Accounting

Get Journals

Request

GET https://go.paytraq.com/api/journals?APIToken={APIToken}&APIKey={APIKey}

Result list is sorted by journal date in descending order.
Optional parameters are available. Results can be filtered by journal number or business partner name.
Journal date range filter can be applied.

Response


<Journals>
   <Journal>
      <JournalID></JournalID>
      <JournalRef></JournalRef>
      <JournalDate></JournalDate>
      <JournalStatus></JournalStatus>
      <JournalType>
         <JournalTypeID></JournalTypeID>
         <JournalTypeName></JournalTypeName>
      </JournalType>
      <Currency></Currency>
      <Narration />
      <DocumentLink>
         <DocumentID></DocumentID>
         <DocumentRef></DocumentRef>
         <DocumentDate></DocumentDate>
      </DocumentLink>
      <ExtReference></ExtReference>
      <BusinessPartner>
         <BusinessPartnerID></BusinessPartnerID>
         <BusinessPartnerName></BusinessPartnerName>
      </BusinessPartner>
      <IsApproved></IsApproved>
      <IsManual></IsManual>
      <IsCompressed></IsCompressed>
      <JournalEntries>
         <JournalEntry>
            <Account>
               <AccountID></AccountID>
               <AccountCode></AccountCode>
               <AccountName></AccountName>
            </Account>
            <Description></Description>
            <Amounts>
               <AmountJournal></AmountJournal>
               <CurrencyJournal></CurrencyJournal>
               <AmountBalance></AmountBalance>
               <CurrencyBalance></CurrencyBalance>
               <Rate></Rate>
            </Amounts>
            <Operation></Operation>
            <TaxKey>
               <TaxKeyID></TaxKeyID>
               <TaxKeyName></TaxKeyName>
            </TaxKey>
            <ItemID />
            <DocumentLink>
               <DocumentID />
               <DocumentRef />
               <DocumentDate />
            </DocumentLink>
         </JournalEntry>
         ...
      </JournalEntries>
      <TotalDR></TotalDR>
      <TotalCR></TotalCR>
   </Journal>
   ...
</Journals>
   

Tag Description
<JournalID> Unique system identifier for journal
<JournalRef> System journal number (reference)
<JournalTypeID> Unique system identifier for journal type. See Get Journal Types
<Currency> 3-letter currency code
<BusinessPartnerID> Unique system identifier for business partner e.g. client, supplier or employee. See Get Client, Get Supplier or Get Employee
<IsApproved> Boolean value (false | true)
<IsManual> Boolean value (false | true)
<IsCompressed> Boolean value (false | true)
<AccountID> Unique system identifier for account. See Get Account
<AccountCode> Account Code
<Operation> Possible values:
  • DR - Debit
  • CR - Credit
<TaxKeyID> Unique system identifier for tax key. See Get Tax Key

Back to Accounting

Get Journal

Request

GET https://go.paytraq.com/api/journal/{JournalID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
JournalID Unique system identifier for journal
Response


<Journal>
   <JournalID></JournalID>
   <JournalRef></JournalRef>
   <JournalDate></JournalDate>
   <JournalStatus></JournalStatus>
   <JournalType>
      <JournalTypeID></JournalTypeID>
      <JournalTypeName></JournalTypeName>
   </JournalType>
   <Currency></Currency>
   <Narration />
   <DocumentLink>
      <DocumentID></DocumentID>
      <DocumentRef></DocumentRef>
      <DocumentDate></DocumentDate>
   </DocumentLink>
   <ExtReference></ExtReference>
   <BusinessPartner>
      <BusinessPartnerID></BusinessPartnerID>
      <BusinessPartnerName></BusinessPartnerName>
   </BusinessPartner>
   <IsApproved></IsApproved>
   <IsManual></IsManual>
   <IsCompressed></IsCompressed>
   <JournalEntries>
      <JournalEntry>
         <Account>
            <AccountID></AccountID>
            <AccountCode></AccountCode>
            <AccountName></AccountName>
         </Account>
         <Description></Description>
         <Amounts>
            <AmountJournal></AmountJournal>
            <CurrencyJournal></CurrencyJournal>
            <AmountBalance></AmountBalance>
            <CurrencyBalance></CurrencyBalance>
            <Rate></Rate>
         </Amounts>
         <Operation></Operation>
         <TaxKey>
            <TaxKeyID></TaxKeyID>
            <TaxKeyName></TaxKeyName>
         </TaxKey>
         <ItemID />
         <DocumentLink>
            <DocumentID />
            <DocumentRef />
            <DocumentDate />
         </DocumentLink>
      </JournalEntry>
      ...
   </JournalEntries>
   <JournalTaxes>
      <Tax>
         <TaxKey>
            <TaxKeyID></TaxKeyID>
            <TaxKeyName></TaxKeyName>
         </TaxKey>
         <Account>
            <AccountID></AccountID>
            <AccountCode></AccountCode>
            <AccountName></AccountName>
         </Account>
         <TaxableAmount></TaxableAmount>
         <TaxAmount></TaxAmount>
         <Rate></Rate>
      </Tax>
      ...
   </JournalTaxes>
   <TotalDR></TotalDR>
   <TotalCR></TotalCR>
</Journal>

   

Tag Description
<JournalID> Unique system identifier for journal
<JournalRef> System journal number (reference)
<JournalTypeID> Unique system identifier for journal type. See Get Journal Types
<Currency> 3-letter currency code
<BusinessPartnerID> Unique system identifier for business partner e.g. client, supplier or employee. See Get Client, Get Supplier or Get Employee
<IsApproved> Boolean value (false | true)
<IsManual> Boolean value (false | true)
<IsCompressed> Boolean value (false | true)
<AccountID> Unique system identifier for account. See Get Account
<AccountCode> Account Code
<Operation> Possible values:
  • DR - Debit
  • CR - Credit
<TaxKeyID> Unique system identifier for tax key. See Get Tax Key

Back to Accounting

Add Manual Journal

Request

POST https://go.paytraq.com/api/manualJournal?APIToken={APIToken}&APIKey={APIKey}


<Journal>
   <JournalDate></JournalDate>
   <JournalType>
      <JournalTypeID></JournalTypeID>
   </JournalType>
   <Narration />
   <ExtReference></ExtReference>
   <BusinessPartner>
      <BusinessPartnerID></BusinessPartnerID>
      <BusinessPartnerName></BusinessPartnerName>
   </BusinessPartner>
   <JournalEntries>
      <JournalEntry>
         <Account>
            <AccountID></AccountID>
            <AccountCode></AccountCode>
         </Account>
         <Description></Description>
         <Amounts>
            <AmountJournal></AmountJournal>
            <CurrencyJournal></CurrencyJournal>
            <AmountBalance></AmountBalance>
         </Amounts>
         <Operation></Operation>
         <TaxKey>
            <TaxKeyID></TaxKeyID>
         </TaxKey>
      </JournalEntry>
      ...
   </JournalEntries>
  </Journal>

   

To add a business partner <BusinessPartnerID /> OR <BusinessPartnerName /> should be provided.
To add an account <AccountID /> OR <AccountCode /> should be provided.

<JournalDate>, <JournalTypeID>, <Narration />, <ExtReference>, <Description>, <CurrencyJournal>, <AmountBalance> and <TaxKeyID> are optional
Tag Description
<JournalTypeID> Unique system identifier for journal type. See Get Journal Types
<CurrencyJournal> 3-letter currency code
<BusinessPartnerID> Unique system identifier for business partner e.g. client, supplier or employee. See Get Client, Get Supplier or Get Employee
<AccountID> Unique system identifier for account. See Get Account
<AccountCode> Account Code
<Operation> Possible values:
  • DR - Debit
  • CR - Credit
<TaxKeyID> Unique system identifier for tax key. See Get Tax Key

For other tags description please refer to Get Journal.

Response


<Response>
   <JournalID></JournalID>
</Response>
   

Tag Description
<JournalID> Unique system identifier for journal

Back to Accounting

Settings

Get Price Groups

Request

GET https://go.paytraq.com/api/priceGroups?APIToken={APIToken}&APIKey={APIKey}

Response


<PriceGroups>
   <PriceGroup>
      <PriceGroupID></PriceGroupID>
      <Name></Name>
      <Currency></Currency>
      <IncludeTax></IncludeTax>
      <IsDefault></IsDefault>
      <IsInactive></IsInactive>
   </PriceGroup>
   ...
</PriceGroups>
   

Tag Description
<PriceGroupID> Unique system identifier for price group
<Currency> 3-letter currency code
<IncludeTax> Boolean value (false | true)
Shows that amounts are tax inclusive
<IsDefault> Boolean value (false | true)
<IsInactive> Boolean value (false | true)

Back to Settings

Get Price Group

Request

GET https://go.paytraq.com/api/priceGroup/{PriceGroupID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
PriceGroupID Unique system identifier for price group
Response


<PriceGroup>
   <PriceGroupID></PriceGroupID>
   <Name></Name>
   <Currency></Currency>
   <IncludeTax></IncludeTax>
   <IsDefault></IsDefault>
   <IsInactive></IsInactive>
</PriceGroup>
   

Tag Description
<PriceGroupID> Unique system identifier for price group
<Currency> 3-letter currency code
<IncludeTax> Boolean value (false | true)
Shows that amounts are tax inclusive
<IsDefault> Boolean value (false | true)
<IsInactive> Boolean value (false | true)

Back to Settings

Get Default Price Group

Request

GET https://go.paytraq.com/api/priceGroupDefaultId?APIToken={APIToken}&APIKey={APIKey}

Response


<PriceGroup>
   <PriceGroupID></PriceGroupID>
</PriceGroup>
   

Tag Description
<PriceGroupID> Unique system identifier for price group.
If no default price group is found then <PriceGroupID>0</PriceGroupID> will be returned

Back to Settings

Get Units

Request

GET https://go.paytraq.com/api/units?APIToken={APIToken}&APIKey={APIKey}

Response


<Units>
   <Unit>
      <UnitID></UnitID>
      <Name></Name>
      <IsDefault></IsDefault>
      <IsInactive></IsInactive>
   </Unit>
   ...
</Units>
   

Tag Description
<UnitID> Unique system identifier for unit of measure
<Name> Unit name
<IsDefault> Boolean value (false | true)
<IsInactive> Boolean value (false | true)

Back to Settings

Get Unit

Request

GET https://go.paytraq.com/api/unit/{UnitID}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
UnitID Unique system identifier for unit of measure
Response


<Unit>
   <UnitID></UnitID>
   <Name></Name>
   <IsDefault></IsDefault>
   <IsInactive></IsInactive>
</Unit>
   

Tag Description
<UnitID> Unique system identifier for unit of measure
<Name> Unit name
<IsDefault> Boolean value (false | true)
<IsInactive> Boolean value (false | true)

Back to Settings

Get Unit By Name

Request

GET https://go.paytraq.com/api/unitByName/{Name}?APIToken={APIToken}&APIKey={APIKey}

Parameter Description
Name Unit name
Response


<Unit>
   <UnitID></UnitID>
   <Name></Name>
   <IsDefault></IsDefault>
   <IsInactive></IsInactive>
</Unit>
   

Tag Description
<UnitID> Unique system identifier for unit of measure
<Name> Unit name
<IsDefault> Boolean value (false | true)
<IsInactive> Boolean value (false | true)

Back to Settings