Bulk Import of Gift Cards Status

Method Description

Invoked with a POST request. Request address and parameters are set up via Maestra framework.

POST https://api.maestra.io/v3/operations/bulk?endpointId={API endpoint ID}&operation=DirectCrm.GiftCards.Import&csvCodePage=65001
HTTP/1.1

Authorization: SecretKey {Secret Key}
Accept: application/xml
Content-Type: text/csv

csvCodePage: Windows codepage ID for CSV file. 65001 (UTF-8) is preferred.
csvColumnDelimiter: Column delimiter character in CSV file.
csvTextQualifier: Optional start/end character in column value, masking otherwise invalid characters.
Authorization key: The value is obtained via Maestra.
The service allows up to 60 imports per hour. If the limit is exceeded, you’ll receive 429 Too Many Requests until the ratio of tasks queued/hour drops below 60.

Field Descriptions

Title	Description
CustomFieldNumber	Gift card number
Amount	Card balance
ActivationDateTimeUtc	Card purchase (activation) date in UTC+0
ActivatedPointOfContact	Point of contact where the card was purchased
ActivatedCustomerId	Purchasing customer ID
UsedDateTimeUtc	Card redemption date and time in UTC+0
UsedPointOfContact	Point of contact where the card was redeemed
UsedCustomerId	Redeeming customer ID
BlockedDateTimeUtc	Card blocking date and time in UTC+0

Sample Request

POST https://api.maestra.io/v3/operations/bulk?endpointId=Maestra&operation=DirectCrm.GiftCards.Import&csvCodePage=65001

Authorization: SecretKey mDdO
Accept: application/xml
Content-Type: text/csv

CustomFieldNumber;Amount;ActivationDateTimeUtc;ActivatedPointOfContact;ActivatedMaestraId
6768953;5000;18.10.2016 20:02;Shop123;2342357