Upload Diamonds
Overview
Primary Suppliers and RapNet Dealers can upload diamonds for sale on the RapNet website.
- We provide a list of diamond fields and values plus a diamond inventory file template.
- Some diamond fields are mandatory and if data is missing in these fields, the diamond will not upload to RapNet.
- We recommend listing diamond inventory with all diamond parameters and grading reports, images, and videos. This increases the chances of your diamond being found.
Diamond Upload Methods
We offer 5 methods for uploading and managing diamond inventory on RapNet.
They are :
Single Diamond Upload
On RapNet’s Single Diamond Upload page, either type in the GIA report number and we will auto-populate the diamond data fields for you, or use drop-downs and fields to manually enter data.
Click here to go to RapNet’s single diamond upload page.
Multiple Diamond Upload
Upload through RapNet website
- Fill out diamond information on an XL or CSV worksheet using one of these options:
- Download & use our CSV template
- Use your own inventory file or a blank XL/CSV worksheet
- Download & use our CSV template
- Refer to RapNet’s Accepted Fields and Values to ensure the data is correctly filled out
- Save in CSV format.
- Login to RapNet > Go to Upload Diamonds
- Browse or Drag & Drop your CSV inventory file
- Choose:
- Replace All: Lots not included in the upload file removed from RapNet.
- Add & Update: New lots are added, existing lots are updated and lots not included in the file remain untouched.
- Upload File > Page moves to Upload History to view valid lots and understand why diamonds aren’t uploading or displaying correctly.
Upload using RapNet XL
Prepare and upload diamond inventory to RapNet either through the RapNet website or via RapNet XL.
Minimal System Requirements for RapNet XL:
- Microsoft Excel 2013 and higher, and Windows 10 and above
- Apple Mac and Open Office are not supported
- RapNet XL add-on does not work on free or student versions of XL
- Download RapNet XL
- Fill out diamond information on an XL or CSV worksheet using one of these options:
- Open XL > RapNet XL tab > New Stock file
- Download & use our CSV template
- Use your own inventory file or a blank XL/CSV worksheet
- Refer to RapNet’s Accepted Fields and Values to ensure the data is correctly filled out
- Save in CSV, XLS, and XLSX format.
- RapNet XL tab > Upload to RapNet > Select
- Replace All: Lots not included in the upload file were removed from RapNet.
- Add & Update: New lots are added, existing lots are updated and lots not included in the file remain untouched.
A pop-up box identifies valid lots and explains why diamonds aren’t uploading or displaying correctly.
FTP File Uploads
FTP (File Transfer Protocol ) is a simple, secure, and reliable method designed to transfer large amounts of data or multiple files from one computer to another. It’s also faster than other methods such as uploading data or media files via a website.
Using RapNet’s FTP means that you can now upload your diamond and jewelry inventory and media, faster and more efficiently.
Click here for a full-service description
Diamond Upload API
Upload Diamonds
Our APIs allow you to upload inventory and check on the upload status.
There is a 2 step method when uploading Diamonds
- Upload the file using Upload Diamonds – File. An Upload ID is generated
- Use the Upload ID to check the status of your uploads using the Check Upload Status API
Note: To use RapNet APIs, you need to create a Login token. Please click here for Authentication.
Upload Diamonds-File
POST /diamondupdateingest/api/public/lots HTTP/1.1
Host: technet.rapnetapis.com
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6Ik16aERRMFExTURFeVJqSTNRa0k0TTBGRV
Content-Length: 635
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="File"; filename="/C:/10diamondsgwlab.csv"
Content-Type: text/csv
(data)
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="DiamondFileFormat"
Rapnet
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="ReplaceAll"
true
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="FirstRowHeaders"
true
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="ReportOption"
Daily
------WebKitFormBoundary7MA4YWxkTrZu0gW--
Request parameters:
Name | Type | Description | Allowed Values |
---|---|---|---|
File | File (Binary) | Binary content of the file with the diamonds data | |
DiamondFileFormat | Enum | Diamonds File Format | RapNet RapXML CertNet PolyPlus RapNetXL RapNetWS |
ReplaceAll | Boolean | Replace all current stock of diamonds or just add/update existing | true false |
SendEmail | Boolean | Send email report after upload processing is complete. | true false |
Web Request -Response
{
"uploadId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
Check Upload Status
The Check Upload Status API enables users to check their file upload status.
Upload status
curl -X 'GET' \
'https://technet.rapnetapis.com/diamondupdateingest/api/public/lots/status/1f2f9cd0-a732-4393-96fc-83178ec13950' \
-H 'accept: application/json' \
-H 'Authorization: "Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6Ik56aERNVFkzUmtGRE56WXdOMEZDUVVWRE5qQTFOVU00TXpkRlJUTTVPVFF3T1VGRVEwTkdSUSJ9.eyJodHRwOi8vcmFwYXBvcnQuY29tL3VzZXIiOnsiYWNjb3VudElkIjoxMTIwNzMzfSwiaHR0cDovL3JhcGFwb3J0LmNvbS9hcGlrZXkiOnsiaHR0cHM6Ly91cGxvYWRsb3RzLnJhcG5ldGFwaXMuY29tIjoiWVpFM1VHcjRLZDVtSGhnN0FtYTRSOWhzZDBtOGhURjQzU1VjbGxqSiJ9LCJodHRwOi8vcmFwYXBvcnQuY29tL2F1ZGllbmNlIjpbImh0dHBzOi8vYXBpZ2F0ZXdheS5yYXBuZXRhcGlzLmNvbSIsImh0dHBzOi8vdXBsb2FkbG90cy5yYXBuZXRhcGlzLmNvbSJdLCJodHRwOi8vcmFwYXBvcnQuY29tL3Blcm1pc3Npb25zIjp7InJhcG5ldGFwaXMtYXBpZ2F0ZXdheSI6WyJwcmltYXJ5U3VwbGxpZXIiLCJwcmljZUxpc3RXZWVrbHkiLCJlbnRlcnByaXNlIiwicHJpY2VMaXN0TW9udGhseSIsInJhcG5ldFByaWNlTGlzdFdlZWtseSIsImJhc2ljIiwicmFwYXBvcnRFbXBsb3llZXMiLCJETFMiLCJyYXBuZXRQcmljZUxpc3RNb250aGx5IiwiYmV0YSIsImluc3RhbnRJbnZlbnRvcnkiLCJtZW1iZXJEaXJlY3RvcnkiLCJzZWFyY2giLCJtYW5hZ2VMaXN0aW5nc0ZpbGUiLCJidXlSZXF1ZXN0c0FkZCIsIml0ZW1TaGFyZWQiLCJ0cmFkZUNlbnRlciIsImluc3RhbnRJbnZlbnRvcnlTZXR1cCIsIm15Q29udGFjdHMiLCJjaGF0IiwibWFuYWdlTGlzdGluZ3MiLCJsZWFkcyIsIm1lbWJlclJhdGluZyIsImFkbWluIiwiYnV5UmVxdWVzdHMiXX0sImlzcyI6Imh0dHBzOi8vcmFwYXBvcnQtc3RhZ2luZy5hdXRoMC5jb20vIiwic3ViIjoiNjN5QTVzUjM0andyYkQwVGdaTHk3NnE3MWNjd0lnUWpAY2xpZW50cyIsImF1ZCI6Imh0dHBzOi8vYXBpZ2F0ZXdheS5yYXBuZXRhcGlzLmNvbSIsImlhdCI6MTY4NTA0Mjk3MywiZXhwIjoxNjg1MTI5MzczLCJhenAiOiI2M3lBNXNSMzRqd3JiRDBUZ1pMeTc2cTcxY2N3SWdRaiIsInNjb3BlIjoibWFuYWdlTGlzdGluZ3MiLCJndHkiOiJjbGllbnQtY3JlZGVudGlhbHMifQ.1srYnId36Z7eux_KTMjoNg-ftJIUXQ2PtS2qVvAyNGK2-injHbBTYBGb7zoYaMMBZ1YGancWSwKLOQz3wnsKzYnX-L296R0ewzkzYOLn9ah3s1mdrsCoycTdvG20fcoY16mXPjSHgNn2rJRX4EYKe7R-k2TlVgCC8ollgD1tGftUnOtgHe2EMYLvRjBK3-UbziUke0Lw2qEhSHGauX2eTP2Jv0k4qbRY6MdKe5mwie2mLrFouykkeOyXpgoyzPduUjBpPrLJowVhOd7bnPXwxN-BlW0pGm9TADPTKEABcVX5yUHPJpCPhJ6s2lN8x3MkIETlYcGt0Q72dn-ijXjOjg"\
Request URL
http://services.stage.k8s.rapaport.com/diamondupdateingestapp/api/public/lots/status/1f2f9cd0-a732-4393-96fc-83178ec13950
Upload Status -Response
{
"uploadID": 58955452,
"uploadType": "Rapnet.com",
"fileFormat": "Rapnet",
"stockReplaced": false,
"dateUploaded": "2023-05-26T12:22:48.969812",
"status": "Finished successfully",
"errorMessages": null,
"warningMessages": null,
"numLotReceived": 131,
"numValidLots": 130,
"numInvalidLots": 1,
"startTime": "2023-05-26T12:22:55.616365",
"endTime": "2023-05-26T12:22:57.529206",
"lastUpdated": "2023-05-26T12:22:57.545855",
"duration": null,
"progressPercent": 0,
"waitingINQueue": 0
}
Request parameters:
Name | Type | Description |
---|---|---|
UploadId | String | GUID id of the upload returned by initiate upload |
Manage Diamond Listings
Our New diamond upload APIs, enables users to manage his diamond listings.
Users can change the price and update and maintain inventory on RapNet.
- Delete Diamonds – Enables users to delete stones by using lotId or stockNumber.
- Change Price – Enables users to modify the prices of stones by using lotId or stockNumber.
- Change Status – Enables users to change the availability of the stone by using lotId or stockNumber.
- Keep Alive – Allows users to renew their suspended inventory via single stones or full inventory.
Request parameters: Note: For each diamond specify only one type of identifier i.e. either Client Row Id, Lot Id or Stock NumberDelete Diamonds
Delete Diamonds -Response
Name Type Description ClientRowIds List of strings List of Client Row Ids for diamonds that need to ne deleted RapnetLotIds List of strings List of Lot Ids for diamonds that need to ne deleted StockNumbers List of strings List of Stock Numbers for diamonds that need to ne deleted
Upload Diamonds – Change Price
PUT /diamondupdateingest/api/public/lots/prices HTTP/1.1
Host: technet.rapnetapis.com
Content-Type: text/plain
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6Ik16aERRMFExTURFeVJqSTNRa0k0TTBGRVJUZzFNekUzTWtOQ09UTXhNREZDTVVZM1JURkNNZyJ9.eyJodHRwOi8vcmFwYXBvcnQuY29tL3VzZXIiOnsiYWNjb3VudElkIjoxMjEzMDZ9LCJodHRwOi8vcmFwYXBvcnQuY29tL2FwaWtleSI6eyJodHRwczovL3VwbG9hZGxvdHMucmFwbmV0YXBpcy5jb20iOiJYVFV2YzcwdE1xOE9ZbjNmQldBUU42YXNQZGVIZmwxUjFvWFJNQmNLIn0sImh0dHA6Ly9yYXBhcG9ydC5jb20vYXVkaWVuY2UiOlsiaHR0cHM6Ly91cGxvYWRsb3RzLnJhcG5ldGFwaXMuY29tIiwiaHR0cHM6Ly9hcGlnYXRld2F5LnJhcG5ldGFwaXMuY29tIl0sImh0dHA6Ly9yYXBhcG9ydC5jb20vcGVybWlzc2lvbnMiOnsicmFwbmV0YXBpcy1hcGlnYXRld2F5IjpbInByaW1hcnlTdXBsbGllciIsInByaWNlTGlzdFdlZWtseSIsInByaWNlTGlzdE1vbnRobHkiLCJyYXBuZXRQcmljZUxpc3RXZWVrbHkiLCJiYXNpYyIsInJhcG5ldFByaWNlTGlzdE1vbnRobHkiLCJtZW1iZXJEaXJlY3RvcnkiLCJzZWFyY2giLCJpbnN0YW50SW52ZW50b3J5U2V0dXAiLCJtYW5hZ2VMaXN0aW5nc0ZpbGUiLCJidXlSZXF1ZXN0c0FkZCIsIml0ZW1TaGFyZWQiLCJ0cmFkZUNlbnRlciIsIm15Q29udGFjdHMiLCJtZW1iZXJSYXRpbmciLCJjaGF0IiwibWFuYWdlTGlzdGluZ3MiLCJsZWFkcyIsImFkbWluIiwiYnV5UmVxdWVzdHMiXX0sImlzcyI6Imh0dHBzOi8vcmFwYXBvcnQuYXV0aDAuY29tLyIsInN1YiI6ImhUWnpDc0JkQ2toV1l4UTRvbEJXMmYzOFd1eWQ3cDJvQGNsaWVudHMiLCJhdWQiOiJodHRwczovL2FwaWdhdGV3YXkucmFwbmV0YXBpcy5jb20iLCJpYXQiOjE2OTI3ODk1MTIsImV4cCI6MTY5Mjg3NTkxMiwiYXpwIjoiaFRaekNzQmRDa2hXWXhRNG9sQlcyZjM4V3V5ZDdwMm8iLCJzY29wZSI6Im1hbmFnZUxpc3RpbmdzIiwiZ3R5IjoiY2xpZW50LWNyZWRlbnRpYWxzIn0.n864uovpKXENMK8k0vepXvlxJ0C3_2QSx_m-MYby_xO1dmdTb3vYFzEikv3TfV-AXdTRQWoRqzLChEU7VqNNpIAYmmH5JtB7S5Pkf7OW62pxJwoDeWviBtTtdQK7YWza_tkHpJQMwggW3AJl9NUw0oa4XKWsm6pOdQgYcuBCBYg-LkKY8gx0EzLL9h14z2eAF-oAbAtvg7QksuC3GgHi0LP1xyba_U-t80SGTHg3FOCOTXtRl2qOF9cOQ9iq-IqlTjDi1O7k0zcmxh8U8usOFUYtmqBO5TbbldRp3YG32j6L9kgepZmLqnyYZV9j8iztFwaE0B_g17gSnw-iEoWo0g
Content-Length: 2248
curl -X 'PUT' \
'https://technet.rapnetapis.com/diamondupdateingest/api/public/lots/prices' \
-H 'accept: application/json' \
-H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6Ik56aERNVFkzUmtGRE56WXdOMEZDUVVWRE5qQTFOVU00TXpkRlJUTTVPVFF3T1VGRVEwTkdSUSJ9.eyJodHRwOi8vcmFwYXBvcnQuY29tL3VzZXIiOnsiYWNjb3VudElkIjoxMTIwNzMzfSwiaHR0cDovL3JhcGFwb3J0LmNvbS9hcGlrZXkiOnsiaHR0cHM6Ly91cGxvYWRsb3RzLnJhcG5ldGFwaXMuY29tIjoiWVpFM1VHcjRLZDVtSGhnN0FtYTRSOWhzZDBtOGhURjQzU1VjbGxqSiJ9LCJodHRwOi8vcmFwYXBvcnQuY29tL2F1ZGllbmNlIjpbImh0dHBzOi8vYXBpZ2F0ZXdheS5yYXBuZXRhcGlzLmNvbSIsImh0dHBzOi8vdXBsb2FkbG90cy5yYXBuZXRhcGlzLmNvbSJdLCJodHRwOi8vcmFwYXBvcnQuY29tL3Blcm1pc3Npb25zIjp7InJhcG5ldGFwaXMtYXBpZ2F0ZXdheSI6WyJwcmltYXJ5U3VwbGxpZXIiLCJwcmljZUxpc3RXZWVrbHkiLCJlbnRlcnByaXNlIiwicHJpY2VMaXN0TW9udGhseSIsInJhcG5ldFByaWNlTGlzdFdlZWtseSIsImJhc2ljIiwicmFwYXBvcnRFbXBsb3llZXMiLCJETFMiLCJyYXBuZXRQcmljZUxpc3RNb250aGx5IiwiYmV0YSIsImluc3RhbnRJbnZlbnRvcnkiLCJtZW1iZXJEaXJlY3RvcnkiLCJzZWFyY2giLCJtYW5hZ2VMaXN0aW5nc0ZpbGUiLCJidXlSZXF1ZXN0c0FkZCIsIml0ZW1TaGFyZWQiLCJ0cmFkZUNlbnRlciIsImluc3RhbnRJbnZlbnRvcnlTZXR1cCIsIm15Q29udGFjdHMiLCJjaGF0IiwibWFuYWdlTGlzdGluZ3MiLCJsZWFkcyIsIm1lbWJlclJhdGluZyIsImFkbWluIiwiYnV5UmVxdWVzdHMiXX0sImlzcyI6Imh0dHBzOi8vcmFwYXBvcnQtc3RhZ2luZy5hdXRoMC5jb20vIiwic3ViIjoiNjN5QTVzUjM0andyYkQwVGdaTHk3NnE3MWNjd0lnUWpAY2xpZW50cyIsImF1ZCI6Imh0dHBzOi8vYXBpZ2F0ZXdheS5yYXBuZXRhcGlzLmNvbSIsImlhdCI6MTY4NTA0Mjk3MywiZXhwIjoxNjg1MTI5MzczLCJhenAiOiI2M3lBNXNSMzRqd3JiRDBUZ1pMeTc2cTcxY2N3SWdRaiIsInNjb3BlIjoibWFuYWdlTGlzdGluZ3MiLCJndHkiOiJjbGllbnQtY3JlZGVudGlhbHMifQ.1srYnId36Z7eux_KTMjoNg-ftJIUXQ2PtS2qVvAyNGK2-injHbBTYBGb7zoYaMMBZ1YGancWSwKLOQz3wnsKzYnX-L296R0ewzkzYOLn9ah3s1mdrsCoycTdvG20fcoY16mXPjSHgNn2rJRX4EYKe7R-k2TlVgCC8ollgD1tGftUnOtgHe2EMYLvRjBK3-UbziUke0Lw2qEhSHGauX2eTP2Jv0k4qbRY6MdKe5mwie2mLrFouykkeOyXpgoyzPduUjBpPrLJowVhOd7bnPXwxN-BlW0pGm9TADPTKEABcVX5yUHPJpCPhJ6s2lN8x3MkIETlYcGt0Q72dn-ijXjOjg' \
-H 'Content-Type: application/json' \
-d '[
{
"stockNumber": "C233",
"rapNetPrice": 1000.23,
"cashPriceDiscountPercent": 10.9
},
{
"rapnetLotId": 46256343,
"cashPrice": 9870.9,
"cashPriceDiscountPercent": 8.65
},
{
"stockNumber": "C235",
"rapNetPrice": 2150.0,
},
]'
Change Prices Upload -Response
{
"uploadId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
Request parameters:
Name | Type | Description |
---|---|---|
RapnetLotId | Int | Lot ID of diamond that needs updating |
StockNumber | String | Stock Numbers of diamond that needs updating |
RapNetPrice | Decimal | New RapNet Price for corresponding diamond |
RapNetDiscountPercent | Decimal | New RapNet Discount Percent for corresponding diamond |
CashPrice | Decimal | New Cash Price for corresponding diamond |
CashPriceDiscountPercent | Decimal | New Cash Price Discount Percent for corresponding diamond |
Note: For each diamond specify only one type of identifier : Lot ID or Stock Number.
This can be for single or all price changes.
Upload Diamonds – Change status
PUT /diamondupdateingest/api/public/lots/availability HTTP/1.1
Host: technet.rapnetapis.com
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6Ik16aERRMFExTURFeVJqSTNRa0k0TTBGRVJUZzFNekUzTWtOQ09UTXhNREZDTVVZM1JURkNNZyJ9.eyJodHRwOi8vcmFwYXBvcnQuY29tL3VzZXIiOnsiYWNjb3VudElkIjoxMjEzMDZ9LCJodHRwOi8vcmFwYXBvcnQuY29tL2FwaWtleSI6eyJodHRwczovL3VwbG9hZGxvdHMucmFwbmV0YXBpcy5jb20iOiJYVFV2YzcwdE1xOE9ZbjNmQldBUU42YXNQZGVIZmwxUjFvWFJNQmNLIn0sImh0dHA6Ly9yYXBhcG9ydC5jb20vYXVkaWVuY2UiOlsiaHR0cHM6Ly91cGxvYWRsb3RzLnJhcG5ldGFwaXMuY29tIiwiaHR0cHM6Ly9hcGlnYXRld2F5LnJhcG5ldGFwaXMuY29tIl0sImh0dHA6Ly9yYXBhcG9ydC5jb20vcGVybWlzc2lvbnMiOnsicmFwbmV0YXBpcy1hcGlnYXRld2F5IjpbInByaW1hcnlTdXBsbGllciIsInByaWNlTGlzdFdlZWtseSIsInByaWNlTGlzdE1vbnRobHkiLCJyYXBuZXRQcmljZUxpc3RXZWVrbHkiLCJiYXNpYyIsInJhcG5ldFByaWNlTGlzdE1vbnRobHkiLCJtZW1iZXJEaXJlY3RvcnkiLCJzZWFyY2giLCJpbnN0YW50SW52ZW50b3J5U2V0dXAiLCJtYW5hZ2VMaXN0aW5nc0ZpbGUiLCJidXlSZXF1ZXN0c0FkZCIsIml0ZW1TaGFyZWQiLCJ0cmFkZUNlbnRlciIsIm15Q29udGFjdHMiLCJtZW1iZXJSYXRpbmciLCJjaGF0IiwibWFuYWdlTGlzdGluZ3MiLCJsZWFkcyIsImFkbWluIiwiYnV5UmVxdWVzdHMiXX0sImlzcyI6Imh0dHBzOi8vcmFwYXBvcnQuYXV0aDAuY29tLyIsInN1YiI6ImhUWnpDc0JkQ2toV1l4UTRvbEJXMmYzOFd1eWQ3cDJvQGNsaWVudHMiLCJhdWQiOiJodHRwczovL2FwaWdhdGV3YXkucmFwbmV0YXBpcy5jb20iLCJpYXQiOjE2OTI3ODk1MTIsImV4cCI6MTY5Mjg3NTkxMiwiYXpwIjoiaFRaekNzQmRDa2hXWXhRNG9sQlcyZjM4V3V5ZDdwMm8iLCJzY29wZSI6Im1hbmFnZUxpc3RpbmdzIiwiZ3R5IjoiY2xpZW50LWNyZWRlbnRpYWxzIn0.n864uovpKXENMK8k0vepXvlxJ0C3_2QSx_m-MYby_xO1dmdTb3vYFzEikv3TfV-AXdTRQWoRqzLChEU7VqNNpIAYmmH5JtB7S5Pkf7OW62pxJwoDeWviBtTtdQK7YWza_tkHpJQMwggW3AJl9NUw0oa4XKWsm6pOdQgYcuBCBYg-LkKY8gx0EzLL9h14z2eAF-oAbAtvg7QksuC3GgHi0LP1xyba_U-t80SGTHg3FOCOTXtRl2qOF9cOQ9iq-IqlTjDi1O7k0zcmxh8U8usOFUYtmqBO5TbbldRp3YG32j6L9kgepZmLqnyYZV9j8iztFwaE0B_g17gSnw-iEoWo0g
Content-Length: 2077
curl -X 'PUT' \
' https:
-H 'accept: application/json' \
-H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6Ik56aERNVFkzUmtGRE56WXdOMEZDUVVWRE5qQTFOVU00TXpkRlJUTTVPVFF3T1VGRVEwTkdSUSJ9.eyJodHRwOi8vcmFwYXBvcnQuY29tL3VzZXIiOnsiYWNjb3VudElkIjoxMTIwNzMzfSwiaHR0cDovL3JhcGFwb3J0LmNvbS9hcGlrZXkiOnsiaHR0cHM6Ly91cGxvYWRsb3RzLnJhcG5ldGFwaXMuY29tIjoiWVpFM1VHcjRLZDVtSGhnN0FtYTRSOWhzZDBtOGhURjQzU1VjbGxqSiJ9LCJodHRwOi8vcmFwYXBvcnQuY29tL2F1ZGllbmNlIjpbImh0dHBzOi8vYXBpZ2F0ZXdheS5yYXBuZXRhcGlzLmNvbSIsImh0dHBzOi8vdXBsb2FkbG90cy5yYXBuZXRhcGlzLmNvbSJdLCJodHRwOi8vcmFwYXBvcnQuY29tL3Blcm1pc3Npb25zIjp7InJhcG5ldGFwaXMtYXBpZ2F0ZXdheSI6WyJwcmltYXJ5U3VwbGxpZXIiLCJwcmljZUxpc3RXZWVrbHkiLCJlbnRlcnByaXNlIiwicHJpY2VMaXN0TW9udGhseSIsInJhcG5ldFByaWNlTGlzdFdlZWtseSIsImJhc2ljIiwicmFwYXBvcnRFbXBsb3llZXMiLCJETFMiLCJyYXBuZXRQcmljZUxpc3RNb250aGx5IiwiYmV0YSIsImluc3RhbnRJbnZlbnRvcnkiLCJtZW1iZXJEaXJlY3RvcnkiLCJzZWFyY2giLCJtYW5hZ2VMaXN0aW5nc0ZpbGUiLCJidXlSZXF1ZXN0c0FkZCIsIml0ZW1TaGFyZWQiLCJ0cmFkZUNlbnRlciIsImluc3RhbnRJbnZlbnRvcnlTZXR1cCIsIm15Q29udGFjdHMiLCJjaGF0IiwibWFuYWdlTGlzdGluZ3MiLCJsZWFkcyIsIm1lbWJlclJhdGluZyIsImFkbWluIiwiYnV5UmVxdWVzdHMiXX0sImlzcyI6Imh0dHBzOi8vcmFwYXBvcnQtc3RhZ2luZy5hdXRoMC5jb20vIiwic3ViIjoiNjN5QTVzUjM0andyYkQwVGdaTHk3NnE3MWNjd0lnUWpAY2xpZW50cyIsImF1ZCI6Imh0dHBzOi8vYXBpZ2F0ZXdheS5yYXBuZXRhcGlzLmNvbSIsImlhdCI6MTY4NTA0Mjk3MywiZXhwIjoxNjg1MTI5MzczLCJhenAiOiI2M3lBNXNSMzRqd3JiRDBUZ1pMeTc2cTcxY2N3SWdRaiIsInNjb3BlIjoibWFuYWdlTGlzdGluZ3MiLCJndHkiOiJjbGllbnQtY3JlZGVudGlhbHMifQ.1srYnId36Z7eux_KTMjoNg-ftJIUXQ2PtS2qVvAyNGK2-injHbBTYBGb7zoYaMMBZ1YGancWSwKLOQz3wnsKzYnX-L296R0ewzkzYOLn9ah3s1mdrsCoycTdvG20fcoY16mXPjSHgNn2rJRX4EYKe7R-k2TlVgCC8ollgD1tGftUnOtgHe2EMYLvRjBK3-UbziUke0Lw2qEhSHGauX2eTP2Jv0k4qbRY6MdKe5mwie2mLrFouykkeOyXpgoyzPduUjBpPrLJowVhOd7bnPXwxN-BlW0pGm9TADPTKEABcVX5yUHPJpCPhJ6s2lN8x3MkIETlYcGt0Q72dn-ijXjOjg' \
-H 'Content-Type: application/json' \
-d '[
{
"stockNumber": "C233",
"status": "M"
},
{
"rapnetLotId": 46256343,
"status": "G"
},
{
"stockNumber": "C235",
"status": "NA"
},
]'
Change status Upload -Response
{
"uploadId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
Request parameters:
Name | Type | Description |
---|---|---|
RapnetLotId | Int | Lot ID of diamond that needs updating |
StockNumber | String | Stock Numbers of diamond that needs updating |
Status | String | New Availability status for corresponding diamond |
Note: For each diamond specify only one type of identifier i.e. either Lot ID or Stock Number
Upload Diamonds – Keep Alive All
PUT /diamondupdate/api/public/lots/keepalive/all HTTP/1.1
Host: technet.rapnetapis.com
AccountId: 115074
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6Ik56aERNVFkzUmtGRE56WXdOMEZDUVVWRE5qQTFOVU00TXpkRlJUTTVPVFF3T1VGRVEwTkdSUSJ9
Keep Alive All -Response
{
"totalUpdated": 80124
}
Upload Diamonds – Keep Alive Single
PUT /diamondupdate/api/public/lots/keepalive HTTP/1.1
Host: technet.rapnetapis.com
Content-Type: text/plain
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6Ik16aERRMFExTURFeVJqSTNRa0k0TTBGRVJUZzFNekUzTWtOQ09UTXhNREZDTVVZM1JURkNNZyJ9.eyJodHRwOi8vcmFwYXBvcnQuY29tL3VzZXIiOnsiYWNjb3VudElkIjoxMjEzMDZ9LCJodHRwOi8vcmFwYXBvcnQuY29tL2FwaWtleSI6eyJodHRwczovL3VwbG9hZGxvdHMucmFwbmV0YXBpcy5jb20iOiJYVFV2YzcwdE1xOE9ZbjNmQldBUU42YXNQZGVIZmwxUjFvWFJNQmNLIn0sImh0dHA6Ly9yYXBhcG9ydC5jb20vYXVkaWVuY2UiOlsiaHR0cHM6Ly91cGxvYWRsb3RzLnJhcG5ldGFwaXMuY29tIiwiaHR0cHM6Ly9hcGlnYXRld2F5LnJhcG5ldGFwaXMuY29tIl0sImh0dHA6Ly9yYXBhcG9ydC5jb20vcGVybWlzc2lvbnMiOnsicmFwbmV0YXBpcy1hcGlnYXRld2F5IjpbInByaW1hcnlTdXBsbGllciIsInByaWNlTGlzdFdlZWtseSIsInByaWNlTGlzdE1vbnRobHkiLCJyYXBuZXRQcmljZUxpc3RXZWVrbHkiLCJiYXNpYyIsInJhcG5ldFByaWNlTGlzdE1vbnRobHkiLCJtZW1iZXJEaXJlY3RvcnkiLCJzZWFyY2giLCJpbnN0YW50SW52ZW50b3J5U2V0dXAiLCJtYW5hZ2VMaXN0aW5nc0ZpbGUiLCJidXlSZXF1ZXN0c0FkZCIsIml0ZW1TaGFyZWQiLCJ0cmFkZUNlbnRlciIsIm15Q29udGFjdHMiLCJtZW1iZXJSYXRpbmciLCJjaGF0IiwibWFuYWdlTGlzdGluZ3MiLCJsZWFkcyIsImFkbWluIiwiYnV5UmVxdWVzdHMiXX0sImlzcyI6Imh0dHBzOi8vcmFwYXBvcnQuYXV0aDAuY29tLyIsInN1YiI6ImhUWnpDc0JkQ2toV1l4UTRvbEJXMmYzOFd1eWQ3cDJvQGNsaWVudHMiLCJhdWQiOiJodHRwczovL2FwaWdhdGV3YXkucmFwbmV0YXBpcy5jb20iLCJpYXQiOjE2OTI3ODk1MTIsImV4cCI6MTY5Mjg3NTkxMiwiYXpwIjoiaFRaekNzQmRDa2hXWXhRNG9sQlcyZjM4V3V5ZDdwMm8iLCJzY29wZSI6Im1hbmFnZUxpc3RpbmdzIiwiZ3R5IjoiY2xpZW50LWNyZWRlbnRpYWxzIn0.n864uovpKXENMK8k0vepXvlxJ0C3_2QSx_m-MYby_xO1dmdTb3vYFzEikv3TfV-AXdTRQWoRqzLChEU7VqNNpIAYmmH5JtB7S5Pkf7OW62pxJwoDeWviBtTtdQK7YWza_tkHpJQMwggW3AJl9NUw0oa4XKWsm6pOdQgYcuBCBYg-LkKY8gx0EzLL9h14z2eAF-oAbAtvg7QksuC3GgHi0LP1xyba_U-t80SGTHg3FOCOTXtRl2qOF9cOQ9iq-IqlTjDi1O7k0zcmxh8U8usOFUYtmqBO5TbbldRp3YG32j6L9kgepZmLqnyYZV9j8iztFwaE0B_g17gSnw-iEoWo0g
Content-Length: 1945
curl -X 'PUT' \
'https://technet.rapnetapis.com/diamondupdate/api/public/lots/keepalive' \
-H 'accept: application/json' \
-H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6Ik16aERRMFExTURFeVJqSTNRa0k0TTBGRVJUZzFNekUzTWtOQ09UTXhNREZDTVVZM1JURkNNZyJ9.eyJodHRwOi8vcmFwYXBvcnQuY29tL3VzZXIiOnsiYWNjb3VudElkIjoxMjEzMDZ9LCJodHRwOi8vcmFwYXBvcnQuY29tL2FwaWtleSI6eyJodHRwczovL3VwbG9hZGxvdHMucmFwbmV0YXBpcy5jb20iOiJYVFV2YzcwdE1xOE9ZbjNmQldBUU42YXNQZGVIZmwxUjFvWFJNQmNLIn0sImh0dHA6Ly9yYXBhcG9ydC5jb20vYXVkaWVuY2UiOlsiaHR0cHM6Ly91cGxvYWRsb3RzLnJhcG5ldGFwaXMuY29tIiwiaHR0cHM6Ly9hcGlnYXRld2F5LnJhcG5ldGFwaXMuY29tIl0sImh0dHA6Ly9yYXBhcG9ydC5jb20vcGVybWlzc2lvbnMiOnsicmFwbmV0YXBpcy1hcGlnYXRld2F5IjpbInByaW1hcnlTdXBsbGllciIsInByaWNlTGlzdFdlZWtseSIsInByaWNlTGlzdE1vbnRobHkiLCJyYXBuZXRQcmljZUxpc3RXZWVrbHkiLCJiYXNpYyIsInJhcG5ldFByaWNlTGlzdE1vbnRobHkiLCJtZW1iZXJEaXJlY3RvcnkiLCJzZWFyY2giLCJpbnN0YW50SW52ZW50b3J5U2V0dXAiLCJtYW5hZ2VMaXN0aW5nc0ZpbGUiLCJidXlSZXF1ZXN0c0FkZCIsIml0ZW1TaGFyZWQiLCJ0cmFkZUNlbnRlciIsIm15Q29udGFjdHMiLCJtZW1iZXJSYXRpbmciLCJjaGF0IiwibWFuYWdlTGlzdGluZ3MiLCJsZWFkcyIsImFkbWluIiwiYnV5UmVxdWVzdHMiXX0sImlzcyI6Imh0dHBzOi8vcmFwYXBvcnQuYXV0aDAuY29tLyIsInN1YiI6ImhUWnpDc0JkQ2toV1l4UTRvbEJXMmYzOFd1eWQ3cDJvQGNsaWVudHMiLCJhdWQiOiJodHRwczovL2FwaWdhdGV3YXkucmFwbmV0YXBpcy5jb20iLCJpYXQiOjE2OTI3ODk1MTIsImV4cCI6MTY5Mjg3NTkxMiwiYXpwIjoiaFRaekNzQmRDa2hXWXhRNG9sQlcyZjM4V3V5ZDdwMm8iLCJzY29wZSI6Im1hbmFnZUxpc3RpbmdzIiwiZ3R5IjoiY2xpZW50LWNyZWRlbnRpYWxzIn0.n864uovpKXENMK8k0vepXvlxJ0C3_2QSx_m-MYby_xO1dmdTb3vYFzEikv3TfV-AXdTRQWoRqzLChEU7VqNNpIAYmmH5JtB7S5Pkf7OW62pxJwoDeWviBtTtdQK7YWza_tkHpJQMwggW3AJl9NUw0oa4XKWsm6pOdQgYcuBCBYg-LkKY8gx0EzLL9h14z2eAF-oAbAtvg7QksuC3GgHi0LP1xyba_U-t80SGTHg3FOCOTXtRl2qOF9cOQ9iq-IqlTjDi1O7k0zcmxh8U8usOFUYtmqBO5TbbldRp3YG32j6L9kgepZmLqnyYZV9j8iztFwaE0B_g17gSnw-iEoWo0g' \
-H 'Content-Type: application/json' \
-d '{
"clientRowIds": [],
"stockNumbers": [
"C233"
]
}'
Keep Alive Single-Response
{
"totalUpdated": 0,
"notFound": {
"clientRowIds": [
"string"
],
"stockNumbers": [
"string"
]
}
}
Request parameters:
Name | Type | Description |
---|---|---|
ClientRowIds | List of strings | List of Client Row Ids of diamonds |
StockNumbers | List of strings | List of Stock Numbers of diamonds |
Multipart Uploads
For large inventory files that are greater than 5 MB, we offer a Multipart Upload API that allows you to upload split files. We recommend using this method if your inventory file is larger than 5 MB.
Note: To use RapNet APIs, you need to create a Login token. Please click here for the Authentication Details.
To use Multipart Uploads:
- Initiate Diamonds – Upload file larger than 5 MB
Specify the FileSize of the upload file.
A response is generated with an uploadId and multipart UploadId. - Divide your file into smaller Files and upload them to putUrls.
- Insert the uploadId, multipartId and Etags into the Multipart Upload.
A new uploadId will be generated. - Use the new uploadId to check the upload status or to make changes.
Upload Diamonds – Initiate Multiload
POST /diamondupdateingest/api/public/lots/multipart HTTP/1.1
Host: technet.rapnetapis.com
accept: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6Ik16aERRMFExTURFeVJqSTNRa0k0TTBGRVJUZzFNekUzTWtOQ09UTXhNREZDTVVZM1JURkNNZyJ9
Content-Type: application/json
Content-Length: 137
{
"fileName": "BIGDATA.csv",
"replaceAll": true,
"sendEmail": true,
"diamondFileFormat": "Rapnet",
"fileSize": 69509706
}
Request parameters:
Name | Type | Description | Allowed Values |
---|---|---|---|
FileName | String | Name of the files with the diamond data | |
ReplaceAll | Boolean | Replace all current stock of diamonds or just add/update existing | true false |
SendEmail | Boolean | Send upload report by email | true false |
DiamondFileFormat | Enum | Diamonds File Format | RapNet RapXML CertNet PolyPlus RapNetXL RapNetWS |
FileSize | Integer | Size of diamonds file in bytes |
Initiate Mutipart -Response
{
"putUrls": [
"https://diamondupdate-prod1.s3.amazonaws.com/IngestRawUpload/115074/cb8978ae-18d0-4496-b139-8264ce24b1be.csv?uploadId=EjBFRcagsZGRR3oq9dMpdJ7R4oeeRoQtJ7HNvSf626fCPAuiaqqfMK7BMNPykIGBV6iKancNLBigs72HaFTtJ6vE5kMa7Ynvq2t1tH1NzAoc2xyAvSUwwBm0uQCETQq2&partNumber=1&AWSAccessKeyId=AKIA42NZZRC6U4DUW7HP&Expires=1707743853&Signature=ekqeuVud1IHx0qBD0FLFxHizfUM%3D",
"https://diamondupdate-prod1.s3.amazonaws.com/IngestRawUpload/115074/cb8978ae-18d0-4496-b139-8264ce24b1be.csv?uploadId=EjBFRcagsZGRR3oq9dMpdJ7R4oeeRoQtJ7HNvSf626fCPAuiaqqfMK7BMNPykIGBV6iKancNLBigs72HaFTtJ6vE5kMa7Ynvq2t1tH1NzAoc2xyAvSUwwBm0uQCETQq2&partNumber=2&AWSAccessKeyId=AKIA42NZZRC6U4DUW7HP&Expires=1707743853&Signature=QIE0GDYb0drR0QkHWzL%2FSNwK%2B%2BU%3D",
"https://diamondupdate-prod1.s3.amazonaws.com/IngestRawUpload/115074/cb8978ae-18d0-4496-b139-8264ce24b1be.csv?uploadId=EjBFRcagsZGRR3oq9dMpdJ7R4oeeRoQtJ7HNvSf626fCPAuiaqqfMK7BMNPykIGBV6iKancNLBigs72HaFTtJ6vE5kMa7Ynvq2t1tH1NzAoc2xyAvSUwwBm0uQCETQq2&partNumber=3&AWSAccessKeyId=AKIA42NZZRC6U4DUW7HP&Expires=1707743853&Signature=FC5ll0iICzLdkudaOdTuvCT5aOY%3D",
"https://diamondupdate-prod1.s3.amazonaws.com/IngestRawUpload/115074/cb8978ae-18d0-4496-b139-8264ce24b1be.csv?uploadId=EjBFRcagsZGRR3oq9dMpdJ7R4oeeRoQtJ7HNvSf626fCPAuiaqqfMK7BMNPykIGBV6iKancNLBigs72HaFTtJ6vE5kMa7Ynvq2t1tH1NzAoc2xyAvSUwwBm0uQCETQq2&partNumber=5&AWSAccessKeyId=AKIA42NZZRC6U4DUW7HP&Expires=1707743853&Signature=6rAPMyLDFg0d4W%2BZpvC%2FifqkG68%3D",
"https://diamondupdate-prod1.s3.amazonaws.com/IngestRawUpload/115074/cb8978ae-18d0-4496-b139-8264ce24b1be.csv?uploadId=EjBFRcagsZGRR3oq9dMpdJ7R4oeeRoQtJ7HNvSf626fCPAuiaqqfMK7BMNPykIGBV6iKancNLBigs72HaFTtJ6vE5kMa7Ynvq2t1tH1NzAoc2xyAvSUwwBm0uQCETQq2&partNumber=7&AWSAccessKeyId=AKIA42NZZRC6U4DUW7HP&Expires=1707743853&Signature=zUc98VW%2BstTf9d9clWmOL87no7c%3D",
"https://diamondupdate-prod1.s3.amazonaws.com/IngestRawUpload/115074/cb8978ae-18d0-4496-b139-8264ce24b1be.csv?uploadId=EjBFRcagsZGRR3oq9dMpdJ7R4oeeRoQtJ7HNvSf626fCPAuiaqqfMK7BMNPykIGBV6iKancNLBigs72HaFTtJ6vE5kMa7Ynvq2t1tH1NzAoc2xyAvSUwwBm0uQCETQq2&partNumber=14&AWSAccessKeyId=AKIA42NZZRC6U4DUW7HP&Expires=1707743853&Signature=B8acbo9wBGfJNN25lEoa%2BifGooI%3D"
],
"multipartSplitSize": 5242880,
"uploadId": "cb8978ae-18d0-4496-b139-8264ce24b1be",
"multipartUploadId": "EjBFRcagsZGRR3oq9dMpdJ7R4oeeRoQtJ7HNvSf626fCPAuiaqqfMK7BMNPykIGBV6iKancNLBigs72HaFTtJ6vE5kMa7Ynvq2t1tH1NzAoc2xyAvSUwwBm0uQCETQq2"
}
2. Prepare the Request Body: 3. Send the Request: 4. Copy Identifiers:Put Url Upload-Text
Put Url Upload-CSV
Put Url Headers
Put Url -Response
Request parameters:Multipart upload
Name Type Description UploadId String GUID id of the upload returned by initiate multipart upload MultipartUploadId String multipart upload id returned by initiate multipart upload eTags List List of ETags returned in response headers of each file part uploading, number of records equals to number of split parts Mutipart Upload -Response
Request parameters:Upload status
Upload Status -Response
Name Type Description UploadId String GUID id of the upload returned by initiate upload
Diamond Media Upload
Members can list diamonds with a grading report, an unlimited number of images, and one video.
Grading Reports
- When uploaded diamond data includes the diamond’s Lab and Report #, we auto-sync most GIA, IGI, and HRD reports to display on RapNet, wherever possible.
- Wherever it is not possible for us to automatically download a diamond report, members can upload a copy of the report to either a single diamond listing or bulk upload certificate files to their RapNet certificate folder.
- Certificate filenames matching the stock or report number auto-connect to the correct diamond.
Images
RapNet’s Diamond Media Library supports image uploads and connects & manages diamond images.
- We accept images in jpg, png, and gif format.
- Image filenames matching the diamond’s stock or report number auto-connect to the correct diamond.
- Upload methods:
- One by one
- Zip folder
- CSV file with image links suffixed in png or jpg
- FTP
Members can now upload diamond and jewelry media via FTP.
Click here for a full-service description
Videos
We accept video URLs that members copy & paste into the single upload form or the “Video Link” column in their diamond inventory file.
- We only display videos from approved video providers on diamond search results and on the diamond’s item pages. All other videos will be shown externally to RapNet.
- Click here to view a list of RapNet-approved diamond video providers.
- We only accept secure links formatted with HTTPS.
Important: Images or videos with external URL links appear as links on RapNet.
They do not display on item pages nor can they be used for advanced reseller services such as Instant Inventory.