Bulk Import of Gift Card Pools

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.ImportNew&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
Number	Gift card number
Amount	Card balance
ProductId{ExternalSystem}	Product ID the card is related to. Field name can be obtained from the manager
SkuExternalId	SKU ID the card is related to. Check with the manager if it is mandatory

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

Number;Amount;ProductIdWebSite
6768953;5000;21533674