Softwear Web-API
- Jolanda Smit (Deactivated)
SWAPI
about
SWAPI
(Softwear Web-API)
Version: 1.15
Date: 2 december 2015
Author: Jeroen de Vries
Version history
2 december 2015
- api url change: http://www.softwear.nl/api/scripts/foxisapi.dll/sww1.wreq1.mpx to http://webshop.softwear.nl/scripts/FoxIsapi.dll/sww1.wreq1.mpx
30 oktober 2015
- getStatus aanpassen: toevoegen REFID documentatie
19 jun 2015
- Toevoegen documentatie SendOrderSpecs
23 maart 2015
- oude logo verwijderd uit het document (in header)
- function SetClient: ook voorbeeld wholesale toegevoegd
- parameter clientnr:string added
08 oct 2013
- Added GetBasicOrderInfo function
- Added getOrderProgress function
11 jul 2013
- Added customer telephone
- Added customer feed
25 jun 2013
- Added JSON support
- Removed SOAP support
- Improved ADDCOUPON function
19 sep 2012
- Added DISCOUNT-examples
23 jul 2012
- Changed UUID-code for get token
2 nov 2011: 1.7
- Added SENDRMA function
- Added HTTPS support
27 dec 2011: 1.6
- Added CHECKCOUPON function
18 oct 2011: 1.5
- Added RAPTORSKU function
21 oct 2010: 1.4
- Added barcode parameter to GETSTOCK
21 oct 2010: 1.2
- Added multiple-article capability to GETSTOCK
04 oct 2010: 1.1
- Added BLOCKCLIENT function
31 aug 2010: 1.0.a
- Added pwd parameter to SETCLIENT function
10 aug 2010: 1.0
- Changed all XML encoding from utf-8 to windows-1252
- GETCLIENT can now be called with id and/or email address
- SETCLIENT now returns id of newly created client
- Added GETINVOICE function
07 jun 2010: Draft 0.9
- Added SETCLIENT function
31 may 2010: Draft 0.8
- Added GETCLIENT function
30 may 2010: Draft 0.7
- Added SENDTRANSIT function
23 may 2010: Draft 0.6
- Added perShop switch to GETSTOCK function
23 apr 2010: Draft 0.5
- Added GETSTATUS function
- Added GETCOUPONS function
- Added REDEEMCOUPON function
- Added ADDCOUPON function
05 jan 2010: Draft 0.4
- Added RefiD to SENDORDER function
- Added CANCELORDER function
27 nov 2009: Draft 0.3
- Added Shipping and discount to SENDORDER function
20 nov 2009: Draft 0.2
- Added SENDORDER function
31 oct 2009: Draft 0.1
The Softwear Web API (SWAPI) allows developers to interact with the Softwear ERP and POS systems.
The API is HTTP-based
All methods in SWAPI require a GET or POST request. HTTP response codes are not (yet) meaningful.
Let op!
The maximum size of a POST request is 48 kilobytes.
The API is a RESTful resource
SWAPI attempts to conform to the design principles of Representational State Transfer (REST).
Most methods take the optional format parameter that allows you to get results in the format of your choice.
SWAPI currently supports the following data formats: XML, HTML and JSON.
Test v.s production
For testing, use http://testapi.softwear.nl.
For production purposes, use http://webshop.softwear.nl or http://webshop.softwear.nl/scripts/FoxIsapi.dll/sww1.wreq1.mpx
Let op!
If the testapi is used, return values will be the same as the production api however, no changes are made in the database.
Please note that the testapi is significantly slower than the production api.
HTTPS
Encrypted services are available.
For testing, use https://www.softwear.nl/testapi
For production purposes, use https://webshop.softwear.nl/
Be aware that encrypted services run slower than unencrypted services.
We advice to run non-sensitive api’s like getStock on unencrypted services to keep them as fast as possible. Sensitive api’s, specifically those that deal with customer data like getclient and sendorder are better run on encrypted services.
DATAFEEDS
In addition to the api, several datafeeds can be downloaded upon request. Datafeeds are available for article information and client information. Datafeeds are refreshed automatically every 24 hrs. All datafeeds are in CSV format.
The content of the datafeeds can vary per project, for more information contact us at info@softwear.nl or 075-7630650.
TOKEN
The API uses a token for identification. If an API has been setup for a Softwear instance, a token will be provided. Throughout this documentation, a sample token will be used. This UUID token, 1660-8920-F99A-11E0-BE50-0800-200C-9A66, gives access to an example database.
The datafeed for the example database, the one with token=1660-8920-F99A-11E0-BE50-0800-200C-9A66 can be downloaded from:
http://www.softwear.nl/ism/1660-8920-F99A-11E0-BE50-0800-200C-9A66/a.csv
The customerfeed for the example database, the one with token=1660-8920-F99A-11E0-BE50-0800-200C-9A66 can be downloaded from:
http://www.softwear.nl/ism/1660-8920-F99A-11E0-BE50-0800-200C-9A66/cu.csv
function getStock.
This method is used to recieve the actual stock of an article.
Syntax 1:
http://testapi.softwear.nl/scripts/foxisapi.dll/sww1.wreq1.mpx?[function=]getstock&[token=]<shopid>[&articlecode=<articlecode>][&barcode=<barcode> ][&format=<xml/html>][&switches=<logical|detail|perShop>]
Syntax 2: http://testapi.softwear.nl/getstock/<shopid>/articlecode__<articlecode> /barcode__<barcode> [/format__<xml/html>][/switches__<logical|detail|perShop>]
elements in [ ] are optional
elements in <> should be replaced by literals
parameter: token:string
UUID shopid
parameter: articlecode:string
Articlecode of article for which stock should be returned.
Articlecode is case-sensitive.
Articlecode can be either a single artilecode or a comma separated list of articlecodes.
parameter: barcode:string
Barcode of article for which stock should be returned.
Barcode is case-sensitive.
Barcode can be either a single barcode or a comma separated list of barcodes.
Can be any barcode of article, stock for all variations of article will be returned.
parameter: switches:string
comma separated string of switches.
logical returns result as 1 or 0. 1 Means that there is at least one piece of that article in stock, regardless of size and color. The logical option can only be used when stock is retrieved for a single articlecode.
detail returns result per SKU (default)
perShop returns results per shop (implies detail)
function sendOrderSpec.
This method is used to set order specifications to a leading order in a Softwear backoffice.
Syntax 1:
http://testapi.softwear.nl/scripts/foxisapi.dll/sww1.wreq1.mpx?[function=]sendorderspecs[&token=]<shopid>[&nettterm]=<nettterm>[&discperc1]=<discperc1>[&discterm1]=<discterm1>[&discperc2]=<discperc2>[&discterm2]=<discterm2>[&fixdate]=<fixdate>[&reservationdate]=<reservationdate>[&remarks]=<remarks>[¬es]=<notes>[&signature]=<signature>[&carrier]=<carrier>&custnum=<custnum>&refid=<refid>
elements in [ ] are optional
elements in <> should be replaced by literals
Example:
http://testapi.softwear.nl/scripts/foxisapi.dll/sww1.wreq1.mpx?sendorderspecs&token=1660-8920-F99A-11E0-BE50-0800-200C-9A66&nettterm=30&discperc1=2.00&discterm1=10&fixdate=30-10-2015&reservationdate=19-06-2015&remarks=Telefonische order.¬es=&signature=&carrier=&custnum=1234&refid=50-32-1234
parameter: token:string
UUID shopid
parameter: nettterm:number
Term of payment in days
parameter: discperc1:number
Discount percentage (1)
parameter: discterm1:number
Term of discount (1) in days
parameter: discperc2:number
Discount percentage (2)
parameter: discterm1:number
Term of discount (2) in days
parameter: reservationdate:date
Date of order issue from
parameter: fixdate:date
Date of order issue till
parameter: carrier:string
Name of carrier / expediter
parameter: custnum:string
Customer number of client
parameter: refid:string
Reference order number. This number uniquely identifies the leading order. If this number is supplied with this function, the same number must be used to send in the actual order.
function sendOrder.
This method is used to place an order in a Softwear backoffice.
Syntax 1:
http://testapi.softwear.nl/scripts/foxisapi.dll/sww1.wreq1.mpx?[function=]sendorder&[token=]<shopid>&custnum=<custnum>&email=<email>&title=<title>&firstname=<firstname>&middlename=<middlename>&lastname=<lastname>&street=<street>&housenum=<housenum>&houseadd=<houseadd>&zipcode=<zipcode>&city=<city>&countrycode=<countrycode>&remarks=<remarks>&shipping=<shipping>&discount=<discount> [&refid=<refid>][&articlecode=<articlecode>&color=<color>&size=<size>&qty=<qty>&price=<price>]*
elements in [ ] are optional
elements in <> should be replaced by literals
parameter: token:string
UUID shopid
parameter: custnum:string
Customer number of client. Returning customers should be addressed by their existing emailadres, not necessarily their customernumber. Otherwise, a new customers will be created in Softwear.
parameter: email:string
email address of customer
parameter: title:string
Title of customer. Usually something like Mr/Mrs/Ms etc…
parameter: firstname:string
Customers firstname or initials
parameter: middlename:string
Customers middlename
parameter: lastname:string
Customers last- or familyname
parameter: street:string
Deliveryaddress streetname
parameter: housenum:string
Deliveryaddress house number
parameter: houseadd:string
Deliveryaddress housenumber addition
parameter: zipcode:string
Deliveryaddress zip or postal code
parameter: city:string
Deliveryaddress city
parameter: countrycode:string
Deliveryaddress countrycode.
Coded against ISO 3166: http://www.iso.org/iso/english_country_names_and_code_elements
parameter: remarks:string
Remarks
parameter: shipping:number
Shipping fee in eurocents or the actual fee times 100
Eg. € 4,95 would be represented as 495.
Shipping includes VAT
parameter:discount:number
Discount amount in eurocents or the actual amount times 100.
Eg. € 6,25 would be represented as 625.
This discount applies to the whole order, not to the individual articles listed below. Discount includes VAT. Use this parameter for coupons, sales, loyalty discount,etc.
Discounts for specific articles should be specified per article be changing the price parameter in the articlelist described below.
parameter:refid:string(10)
Reference order number.
This number uniquely identifies the order. If this number is supplied with this function, the same number can be used with the cancelorder function to cancel an order in the backoffice.
parameter: articlecode:string
Articlecode as found in datafeed.
parameter: color:string
Colorcode as found in datafeed.
parameter: size:string
Size as found in datafeed. When mailcolor/sucolor or mailcolor/cup are both used, concatenate them both with a slash ( / ) in between .
parameter: qty:integer
Nr. Pieces sold of most recently mentioned article
parameter: price:integer
Price of most recently mentioned article times 100
Price includes VAT
If price=0, Softwear will use the price that it knows for the article.
If price is less than known in Softwear, the difference will be treated as a discount.
The previous 5 parameters can be repeated as many times as needed to express the complete salesorder.
The order of these parameters is significant: articlecode, color, size, qty, price.
Return values
Results are returned in HTML.
On success, OK is returned, otherwise a human readable error message is returned.
Remarks:
Optionally, the sendOrder API can be configured to accept amounts excluding VAT.
function cancelOrder.
This method is used to cancel an existing order in a Softwear backoffice.
Syntax 1:
http://testapi.softwear.nl/scripts/foxisapi.dll/sww1.wreq1.mpx?[function=]cancelorder&[token=]<shopid>&refid=<refid>
elements in [ ] are optional
elements in <> should be replaced by literals
parameter: token:string
UUID shopid
parameter: refid:string(10)
Reference order number.
This number uniquely identifies the order. It is the same number originally supplied as refid when the order was created with the sendorder function.
function getStatus.
This method is used to recieve the historical transactions of a customer or a specific transaction.
Syntax 1:
http://testapi.softwear.nl/scripts/foxisapi.dll/sww1.wreq1.mpx?[function=]getstatus&[token=]<shopid>&email=<email>&custnum=<customernumber>[&format=<xml/html>]
Syntax 2: http://testapi.softwear.nl/getstatus/<shopid>/email__<email>[/format__<xml/html>]
elements in [ ] are optional
elements in <> should be replaced by literals
parameter: token:string
UUID shopid
Historical transactions of a customer:
parameter: custnum or email :string (choose custnum OR email)
Emailaddress of clientnr
A specific transaction
parameter: refid: string(10)
Reference order number.
This number uniquely identifies the order. It is the same number originally supplied as refid when the order was created with the sendorder function.
function getCoupons.
This method is used to recieve the coupons status of a customer.
Syntax 1:
http://testapi.softwear.nl/scripts/foxisapi.dll/sww1.wreq1.mpx?[function=]getcoupons&[token=]<shopid>&email=<email>[&format=<xml/html>]
Syntax 2: http://testapi.softwear.nl/getcoupons/<shopid>/email__<email>[/format__<xml/html>]
elements in [ ] are optional
elements in <> should be replaced by literals
parameter: token:string
UUID shopid
parameter: email:string
Emailaddress of client.
function redeemCoupon.
This method is used to redeem (part of) an existing coupon.
Syntax 1:
http://testapi.softwear.nl/scripts/foxisapi.dll/sww1.wreq1.mpx?[function=]redeemcoupon&[token=]<shopid>&couponid=<couponid> [&value=<value>][&format=<xml/html>]
Syntax 2: http://testapi.softwear.nl/redeemcoupon/<shopid>/couponid__<couponid> /[value__<value>][/format__<xml/html>]
elements in [ ] are optional
elements in <> should be replaced by literals
Example: http://testapi.softwear.nl/scripts/foxisapi.dll/sww1.wreq1.mpx?redeemcoupon&token=1660-8920-F99A-11E0-BE50-0800-200C-9A66& format=xml
parameter: token:string
UUID shopid
parameter: couponid:string
unique id of existing coupon.
parameter: value:string
Value to substract from coupon in eurocents.
Of value is omitted, the entire coupon is redeemed.
Value can only be specified for monetary coupons, not for percentage coupons. Percentage coupons can only be redeemed entirely.
function addCoupon.
This method is used to create a new coupon for an existing customer.
Syntax 1:
http://testapi.softwear.nl/scripts/foxisapi.dll/sww1.wreq1.mpx?[function=]addcoupon&[token=]<shopid>[&email=<email>]&couponid=<couponid >&value=<value>[&format=<xml/html>]
Syntax 2: http://testapi.softwear.nl/addcoupon/<shopid>[/email__<email>]/couponid__<couponid>/value__<value>[/format__<xml/html>]
elements in [ ] are optional
elements in <> should be replaced by literals
parameter: token:string
UUID shopid
parameter: email:string
Emailaddress of an existing client. If emailaddress is omitted, a generic coupon will be generated that can be redeemed by any client.
parameter: couponid:string
unique id for new coupon.
CouponId’s can contain all alphanumeric characters.
CouponId’s that start with a lowercase letter are special coupons that are redeemable multiple times (like couponcodes that are distributed in newspapers or other media). These coupons are not to be combined with email addresses.
All other coupons are redeemable up to their designated value.
parameter: value:string
Coupon value in eurocents or a percentage.
To create a percentage discount coupon, add a percent sign (%) to the value e.g. value=10%.
function checkCoupon.
This method is used to check the status of an existing anonymous coupon, i.e. a coupon that is not bound to a particular customer.
Syntax 1:
http://testapi.softwear.nl/scripts/foxisapi.dll/sww1.wreq1.mpx?[function=]checkcoupon&[token=]<shopid>&coupon=<couponid> [&value=<value>][&format=<xml/html>]
elements in [ ] are optional
elements in <> should be replaced by literals
parameter: token:string
UUID shopid
parameter: coupon:string
unique id of existing coupon.
function sendTransit.
This method is used to create a transit order in a Softwear backoffice.
Syntax 1:
http://testapi.softwear.nl/scripts/foxisapi.dll/sww1.wreq1.mpx?[function=]sendtransit&[token=]<shopid>&from=<sourceshop>&to=<destinationshopl>&articlecode=<articlecode>&color=<color>&size=<size>&qty=<qty>
elements in [ ] are optional
elements in <> should be replaced by literals
parameter: token:string
UUID shopid
parameter: from:string
Shopname where transit is originating. Shopname is case sensitive and should be obtained from the getstock function used with the perShop switch
parameter: to:string
Shopname where transit is going to. Shopname is case sensitive and should be obtained from the getstock function used with the perShop switch
parameter: articlecode:string
Articlecode as found in datafeed.
parameter: color:string
Colorcode as found in datafeed.
parameter: size:string
Size as found in datafeed.
parameter: qty:integer
Nr. Pieces sold of most recently mentioned article
Return values
Results are returned in HTML.
On success, OK is returned, otherwise a human readable error message is returned.
function getClient.
This method is used to recieve the address information of a customer.
Syntax 1:
http://testapi.softwear.nl/scripts/foxisapi.dll/sww1.wreq1.mpx?[function=]getclient&[token=]<shopid>[&email]<email>][&id]<id>][&format=<xml/html>][&switches=<list>]
Syntax 2: http://testapi.softwear.nl/getclient/<shopid>/[email__<email>][/format__<xml/html>][/switches__<logical>]
elements in [ ] are optional
elements in <> should be replaced by literals
parameter: token:string
UUID shopid
parameter: email:string
Emailaddress of client.
parameter: switches:string
comma separated string of switches.
list returns a list emailaddresses for all active clients
detail returns details for client specified by email address parameter (default).
function setClient.
This method is used to add or update a client order in a Softwear backoffice.
Syntax 1 for use with Softwear retail systems:
http://testapi.softwear.nl/scripts/foxisapi.dll/sww1.wreq1.mpx?[function=]setclient&[token=]<shopid>&custnum=<custnum>&email=<email>&title=<title>&firstname=<firstname>&middlename=<middlename>&lastname=<lastname>&street=<street>&housenum=<housenum>&houseadd=<houseadd>&zipcode=<zipcode>&city=<city>&pwd=<pwd>&countrycode=<countrycode>
Syntax 2 for use with Softwear wholesale systems:
http://testapi.softwear.nl/scripts/foxisapi.dll/sww1.wreq1.mpx?[function=]setclient&[token=]<shopid>&custnum=<custnum>&email=<email>&title=&name=<name>&street=<street>&housenum=<housenum>&houseadd=<houseadd>&zipcode=<zipcode>&city=<city>&countrycode=<countrycode>
elements in [ ] are optional
elements in <> should be replaced by literals
Example for wholesale:
http://testapi.softwear.nl/scripts/foxisapi.dll/sww1.wreq1.mpx?setclient&token=1660-8920-F99A-11E0-BE50-0800-200C-9A66&custnum=1234&email=jeroen@softwear.nl&name=Jeroen%20de%20Vries&street=Veerdijk&housenum=42&houseadd=e&zipcode=1531%20MS&city=WORMER&countrycode=NL&deliveryaddress=veerdijk%2014&deliverycountrycode=NL&deliverycity=Wormer&deliveryzipcode=1531%20MS
parameter: token:string
UUID shopid
parameter: custnum:string
Internal Softwear customernumber of client. Returning customers should be addressed by their existing email address, not necessarily their customernumber. Otherwise, a new customer will be created in Softwear.
parameter: clientnr:string
Customernumber of client. Returning customers should be addressed by their existing email address, not necessarily their customernumber. Otherwise, a new customer will be created in Softwear.
parameter: email:string
emailaddress of customer
parameter: title:string
Title of customer. Usually something like Mr/Mrs/Ms etc…
parameter: firstname:string
Customers firstname or initials
parameter: middlename:string
Customers middlename
parameter: lastname:string
Customers last- or familyname
parameter: telephone:string
Customers telephone
parameter (wholesale): name:string
Company name
parameter (wholesale): deliveryaddress:string
Delivery address
parameter (wholesale): deliverycountrycode:string
Delivery countrycode
parameter (wholesale): deliverycity:string
Delivery city
parameter (wholesale): deliverytelephone:string
Delivery telephone
parameter (wholesale): deliveryzipcode:string
Delivery zipcode
parameter (wholesale): vatnr:string
VAT nr
parameter: street:string
Deliveryaddress streetname
parameter: housenum:string
Deliveryaddress house number
parameter: houseadd:string
Deliveryaddress housenumber addition
parameter: zipcode:string
Deliveryaddress zip or postal code
parameter: city:string
Deliveryaddress city
parameter: password:string
Password. If not supplied, Softwear will generate a password.
parameter: countrycode:string
Deliveryaddress countrycode.
Coded against ISO 3166: http://www.iso.org/iso/english_country_names_and_code_elements
function getInvoice.
This method is used to recieve invoice data for a particular day from Softwear.
Syntax 1:
http://testapi.softwear.nl/scripts/foxisapi.dll/sww1.wreq1.mpx?[function=]getinvoice&[token=]<shopid> [&year]<year>] [&month]<month>] [&day]<day>][&format=<xml/html>]
Syntax 2: http://testapi.softwear.nl/getinvoice/<shopid>/[year__<year>][month__<month>][day__<day>][/format__<xml/html>]
elements in [ ] are optional
elements in <> should be replaced by literals
parameter: token:string
UUID shopid
parameter: year:number
Year to query.
parameter: month:number
Month to query.
parameter: day:number
Day to query.
function blockClient.
This method is used to block/unblock a client in a Softwear backoffice.
Syntax 1:
http://testapi.softwear.nl/scripts/foxisapi.dll/sww1.wreq1.mpx?[function=]blockclient&[token=]<shopid>&custnum=<custnum>&blocked=<true|false>
elements in [ ] are optional
elements in <> should be replaced by literals
parameter: token:string
UUID shopid
parameter: custnum:string
Customernumber of client.
parameter: blocked:string
true to block a client, false to unblock.
function getBasicOrderInfo.
This method is used to get order-information out of a retail Softwear Back-office. Can be used to check if an sendorder has worked properly.
Syntax 1:
http://testapi.softwear.nl/scripts/foxisapi.dll/sww1.wreq1.mpx?[function=]getbasicorderinfo&[token=]<shopid>&refid=<refid>
elements in [ ] are optional
elements in <> should be replaced by literals
parameter: token:string
UUID shopid
parameter: refid:string(10)
Reference order number.
This number uniquely identifies the order. It is the same number originally supplied as refid when the order was created with the sendorder function.
Server-Response:
{"response”:”OK","refid":"65748392","amount":0.00,"interestdate":"01/10/13","collection":"102010,
"agent":"WEBSHOP","currency":"EURO" }
function getOrderProgress.
This method is used to retrieve the status of an order.
Syntax 1:
http://testapi.softwear.nl/scripts/foxisapi.dll/sww1.wreq1.mpx?[function=]getorderprogess&[token=]<shopid>&refid=<refid>
elements in [ ] are optional
elements in <> should be replaced by literals
parameter: token:string
UUID shopid
parameter: refid:string(10)
Reference order number.
This number uniquely identifies the order. It is the same number originally supplied as refid when the order was created with the sendorder function.
Server-Response:
O = preorder
ON = order
P = packinglist for preorder
PN = packinglist
F = invoice for preorder
FN = invoice backorder
function raptorSKU.
This method is used to fetch article properties from a barcode. Can be used to implement cash registers.
Syntax 1:
http://testapi.softwear.nl/scripts/foxisapi.dll/sww1.wreq1.mpx?[function=]raptorsku&[token=]<shopid>&barcode=<barcode>
elements in [ ] are optional
elements in <> should be replaced by literals
parameter: token:string
UUID shopid
parameter: barcode:string
max. 13 digit barcode.
function sendrma.
This method is used to place a returnorder in a Softwear backoffice. RMA’s should only be created for goods that have been invoiced to the customer. This information can be found in the getStatus api.
Syntax 1:
http://testapi.softwear.nl/scripts/foxisapi.dll/sww1.wreq1.mpx?[function=]sendrma&[token=]<shopid>&custnum=<custnum>[&articlecode=<articlecode>&color=<color>&size=<size>&qty=<qty>&line=<line>&price=<price>]*
elements in [ ] are optional
elements in <> should be replaced by literals
parameter: token:string
UUID shopid
parameter: custnum:string
Customernumber of client.
This method is used to place a returnorder in a Softwear backoffice. RMA’s should only be created for goods that have been invoiced to the customer. This information can be found in the getStatus api.
Syntax 1:
http://testapi.softwear.nl/scripts/foxisapi.dll/sww1.wreq1.mpx?[function=]sendrma&[token=]<shopid>&custnum=<custnum>[&articlecode=<articlecode>&color=<color>&size=<size>&qty=<qty>&line=<line>&price=<price>[&reason=<reasoncode>]&remarks=<remarks>]*
elements in [ ] are optional
elements in <> should be replaced by literals
parameter: token:string
UUID shopid
parameter: custnum:string
Customernumber of client.
parameter: articlecode:string
Articlecode as found in datafeed.
parameter: color:string
Colorcode as found in datafeed.
parameter: size:string
Size as found in datafeed. When mailcolor/sucolor or mailcolor/cup are both used, concatenate them both with a slash ( / ) in between .
parameter: qty:integer
Nr. Pieces sold of most recently mentioned article
parameter: line:integer
line code as found in getStatus api. This uniquely identifies an invoice line.
parameter: price:integer
Price of most recently mentioned article times 100
Price includes VAT
parameter: reason:string
Reason code. Codes can be found in the claims-reason table in Softwear.
Example: 00001
parameter: remarks:string
Remarks.
The previous 7 parameters can be repeated as many times as needed to express the complete rma.
The order of these parameters is significant: articlecode, color, size, qty, line, price, reason, remarks.
The last two parameters of the 7 are optional.
Return values
Results are returned in HTML.
On success, OK is returned, otherwise a human readable error message is returned.